document WPA-PSK support.

"i would really appreciate just something going in" jmc@

1 files changed, 17 insertions, 16 deletions

diff --git a/share/man/man4/iwn.4 b/share/man/man4/iwn.4
index e2773dca04c..cdbe8eebcae 100644
--- a/share/man/man4/iwn.4
+++ b/share/man/man4/iwn.4
@@ -1,4 +1,4 @@
-.\" $OpenBSD: iwn.4,v 1.6 2008/04/17 14:01:22 jmc Exp $
+.\" $OpenBSD: iwn.4,v 1.7 2008/07/28 20:10:28 damien Exp $
 .\"
 .\" Copyright (c) 2007
 .\"	Damien Bergamini <damien.bergamini@free.fr>. All rights reserved.
@@ -15,7 +15,7 @@
 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 .\"
-.Dd $Mdocdate: April 17 2008 $
+.Dd $Mdocdate: July 28 2008 $
 .Os
 .Dt IWN 4
 .Sh NAME
@@ -48,16 +48,13 @@ capture packets from networks which it wouldn't normally have access to,
 or to scan for access points.
 .El
 .Pp
+The
+.Nm
+driver can be configured to use the WEP, WPA-PSK and WPA2-PSK protocols.
+The
 .Nm
-supports software WEP.
-Wired Equivalent Privacy (WEP) is the de facto encryption standard
-for wireless networks.
-It can be typically configured in one of three modes:
-no encryption; 40-bit encryption; or 104-bit encryption.
-Unfortunately, due to serious weaknesses in WEP protocol
-it is strongly recommended that it not be used as the
-sole mechanism to secure wireless communication.
-WEP is not enabled by default.
+driver relies on the software 802.11 stack for both encryption and decryption
+of data frames.
 .Pp
 The device has one temperature sensor in degC.
 Sensor data is updated every 500 milliseconds.
@@ -102,16 +99,19 @@ channel 11, obtaining an IP address using DHCP:
 dhcp NONE NONE NONE nwkey 0x1deadbeef1 chan 11
 .Ed
 .Pp
-Configure iwn0 for WEP, using hex key
-.Dq 0x1deadbeef1 :
+Configure iwn0 to join network
+.Dq my_net
+using WPA-PSK with passphrase
+.Dq my_passphrase :
 .Bd -literal -offset indent
-# ifconfig iwn0 nwkey 0x1deadbeef1
+# _psk=$(wpa-psk my_net my_passphrase)
+# ifconfig iwn0 nwid my_net wpa wpapsk ${_psk}
 .Ed
 .Pp
 Return iwn0 to its default settings:
 .Bd -literal -offset indent
 # ifconfig iwn0 -bssid -chan media autoselect \e
-	nwid "" -nwkey
+	nwid "" -nwkey -wpa -wpapsk
 .Ed
 .Pp
 Join an existing BSS network,
@@ -151,7 +151,8 @@ The driver will reset the hardware.
 .Xr netintro 4 ,
 .Xr pci 4 ,
 .Xr hostname.if 5 ,
-.Xr ifconfig 8
+.Xr ifconfig 8 ,
+.Xr wpa-psk 8
 .Rs
 .%T The IPW Web Page
 .%O http://damien.bergamini.free.fr/ipw/