[src/netbsd-1-5]: src/usr.sbin/wiconfig Pull up rev 1.9-1.10 (approved by jhawk)

[onoe <onoe%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/066f08f47517
branches:  netbsd-1-5
changeset: 488783:066f08f47517
user:      onoe <onoe%NetBSD.org@localhost>
date:      Thu Jul 27 21:23:36 2000 +0000

description:
Pull up rev 1.9-1.10 (approved by jhawk)

1.9 by itojun
  beautify SYNOPSIS section with .Bk - .Ek pair.
  correctly describe "no option" behavior (show 802.11 setting).
  add comment about statistics update delay (-o).
  TODO: should put \n after sentences

1.10 by onoe
  Confirmed the maximum length of the key for WaveLAN Gold cards is
  13 characters, not 14.  The 13 characters (104bit) secret will be
  combined with 24-bit IV to consist the seed for 128-bit RC4.
  Though maximum 14 characters can be configured in seven 16-bit hardware
  registers, the last charactoer is apparently ignored both for encryption
  and decryption.

diffstat:

 usr.sbin/wiconfig/wiconfig.8 |  54 ++++++++++++++++++++++++++++++++++---------
 1 files changed, 42 insertions(+), 12 deletions(-)

diffs (105 lines):

diff -r 4e0fe2a00434 -r 066f08f47517 usr.sbin/wiconfig/wiconfig.8
--- a/usr.sbin/wiconfig/wiconfig.8      Thu Jul 27 16:58:40 2000 +0000
+++ b/usr.sbin/wiconfig/wiconfig.8      Thu Jul 27 21:23:36 2000 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: wiconfig.8,v 1.5.6.3 2000/07/03 22:18:17 thorpej Exp $
+.\"    $NetBSD: wiconfig.8,v 1.5.6.4 2000/07/27 21:23:36 onoe Exp $
 .\"
 .\" Copyright (c) 1997, 1998, 1999
 .\"    Bill Paul <wpaul%ctr.columbia.edu@localhost> All rights reserved.
@@ -42,25 +42,57 @@
 .Nm wiconfig
 .Ar interface
 .Op Fl o
+.Bk -words
 .Op Fl e Ar 0|1
+.Ek
+.Bk -words
 .Oo
 .Fl k Ar key
 .Op Fl v Ar 1|2|3|4
 .Oc
+.Ek
+.Bk -words
 .Op Fl t Ar tx rate
+.Ek
+.Bk -words
 .Op Fl n Ar network name
+.Ek
+.Bk -words
 .Op Fl s Ar station name
+.Ek
+.Bk -words
 .Op Fl c Ar 0|1
+.Ek
+.Bk -words
 .Op Fl q Ar SSID
+.Ek
+.Bk -words
 .Op Fl p Ar port type
+.Ek
+.Bk -words
 .Op Fl a Ar access point density
+.Ek
+.Bk -words
 .Op Fl m Ar MAC address
+.Ek
+.Bk -words
 .Op Fl d Ar max data length
+.Ek
+.Bk -words
 .Op Fl r Ar RTS threshold
+.Ek
+.Bk -words
 .Op Fl f Ar frequency
+.Ek
+.Bk -words
 .Op Fl P Ar 0|1
+.Ek
+.Bk -words
 .Op Fl S Ar max sleep duration
+.Ek
+.Bk -words
 .Op Fl T Ar 1|2|3|4
+.Ek
 .Sh DESCRIPTION
 The
 .Nm
@@ -85,17 +117,16 @@
 should be the logical interface name associated with the WaveLAN/IEEE
 device (wi0, wi1, etc...).
 .Sh OPTIONS
+With no extra options,
+.Nm
+will display the current settings of the specified WaveLAN/IEEE interface.
+.Pp
 The options are as follows:
 .Pp
 .Bl -tag -width Fl
 .It Fl o
-Display the current settings of the specified WaveLAN/IEEE interface.
-This retrieves the current card settings from the driver and prints them
-out. Using the additional
-.Fl o
-flag will cause
-.Nm
-to print out the statistics counters instead of the card settings.
+Print out the statistics counters instead of the card settings.
+Note that, however, the statictics will only be updated every 1 minutes or so.
 .It Fl e Ar 0|1
 Enable or disable WEP encryption. Permitted values are
 .Ar 0
@@ -115,10 +146,9 @@
 (i.e., "0x1234512345"). For WaveLAN Silver cards, the key is
 restricted to 40 bits, hence the key can be either a 5-character text string
 or 10 hexadecimal digits. For WaveLAN Gold cards, the key can be up to
-112 bits, which means the key can be specified as either a 14-character
-text string or 28 hexadecimal digits.  (The card claims to be 128-bit RC4,
-but you can only send 112 bits to the driver.  Strange, I wonder where the
-other 16 bits come from, and what they are.)
+104 bits, which means the key can be specified as either a 13-character
+text string or 26 hexadecimal digits.  The key will be combined with the
+24-bit IV to consist the seed for RC4 in either case.
 .It Fl T Ar 1|2|3|4
 Specify which of the four WEP encryption keys will be used to encrypt
 transmitted packets.