diff options
author | Lennart Poettering <lennart@poettering.net> | 2003-10-16 17:38:58 +0000 |
---|---|---|
committer | Lennart Poettering <lennart@poettering.net> | 2003-10-16 17:38:58 +0000 |
commit | 06ba2a37d32475c4aa00f4153515716104ee43f1 (patch) | |
tree | 861866c84ff2d53813e2b63955a0c339cf6f430e | |
parent | d896beaea35f8ea05ef7712ce0097e087d2aaac3 (diff) |
further fixes
git-svn-id: file:///home/lennart/svn/public/aeswepd/trunk@26 022f378f-78c4-0310-b860-d162c87e6274
-rw-r--r-- | doc/README | 192 | ||||
-rw-r--r-- | doc/README.html.in | 187 | ||||
-rw-r--r-- | doc/style.css | 29 |
3 files changed, 216 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/ diff --git a/doc/README.html.in b/doc/README.html.in new file mode 100644 index 0000000..8675a90 --- /dev/null +++ b/doc/README.html.in @@ -0,0 +1,187 @@ +<?xml version="1.0" encoding="iso-8859-1"?> <!-- -*-html-helper-*- --> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml"> + +<head> +<title>aeswepd @PACKAGE_VERSION@</title> +<link rel="stylesheet" type="text/css" href="style.css" /> +</head> + +<body> +<h1><a name="top">aeswepd @PACKAGE_VERSION@</a></h1> + +<p><i>Copyright 2002,2003 Lennart Poettering <@PACKAGE_BUGREPORT@></i></p> + +<ul class="toc"> + <li><a href="#license">License</a></li> + <li><a href="#news">News</a></li> + <li><a href="#overview">Overview</a></li> + <li><a href="#status">Status</a></li> + <li><a href="#documentation">Documentation</a></li> + <li><a href="#requirements">Requirements</a></li> + <li><a href="#installation">Installation</a></li> + <li><a href="#acks">Acknowledgements</a></li> + <li><a href="#download">Download</a></li> +</ul> + +<h2><a name="license">License</a></h2> + +<p>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.</p> + +<p>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.</p> + +<p>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.</p> + +<h2><a name="news">News</a></h2> + +<div class="news-date">Fri Sep 13 2003: </div> + +<p class="news-text"><a href="@PACKAGE_URL@aeswepd-0.3.tar.gz">Version 0.3</a> released, splitted from <tt><a href="http://0pointer.de/lennart/projects/waproamd">waproamd</a></tt>, added documentation, manpage, some bug fixes.</p> + +<h2><a name="overview">Overview</a></h2> + +<pre> +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/ +</pre> + +<h2><a name="status">Status</a></h2> + +<p>Version 0.3 is stable and has all the sensible features its users could think of.</p> + +<h2><a name="documentation">Documentation</a></h2> + +<p>Have a look on the man pages <a href="@PACKAGE_URL@aeswepd.8.xml"><tt>aeswepd(8)</tt></a>, <a href="@PACKAGE_URL@ifstatus.8.xml"><tt>ifstatus(8)</tt></a>, <a href="@PACKAGE_URL@aeswepd.conf.5.xml"><tt>aeswepd.conf(5)</tt></a>. (A XSLT capable browser is required)</p> + +<h3>Configuration</h3> + + +<h3>Troubleshooting</h3> + + +<h3>FAQ</h3> + +<ol> +</ol> + +<h2><a name="requirements">Requirements</a></h2> + +<p>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 <tt>8139too</tt> driver.</p> + +<p><tt>aeswepd</tt> 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.</p> + +<p>The machine used was a Medion 9580-F laptop with a Realtek 8139 +network card and a PRISM1 PCMCIA wireless LAN card.</p> + +<p><tt>aeswepd</tt> needs <a href="http://0pointer.de/lennart/projects/libdaemon/"><tt>libdaemon</tt></a>.</p> + +<h2><a name="installation">Installation</a></h2> + +<p>As this package is made with the GNU autotools you should run +<tt>./configure</tt> inside the distribution directory for configuring +the source tree. After that you should run <tt>make</tt> for +compilation and <tt>make install</tt> (as root) for installation of +<tt>aeswepd</tt>.</p> + +<h2><a name="acks">Acknowledgements</a></h2> + +<p>None so far</p> + +<h2><a name="download">Download</a></h2> + +<p>The newest release is always available from <a href="@PACKAGE_URL@">@PACKAGE_URL@</a></p> + +<p>The current release is <a href="@PACKAGE_URL@aeswepd-@PACKAGE_VERSION@.tar.gz">@PACKAGE_VERSION@</a></p> + +<p>Get <tt>aeswepd</tt>'s development sources from the <a href="http://subversion.tigris.org/">Subversion</a> <a href="https://seth.intheinter.net:8081/svn/aeswepd/">repository</a>.</p> + +<hr/> +<address>Lennart Poettering <@PACKAGE_BUGREPORT@>, October 2003</address> + +<div><i>$Id: README.html.in 48 2003-09-13 11:36:11Z lennart $</i></div> + +</body> +</html> diff --git a/doc/style.css b/doc/style.css new file mode 100644 index 0000000..090bbc7 --- /dev/null +++ b/doc/style.css @@ -0,0 +1,29 @@ +/* $Id: style.css 43 2003-09-13 11:25:11Z lennart $ */ + +/*** + * This file is part of ifplugd. + * + * ifplugd 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. + * + * ifplugd 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 ifplugd; if not, write to the Free Software Foundation, + * Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA. + ***/ + +body { color: black; background-color: white; margin: 0.5cm; } +a:link, a:visited { color: #900000; } +p { margin-left: 0.5cm; margin-right: 0.5cm; } +div.news-date { margin-left: 0.5cm; font-size: 80%; color: #4f0000; } +p.news-text { margin-left: 1cm; } +ul { margin-left: 0.5cm; } +h1 { color: #00009F; } +h2 { color: #00009F; } +h3 { color: #00004F; margin-left: 0.5cm; } |