diff options
Diffstat (limited to 'man/waproamd.8.xml.in')
-rw-r--r-- | man/waproamd.8.xml.in | 359 |
1 files changed, 180 insertions, 179 deletions
diff --git a/man/waproamd.8.xml.in b/man/waproamd.8.xml.in index 73ff3ea..e00667a 100644 --- a/man/waproamd.8.xml.in +++ b/man/waproamd.8.xml.in @@ -22,182 +22,183 @@ Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA. --> - <manpage name="waproamd" section="8" desc="Wireless Access Point Roaming Daemon for WLAN IEEE 802.11"> - - <synopsis> - <cmd>waproamd [<arg>options</arg>]</cmd> - </synopsis> - - <description> <p>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.</p> - - <p>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 <file>@sysconfdir@/waproamd/scripts/</file> named - after the MAC address of the access point is called. If this - script is not existent, - <file>@sysconfdir@/waproamd/scripts/default</file> 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.</p> - - <p>waproamd is intended to be used together with - ifplugd. Whenever an association succeeds, ifplugd detects it - and runs further configuration commands for it.</p> - - <p>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.</p> - - <p>waproamd requires a network driver supporting the Linux - wireless extensions 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.</p> - - - </description> - - <options> - - <option> - <p><opt>-n | --no-daemon</opt></p> - <optdesc><p> - Do not daemonize (for debugging) (default: off) - </p></optdesc> - </option> - - <option> - <p><opt>-s | --no-syslog</opt></p> - <optdesc><p> - Do not use syslog, use stdout instead (for debugging) (default: off). - </p></optdesc> - </option> - - <option> - <p><opt>-i | --iface=</opt><arg>IFACE</arg></p> - <optdesc><p> - Specify the wireless network interface (default: wlan0) - </p></optdesc> - </option> - - <option> - <p><opt>-w | --wait-on-fork</opt></p> - - <optdesc><p> When daemonizing, wait until the background - process finished with the initial association detection. - </p></optdesc> - </option> - - <option> <p><opt>-M | --monitor</opt></p> <optdesc><p>Don't fail - when the network interface is not available, instead use - NETLINK to monitor device avaibility. The is useful for PCMCIA - devices and similar.</p></optdesc> </option> - - <option> <p><opt>-e | --no-event</opt></p> <optdesc><p>Don't use - the wireless event API (as used by <manref name="iwevent" - section="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.</p></optdesc> </option> - - <option> - <p><opt>-t | --scan-interval=</opt><arg>SECS</arg></p> - <optdesc><p>Specify the time between scans for wireless networks.</p></optdesc> - </option> - - <option> - <p><opt>-p | --poll-intervall=</opt><arg>SECS</arg></p> - <optdesc><p>When using -e, specify the time between association status polls.</p></optdesc> - </option> - - <option> - <p><opt>-h | --help</opt></p> - <optdesc><p> - Show help - </p></optdesc> - </option> - - <option> - <p><opt>-k | --kill</opt></p> - <optdesc><p> - Kill a running daemon (Specify -i to select the daemon instance to kill) - </p></optdesc> - </option> - - <option> - <p><opt>-c | --check-running</opt></p> - <optdesc><p> - 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. - </p></optdesc> - </option> - - <option> - <p><opt>-v | --version</opt></p> - <optdesc><p> - Show version - </p></optdesc> - </option> - - </options> - - <section name="Files"> - - <p><file>@sysconfdir@/waproamd/waproamd.conf</file>: this file is sourced - by the init script <file>@sysconfdir@/init.d/waproamd</file> and - contains the interface to be monitored and the options to be - used.</p> - - <p><file>@sysconfdir@/waproamd/scripts/<AP MAC - address></file>: this is called whenever a wireless network - controlled by an AP with a matching address is detected. The MAC - address is formatted lowercase. Takes the same arguments as the - following script:</p> - - <p><file>@sysconfdir@/waproamd/scripts/default</file>: this is - the script which is called whenever no script named after the - AP MAC address 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. The default - implementation of this script looks for a file - <file>@sysconfdir@/waproamd/keys/<AP MAC - address>.wep</file>. If it exists its contents is used to - set the WEP key of the NIC. Otherwise the script looks for a - file <file>@sysconfdir@/waproamd/keys/<AP - MAC address>.aes</file>. If it exists the AES WEP rekeying daemon - <manref name="aeswepd" section="8"/> is called. Otherwise WEP - encryption is disabled.</p> - - - <p><file>/var/run/waproamd.<iface>.pid</file>: the pid file - for waproamd.</p> - - </section> - <section name="Signals"> - <p><arg>SIGINT, SIGTERM, SIGTQUIT</arg> waproamd will quit. This is issued by passing -k to waproamd.</p> - <p><arg>SIGHUP</arg> waproamd will rescan for available networks immediately.</p> - </section> - - <section name="Author"> - <p>waproamd was written by Lennart Poettering - <@PACKAGE_BUGREPORT@>. waproamd is available - at <url - href="@PACKAGE_URL@"/> - </p> - </section> - - <section name="See also"> - <p> - <manref name="ifplugd" section="8"/>, <manref name="aeswepd" section="8"/>, <manref name="iwconfig" section="8"/>, <manref name="iwlist" section="8"/> - </p> - </section> - - <section name="Comments"> - <p>This man page was written using <manref name="xmltoman" section="1" - href="http://masqmail.cx/xml2man/"/> by Oliver Kurth.</p> - </section> - - </manpage> +<manpage name="waproamd" section="8" desc="Wireless Access Point Roaming Daemon for WLAN IEEE 802.11"> + + <synopsis> + <cmd>waproamd [<arg>options</arg>]</cmd> + </synopsis> + + <description> + + <p>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.</p> + + <p>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 <file>@sysconfdir@/waproamd/scripts/</file> named after + the MAC address of the access point is called. If this script is + not existent, <file>@sysconfdir@/waproamd/scripts/default</file> + 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.</p> + + <p>waproamd is intended to be used together with ifplugd. Whenever + an association succeeds, ifplugd detects it and runs further + configuration commands for it.</p> + + <p>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.</p> + + <p>waproamd requires a network driver supporting the Linux + wireless extensions 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.</p> + + </description> + + <options> + + <option> + <p><opt>-n | --no-daemon</opt></p> + <optdesc><p> + Do not daemonize (for debugging) (default: off) + </p></optdesc> + </option> + + <option> + <p><opt>-s | --no-syslog</opt></p> + <optdesc><p> + Do not use syslog, use stdout instead (for debugging) (default: off). + </p></optdesc> + </option> + + <option> + <p><opt>-i | --iface=</opt><arg>IFACE</arg></p> + <optdesc><p> + Specify the wireless network interface (default: wlan0) + </p></optdesc> + </option> + + <option> + <p><opt>-w | --wait-on-fork</opt></p> + + <optdesc><p> When daemonizing, wait until the background + process finished with the initial association detection. + </p></optdesc> + </option> + + <option> <p><opt>-M | --monitor</opt></p> <optdesc><p>Don't fail + when the network interface is not available, instead use + NETLINK to monitor device avaibility. The is useful for PCMCIA + devices and similar.</p></optdesc> </option> + + <option> <p><opt>-e | --no-event</opt></p> <optdesc><p>Don't use + the wireless event API (as used by <manref name="iwevent" + section="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.</p></optdesc> </option> + + <option> + <p><opt>-t | --scan-interval=</opt><arg>SECS</arg></p> + <optdesc><p>Specify the time between scans for wireless networks.</p></optdesc> + </option> + + <option> + <p><opt>-p | --poll-intervall=</opt><arg>SECS</arg></p> + <optdesc><p>When using -e, specify the time between association status polls.</p></optdesc> + </option> + + <option> + <p><opt>-h | --help</opt></p> + <optdesc><p> + Show help + </p></optdesc> + </option> + + <option> + <p><opt>-k | --kill</opt></p> + <optdesc><p> + Kill a running daemon (Specify -i to select the daemon instance to kill) + </p></optdesc> + </option> + + <option> + <p><opt>-c | --check-running</opt></p> + <optdesc><p> + 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. + </p></optdesc> + </option> + + <option> + <p><opt>-v | --version</opt></p> + <optdesc><p> + Show version + </p></optdesc> + </option> + + </options> + + <section name="Files"> + + <p><file>@sysconfdir@/waproamd/waproamd.conf</file>: this file is sourced + by the init script <file>@sysconfdir@/init.d/waproamd</file> and + contains the interface to be monitored and the options to be + used.</p> + + <p><file>@sysconfdir@/waproamd/scripts/<AP MAC + address></file>: this is called whenever a wireless network + controlled by an AP with a matching address is detected. The MAC + address is formatted lowercase. Takes the same arguments as the + following script:</p> + + <p><file>@sysconfdir@/waproamd/scripts/default</file>: this is + the script which is called whenever no script named after the + AP MAC address 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. The default + implementation of this script looks for a file + <file>@sysconfdir@/waproamd/keys/<AP MAC + address>.wep</file>. If it exists its contents is used to + set the WEP key of the NIC. Otherwise the script looks for a + file <file>@sysconfdir@/waproamd/keys/<AP + MAC address>.aes</file>. If it exists the AES WEP rekeying daemon + <manref name="aeswepd" section="8"/> is called. Otherwise WEP + encryption is disabled.</p> + + + <p><file>/var/run/waproamd.<iface>.pid</file>: the pid file + for waproamd.</p> + + </section> + <section name="Signals"> + <p><arg>SIGINT, SIGTERM, SIGQUIT</arg> waproamd will quit. This is issued by passing -k to waproamd.</p> + <p><arg>SIGHUP</arg> waproamd will rescan for available networks immediately.</p> + </section> + + <section name="Author"> + <p>waproamd was written by Lennart Poettering + <@PACKAGE_BUGREPORT@>. waproamd is available + at <url + href="@PACKAGE_URL@"/> + </p> + </section> + + <section name="See also"> + <p> + <manref name="ifplugd" section="8"/>, <manref name="aeswepd" section="8"/>, <manref name="iwconfig" section="8"/>, <manref name="iwlist" section="8"/> + </p> + </section> + + <section name="Comments"> + <p>This man page was written using <manref name="xmltoman" section="1" + href="http://masqmail.cx/xml2man/"/> by Oliver Kurth.</p> + </section> + +</manpage> |