NoCatSplash on the Linksys WRT54G

* What is it?

This package will turn your Linksys WRT54G access point into a NoCat open
portal.  This means that users will be presented with a "splash page" of
your choosing, and must click a button before they can access the network
from your AP.

It supports virtually all known web browsers on any platform, and requires
no Javascript or special client side tools.

For more details on how NoCatSplash works, try this:
http://nocat.net/download/NoCatSplash/


* Will it break my access point?

This version of Splash54G runs out of the system RAM on the access point,
and does not attempt to touch the flash.  To revert to your previous
settings, just cycle the power on your AP.

I don't believe it's possible to permanently damage your AP without fiddling
with the flash, but that said, use this software AT YOUR OWN RISK.


* Requirements

To use this package, you'll need the latest wrt54g tools package from CJ
Collier: http://cj.colliertech.org/swn/

Also, this has only been tested to work with US Firmware v1.30.7.

More information on wrt54g tools is available at:
http://www.seattlewireless.net/index.cgi/Wrt54gTools


* Won't this install a back-door telnet on my AP?

No.  This package uses the wrt54g tools, but doesn't install anything beyond
what NoCatSplash needs to run.


* Installation

First, install the wrt54g tools package.  Next, download the
NoCatSplash-54g.tgz archive from http://nocat.net/~rob/wrt54g/ and extract
it into the directory where you installed the tools.  Don't extract the
splash54g.tgz archive inside it; this will be copied verbatim to the AP.

You *must* edit the nocat.conf to supply values for the first three
variables: LocalNetwork, InsideIP, and DNSAddr.  The first two will work out
of the box if you haven't changed the IP settings of your WRT54G.  

You must set DNSAddr to the IP address of the DNS server that the WRT54G
hands out in DHCP.  If it doesn't match the DNS address that your clients
receive from DHCP, they won't be able to resolve host names.  (Future
versions should auto-detect this setting...)

Also, edit the splash.html file to your liking.

Finally, you're ready to install it to the AP.  Make sure you configured the
wrt54g tools package correctly (did you edit wrt54g.cfg?) and that the
push_splash command is executable (chmod a+x push_splash).  Now run this
command:

./push_splash

In a few moments, you should see something like this:

Pushing busybox .. done
Configuring busybox .... done

Pushing splash archive.
Extracting archive.
Cleaning up.
Pushing nocat.conf.
Pushing splash.html.
Launching splashd.

Now try browsing the net through your AP.  If all went well, you should be
presented with a splash screen (click 'login' to proceed).  If it didn't go
well, make sure you installed the wrt54g tools package properly.  Reboot the
AP before attempting to install NoCatSplash again.

To revert back to a normal access point, remove power for a moment, then
plug it back in.


* License

This code is released under the GNU Public License.  Deal.

Good luck!

--Rob Flickenger
rob {at} nocat {dot} net