Provided by:
waproamd_0.6-9ubuntu1_i386
NAME
waproamd - Wireless Access Point Roaming Daemon for WLAN IEEE 802.11
SYNOPSIS
waproamd [options]
DESCRIPTION
waproamd is a roaming daemon for wireless NICs supporting the Linux
wireless extensions. It is intended to configure the WEP keys according
to the networks found.
As long as the local NIC is not associated to any wireless network
waproamd scans iteratively for them. If one is detected, a script in
/etc/waproamd/scripts/ named after the MAC address of the access point
is called. (First lowercase, than uppercase is checked) If a script
like this is not found a script named essid:<ESSID> in the same direc‐
tory is used. Special characters are escape in an HTTP URL like fash‐
ion. If this script is not existent, /etc/waproamd/scripts/default is
called instead. The first argument to this script is "start". If the
association is lost, the same script is run with the argument "stop".
While the NIC is associated no scans are issued.
waproamd is intended to be used together with ifplugd. Whenever an
association succeeds, ifplugd detects it and runs further configuration
commands for it.
If multiple WLANs are detected at the same time, the network which is
detected by the hardware first is selected. However, networks where a
matching script exists take precedence.
waproamd requires a network driver supporting the Linux wireless exten‐
sions v15 or newer. The driver needs to support scanning for wireless
networks, which may be tested by running "iwlist scan". If the driver
supports the wireless event subsystem, waproamd may use it to improve
latency behaviour. It is not required, however.
waproamd supports the host_roaming ioctl() defined by the hostap
driver.
OPTIONS
-n | --no-daemon
Do not daemonize (for debugging) (default: off)
-s | --no-syslog
Do not use syslog, use stdout instead (for debugging) (default:
off).
-i | --iface=IFACE
Specify the wireless network interface (default: wlan0)
-w | --wait-on-fork
When daemonizing, wait until the background process finished
with the initial association detection.
-W | --wait-on-kill
When killing a running daemon (with -k) wait until the daemon
died.
-M | --monitor
Don’t fail when the network interface is not available, instead
use NETLINK to monitor device avaibility. The is useful for PCM‐
CIA devices and similar.
-e | --no-event
Don’t use the wireless event API (as used by iwevent(8)),
instead poll for association information. Some network drivers
do not support this relatively new feature of the Linux wireless
extension. Sadly the support of this feature cannot be detected
automatically.
-t | --scan-interval=SECS
Specify the time between scans for wireless networks.
-p | --poll-intervall=SECS
When using -e, specify the time between association status
polls.
-h | --help
Show help
-k | --kill
Kill a running daemon (Specify -i to select the daemon instance
to kill)
-c | --check-running
Check if a daemon is running for a given network interface. Sets
the return value to 0 if a daemon is already running or to 255
if not.
-S | --supend
Suspend a running daemon. The daemon will no longer check the
link status until it is resumed (-R) again. (Specify -i to
select the daemon instance to suspend.)
-R | --resume
Resume a suspended daemon. (Specify -i to select the daemon
instance to resume.)
-v | --version
Show version
-r | --issue-scan
Tell a running daemon to issue an immediate scan for new net‐
works
-U | --no-userspace-roaming
Don’t enable userspace roaming as supported by certain drivers
(e.g. hostap). Normaly, waproamd tries to enable this special
feature, doing effectively the same as "iwpriv wlan0 host_roam‐
ing 2". If the driver supports this private ioctl the robustness
of waproamd’s operation is increased. However, it is not
required for successful use. See your driver documentation for
mor information on this topic.
FILES
/etc/waproamd/waproamd.conf: this file is sourced by the init script
/etc/init.d/waproamd and contains the interface to be monitored and the
options to be used.
/etc/waproamd/scripts/<AP MAC address>: this is called whenever a wire‐
less network controlled by an AP with a matching address is detected.
The file is first tried with the MAC address formatted lowercase. If no
script with that name exists waproamd looks for a file with the MAC
address formatted uppercase. Only scripts marked executable are consid‐
ered. Networks with non-executable scripts are always ignored. You may
use this to "disable" specific networks from being selected. Takes the
same arguments as the following script:
/etc/waproamd/scripts/essid:<ESSID>: This is called whenever a wireless
AP is detected but no script named after the AP MAC exists (See above).
If the ESSID contains special chracters (ASCII code < 32, >= 127, ’/’,
’%’) they are replaced by a character % and the hexadecimal ASCII num‐
ber of the character in uppercase. This is similar to the HTTP URL
encoding. Only scripts marked executable are considered. Takes the same
arguments as the following script:
/etc/waproamd/scripts/default: this is the script which is called when
neither a script named after the AP MAC address, nor a script named
after the ESSID is found. It takes a single argument: either "start" or
"stop". An environment variable AP is set to the MAC address of the
access point found. An environment variable IFACE is set to the network
interface name. An environment variable ESSID contains the ESSID of the
WLAN network. ESSID_ESCAPED contains the ESSID with all special chrac‐
ters escaped the same way as described above. The default implementa‐
tion of this script looks for a file /etc/waproamd/keys/<AP MAC
address>.wep (or named after the ESSID, following the same scheme as
the script selection described above). If it exists its contents is
used to set the WEP key of the NIC. Otherwise the script looks for a
file /etc/waproamd/keys/<AP MAC address>.aes. If it exists the AES WEP
rekeying daemon aeswepd(8) is called. Otherwise WEP encryption is dis‐
abled.
/var/run/waproamd.<iface>.pid: the pid file for waproamd.
SIGNALS
SIGINT, SIGTERM, SIGQUIT waproamd will quit. This is issued by passing
-k to waproamd.
SIGHUP waproamd will rescan for available networks immediately.
AUTHOR
waproamd was written by Lennart Poettering <mzjncebnzq (at) 0pointer
(dot) de>. waproamd is available at
http://0pointer.de/lennart/projects/waproamd/
ifplugd(8), aeswepd(8), iwconfig(8), iwlist(8)
COMMENTS
This man page was written using xmltoman(1) by Oliver Kurth.