Skip site navigation (1)Skip section navigation (2)
Date:      Mon, 22 Jul 2002 15:23:45 +1000 (EST)
From:      Gregory Bond <gnb@itga.com.au>
To:        FreeBSD-gnats-submit@FreeBSD.org
Subject:   docs/40872: [PATCH] document potential WEP text key incompatabilities
Message-ID:  <200207220523.g6M5NjCu053783@grollo.itga.com.au>

next in thread | raw e-mail | index | archive | help

>Number:         40872
>Category:       docs
>Synopsis:       [PATCH] document potential WEP text key incompatabilities
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Sun Jul 21 22:30:01 PDT 2002
>Closed-Date:
>Last-Modified:
>Originator:     Gregory Bond
>Release:        FreeBSD 4.6-STABLE i386
>Organization:
ITG Australia Ltd
>Environment:
System: FreeBSD grollo.itga.com.au 4.6-STABLE FreeBSD 4.6-STABLE #4: Mon Jul 1 10:48:12 EST 2002 aaw@grollo.itga.com.au:/usr/obj/usr/src/sys/GROLLO i386


wicontrol and ifconfig man pages.

>Description:

The setting of WEP keys from text passphrases is driver specific
and is unlikely to interoperate with other drivers.  Setting WEP keys from
a hex string is guaranteed to interoperate with all drivers.

This should be noted in wicontrol(8) and ifconfig(8).

>How-To-Repeat:

wicontrol -k 'hello'
Set the passphrase on a Windows driver to the same thing.
Note the failure to communicate.

Read ifconfig(8) and wicontrol(8) and notice the lack of warning!

>Fix:

--- diffs begins here ---
Index: sbin/ifconfig/ifconfig.8
===================================================================
RCS file: /usr/ncvs/src/sbin/ifconfig/ifconfig.8,v
retrieving revision 1.27.2.19
diff -u -r1.27.2.19 ifconfig.8
--- sbin/ifconfig/ifconfig.8	14 May 2002 17:42:38 -0000	1.27.2.19
+++ sbin/ifconfig/ifconfig.8	22 Jul 2002 05:15:41 -0000
@@ -590,6 +590,9 @@
 It may be specified either as a plain
 string or as a string of hexadecimal digits proceeded by
 .Ql 0x .
+For maximum portability, hex keys are recommended;
+the mapping of text keys to WEP encryption is usually driver-specific.   
+In particular, the Windows drivers do this mapping differently to FreeBSD.
 A key may be cleared by setting it to
 .Ql - .
 If WEP is supported then there are at least four keys.
Index: usr.sbin/wicontrol/wicontrol.8
===================================================================
RCS file: /usr/ncvs/src/usr.sbin/wicontrol/wicontrol.8,v
retrieving revision 1.14.2.9
diff -u -r1.14.2.9 wicontrol.8
--- usr.sbin/wicontrol/wicontrol.8	5 Jun 2002 20:26:10 -0000	1.14.2.9
+++ usr.sbin/wicontrol/wicontrol.8	22 Jul 2002 05:14:03 -0000
@@ -274,6 +274,9 @@
 .Dq Li hello )
 or a series of hexadecimal digits (i.e.\&
 .Dq Li 0x1234512345 ) .
+For maximum portability, hex keys are recommended;
+the mapping of text keys to WEP encryption is usually driver-specific.
+In particular, the Windows drivers do this mapping differently to FreeBSD.
 For
 WaveLAN Turbo Silver cards, the key is restricted to 40 bits, hence
 the key can be either a 5 character text string or 10 hex digits.
--- diffs ends here ---


>Release-Note:
>Audit-Trail:
>Unformatted:

To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message




Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200207220523.g6M5NjCu053783>