usr.sbin/wlconfig/wlconfig.8

   1 .Dd December 26 1996
   2 .Os
   3 .Dt WLCONFIG 8
   4 .Sh NAME
   5 .Nm wlconfig
   6 .Nd read/write wavelan config parameters
   7 .Sh SYNOPSIS
   8 .Nm wlconfig
   9 .Ar ifname
  10 .Op Ar param value ...
  11 .Sh DESCRIPTION
  12 The
  13 .Nm wlconfig
  14 command can be used to read and set parameters for the NCR/AT&T Wavelan
  15 radio LAN card.  Various parameters stored in the nonvolatile Parameter
  16 Storage Area (PSA) on the card can be modified with this program, which
  17 obviates the need for the DOS-based
  18 .Nm instconf.exe
  19 program.
  20 .Pp
  21 The
  22 .Ar ifname
  23 parameter specifies the wavelan interface name (eg.
  24 .Pa wl0
  25 ).  If no other arguments are supplied, the current contents of the PSA
  26 are interpreted and displayed.
  27 .Pp
  28 The
  29 .Ar param
  30 and
  31 .Ar value
  32 arguments can be used to change the value of several of the parameters.
  33 Any number of
  34 .Ar param value
  35 pairs may be supplied.
  36 .Bl -tag -width 15n -compat -offset indent
  37 .It Va param
  38 .Va value
  39 .It irq
  40 IRQ value (used at next reset), may be one of 3,4,5,6,10,11,12,15
  41 .It mac
  42 Local MAC value (ethernet address)
  43 .It macsel
  44 .Sq soft
  45 (as set by the
  46 .Sq mac
  47 parameter) or
  48 .Sq default
  49 (as set at the factory).
  50 .It nwid
  51 The NWID is a 2-byte parameter passed to the card's radio modem.
  52 NWIDs allow multiple logically discrete networks to operate
  53 independantly whilse occupying the same airspace.
  54 Packets with a different NWID are simply ignored by the modem.
  55 In the hardware, NWIDs are stored long-term in non-volative memory
  56 (called the PSA or programmable storage area), and are loaded by
  57 software into the radio modem when the driver is
  58 initialized.  This sets the default NWID loaded at startup.
  59 .It curnwid
  60 This sets the current operating NWID (but does not save it to the
  61 PSA).
  62 .El
  63 .Pp
  64 Note that if the IRQ on the Wavelan card is incorrect, the interface
  65 will be configured, but will not function.  The
  66 .Nm wlconfig
  67 program should then be used to reconfigure the card to a sensible
  68 value.
  69 .Sh EXAMPLES
  70 Set the NWID to 0x1234 :
  71 .Bd -literal -offset
  72 # wlconfig wl0 nwid 0x1234
  73 .Ed
  74 .Pp
  75 Show the current settings :
  76 .Bd -literal -offset
  77 # wlconfig wl0
  78 Board type            : ISA
  79 Base address options  : 0x300, 0x390, 0x3c0, 0x3e0
  80 Waitstates            : 0
  81 Bus mode              : ISA
  82 IRQ                   : 10
  83 Default MAC address   : 08:00:0e:20:3d:4b
  84 Soft MAC address      : 00:00:00:00:00:00
  85 Current MAC address   : Default
  86 Adapter compatability : PC-AT 2.4GHz
  87 Threshold preset      : 1
  88 Call code required    : NO
  89 Subband               : 2425MHz
  90 Quality threshold     : 3
  91 Hardware version      : 0 (Rel1/Rel2)
  92 Network ID enable     : YES
  93 NWID                  : 0xdead
  94 Datalink security     : NO
  95 Databus width         : 16 (variable)
  96 Configuration state   : unconfigured
  97 CRC-16                : 0x3c26
  98 CRC status            : OK
  99 .Ed
 100 .Sh HISTORY
 101 This implementation of the
 102 .Nm wlconfig
 103 command is completely new, written for Hilink Internet by Michael Smith.