From toor@itga.com.au Sun Jul 21 22:23:49 2002 Return-Path: Received: from mx1.FreeBSD.org (mx1.FreeBSD.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id C8FAD37B400 for ; 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 ; 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 ; 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 ; 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 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: