Wlanconfig
From blag.wiki.aktivix.org
Contents |
WLANCONFIG
INTRO
This doc is a set of notes based on the man page of wlanconfig, the configuration tool for the MADWIFI wireless driver. wlanconfig is free software with the GPL liscence. Note that it uses a binary HAL, (Hardware Abstraction Layer), so it taints your kernel!. The FCC does not allow end users to change thier country codes so the HAL had to be shipped in binary format.
NAME
wlanconfig - Create, destroy and manipulate madwifi VAPs, (virtual access points).
SYNOPSIS
A brief list of example usage, where <vap>, the virtual acces point is typically ath0, ath1 etc.
To create a vap
wlanconfig <vap> create wlandev <base device> wlanmode <mode>
To destroy a vap
wlanconfig <vap> destroy
To list or display proporties of a vap
wlanconfig <vap> list <list item>
DESCRIPTION
Use the MadWifi driver to create, destroy and configure AP's (access points) on your network device, typically a pcmcia card. An advantage of using the MADWIFI driver is the ability to have multiple AP’s on the same devices, with each one using it's own mode.
To create a vap
wlanconfig <vap> create wlandev <base device> wlanmode <mode>
To destroy a vap
wlanconfig <vap> destroy
To list or display proporties of a vap
wlanconfig <vap> list <list item>
Every VAP has an associated underlying base device which is created when the driver is loaded.
ARGUMENTS
use a vap that is reflected by that shown by another comand such as /sbin/iwconfig. Typically shown as athX, where X=0,1,...
<vap> create [nounit] wlandev <base device> wlanmode <mode> \ [bssid|-bssid] [nosbeacon]
use this command to create a new a interface <vap> with specified <base device> and <mode>. Use the full interface name, (ath0, ath1..) or just ath and the kernel will append the next available integer to the name of the vap
To turn off the automatic integer increments use [nounit]
To remove/kill a vap use the full name of the interface
<vap> destroy
To see info of connections, keys, channels etc use
<vap> list <list item>
AVAILABLE MODES
ahdemo Create the station in ad-hoc demo (aka pseudo IBSS) mode. adhoc Create the station in ad-hoc mode. ap Create the VAP in AP mode. monitor Create the station in monitor mode. sta Create the VAP in station mode. wds Create the station in WDS mode.
OPTIONS
bssid
Create the VAP using a different MAC address from the underlying device.
<vap> destroy
To see info of connections, keys, channels etc use
<vap> list <list item>
AVAILABLE MODES
ahdemo Create the station in ad-hoc demo (aka pseudo IBSS) mode. adhoc Create the station in ad-hoc mode. ap Create the VAP in AP mode. monitor Create the station in monitor mode. sta Create the VAP in station mode. wds Create the station in WDS mode.
OPTIONS
bssid
Create the VAP using a different MAC address from the underlying device.
-bssid
Create the VAP using the MAC address of the underlying device.
nosbeacon
When both station VAPS and AP VAPs coexist, the station should be created with the nosbeacon flag set in order to disable the use of hardware beacon times for the station.
LIST ITEMS
sta or no parameters. Show information on associated stations.
scan or ap
List all visible stations.
-bssid
Create the VAP using the MAC address of the underlying device.
nosbeacon
When both station VAPS and AP VAPs coexist, the station should be created with the nosbeacon flag set in order to disable the use of hardware beacon times for the station.
LIST ITEMS
sta or no parameters. Show information on associated stations.
scan or ap
List all visible stations.
chan or freq
List all channels and frequencies.
active
List all available channels and frequencies.
keys
List all of the keys associated with the VAP
caps
List the capabilities of the given VAP.
wme
List WME (Wireless multimedia extensions, aka WMM) parameters.
EXAMPLES
wlanconfig ath create wlandev wifi0 wlanmode sta
Create a station mode VAP, using wifi0 as the underlying device. The interface wil be called athN, where N is the first free integer. The MAC address will be the same as the underlying device.
wlanconfig ath0 create wlandev wifi0 wlanmode sta
Create a station mode VAP (ath0) using wifi0 as the underlying device. The MAC address will be the same as the underlying device.
wlanconfig ath0 create wlandev wifi0 wlanmode ap wlanconfig ath1 create wlandev wifi0 wlanmode sta nosbeacon
Create both an AP and a station mode interface.
wlanconfig ath0 destroy
Destroy VAP ath0.
wlanconfig ath0 list scan
Scan for local stations and access points.
wlanconfig ath0 create wlandev wifi0 wlanmode ap wlanconfig ath1 create wlandev wifi0 wlanmode wds iwconfig ath0 essid "Normal atheros AP" channel 1 iwpriv ath1 wds_add <mac of the peer wds ap> iwpriv ath1 wds 1 ifconfig ath1 up ifconfig ath0 up brctl addbr br0 brctl addif br0 ath1
wlanconfig ath0 destroy
Destroy VAP ath0.
wlanconfig ath0 list scan
Scan for local stations and access points.
wlanconfig ath0 create wlandev wifi0 wlanmode ap wlanconfig ath1 create wlandev wifi0 wlanmode wds iwconfig ath0 essid "Normal atheros AP" channel 1 iwpriv ath1 wds_add <mac of the peer wds ap> iwpriv ath1 wds 1 ifconfig ath1 up ifconfig ath0 up brctl addbr br0 brctl addif br0 ath1 brctl addif br0 ath0 ifconfig br0 up
Create a WDS bridge. See http://madwifi.org/ for more informa- tion.
more examples
Examples of the output of various commands performed as a non-root user are shown below.
% wlanconfig ath0 list ADDR AID CHAN RATE RSSI DBM IDLE TXSEQ RXSEQ CAPS ACAPS ERP STATE MODE 00:01:f4:88:b4:56 0 116 36M 0 -95 300 0 0 0 1 Normal
(/home/jayeola/sys/notes/) % wlanconfig ath0 list active Channel 1 : 2412 Mhz 11g Channel 52 : 5260* Mhz 11a Channel 2 : 2417 Mhz 11g Channel 56 : 5280* Mhz 11a Channel 3 : 2422 Mhz 11g Channel 58 : 5290* Mhz 11a Static Channel 4 : 2427 Mhz 11g Channel 60 : 5300* Mhz 11a Channel 5 : 2432 Mhz 11g Channel 64 : 5320* Mhz 11a Channel 6 : 2437 Mhz 11g Channel 100 : 5500* Mhz 11a Channel 7 : 2442 Mhz 11g Channel 104 : 5520* Mhz 11a Channel 8 : 2447 Mhz 11g Channel 108 : 5540* Mhz 11a Channel 9 : 2452 Mhz 11g Channel 112 : 5560* Mhz 11a Channel 10 : 2457 Mhz 11g Channel 116 : 5580* Mhz 11a Channel 11 : 2462 Mhz 11g Channel 120 : 5600* Mhz 11a Channel 12 : 2467* Mhz 11g Channel 124 : 5620* Mhz 11a Channel 13 : 2472* Mhz 11g Channel 128 : 5640* Mhz 11a Channel 14 : 2484* Mhz 11b Channel 132 : 5660* Mhz 11a Channel 34 : 5170* Mhz 11a Channel 136 : 5680* Mhz 11a Channel 36 : 5180* Mhz 11a Channel 140 : 5700* Mhz 11a Channel 38 : 5190* Mhz 11a Channel 149 : 5745* Mhz 11a Channel 40 : 5200* Mhz 11a Channel 152 : 5760* Mhz 11a Static Channel 3 : 2422 Mhz 11g Channel 58 : 5290* Mhz 11a Static Channel 4 : 2427 Mhz 11g Channel 60 : 5300* Mhz 11a Channel 5 : 2432 Mhz 11g Channel 64 : 5320* Mhz 11a Channel 6 : 2437 Mhz 11g Channel 100 : 5500* Mhz 11a Channel 7 : 2442 Mhz 11g Channel 104 : 5520* Mhz 11a Channel 8 : 2447 Mhz 11g Channel 108 : 5540* Mhz 11a Channel 9 : 2452 Mhz 11g Channel 112 : 5560* Mhz 11a Channel 10 : 2457 Mhz 11g Channel 116 : 5580* Mhz 11a Channel 11 : 2462 Mhz 11g Channel 120 : 5600* Mhz 11a Channel 12 : 2467* Mhz 11g Channel 124 : 5620* Mhz 11a Channel 13 : 2472* Mhz 11g Channel 128 : 5640* Mhz 11a Channel 14 : 2484* Mhz 11b Channel 132 : 5660* Mhz 11a Channel 34 : 5170* Mhz 11a Channel 136 : 5680* Mhz 11a Channel 36 : 5180* Mhz 11a Channel 140 : 5700* Mhz 11a Channel 38 : 5190* Mhz 11a Channel 149 : 5745* Mhz 11a Channel 40 : 5200* Mhz 11a Channel 152 : 5760* Mhz 11a Static Channel 42 : 5210* Mhz 11a Static Channel 153 : 5765* Mhz 11a Channel 44 : 5220* Mhz 11a Channel 157 : 5785* Mhz 11a Channel 46 : 5230* Mhz 11a Channel 160 : 5800* Mhz 11a Static Channel 48 : 5240* Mhz 11a Channel 161 : 5805* Mhz 11a Channel 50 : 5250* Mhz 11a Static Channel 165 : 5825* Mhz 11a
(/home/jayeola/sys/notes/) % wlanconfig ath0 list ADDR AID CHAN RATE RSSI DBM IDLE TXSEQ RXSEQ CAPS ACAPS ERP STATE MODE 00:01:f4:88:b4:56 0 116 36M 0 -95 300 0 0 0 1 Normal
(/home/jayeola/sys/notes/) % wlanconfig ath0 list sta ADDR AID CHAN RATE RSSI DBM IDLE TXSEQ RXSEQ CAPS ACAPS ERP STATE MODE 00:01:f4:88:b4:56 0 116 36M 0 -95 300 0 0 0 1 Normal
(/home/jayeola/sys/notes/) % wlanconfig ath0 list ap
(/home/jayeola/sys/notes/) % wlanconfig ath0 list scan
(/home/jayeola/sys/notes/) % wlanconfig ath0 list chan Channel 1 : 2412 Mhz 11g Channel 52 : 5260* Mhz 11a Channel 2 : 2417 Mhz 11g Channel 56 : 5280* Mhz 11a Channel 3 : 2422 Mhz 11g Channel 58 : 5290* Mhz 11a Static Channel 4 : 2427 Mhz 11g Channel 60 : 5300* Mhz 11a Channel 5 : 2432 Mhz 11g Channel 64 : 5320* Mhz 11a Channel 6 : 2437 Mhz 11g Channel 100 : 5500* Mhz 11a Channel 7 : 2442 Mhz 11g Channel 104 : 5520* Mhz 11a Channel 8 : 2447 Mhz 11g Channel 108 : 5540* Mhz 11a Channel 9 : 2452 Mhz 11g Channel 112 : 5560* Mhz 11a Channel 10 : 2457 Mhz 11g Channel 116 : 5580* Mhz 11a Channel 11 : 2462 Mhz 11g Channel 120 : 5600* Mhz 11a Channel 12 : 2467* Mhz 11g Channel 124 : 5620* Mhz 11a Channel 13 : 2472* Mhz 11g Channel 128 : 5640* Mhz 11a Channel 14 : 2484* Mhz 11b Channel 132 : 5660* Mhz 11a Channel 34 : 5170* Mhz 11a Channel 136 : 5680* Mhz 11a Channel 36 : 5180* Mhz 11a Channel 140 : 5700* Mhz 11a Channel 38 : 5190* Mhz 11a Channel 149 : 5745* Mhz 11a Channel 40 : 5200* Mhz 11a Channel 152 : 5760* Mhz 11a Static Channel 42 : 5210* Mhz 11a Static Channel 153 : 5765* Mhz 11a Channel 44 : 5220* Mhz 11a Channel 157 : 5785* Mhz 11a Channel 46 : 5230* Mhz 11a Channel 160 : 5800* Mhz 11a Static Channel 48 : 5240* Mhz 11a Channel 161 : 5805* Mhz 11a
Channel 7 : 2442 Mhz 11g Channel 104 : 5520* Mhz 11a
Channel 8 : 2447 Mhz 11g Channel 108 : 5540* Mhz 11a Channel 9 : 2452 Mhz 11g Channel 112 : 5560* Mhz 11a Channel 10 : 2457 Mhz 11g Channel 116 : 5580* Mhz 11a Channel 11 : 2462 Mhz 11g Channel 120 : 5600* Mhz 11a Channel 12 : 2467* Mhz 11g Channel 124 : 5620* Mhz 11a Channel 13 : 2472* Mhz 11g Channel 128 : 5640* Mhz 11a Channel 14 : 2484* Mhz 11b Channel 132 : 5660* Mhz 11a Channel 34 : 5170* Mhz 11a Channel 136 : 5680* Mhz 11a Channel 36 : 5180* Mhz 11a Channel 140 : 5700* Mhz 11a Channel 38 : 5190* Mhz 11a Channel 149 : 5745* Mhz 11a Channel 40 : 5200* Mhz 11a Channel 152 : 5760* Mhz 11a Static Channel 42 : 5210* Mhz 11a Static Channel 153 : 5765* Mhz 11a Channel 44 : 5220* Mhz 11a Channel 157 : 5785* Mhz 11a Channel 46 : 5230* Mhz 11a Channel 160 : 5800* Mhz 11a Static Channel 48 : 5240* Mhz 11a Channel 161 : 5805* Mhz 11a Channel 50 : 5250* Mhz 11a Static Channel 165 : 5825* Mhz 11a
(/home/jayeola/sys/notes/) % wlanconfig ath0 list freq Channel 1 : 2412 Mhz 11g Channel 52 : 5260* Mhz 11a Channel 2 : 2417 Mhz 11g Channel 56 : 5280* Mhz 11a Channel 3 : 2422 Mhz 11g Channel 58 : 5290* Mhz 11a Static Channel 4 : 2427 Mhz 11g Channel 60 : 5300* Mhz 11a Channel 5 : 2432 Mhz 11g Channel 64 : 5320* Mhz 11a Channel 6 : 2437 Mhz 11g Channel 100 : 5500* Mhz 11a Channel 7 : 2442 Mhz 11g Channel 104 : 5520* Mhz 11a Channel 8 : 2447 Mhz 11g Channel 108 : 5540* Mhz 11a Channel 9 : 2452 Mhz 11g Channel 112 : 5560* Mhz 11a Channel 10 : 2457 Mhz 11g Channel 116 : 5580* Mhz 11a Channel 11 : 2462 Mhz 11g Channel 120 : 5600* Mhz 11a Channel 12 : 2467* Mhz 11g Channel 124 : 5620* Mhz 11a
Channel 50 : 5250* Mhz 11a Static Channel 165 : 5825* Mhz 11a
(/home/jayeola/sys/notes/) % wlanconfig ath0 list freq Channel 1 : 2412 Mhz 11g Channel 52 : 5260* Mhz 11a Channel 2 : 2417 Mhz 11g Channel 56 : 5280* Mhz 11a Channel 3 : 2422 Mhz 11g Channel 58 : 5290* Mhz 11a Static Channel 4 : 2427 Mhz 11g Channel 60 : 5300* Mhz 11a Channel 5 : 2432 Mhz 11g Channel 64 : 5320* Mhz 11a Channel 6 : 2437 Mhz 11g Channel 100 : 5500* Mhz 11a Channel 7 : 2442 Mhz 11g Channel 104 : 5520* Mhz 11a Channel 8 : 2447 Mhz 11g Channel 108 : 5540* Mhz 11a Channel 9 : 2452 Mhz 11g Channel 112 : 5560* Mhz 11a Channel 10 : 2457 Mhz 11g Channel 116 : 5580* Mhz 11a Channel 11 : 2462 Mhz 11g Channel 120 : 5600* Mhz 11a Channel 12 : 2467* Mhz 11g Channel 124 : 5620* Mhz 11a Channel 13 : 2472* Mhz 11g Channel 128 : 5640* Mhz 11a Channel 14 : 2484* Mhz 11b Channel 132 : 5660* Mhz 11a Channel 34 : 5170* Mhz 11a Channel 136 : 5680* Mhz 11a Channel 36 : 5180* Mhz 11a Channel 140 : 5700* Mhz 11a Channel 38 : 5190* Mhz 11a Channel 149 : 5745* Mhz 11a Channel 40 : 5200* Mhz 11a Channel 152 : 5760* Mhz 11a Static Channel 42 : 5210* Mhz 11a Static Channel 153 : 5765* Mhz 11a Channel 44 : 5220* Mhz 11a Channel 157 : 5785* Mhz 11a Channel 46 : 5230* Mhz 11a Channel 160 : 5800* Mhz 11a Static Channel 48 : 5240* Mhz 11a Channel 161 : 5805* Mhz 11a Channel 50 : 5250* Mhz 11a Static Channel 165 : 5825* Mhz 11a
(/home/jayeola/sys/notes/) % wlanconfig ath0 list active Channel 1 : 2412 Mhz 11g Channel 52 : 5260* Mhz 11a Channel 2 : 2417 Mhz 11g Channel 56 : 5280* Mhz 11a Channel 13 : 2472* Mhz 11g Channel 128 : 5640* Mhz 11a Channel 14 : 2484* Mhz 11b Channel 132 : 5660* Mhz 11a Channel 34 : 5170* Mhz 11a Channel 136 : 5680* Mhz 11a Channel 36 : 5180* Mhz 11a Channel 140 : 5700* Mhz 11a Channel 38 : 5190* Mhz 11a Channel 149 : 5745* Mhz 11a Channel 40 : 5200* Mhz 11a Channel 152 : 5760* Mhz 11a Static Channel 42 : 5210* Mhz 11a Static Channel 153 : 5765* Mhz 11a Channel 44 : 5220* Mhz 11a Channel 157 : 5785* Mhz 11a Channel 46 : 5230* Mhz 11a Channel 160 : 5800* Mhz 11a Static Channel 48 : 5240* Mhz 11a Channel 161 : 5805* Mhz 11a Channel 50 : 5250* Mhz 11a Static Channel 165 : 5825* Mhz 11a
(/home/jayeola/sys/notes/) % wlanconfig ath0 list active Channel 1 : 2412 Mhz 11g Channel 52 : 5260* Mhz 11a Channel 2 : 2417 Mhz 11g Channel 56 : 5280* Mhz 11a Channel 3 : 2422 Mhz 11g Channel 58 : 5290* Mhz 11a Static Channel 4 : 2427 Mhz 11g Channel 60 : 5300* Mhz 11a Channel 5 : 2432 Mhz 11g Channel 64 : 5320* Mhz 11a Channel 6 : 2437 Mhz 11g Channel 100 : 5500* Mhz 11a Channel 7 : 2442 Mhz 11g Channel 104 : 5520* Mhz 11a Channel 8 : 2447 Mhz 11g Channel 108 : 5540* Mhz 11a Channel 9 : 2452 Mhz 11g Channel 112 : 5560* Mhz 11a Channel 10 : 2457 Mhz 11g Channel 116 : 5580* Mhz 11a Channel 11 : 2462 Mhz 11g Channel 120 : 5600* Mhz 11a Channel 12 : 2467* Mhz 11g Channel 124 : 5620* Mhz 11a Channel 13 : 2472* Mhz 11g Channel 128 : 5640* Mhz 11a Channel 14 : 2484* Mhz 11b Channel 132 : 5660* Mhz 11a Channel 34 : 5170* Mhz 11a Channel 136 : 5680* Mhz 11a Channel 36 : 5180* Mhz 11a Channel 140 : 5700* Mhz 11a Channel 38 : 5190* Mhz 11a Channel 149 : 5745* Mhz 11a Channel 40 : 5200* Mhz 11a Channel 152 : 5760* Mhz 11a Static Channel 3 : 2422 Mhz 11g Channel 58 : 5290* Mhz 11a Static Channel 4 : 2427 Mhz 11g Channel 60 : 5300* Mhz 11a Channel 5 : 2432 Mhz 11g Channel 64 : 5320* Mhz 11a Channel 6 : 2437 Mhz 11g Channel 100 : 5500* Mhz 11a Channel 7 : 2442 Mhz 11g Channel 104 : 5520* Mhz 11a Channel 8 : 2447 Mhz 11g Channel 108 : 5540* Mhz 11a Channel 9 : 2452 Mhz 11g Channel 112 : 5560* Mhz 11a Channel 10 : 2457 Mhz 11g Channel 116 : 5580* Mhz 11a Channel 11 : 2462 Mhz 11g Channel 120 : 5600* Mhz 11a Channel 12 : 2467* Mhz 11g Channel 124 : 5620* Mhz 11a Channel 13 : 2472* Mhz 11g Channel 128 : 5640* Mhz 11a Channel 14 : 2484* Mhz 11b Channel 132 : 5660* Mhz 11a Channel 34 : 5170* Mhz 11a Channel 136 : 5680* Mhz 11a Channel 36 : 5180* Mhz 11a Channel 140 : 5700* Mhz 11a Channel 38 : 5190* Mhz 11a Channel 149 : 5745* Mhz 11a Channel 40 : 5200* Mhz 11a Channel 152 : 5760* Mhz 11a Static Channel 42 : 5210* Mhz 11a Static Channel 153 : 5765* Mhz 11a Channel 44 : 5220* Mhz 11a Channel 157 : 5785* Mhz 11a Channel 46 : 5230* Mhz 11a Channel 160 : 5800* Mhz 11a Static Channel 48 : 5240* Mhz 11a Channel 161 : 5805* Mhz 11a Channel 50 : 5250* Mhz 11a Static Channel 165 : 5825* Mhz 11a
(/home/jayeola/sys/notes/)
% wlanconfig ath0 list keys
Error reading wireless keys (SIOCGIWENCODE): Operation not permitted
ath0 3 key sizes : 40, 104, 128bits
4 keys available :
Authentication capabilities :
WPA
WPA2
CIPHER TKIP
CIPHER CCMP
Channel 42 : 5210* Mhz 11a Static Channel 153 : 5765* Mhz 11a
Channel 44 : 5220* Mhz 11a Channel 157 : 5785* Mhz 11a
Channel 46 : 5230* Mhz 11a Channel 160 : 5800* Mhz 11a Static
Channel 48 : 5240* Mhz 11a Channel 161 : 5805* Mhz 11a
Channel 50 : 5250* Mhz 11a Static Channel 165 : 5825* Mhz 11a
(/home/jayeola/sys/notes/)
% wlanconfig ath0 list keys
Error reading wireless keys (SIOCGIWENCODE): Operation not permitted
ath0 3 key sizes : 40, 104, 128bits
4 keys available :
Authentication capabilities :
WPA
WPA2
CIPHER TKIP
CIPHER CCMP
Current key_mgmt:0x3
Current cipher_pairwise:0x10
Current cipher_group:0x4
[list_keys not implemented (yet). Spawning iwlist...]
(/home/jayeola/sys/notes/) % wlanconfig ath0 list caps ath0=6783e00f<WEP,TKIP,AES,AES_CCM,TXPMGT,SHSLOT,SHPREAMBLE,MONITOR,TKIPMIC,WPA1,WPA2,BURST,WME>
(/home/jayeola/sys/notes/)
% wlanconfig ath0 list wme
AC_BE cwmin 4 cwmax 10 aifs 2 txopLimit 2048
cwmin 4 cwmax 10 aifs 2 txopLimit 2048
AC_BK cwmin 4 cwmax 10 aifs 7 txopLimit 0
ath0 3 key sizes : 40, 104, 128bits
4 keys available :
Authentication capabilities :
WPA
WPA2
CIPHER TKIP
CIPHER CCMP
Current key_mgmt:0x3
Current cipher_pairwise:0x10
Current cipher_group:0x4
[list_keys not implemented (yet). Spawning iwlist...]
(/home/jayeola/sys/notes/) % wlanconfig ath0 list caps ath0=6783e00f<WEP,TKIP,AES,AES_CCM,TXPMGT,SHSLOT,SHPREAMBLE,MONITOR,TKIPMIC,WPA1,WPA2,BURST,WME>
(/home/jayeola/sys/notes/)
% wlanconfig ath0 list wme
AC_BE cwmin 4 cwmax 10 aifs 2 txopLimit 2048
cwmin 4 cwmax 10 aifs 2 txopLimit 2048
AC_BK cwmin 4 cwmax 10 aifs 7 txopLimit 0
cwmin 4 cwmax 10 aifs 7 txopLimit 0
AC_VI cwmin 3 cwmax 4 aifs 2 txopLimit 3008
cwmin 3 cwmax 4 aifs 2 txopLimit 3008
AC_VO cwmin 2 cwmax 3 aifs 2 txopLimit 1504
cwmin 2 cwmax 3 aifs 2 txopLimit 1504
NOTES
These notes where writen by Jayeola. Refer to the real man page writen by Matt Foster.
