summaryrefslogtreecommitdiff
path: root/share/man/man4/rum.4
diff options
context:
space:
mode:
authorDamien Bergamini <damien@cvs.openbsd.org>2008-07-28 20:10:29 +0000
committerDamien Bergamini <damien@cvs.openbsd.org>2008-07-28 20:10:29 +0000
commit5fca48e0f668901fe0bc1ce2da18122119e3fa99 (patch)
tree0604cfb53a866aca5cee76a8208664eddc011130 /share/man/man4/rum.4
parent6fad5bb8bd2db82610debe7ef7321f529442c9bb (diff)
document WPA-PSK support.
"i would really appreciate just something going in" jmc@
Diffstat (limited to 'share/man/man4/rum.4')
-rw-r--r--share/man/man4/rum.433
1 files changed, 17 insertions, 16 deletions
diff --git a/share/man/man4/rum.4 b/share/man/man4/rum.4
index 6b3d91ee445..26e21c677a5 100644
--- a/share/man/man4/rum.4
+++ b/share/man/man4/rum.4
@@ -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/