WIFIROAMD README
Sean Reifschneider
<jafo@tummy.com>
http://www.tummy.com/Community/software/wifiroamd/
ftp://ftp.tummy.com/pub/tummy/wifiroamd/
Sat Jan 21, 2006
==================

wifiroamd is a program that monitors your wireless device to keep it
connected to a good access point.  It will scan looking for a known AP, or
will try the AP with the strongest un-encrypted signal.  If a script is
found for the specific AP ESSID or MAC address is found, that script is
run.  Otherwise, a "default" script is run.

After that script is run, scripts in the "up.d" directory are run.  These
implement extra functionality such as DHCP, ESSID "pinning" (where it
explicitly does "iwconfig $DEVICE essid $ESSID", so that you don't
accidentally wander to another AP) and other local things such as
restarting OpenVPN, etc.

Features:

   Default set of scripts which do:
      ESSID Pinning, so that you don't drift to another network.
      Restart OpenVPN when wireless comes up.
      DHCP client uses a unique lease file for each AP MAC or ESSID,
            which makes it much faster to get a lease after moving to a
            different wireless network.
      Monitoring of default gateway by ping, and re-scanning for a new
            AP.
      Bonding of wired and wireless interfaces so you can seamlessly plug
            in to the wired for more bandwidth, without breaking existing
            connections or transfers.

QUICKSTART
==========
For every AP you want to connect to, create

   /etc/wifiroamd/connections/essid:$ESSID
or:
   /etc/wifiroamd/connections/mac:$MACADDRESS

files.  Running "touch" on them would work.  For example, if you want to
connect to an AP with the ESSID "ExampleFreeWifi":

   touch /etc/wifiroamd/connections/essid:ExampleFreeWifi

Then just start the wifiroamd daemon with "/etc/init.d/wifiroamd start".

Red Hat/Fedora Notice:

   You need to disable any other wireless or interface hotplug
   functionality.  This probably means disabling NetworkManager
   ("chkconfig NetworkManager off; service NetworkManager stop").  You
   probably also need to remove any of the
   "/etc/sysconfig/network-script/ifcfg-eth*" files, or wifiroamd and
   hotplug will fight over the interface.

   Note that you can't rename these ifcfg files to have a different suffix
   like "ifcfg-eth0.old", because the hotplug doesn't care about the
   suffix.  If you don't want to remove them outright, rename them to
   "disabled-ifcfg-eth0" or the like.

GETTING STARTED
===============
   See the OPERATION section in the man page.

SCRIPTS
=======
   See the SCRIPT INSTRUCTIONS section in the man page.
