linux-wlan-ng/README

Top level directory for linux-wlan-ng.

./doc		- source distribution documentation
./man		- man pages
./etc		- scripts used at run-time
./src		- source code for various components

Note:
Some of the subdirectories have empty README files.  This means we haven't 
gotten to the contents of these directories.  The empty README is just a trick
to prevent CVS from pruning the directory.

The following build and install instructions assume you have configured source
code for both the linux kernel package and pcmcia-cs package installed on your
system.  It's important that the configured code for these packages match
the kernel and pcmcia-cs you're running.

Build Instructions:

1) untar the package using

   tar zxvf linux-wlan-ng.tar.gz

or you can use winzip with the file  linux-wlan-ng.tar.

2) Make sure you have configured kernel and pcmcia sources on your system.

3) To clean up any unwanted files accidentally included in the tar package,
   run 'make clean'.

4) To configure the package, run 'make config' and respond to the questions.
   'make config' must be run after a 'make clean' and before 'make all'.

5) To build the package, run 'make all'

6) To install the package, run 'make install' (as root).

7) Edit the /etc/pcmcia/wlan-ng.opts file.  The only variable to set at
   this point is the DESIRED_SSID.  (Card firmware selects a channel
   and BSSID).  Set the DESIRED_SSID to a string matching a valid
   SSID of an access point.
   e.g. DESIRED_SSID="ACC_POINT_1"
   This assignment would establish the desired SSID to be that
   of the access point whose SSID is ACC_POINT_1.

8) Edit your network.opts file to setup your IP settings.

9) Restart pcmcia-cs with the command:

    /etc/rc.d/init.d/pcmcia restart

10) Insert the card.  A solid LED indicates that the SSID you specified
   was found, a bss was joined, and the firmware completed the authenticate
   and associate processes.

11) Run ifconfig and route to determine if your IP and route settings are
    listed as you wanted them.  It's also a good idea to look at the file
    /etc/resolv.conf to see if your nameserver address has been set up 
    correctly.