diff --git a/README b/README index ae920bc..4b4e383 100644 --- a/README +++ b/README @@ -1,5 +1,12 @@ -Top level directory for linux-wlan-ng. +Description: +The linux-wlan-ng package is a linux device driver and subsystem +package that is designed to provide the full range of IEEE 802.11 MAC +management capabilities for use in user-mode utilities and scripts. +The package currently supports the Intersil Prism2 11Mb/s reference design +PCMCIA wireless LAN (WLAN) card. + +Top level directory for linux-wlan-ng: ./doc - source distribution documentation ./man - man pages @@ -11,36 +18,49 @@ 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. +This software has currently been tested on the following +configurations: + + linux-2.2.9 + pcmcia-cs-3.1.8 + RedHat6.0 + linux-2.2.12 + pcmcia-cs-3.0.14 + RedHat6.1 + 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. +the kernel and pcmcia-cs you currently have running. Build Instructions: -1) untar the package using +1) untar the package using the command: tar zxvf linux-wlan-ng-0.1.3.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'. + run 'make clean'. If make clean behaves badly (infinite loop, for + example), you may have a date/time mismatch. Run the command: -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'. + find . -type f -exec touch {} \; + + to fix the date&time stamps, then run 'make clean' again. + +4) To configure the linux-wlan-ng package, run 'make config' and respond + to the questions. The defaults should be sufficient for most + users. '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 to configure. These options are - set every time you insert a card. If you want to change one, a) pop - your card out, b) alter the file, c) insert your card. + set every time you insert a card. If you want to change an option + after the initial configuration, a) pop your card out, b) alter the + file, c) insert your card. For more information see the file(s) + linux-wlan-ng*/doc/config.* -8) Edit your network.opts file to setup your IP settings. +8) Edit your network.opts file to set up your IP settings. 9) Restart pcmcia-cs with the command: @@ -55,4 +75,8 @@ or you can use winzip with the file linux-wlan-ng.tar. /etc/resolv.conf to see if your nameserver address has been set up correctly. +12) If you are trying to set up an AP, you will need bridging support + compiled into your kernel. You will also need the brcfg utility. + A version of this utility can be found on the AVS ftp site. + ftp://ftp.absoval.com/pub/brcfg