From toor@itga.com.au  Sun Jul 21 22:23:49 2002
Return-Path: <toor@itga.com.au>
Received: from mx1.FreeBSD.org (mx1.FreeBSD.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id C8FAD37B400
	for <FreeBSD-gnats-submit@freebsd.org>; Sun, 21 Jul 2002 22:23:49 -0700 (PDT)
Received: from ns.itga.com.au (ns.itga.com.au [202.53.40.210])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 600CC43E4A
	for <FreeBSD-gnats-submit@freebsd.org>; Sun, 21 Jul 2002 22:23:48 -0700 (PDT)
	(envelope-from toor@itga.com.au)
Received: from lightning.itga.com.au (lightning.itga.com.au [192.168.71.20])
	by ns.itga.com.au (8.9.3/8.9.3) with ESMTP id PAA09388
	for <FreeBSD-gnats-submit@freebsd.org>; Mon, 22 Jul 2002 15:23:46 +1000 (EST)
	(envelope-from toor@itga.com.au)
Received: from grollo.itga.com.au (grollo.itga.com.au [192.168.71.140])
	by lightning.itga.com.au (8.9.3/8.9.3) with ESMTP id PAA05085;
	Mon, 22 Jul 2002 15:23:46 +1000 (EST)
Received: from grollo.itga.com.au (localhost [127.0.0.1])
	by grollo.itga.com.au (8.12.5/8.11.6) with ESMTP id g6M5Nk0C053784
	for <FreeBSD-gnats-submit@freebsd.org>; Mon, 22 Jul 2002 15:23:46 +1000 (EST)
	(envelope-from toor@grollo.itga.com.au)
Received: (from root@localhost)
	by grollo.itga.com.au (8.12.5/8.12.3/Submit) id g6M5NjCu053783;
	Mon, 22 Jul 2002 15:23:45 +1000 (EST)
Message-Id: <200207220523.g6M5NjCu053783@grollo.itga.com.au>
Date: Mon, 22 Jul 2002 15:23:45 +1000 (EST)
From: Gregory Bond <gnb@itga.com.au>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: [PATCH] document potential WEP text key incompatabilities
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         40872
>Category:       docs
>Synopsis:       [PATCH] document potential WEP text key incompatabilities
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    imp
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Sun Jul 21 22:30:01 PDT 2002
>Closed-Date:    Tue Oct 01 17:13:47 PDT 2002
>Last-Modified:  Tue Oct 01 17:13:47 PDT 2002
>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:
State-Changed-From-To: open->closed 
State-Changed-By: dd 
State-Changed-When: Tue Oct 1 17:12:54 PDT 2002 
State-Changed-Why:  
imp committed this on 2002/08/12, but he apparently forgot to close 
the PR. 


Responsible-Changed-From-To: freebsd-doc->imp 
Responsible-Changed-By: dd 
Responsible-Changed-When: Tue Oct 1 17:12:54 PDT 2002 
Responsible-Changed-Why:  
JFYI 

http://www.freebsd.org/cgi/query-pr.cgi?pr=40872 
>Unformatted:
