From 322b6bc8e6bf7e3f4631e995afc6122a6c45a1e4 Mon Sep 17 00:00:00 2001 From: Lennart Poettering Date: Mon, 17 Nov 2003 20:22:45 +0000 Subject: documenation fixes git-svn-id: file:///home/lennart/svn/public/waproamd/trunk@50 022f378f-78c4-0310-b860-d162c87e6274 --- doc/README.html.in | 49 +++++++++++++++++++++++++++++++++++++------------ man/waproamd.8.xml.in | 18 ++++++++++++------ src/waproamd.c | 7 ++++--- 3 files changed, 53 insertions(+), 21 deletions(-) diff --git a/doc/README.html.in b/doc/README.html.in index 726dec3..ebcccab 100644 --- a/doc/README.html.in +++ b/doc/README.html.in @@ -42,6 +42,13 @@ Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

News

+
Mon Nov 17 2003:

Version 0.4 released, +changes include: support for ESSID based configuration, +host_roaming private ioctl support on hostap drivers, ability to +suspend/resume the daemon, support for looking for uppercase MAC +scripts, many robustness fixes.

+
Fri Oct 17 2003:

Version 0.3b released, changes include: minor bug fixes.

@@ -61,9 +68,11 @@ keys according to the networks found.

an association succeeds, ifplugd detects it and runs further configuration commands for it.

+

An alternative implementation of a tool like this is wlandetect.

+

Status

-

Version 0.3 works fine on hostap 0.0.4 and airolan. Other driver/card combinations not tested, but may work too.

+

Version @PACKAGE_VERSION@ works fine on hostap 0.0.4 and airolan. Other driver/card combinations not tested, but may work too.

Documentation

@@ -71,15 +80,18 @@ configuration commands for it.

Mode of Operation

-

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 @sysconfdir@/waproamd/scripts/ named after -the MAC address of the access point is called. If this script is -not existent, @sysconfdir@/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.

+

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 @sysconfdir@/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 directory is +used. Special characters are escaped in an HTTP URL like fashion. If +this script is not existent, +@sysconfdir@/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.

If multiple WLANs are detected at the same time, the network which is detected by the hardware first is selected. However, @@ -92,6 +104,12 @@ 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 private ioctl() as defined by the hostap driver.

+ +

Don't forget to install a firewall on your computer, since +waproamd will try to log into any network it finds with +default settings, if not configured otherwise. Yes, you a right, waproamd is war-driving on steroids.

+

Configuration

Edit /etc/waproamd/waproamd.conf for configuration @@ -99,7 +117,7 @@ changes. This file is a bourne shell script sourced by the init script and used to generate a suiting command line. You may specify more than one ethernet interface in INTERFACES. For each interface a seperate instance of waproamd is spawned. The arguments specified in -ARGS are append to waproamd's command line. Have a look on +ARGS are appended to waproamd's command line. Have a look on waproamd -h or man waproamd for further information about the options available.

@@ -110,7 +128,7 @@ href="http://0pointer.de/projects/lennart/aeswepd/">aeswepd for automatic rekeying, you may put the AES key into a file with the suffix .aes instead.

-

The configuration is similar to ifplugd.

+

The configuration is similar to ifplugd.

Troubleshooting

@@ -122,6 +140,9 @@ driver/card combination does not support this, you have to enable polling of association status by passing -e on the command line. This will increase the reaction latency of waproamd.

+

You can priorize networks over others by adding symbolic links to +the default script to /etc/waproamd/scripts.

+

Requirements

A newer Linux Kernel with a compatible device driver and WLAN NIC @@ -158,6 +179,8 @@ for it.

Thomas Hood for patches

+

Oliver Kurth for packaging waproamd for Debian

+

Download

The newest release is always available from @PACKAGE_URL@

@@ -166,6 +189,8 @@ for it.

Get waproamd's development sources from the Subversion repository.

+

You may find a mostly up to date Debian package of waproamd on the Debian package repository. +

Lennart Poettering <@PACKAGE_BUGREPORT@>, October 2003
$Id$
diff --git a/man/waproamd.8.xml.in b/man/waproamd.8.xml.in index 8fba513..ed56b1c 100644 --- a/man/waproamd.8.xml.in +++ b/man/waproamd.8.xml.in @@ -37,12 +37,15 @@

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 @sysconfdir@/waproamd/scripts/ named after - the MAC address of the access point is called. If this script is - not existent, @sysconfdir@/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.

+ 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 directory is + used. Special characters are escape in an HTTP URL like + fashion. If this script is not existent, + @sysconfdir@/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 @@ -59,6 +62,9 @@ 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.

+ diff --git a/src/waproamd.c b/src/waproamd.c index 41cfa3f..91dd26b 100644 --- a/src/waproamd.c +++ b/src/waproamd.c @@ -274,10 +274,8 @@ int go(struct interface *i) { /* Try to enable userspace roaming in the driver */ if (!disabled && use_userspace_roaming) { - if (iw_set_hostroam(i, 2) < 0) { + if (iw_set_hostroam(i, 2) < 0) daemon_log(LOG_WARNING, "Enabling user space roaming failed, doing without."); - use_userspace_roaming = 0; - } } memset(¤t_ap, 0, sizeof(current_ap)); @@ -406,6 +404,9 @@ int go(struct interface *i) { if (d && !disabled) { daemon_log(LOG_INFO, "Interface enabled"); associated = scanning = 0; + + if (iw_set_hostroam(i, 2) < 0) + daemon_log(LOG_WARNING, "Enabling user space roaming failed, doing without."); } if (!disabled) { -- cgit