diff options
Diffstat (limited to 'doc/README')
| -rw-r--r-- | doc/README | 192 |
1 files changed, 0 insertions, 192 deletions
diff --git a/doc/README b/doc/README deleted file mode 100644 index 20324d3..0000000 --- a/doc/README +++ /dev/null @@ -1,192 +0,0 @@ - - aeswepd 0.3 - - Copyright 2002,2003 Lennart Poettering <mznrfjrcq (at) 0pointer (dot) - de> - * [1]License - * [2]News - * [3]Overview - * [4]Status - * [5]Documentation - * [6]Requirements - * [7]Installation - * [8]Acknowledgements - * [9]Download - -License - - This program is free software; you can redistribute it and/or modify - it under the terms of the GNU General Public License as published by - the Free Software Foundation; either version 2 of the License, or (at - your option) any later version. - - This program is distributed in the hope that it will be useful, but - WITHOUT ANY WARRANTY; without even the implied warranty of - MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU - General Public License for more details. - - You should have received a copy of the GNU General Public License - along with this program; if not, write to the Free Software - Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. - -News - - Fri Sep 13 2003: - - [10]Version 0.3 released, splitted from [11]waproamd, added - documentation, manpage, some bug fixes. - -Overview - -What is it? waproamd is a Linux WLAN roaming daemon for IEEE 802.11b -cards supported by a driver with wireless extension API. It may be -used for configuring WEP keys according to the WLANs available. It is -intended to be used in conjunction with ifplugd, which configures your -network automatically whenever an association with an AP suceeded. - -waproamd is intended to be used together with ifplugd. - -A short overview on the daemons involved and how they work together: - - waproamd: when not associated waproamd does periodic scans and tries - to associate to a sensible AP by running a script in - /etc/waproamd/scripts - - (built from waproamd-xxx.tar.gz) - - aeswepd: A daemon for doing AES based WEP rekeying, it is called by - /etc/waproamd/scripts/default if - /etc/waproamd/keys/[AP-MAC-ADDRESS].aes exists. It implements an - algorithm which is not standardized and only compatible with APs - using aeswepd as well. aeswepd may be used without waproamd. The - opposite is true as well. - - If you create a root-owned directory /var/lib/aeswepd all running - aeswepd instances will save the current wep keys to a file therein - which may be accessed via "aeswepls". - - (built from waproamd-xxx.tar.gz too) - - ifplugd: if an association succeeded ifplugd runs ifup for the - device (and ifdown if it is lost again) - - (built from ifplugd-xxx.tar.gz) - -waproamd will not issue scans while associated. - -The algorithm to select an AP if multiple are available is rather -simple: The first AP which has a script named by the AP MAC address -available in /etc/waproamd/scripts/ is seleted. If none has suh a -script /etc/waproamd/scripts/default is run for the first AP. - -waproamd requires libdaemon. - -waproamd is tested with hostap 0.0.3 only, with other drivers -ymmv. The host roaming feature of newer hostap releases might be -useful, however it is broken on 0.0.3 and not required by waproamd. - -Update: waproamd works fine with 0.0.4 - -waproamd requires a driver supporting the wireless extension v15 or -newer. Drivers supporting the iwevent ("wireless events") API are -useful, however not required. Unfortunately support for this API -cannot be detected automatically. Use the "-e" switch to disable it. - -waproamd requires a driver supporting scanning (iwlist scan) for -detecting the networks available. - -There is no need to compile, nor to install aeswepd if your interest is -limited to waproamd only. See "configure --help" for more information. - -no manpages, no further documentation included. Read the source, luke! - -waproamd relies on autoconf/automake for source code configuration and -building. - -The software packages involved are available from the following URLs: - - http://0pointer.de/lennart/projects/waproamd/ - http://0pointer.de/lennart/projects/libdaemon/ - http://0pointer.de/lennart/projects/ifplugd/ - -Status - - Version 0.3 is stable and has all the sensible features its users - could think of. - -Documentation - - Have a look on the man pages [12]aeswepd(8), [13]ifstatus(8), - [14]aeswepd.conf(5). (A XSLT capable browser is required) - - Configuration - - Troubleshooting - - FAQ - -Requirements - - A newer Linux Kernel (I think 2.2 is good enough, alltough I tested it - only with 2.4) with a compatible device driver and ethernet card. Most - modern cards and drivers are compatible, like mine which works with - the 8139too driver. - - aeswepd was developed and tested on Debian GNU/Linux "testing" from - July 2003, it should work on most other Linux distributions (and maybe - Unix versions) since it uses GNU autoconf and GNU libtool for source - code configuration and shared library management. - - The machine used was a Medion 9580-F laptop with a Realtek 8139 - network card and a PRISM1 PCMCIA wireless LAN card. - - aeswepd needs [15]libdaemon. - -Installation - - As this package is made with the GNU autotools you should run - ./configure inside the distribution directory for configuring the - source tree. After that you should run make for compilation and make - install (as root) for installation of aeswepd. - -Acknowledgements - - None so far - -Download - - The newest release is always available from - [16]http://0pointer.de/lennart/projects/aeswepd/ - - The current release is [17]0.3 - - Get aeswepd's development sources from the [18]Subversion - [19]repository. - _________________________________________________________________ - - - Lennart Poettering <mznrfjrcq (at) 0pointer (dot) de>, October 2003 - - $Id$ - -References - - 1. README#license - 2. README#news - 3. README#overview - 4. README#status - 5. README#documentation - 6. README#requirements - 7. README#installation - 8. README#acks - 9. README#download - 10. http://0pointer.de/lennart/projects/aeswepd/aeswepd-0.3.tar.gz - 11. http://0pointer.de/lennart/projects/waproamd - 12. http://0pointer.de/lennart/projects/aeswepd/aeswepd.8.xml - 13. http://0pointer.de/lennart/projects/aeswepd/ifstatus.8.xml - 14. http://0pointer.de/lennart/projects/aeswepd/aeswepd.conf.5.xml - 15. http://0pointer.de/lennart/projects/libdaemon/ - 16. http://0pointer.de/lennart/projects/aeswepd/ - 17. http://0pointer.de/lennart/projects/aeswepd/aeswepd-0.3.tar.gz - 18. http://subversion.tigris.org/ - 19. https://seth.intheinter.net:8081/svn/aeswepd/ |