mirror of
https://github.com/proski/madwifi
synced 2024-11-22 14:31:22 +03:00
80c58504d7
The need to use software instead of hardware for beacon timers in AP+STA mode (aka nosbeacon) is now just determined in software, as we always knew whether or not to enable this. The confusing bssid and -bssid parameters are now deprecated. The "uniquebssid" flag is equivalent to "bssid" and can be used to force IEEE80211_CLONE_BSSID flag. If this is not specified, then the BSSID used will be the next unused BSSID in the sequence, which could very well be the parent device's MAC address. "uniquebssid" equates directly to IEEE80211_CLONE_BSSID" flag therefore. git-svn-id: http://madwifi-project.org/svn/madwifi/trunk@3476 0192ed92-7a03-0410-a25b-9323aeb14dbd
135 lines
3.8 KiB
Groff
135 lines
3.8 KiB
Groff
.TH "WLANCONFIG" "8" "October 2005"
|
|
.SH "NAME"
|
|
\fBwlanconfig\fP \- Create, destroy and manipulate madwifi VAPs
|
|
.SH "SYNOPSIS"
|
|
\fBwlanconfig <vap> create wlandev <base device> wlanmode <mode>
|
|
.TP
|
|
\fBwlanconfig <vap> destroy
|
|
.TP
|
|
\fBwlanconfig <vap> list <list item>
|
|
.SH "DESCRIPTION"
|
|
The current MadWifi driver supports multiple APs and concurrent AP/Station
|
|
mode operation on the same device. The devices are restricted to using the
|
|
same underlying hardware, thus are limited to coexisting on the same channel
|
|
and using the same physical layer features. Each instance of an AP or station
|
|
is called a Virtual AP (or VAP). Each VAP can be in either AP mode, Station
|
|
Mode, "special" station mode, and Monitor mode. Every VAP has an associated
|
|
underlying base device which is created when the driver is loaded.
|
|
.PP
|
|
.SH "ARGUMENTS"
|
|
.TP
|
|
.B <vap> create [nounit] wlandev <base device> wlanmode <mode> [uniquebssid]
|
|
Create the interface <vap> using the specified <base device> and <mode>. <vap> can either be a full interface name (e.g. 'ath0'), or just the suffix (e.g. 'ath'), in which case, the kernel will automatically append the next vacant integer. [nounit] will turn off the automatic integer increments.
|
|
.TP
|
|
.B <vap> destroy
|
|
Removes the given VAP interface. You must specify the full interface name. I.e 'ath0' rather than just 'ath'.
|
|
.TP
|
|
.B <vap> list <list item>
|
|
Show information about connected peers, keys, channels etc.
|
|
.PP
|
|
.SH "AVAILABLE MODES"
|
|
.TP
|
|
.B ahdemo
|
|
Create the station in ad-hoc demo (aka pseudo IBSS) mode.
|
|
.TP
|
|
.B adhoc
|
|
Create the station in ad-hoc mode.
|
|
.TP
|
|
.B ap
|
|
Create the VAP in AP mode.
|
|
.TP
|
|
.B monitor
|
|
Create the station in monitor mode.
|
|
.TP
|
|
.B sta
|
|
Create the VAP in station mode.
|
|
.TP
|
|
.B wds
|
|
Create the station in WDS mode.
|
|
.PP
|
|
.SH "OPTIONS"
|
|
.TP
|
|
.B uniquebssid
|
|
Create the VAP using a new unique MAC address, different from the underlying device.
|
|
.TP
|
|
.B bssid
|
|
Synonym for uniquebssid, for backward compatibility.
|
|
.TP
|
|
.B \-bssid
|
|
Ignored for backward compatibility.
|
|
.TP
|
|
.B nosbeacon
|
|
Ignored for backward compatibility.
|
|
.PP
|
|
.SH "LIST ITEMS"
|
|
.TP
|
|
.B sta or no parameters.
|
|
Show information on associated stations.
|
|
.TP
|
|
.B scan or ap
|
|
List all visible stations.
|
|
.TP
|
|
.B chan or freq
|
|
List all channels and frequencies.
|
|
.TP
|
|
.B active
|
|
List all available channels and frequencies.
|
|
.TP
|
|
.B keys
|
|
List all of the keys associated with the VAP
|
|
.TP
|
|
.B caps
|
|
List the capabilities of the given VAP.
|
|
.TP
|
|
.B wme
|
|
List WME (Wireless multimedia extensions, aka WMM) parameters.
|
|
.PP
|
|
.SH "EXAMPLES"
|
|
.TP
|
|
\fBwlanconfig 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.
|
|
.TP
|
|
\fBwlanconfig 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.
|
|
.TP
|
|
\fBwlanconfig ath0 create wlandev wifi0 wlanmode ap
|
|
.RS 0
|
|
\fBwlanconfig ath1 create wlandev wifi0 wlanmode sta nosbeacon
|
|
.RS 7
|
|
\fRCreate both an AP and a station mode interface.
|
|
.RS -7
|
|
.TP
|
|
\fBwlanconfig ath0 destroy
|
|
Destroy VAP ath0.
|
|
.TP
|
|
\fBwlanconfig ath0 list scan
|
|
Scan for local stations and access points.
|
|
.TP
|
|
\fBwlanconfig ath0 create wlandev wifi0 wlanmode ap
|
|
.RS 0
|
|
\fBwlanconfig ath1 create wlandev wifi0 wlanmode wds
|
|
.RS 0
|
|
\fBiwconfig ath0 essid "Normal atheros AP" channel 1
|
|
.RS 0
|
|
\fBiwpriv ath1 wds_add <mac of the peer wds ap>
|
|
.RS 0
|
|
\fBiwpriv ath1 wds 1
|
|
.RS 0
|
|
\fBifconfig ath1 up
|
|
.RS 0
|
|
\fBifconfig ath0 up
|
|
.RS 0
|
|
\fBbrctl addbr br0
|
|
.RS 0
|
|
\fBbrctl addif br0 ath1
|
|
.RS 0
|
|
\fBbrctl addif br0 ath0
|
|
.RS 0
|
|
\fBifconfig br0 up
|
|
.RS 7
|
|
\fRCreate a WDS bridge. See http://madwifi.org/ for more information.
|
|
.RS -7
|
|
.PP
|
|
.SH "AUTHOR"
|
|
This manual page was written by Matt Foster <mattfoster@clara.co.uk>, using information from the Atheros user documentation, and MadWiFi users mailing list.
|