wireless_tools/iwconfig.8

   1 .\" Jean II - HPLB - 96
   2 .\" iwconfig.8
   3 .\"
   4 .TH IWCONFIG 8 "31 October 1996" "net-tools" "Linux Programmer's Manual"
   5 .\"
   6 .\" NAME part
   7 .\"
   8 .SH NAME
   9 iwconfig \- configure a wireless network interface
  10 .\"
  11 .\" SYNOPSIS part
  12 .\"
  13 .SH SYNOPSIS
  14 .BI "iwconfig [" interface ]
  15 .br
  16 .BI "iwconfig " interface " [nwid " N "] [freq " F ]
  17 .\"
  18 .\" DESCRIPTION part
  19 .\"
  20 .SH DESCRIPTION
  21 .B Iwconfig
  22 is similar to
  23 .IR ifconfig (8),
  24 but is dedicated to the wireless interfaces. It is used to set the
  25 parameters of the network interface which are specific to the wireless
  26 operation (for example : the frequency).
  27 .B Iwconfig
  28 may also be used to display those parameters, and the wireless
  29 statistics (extracted from
  30 .IR /proc/net/wireless ).
  31 .PP
  32 All these parameters and statistics are device dependant. Each driver
  33 will provide only some of them depending on the hardware support, and
  34 the range of value may change. Please refer to the man page of each
  35 device for details.
  36 .\"
  37 .\" PARAMETER part
  38 .\"
  39 .SH PARAMETERS
  40 .TP
  41 .B nwid
  42 Set the Network ID (in some products it is also called Domain). As all
  43 adjacent wireless networks share the same medium, this number is used
  44 to differenciate them (create virtual networks).
  45 .TP
  46 .BR freq / channel
  47 Set the operating frequency or channel in the device. Value below 1000
  48 are the channel number, value over this is the frequency in Hz. You
  49 may prepend the suffix k, M or G to the value (for example, "2.46G"
  50 for 2.46 GHz frequency).
  51 .\"
  52 .\" DISPLAY part
  53 .\"
  54 .SH DISPLAY
  55 For each device which support wireless extensions,
  56 .I iwconfig
  57 will display the name of the
  58 .B MAC protocol
  59 used (name of device for proprietary protocols), the
  60 .B NWID
  61 and the
  62 .B frequency
  63 (if available).
  64 .PP
  65 If
  66 .I /proc/net/wireless
  67 exists,
  68 .I iwconfig
  69 will also display its content :
  70 .TP
  71 .B Link quality
  72 Quality of the link or the modulation (how good the received signal is).
  73 .TP
  74 .B Signal level
  75 Received signal strength (how strong the received signal is).
  76 .TP
  77 .B Noise level
  78 Background noise level (when no packet is transmited).
  79 .TP
  80 .B invalid nwid
  81 Number of packets received with a different NWID. Used to detect
  82 configuration problems or adjacent network existence.
  83 .TP
  84 .B invalid crypt
  85 Number of packets that the hardware was unable to decrypt.
  86 .TP
  87 .B invalid misc
  88 Other packets lost in relation with specific wireless operations.
  89 .\"
  90 .\" AUTHOR part
  91 .\"
  92 .SH AUTHOR
  93 Jean Tourrilhes \- jt@hplb.hpl.hp.com
  94 .\"
  95 .\" FILES part
  96 .\"
  97 .SH FILES
  98 .I /proc/net/wireless
  99 .\"
 100 .\" SEE ALSO part
 101 .\"
 102 .SH SEE ALSO
 103 .BR ifconfig (8),
 104 .BR iwspy (8),
 105 .BR iwpriv (8),
 106 .BR wavelan (4),
 107 .BR wavelan_cs (4),
 108 .BR xircnw_cs (4).