From owner-freebsd-doc@FreeBSD.ORG Mon Aug 11 10:00:52 2008 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id C431B1065672 for ; Mon, 11 Aug 2008 10:00:52 +0000 (UTC) (envelope-from gkmohan@gmail.com) Received: from py-out-1112.google.com (py-out-1112.google.com [64.233.166.176]) by mx1.freebsd.org (Postfix) with ESMTP id 7B9AC8FC27 for ; Mon, 11 Aug 2008 10:00:52 +0000 (UTC) (envelope-from gkmohan@gmail.com) Received: by py-out-1112.google.com with SMTP id p76so1060058pyb.10 for ; Mon, 11 Aug 2008 03:00:51 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:received:received:message-id:date:from:to :subject:mime-version:content-type:content-transfer-encoding :content-disposition; bh=TAIlgui5VndIJiVyLco2De9UT01dpWHXuc5ZfgItlRQ=; b=JIpMERHRAwq1QTORF2+4AXIQlgeJbHcHOrCE7elRGARHyIN8i9NPFVlNAY2mq4TNvQ KzCP7WY+9SvRE6LiQPYxovMPiAkdGtQSpqfVnvC6+5K4bsoiptiy8PsWpzM/Vf5DxwEN lqH8nHHyZ8w4zyQjKC6g45hApMlZ0n3Dh/Cq4= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=message-id:date:from:to:subject:mime-version:content-type :content-transfer-encoding:content-disposition; b=QnV6pgwwefE8ZI/yGVK5L9Wd8/1GjzioGZonWGmRV3OrnqbxbmgBAgVxmv+W0xe1Aa NS3Qv3xyvrZea2RII7PHfCHZsj3mVN14e1FyIbXOfjwjiJ0pJNJfKlBUR1DWvmkuwLEU yysyCgRYINvYeD51bleDtG0lAM08xBIPBSDzs= Received: by 10.65.188.2 with SMTP id q2mr13119216qbp.11.1218447314239; Mon, 11 Aug 2008 02:35:14 -0700 (PDT) Received: by 10.65.254.17 with HTTP; Mon, 11 Aug 2008 02:35:14 -0700 (PDT) Message-ID: <70ec82800808110235g293bd777i647e13873d640f35@mail.gmail.com> Date: Mon, 11 Aug 2008 02:35:14 -0700 From: "Krishna Mohan Gundu" To: freebsd-doc@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit Content-Disposition: inline Subject: wep key index in examples of section 29.3 in handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 11 Aug 2008 10:00:52 -0000 Hi, After I put some effort into building a ndis driver for my wireless 802.11g card, I proceeded to configure the network. For me the section that seemed to be most relevant was "29.3.3.1.4 WEP". So I chose the example as a template to configure my device. In the hindsight, after spending a few hours in correctly configuring my wireless device, I realized that the document could have saved me those hours if only it had used wep key index of 1 instead 3 in the example. I would like to raise the following concerns 1) A novice would not know that WEP access points can use any of the four keys it uses for encryption and that all these keys have to be set correctly. I got to know this only after reading the wikipedia page on WEP at http://en.wikipedia.org/wiki/Wired_Equivalent_Privacy . Further that most access points only use one key and I believe the index of this key is mostly 1. This discussion could be added to some subsection. 2) The above discussion can be deemed to be too technical to be included in the document. However changing the wep key index from 3 to 1 would save many more novices like me hours of searching, reading, agony etc. The bottom line is "Is the wep key index most likely to be 1? If so the document should use that number in the examples." Please let me know if I should file a document bug about this. regards, Krishna.