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 +++++++++++++++++++++++++++++++++++++------------ 1 file changed, 37 insertions(+), 12 deletions(-) (limited to 'doc') 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$
-- cgit