document WPA-PSK support.
authordamien <damien@openbsd.org>
Mon, 28 Jul 2008 20:10:28 +0000 (20:10 +0000)
committerdamien <damien@openbsd.org>
Mon, 28 Jul 2008 20:10:28 +0000 (20:10 +0000)
"i would really appreciate just something going in" jmc@

share/man/man4/bwi.4
share/man/man4/iwn.4
share/man/man4/malo.4
share/man/man4/ral.4
share/man/man4/rum.4
share/man/man4/upgt.4
share/man/man4/ural.4
share/man/man4/wpi.4
share/man/man4/zyd.4

index e1d9f24..2936a6f 100644 (file)
@@ -1,4 +1,4 @@
-.\" $OpenBSD: bwi.4,v 1.19 2008/04/17 14:01:22 jmc Exp $
+.\" $OpenBSD: bwi.4,v 1.20 2008/07/28 20:10:28 damien Exp $
 .\"
 .\" Copyright (c) 2007 Marcus Glocker <mglocker@openbsd.org>
 .\"
@@ -14,7 +14,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 BWI 4
 .Sh NAME
@@ -59,17 +59,14 @@ capture packets from networks which it wouldn't normally have access to,
 or to scan for access points.
 .El
 .Pp
-.\" .Nm
-.\" supports hardware 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.
-.\" .Pp
+The
+.Nm
+driver can be configured to use the WEP, WPA-PSK and WPA2-PSK protocols.
+The
+.Nm
+driver relies on the software 802.11 stack for both encryption and decryption
+of data frames.
+.Pp
 The transmit speed is user-selectable or can be adapted automatically by the
 driver depending on the received signal strength and on the number of hardware
 transmission retries.
@@ -138,16 +135,19 @@ dhcp NONE NONE NONE nwkey 0x1deadbeef1 chan 11
 .\"    mediaopt hostap nwid my_net chan 11
 .Ed
 .Pp
-Configure bwi0 for WEP, using hex key
-.Dq 0x1deadbeef1 :
+Configure bwi0 to join network
+.Dq my_net
+using WPA-PSK with passphrase
+.Dq my_passphrase :
 .Bd -literal -offset indent
-# ifconfig bwi0 nwkey 0x1deadbeef1
+# _psk=$(wpa-psk my_net my_passphrase)
+# ifconfig bwi0 nwid my_net wpa wpapsk ${_psk}
 .Ed
 .Pp
 Return bwi0 to its default settings:
 .Bd -literal -offset indent
 # ifconfig bwi0 -bssid -chan media autoselect \e
-       nwid "" -nwkey
+       nwid "" -nwkey -wpa -wpapsk
 .Ed
 .Pp
 Join an existing BSS network,
@@ -164,7 +164,8 @@ Join an existing BSS network,
 .Xr pci 4 ,
 .Xr hostname.if 5 ,
 .\".Xr hostapd 8 ,
-.Xr ifconfig 8
+.Xr ifconfig 8 ,
+.Xr wpa-psk 8
 .Sh HISTORY
 The
 .Nm
index e2773dc..cdbe8ee 100644 (file)
@@ -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/
index 584969a..c61b6d2 100644 (file)
@@ -1,4 +1,4 @@
-.\"    $OpenBSD: malo.4,v 1.26 2008/07/27 13:02:38 mglocker Exp $
+.\"    $OpenBSD: malo.4,v 1.27 2008/07/28 20:10:28 damien Exp $
 .\"
 .\" Copyright (c) 2006 Theo de Raadt.
 .\"
@@ -26,7 +26,7 @@
 .\" OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd $Mdocdate: July 27 2008 $
+.Dd $Mdocdate: July 28 2008 $
 .Os
 .Dt MALO 4
 .Sh NAME
@@ -73,16 +73,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
 .Nm
@@ -148,16 +145,19 @@ dhcp NONE NONE NONE nwkey 0x1deadbeef1 chan 11
 .\"    mediaopt hostap nwid my_net chan 11
 .\".Ed
 .\".Pp
-Configure malo0 for WEP, using hex key
-.Dq 0x1deadbeef1 :
+Configure malo0 to join network
+.Dq my_net
+using WPA-PSK with passphrase
+.Dq my_passphrase :
 .Bd -literal -offset indent
-# ifconfig malo0 nwkey 0x1deadbeef1
+# _psk=$(wpa-psk my_net my_passphrase)
+# ifconfig malo0 nwid my_net wpa wpapsk ${_psk}
 .Ed
 .Pp
 Return malo0 to its default settings:
 .Bd -literal -offset indent
 # ifconfig malo0 -bssid -chan media autoselect \e
-       nwid "" -nwkey
+       nwid "" -nwkey -wpa -wpapsk
 .Ed
 .Pp
 Join an existing BSS network,
@@ -174,7 +174,8 @@ Join an existing BSS network,
 .Xr pci 4 ,
 .Xr hostname.if 5 ,
 .Xr hostapd 8 ,
-.Xr ifconfig 8
+.Xr ifconfig 8 ,
+.Xr wpa-psk 8
 .Sh HISTORY
 The
 .Nm
index 234b68a..ed4511e 100644 (file)
@@ -1,4 +1,4 @@
-.\" $OpenBSD: ral.4,v 1.85 2008/07/26 01:12:58 jmc Exp $
+.\" $OpenBSD: ral.4,v 1.86 2008/07/28 20:10:28 damien Exp $
 .\"
 .\" Copyright (c) 2005-2008
 .\"    Damien Bergamini <damien.bergamini@free.fr>
@@ -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: July 26 2008 $
+.Dd $Mdocdate: July 28 2008 $
 .Os
 .Dt RAL 4
 .Sh NAME
@@ -278,14 +278,14 @@ Configure ral0 to join network
 using WPA-PSK with passphrase
 .Dq my_passphrase :
 .Bd -literal -offset indent
-# PSK=$(wpa-psk my_net my_passphrase)
-# ifconfig ral0 nwid my_net wpa wpapsk $PSK
+# _psk=$(wpa-psk my_net my_passphrase)
+# ifconfig ral0 nwid my_net wpa wpapsk ${_psk}
 .Ed
 .Pp
 Return ral0 to its default settings:
 .Bd -literal -offset indent
 # ifconfig ral0 -bssid -chan media autoselect \e
-       nwid "" -nwkey -wpa
+       nwid "" -nwkey -wpa -wpapsk
 .Ed
 .Pp
 Join an existing BSS network,
index 6b3d91e..26e21c6 100644 (file)
@@ -1,4 +1,4 @@
-.\" $OpenBSD: rum.4,v 1.37 2008/06/29 07:31:53 jmc Exp $
+.\" $OpenBSD: rum.4,v 1.38 2008/07/28 20:10:28 damien Exp $
 .\"
 .\" Copyright (c) 2005-2007
 .\"    Damien Bergamini <damien.bergamini@free.fr>
@@ -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: June 29 2008 $
+.Dd $Mdocdate: July 28 2008 $
 .Os
 .Dt RUM 4
 .Sh NAME
@@ -75,16 +75,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
 .Nm
@@ -159,16 +156,19 @@ inet 192.168.1.1 255.255.255.0 NONE media autoselect \e
        mediaopt hostap nwid my_net chan 11
 .Ed
 .Pp
-Configure rum0 for WEP, using hex key
-.Dq 0x1deadbeef1 :
+Configure rum0 to join network
+.Dq my_net
+using WPA-PSK with passphrase
+.Dq my_passphrase :
 .Bd -literal -offset indent
-# ifconfig rum0 nwkey 0x1deadbeef1
+# _psk=$(wpa-psk my_net my_passphrase)
+# ifconfig rum0 nwid my_net wpa wpapsk ${_psk}
 .Ed
 .Pp
 Return rum0 to its default settings:
 .Bd -literal -offset indent
 # ifconfig rum0 -bssid -chan media autoselect \e
-       nwid "" -nwkey
+       nwid "" -nwkey -wpa -wpapsk
 .Ed
 .Pp
 Join an existing BSS network,
@@ -198,7 +198,8 @@ This should not happen.
 .Xr usb 4 ,
 .Xr hostname.if 5 ,
 .Xr hostapd 8 ,
-.Xr ifconfig 8
+.Xr ifconfig 8 ,
+.Xr wpa-psk 8
 .Pp
 Ralink Technology:
 .Pa http://www.ralinktech.com/
index 04c6dde..ca2e3c7 100644 (file)
@@ -1,4 +1,4 @@
-.\" $OpenBSD: upgt.4,v 1.6 2008/04/17 14:01:22 jmc Exp $
+.\" $OpenBSD: upgt.4,v 1.7 2008/07/28 20:10:28 damien Exp $
 .\"
 .\" Copyright (c) 2007 Marcus Glocker <mglocker@openbsd.org>
 .\" Copyright (c) 2005-2007
@@ -48,7 +48,7 @@
 .\" OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd $Mdocdate: April 17 2008 $
+.Dd $Mdocdate: July 28 2008 $
 .Os
 .Dt UPGT 4
 .Sh NAME
@@ -93,20 +93,13 @@ capture packets from networks which it wouldn't normally have access to,
 or to scan for access points.
 .El
 .Pp
+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.
-.\".Pp
-.\"The transmit speed is user-selectable or can be adapted automatically by the
-.\"driver depending on the received signal strength and on the number of hardware
-.\"transmission retries.
+driver can be configured to use the WEP, WPA-PSK and WPA2-PSK protocols.
+The
+.Nm
+driver relies on the software 802.11 stack for both encryption and decryption
+of data frames.
 .Pp
 The
 .Nm
@@ -170,16 +163,19 @@ dhcp NONE NONE NONE nwkey 0x1deadbeef1 chan 11
 .\"    mediaopt hostap nwid my_net chan 11
 .Ed
 .Pp
-Configure upgt0 for WEP, using hex key
-.Dq 0x1deadbeef1 :
+Configure upgt0 to join network
+.Dq my_net
+using WPA-PSK with passphrase
+.Dq my_passphrase :
 .Bd -literal -offset indent
-# ifconfig upgt0 nwkey 0x1deadbeef1
+# _psk=$(wpa-psk my_net my_passphrase)
+# ifconfig upgt0 nwid my_net wpa wpapsk ${_psk}
 .Ed
 .Pp
 Return upgt0 to its default settings:
 .Bd -literal -offset indent
 # ifconfig upgt0 -bssid -chan media autoselect \e
-       nwid "" -nwkey
+       nwid "" -nwkey -wpa -wpapsk
 .Ed
 .Pp
 Join an existing BSS network,
@@ -195,7 +191,8 @@ Join an existing BSS network,
 .Xr usb 4 ,
 .Xr hostname.if 5 ,
 .\".Xr hostapd 8 ,
-.Xr ifconfig 8
+.Xr ifconfig 8 ,
+.Xr wpa-psk 8
 .Sh HISTORY
 The
 .Nm
index 8977574..1afd882 100644 (file)
@@ -1,4 +1,4 @@
-.\" $OpenBSD: ural.4,v 1.5 2008/04/17 14:01:22 jmc Exp $
+.\" $OpenBSD: ural.4,v 1.6 2008/07/28 20:10:28 damien Exp $
 .\"
 .\" Copyright (c) 2005-2007
 .\"    Damien Bergamini <damien.bergamini@free.fr>
@@ -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 URAL 4
 .Sh NAME
@@ -63,16 +63,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 transmit speed is user-selectable or can be adapted automatically by the
 driver depending on the number of hardware transmission retries.
@@ -142,16 +139,19 @@ inet 192.168.1.1 255.255.255.0 NONE media autoselect \e
        mediaopt hostap nwid my_net chan 11
 .Ed
 .Pp
-Configure ural0 for WEP, using hex key
-.Dq 0x1deadbeef1 :
+Configure ural0 to join network
+.Dq my_net
+using WPA-PSK with passphrase
+.Dq my_passphrase :
 .Bd -literal -offset indent
-# ifconfig ural0 nwkey 0x1deadbeef1
+# _psk=$(wpa-psk my_net my_passphrase)
+# ifconfig ural0 nwid my_net wpa wpapsk ${_psk}
 .Ed
 .Pp
 Return ural0 to its default settings:
 .Bd -literal -offset indent
 # ifconfig ural0 -bssid -chan media autoselect \e
-       nwid "" -nwkey
+       nwid "" -nwkey -wpa -wpapsk
 .Ed
 .Pp
 Join an existing BSS network,
@@ -174,7 +174,8 @@ This should not happen.
 .Xr usb 4 ,
 .Xr hostname.if 5 ,
 .Xr hostapd 8 ,
-.Xr ifconfig 8
+.Xr ifconfig 8 ,
+.Xr wpa-psk 8
 .Pp
 Ralink Technology:
 .Pa http://www.ralinktech.com/
index 29742e2..4e5e174 100644 (file)
@@ -1,4 +1,4 @@
-.\" $OpenBSD: wpi.4,v 1.17 2008/04/17 14:01:22 jmc Exp $
+.\" $OpenBSD: wpi.4,v 1.18 2008/07/28 20:10:28 damien Exp $
 .\"
 .\" Copyright (c) 2006, 2007
 .\"    Damien Bergamini <damien.bergamini@free.fr>. All rights reserved.
@@ -25,7 +25,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd $Mdocdate: April 17 2008 $
+.Dd $Mdocdate: July 28 2008 $
 .Os
 .Dt WPI 4
 .Sh NAME
@@ -58,16 +58,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.
 Its value is in the range from 0 (coolest) to 285 (warmest).
@@ -113,16 +110,19 @@ channel 11, obtaining an IP address using DHCP:
 dhcp NONE NONE NONE nwkey 0x1deadbeef1 chan 11
 .Ed
 .Pp
-Configure wpi0 for WEP, using hex key
-.Dq 0x1deadbeef1 :
+Configure wpi0 to join network
+.Dq my_net
+using WPA-PSK with passphrase
+.Dq my_passphrase :
 .Bd -literal -offset indent
-# ifconfig wpi0 nwkey 0x1deadbeef1
+# _psk=$(wpa-psk my_net my_passphrase)
+# ifconfig wpi0 nwid my_net wpa wpapsk ${_psk}
 .Ed
 .Pp
 Return wpi0 to its default settings:
 .Bd -literal -offset indent
 # ifconfig wpi0 -bssid -chan media autoselect \e
-       nwid "" -nwkey
+       nwid "" -nwkey -wpa -wpapsk
 .Ed
 .Pp
 Join an existing BSS network,
@@ -162,7 +162,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/
index 15d0d8b..eb557b6 100644 (file)
@@ -1,4 +1,4 @@
-.\" $OpenBSD: zyd.4,v 1.28 2008/05/27 00:11:11 jsg Exp $
+.\" $OpenBSD: zyd.4,v 1.29 2008/07/28 20:10:28 damien Exp $
 .\"
 .\" Copyright (c) 1997, 1998, 1999
 .\" Bill Paul <wpaul@ctr.columbia.edu>. All rights reserved.
@@ -30,7 +30,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
 .\" THE POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd $Mdocdate: May 27 2008 $
+.Dd $Mdocdate: July 28 2008 $
 .Dt ZYD 4
 .Os
 .Sh NAME
@@ -62,16 +62,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
 .Nm
@@ -148,16 +145,19 @@ channel 11, obtaining an IP address using DHCP:
 dhcp NONE NONE NONE nwkey 0x1deadbeef1 chan 11
 .Ed
 .Pp
-Configure zyd0 for WEP, using hex key
-.Dq 0x1deadbeef1 :
+Configure zyd0 to join network
+.Dq my_net
+using WPA-PSK with passphrase
+.Dq my_passphrase :
 .Bd -literal -offset indent
-# ifconfig zyd0 nwkey 0x1deadbeef1
+# _psk=$(wpa-psk my_net my_passphrase)
+# ifconfig zyd0 nwid my_net wpa wpapsk ${_psk}
 .Ed
 .Pp
 Return zyd0 to its default settings:
 .Bd -literal -offset indent
 # ifconfig zyd0 -bssid -chan media autoselect \e
-       nwid "" -nwkey
+       nwid "" -nwkey -wpa -wpapsk
 .Ed
 .Pp
 Join an existing BSS network,
@@ -194,7 +194,8 @@ This should not happen.
 .Xr netintro 4 ,
 .Xr usb 4 ,
 .Xr hostname.if 5 ,
-.Xr ifconfig 8
+.Xr ifconfig 8 ,
+.Xr wpa-psk 8
 .Sh AUTHORS
 .An -nosplit
 The