1*e0ca220cSdyoung.\" $NetBSD: wlanctl.8,v 1.1 2004/07/16 03:13:51 dyoung Exp $ 2*e0ca220cSdyoung.\" Copyright (c) 2004 David Young. All rights reserved. 3*e0ca220cSdyoung.\" 4*e0ca220cSdyoung.\" This code was written by David Young. 5*e0ca220cSdyoung.\" 6*e0ca220cSdyoung.\" Redistribution and use in source and binary forms, with or without 7*e0ca220cSdyoung.\" modification, are permitted provided that the following conditions 8*e0ca220cSdyoung.\" are met: 9*e0ca220cSdyoung.\" 1. Redistributions of source code must retain the above copyright 10*e0ca220cSdyoung.\" notice, this list of conditions and the following disclaimer. 11*e0ca220cSdyoung.\" 2. Redistributions in binary form must reproduce the above copyright 12*e0ca220cSdyoung.\" notice, this list of conditions and the following disclaimer in the 13*e0ca220cSdyoung.\" documentation and/or other materials provided with the distribution. 14*e0ca220cSdyoung.\" 3. The name of David Young may not be used to endorse or promote 15*e0ca220cSdyoung.\" products derived from this software without specific prior 16*e0ca220cSdyoung.\" written permission. 17*e0ca220cSdyoung.\" 18*e0ca220cSdyoung.\" THIS SOFTWARE IS PROVIDED BY DAVID YOUNG ``AS IS'' AND ANY 19*e0ca220cSdyoung.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, 20*e0ca220cSdyoung.\" THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A 21*e0ca220cSdyoung.\" PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL DAVID 22*e0ca220cSdyoung.\" YOUNG BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, 23*e0ca220cSdyoung.\" EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED 24*e0ca220cSdyoung.\" TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 25*e0ca220cSdyoung.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND 26*e0ca220cSdyoung.\" ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, 27*e0ca220cSdyoung.\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 28*e0ca220cSdyoung.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 29*e0ca220cSdyoung.\" POSSIBILITY OF SUCH DAMAGE. 30*e0ca220cSdyoung.\" 31*e0ca220cSdyoung.Dd July 15, 2004 32*e0ca220cSdyoung.Dt WLANCTL 8 33*e0ca220cSdyoung.Os 34*e0ca220cSdyoung.Sh NAME 35*e0ca220cSdyoung.Nm wlanctl 36*e0ca220cSdyoung.Nd examine IEEE 802.11 client/peer table 37*e0ca220cSdyoung.Sh SYNOPSIS 38*e0ca220cSdyoung.Nm wlanctl 39*e0ca220cSdyoung.Ar interface ... 40*e0ca220cSdyoung.Nm 41*e0ca220cSdyoung.Fl a 42*e0ca220cSdyoung.Sh DESCRIPTION 43*e0ca220cSdyoungUse the 44*e0ca220cSdyoung.Nm 45*e0ca220cSdyoungutility to print node tables from IEEE 802.11 interfaces. 46*e0ca220cSdyoungUse the 47*e0ca220cSdyoung.Fl a 48*e0ca220cSdyoungflag to print the nodes for all interfaces, or list one or more 49*e0ca220cSdyoung802.11 interfaces to select their tables for examination. For 50*e0ca220cSdyoungexample, to examine the node tables for atw0, use: 51*e0ca220cSdyoung.Pp 52*e0ca220cSdyoung.Bd -literal -offset indent -compact 53*e0ca220cSdyoungwlanctl atw0 54*e0ca220cSdyoung.Ed 55*e0ca220cSdyoung.Pp 56*e0ca220cSdyoung.Nm 57*e0ca220cSdyoungmay print this node table, for example: 58*e0ca220cSdyoung.Pp 59*e0ca220cSdyoung.Bd -literal -offset indent -compact 60*e0ca220cSdyoungatw0: mac 00:02:6f:20:f6:2e bss 02:02:6f:20:f6:2e 61*e0ca220cSdyoung node flags 0001<bss> 62*e0ca220cSdyoung ess <netbsd> 63*e0ca220cSdyoung chan 11 freq 2462MHz flags 00a0<cck,2.4GHz> 64*e0ca220cSdyoung capabilities 0022<ibss,short preamble> 65*e0ca220cSdyoung beacon-interval 100 TU tsft 18425852102545544165 us 66*e0ca220cSdyoung rates [1.0] 2.0 5.5 11.0 67*e0ca220cSdyoung assoc-id 0 assoc-failed 0 inactivity 0s 68*e0ca220cSdyoung rssi 161 txseq 10 rxseq 1420 69*e0ca220cSdyoungatw0: mac 00:02:2d:2e:3c:f4 bss 02:02:6f:20:f6:2e 70*e0ca220cSdyoung node flags 0000 71*e0ca220cSdyoung ess <netbsd> 72*e0ca220cSdyoung chan 11 freq 2462MHz flags 00a0<cck,2.4GHz> 73*e0ca220cSdyoung capabilities 0002<ibss> 74*e0ca220cSdyoung beacon-interval 100 TU tsft 18425852105450086784 us 75*e0ca220cSdyoung rates [1.0] 2.0 5.5 11.0 76*e0ca220cSdyoung assoc-id 0 assoc-failed 0 inactivity 0s 77*e0ca220cSdyoung rssi 159 txseq 2 rxseq 551 78*e0ca220cSdyoungatw0: mac 00:02:6f:20:f6:2e bss 02:02:6f:20:f6:2e 79*e0ca220cSdyoung node flags 0000 80*e0ca220cSdyoung ess <netbsd> 81*e0ca220cSdyoung chan 11 freq 2462MHz flags 00a0<cck,2.4GHz> 82*e0ca220cSdyoung capabilities 0022<ibss,short preamble> 83*e0ca220cSdyoung beacon-interval 100 TU tsft 18425852102558548069 us 84*e0ca220cSdyoung rates [1.0] 2.0 5.5 6.0 9.0 11.0 12.0 18.0 24.0 36.0 48.0 54.0 85*e0ca220cSdyoung assoc-id 0 assoc-failed 0 inactivity 145s 86*e0ca220cSdyoung rssi 163 txseq 9 rxseq 2563 87*e0ca220cSdyoung.Ed 88*e0ca220cSdyoung.Pp 89*e0ca220cSdyoungThis example is taken from a network consisting of three stations 90*e0ca220cSdyoungrunning in ad hoc mode. The key for interpreting the node print-outs 91*e0ca220cSdyoungfollows: 92*e0ca220cSdyoung 93*e0ca220cSdyoung.Bl -tag -width "do_not_adapt" -compact 94*e0ca220cSdyoung.It Fa mac 95*e0ca220cSdyoungIn the example node table, the first network node has MAC number 96*e0ca220cSdyoung00:02:6f:20:f6:2e. 97*e0ca220cSdyoung.It Fa bss 98*e0ca220cSdyoungThe first node belongs to the 802.11 network identified 99*e0ca220cSdyoungby Basic Service Set Identifier (BSSID) 02:02:6f:20:f6:2e. 100*e0ca220cSdyoung.It Fa "node flags" 101*e0ca220cSdyoungOnly one node flag, ``bss'', is presently defined. 102*e0ca220cSdyoungThe first node is distinguished from the rest by its node flags: 103*e0ca220cSdyoungflag ``bss'' indicates that the node represents the 802.11 network 104*e0ca220cSdyoungthat the interface has joined or created. 105*e0ca220cSdyoungThe MAC number for the node is the same as the MAC number for the 106*e0ca220cSdyounginterface. 107*e0ca220cSdyoung.It Fa ess 108*e0ca220cSdyoungthe name of the (Extended) Service Set 109*e0ca220cSdyoungwe have joined. 110*e0ca220cSdyoungThis is the same as the network name set by 111*e0ca220cSdyoung.Xr ifconfig 112*e0ca220cSdyoungwith the ``ssid'' option. 113*e0ca220cSdyoung.It Fa chan 114*e0ca220cSdyoung.Nm 115*e0ca220cSdyoungprints the channel number, the center frequency in megahertz, and 116*e0ca220cSdyoungthe channel flags. 117*e0ca220cSdyoungThe channel flags indicate the frequency band (``2.4GHz'' or 118*e0ca220cSdyoung``5GHz''), modulation (``cck'', ``gfsk'', ``ofdm'', ``turbo'', and 119*e0ca220cSdyoung``dynamic cck-ofdm''), and operation constraints (``passive scan''). 120*e0ca220cSdyoungCommon combinations of band and modulation are these: 121*e0ca220cSdyoung.Bl -column 2.4GHz "dynamic cck-ofdm" "1-2Mb/s frequency-hopping 802.11" 122*e0ca220cSdyoung.It Sy Band Modulation Description 123*e0ca220cSdyoung.It 2.4GHz cck 11Mb/s DSSS 802.11b 124*e0ca220cSdyoung.It 2.4GHz gfsk 1-2Mb/s FHSS 802.11 125*e0ca220cSdyoung.It 2.4GHz ofdm 54Mb/s 802.11g 126*e0ca220cSdyoung.It 2.4GHz dynamic cck-ofdm mixed 802.11b/g network 127*e0ca220cSdyoung.It 5GHz ofdm 54Mb/s 802.11a 128*e0ca220cSdyoung.It 5GHz turbo 108Mb/s 802.11a 129*e0ca220cSdyoung.El 130*e0ca220cSdyoung.It Fa capabilities 131*e0ca220cSdyoungad hoc-mode and AP-mode 802.11 stations advertise their capabilities 132*e0ca220cSdyoungin 802.11 Beacons and Probe Responses. 133*e0ca220cSdyoung.Nm 134*e0ca220cSdyoungunderstands these capability flags: 135*e0ca220cSdyoung.Bl -column "channel agility" "adapt channel to protect licensed services" 136*e0ca220cSdyoung.It Sy Flag Description 137*e0ca220cSdyoung.It ess infrastructure (access point) network 138*e0ca220cSdyoung.It ibss ad hoc network (no access point) 139*e0ca220cSdyoung.It cf pollable TBD 140*e0ca220cSdyoung.It request cf poll TBD 141*e0ca220cSdyoung.It privacy WEP encryption 142*e0ca220cSdyoung.It short preamble reduce 802.11b overhead 143*e0ca220cSdyoung.It pbcc 22Mbps ``802.11b+'' 144*e0ca220cSdyoung.It channel agility change channel for licensed services 145*e0ca220cSdyoung.It short slot-time TBD 146*e0ca220cSdyoung.It rsn TBD Real Soon Now 147*e0ca220cSdyoung.It dsss-ofdm TBD 148*e0ca220cSdyoung.El 149*e0ca220cSdyoung.It Fa beacon-interval 150*e0ca220cSdyoungIn the example, beacons are sent once every 100 Time Units. A Time 151*e0ca220cSdyoungUnit (TU) is 1024 microseconds (a ``kilo-microsecond'' or ``kus''). 152*e0ca220cSdyoungThus 100 TU is about one tenth of a second. 153*e0ca220cSdyoung.It Fa tsft 154*e0ca220cSdyoung802.11 stations keep a Time Synchronization Function Timer (TSFT) 155*e0ca220cSdyoungwhich counts up in microseconds. 156*e0ca220cSdyoungAd hoc-mode stations synchronize time with their peers. 157*e0ca220cSdyoungInfrastructure-mode stations synchronize time with their access 158*e0ca220cSdyoungpoint. 159*e0ca220cSdyoungPower-saving stations wake and sleep at intervals measured by the 160*e0ca220cSdyoungTSF Timer. 161*e0ca220cSdyoungThe TSF Timer has a role in the coalescence of 802.11 ad hoc networks 162*e0ca220cSdyoung(``IBSS merges''). 163*e0ca220cSdyoung.It Fa rates 164*e0ca220cSdyoung802.11 stations indicate the bit-rates they support, in units of 165*e0ca220cSdyoung100kb/s in 802.11 Beacons, Probe Responses, and Association Requests. 166*e0ca220cSdyoung.Nm 167*e0ca220cSdyoungprints a station's supported bit-rates in 1Mb/s units. 168*e0ca220cSdyoungA station's basic rates are flagged by an asterisk (``*''). 169*e0ca220cSdyoungThe last bit-rate at which a packet was sent to the station is 170*e0ca220cSdyoungenclosed by square brackets. 171*e0ca220cSdyoung.It Fa assoc-id 172*e0ca220cSdyoungIn an infrastructure network, the access point assigns each client 173*e0ca220cSdyoungan Association Identifier which is used to indicate traffic for 174*e0ca220cSdyoungpower-saving stations. 175*e0ca220cSdyoung.It Fa assoc-failed 176*e0ca220cSdyoungThe number of times the station tried and failed to associate 177*e0ca220cSdyoungwith its access point. Only 178*e0ca220cSdyoung.It Fa inactivity 179*e0ca220cSdyoungSeconds elapsed since a packet was last received from the station. 180*e0ca220cSdyoungWhen this value reaches net.link.ieee80211.maxinact, the station 181*e0ca220cSdyoungis eligible to be purged from the node table. See 182*e0ca220cSdyoung.Xr sysctl 8 . 183*e0ca220cSdyoung.It Fa rssi 184*e0ca220cSdyoungUnitless Received Signal Strength Indication (RSSI). 185*e0ca220cSdyoungHigher numbers indicate stronger signals. 186*e0ca220cSdyoungZero is the lowest possible RSSI. 187*e0ca220cSdyoungOn a hostap- or adhoc-mode interface, the node with 188*e0ca220cSdyoung.Fa "node flag" 189*e0ca220cSdyoung``bss'' set 190*e0ca220cSdyounguses 191*e0ca220cSdyoung.Fa rssi 192*e0ca220cSdyoungto indicate the signal strength for the last packet received from 193*e0ca220cSdyounga station that does not belong to the network. 194*e0ca220cSdyoungOn an infrastructure-mode station, the node with 195*e0ca220cSdyoung.Fa "node flag" 196*e0ca220cSdyoung``bss'' set 197*e0ca220cSdyoungindicates the strength of packets from the access point. 198*e0ca220cSdyoung.It Fa txseq 199*e0ca220cSdyoungThe next 802.11 packet sent to this station will carry this transmit 200*e0ca220cSdyoungsequence number. 201*e0ca220cSdyoungThe 802.11 MAC uses the transmit sequence number to detect duplicate 202*e0ca220cSdyoungpackets. 203*e0ca220cSdyoung.It Fa rxseq 204*e0ca220cSdyoungThe last packet received from this station carried this transmit 205*e0ca220cSdyoungsequence number. 206*e0ca220cSdyoung.El 207*e0ca220cSdyoung.Sh SEE ALSO 208*e0ca220cSdyoung.Xr sysctl 8 209*e0ca220cSdyoung.Sh AUTHOR 210*e0ca220cSdyoung.An David Young Aq dyoung@NetBSD.org 211*e0ca220cSdyoung.Sh HISTORY 212*e0ca220cSdyoung.Nm 213*e0ca220cSdyoungfirst appeared in 214*e0ca220cSdyoung.Nx 2.0 . 215