VERY OBSOLETE linux-wlan-ng master repository
Go to file
mark fc76fe38e4 Added result code to error output for the NV and NVWRITE commands. 2000-11-19 16:31:25 +00:00
doc Changed the comment header at the top of all the files to reflect the new company name. 2000-07-05 04:57:04 +00:00
etc Fixed for Intersil's manfid oversight. 2000-10-18 18:36:41 +00:00
man Changed the comment header at the top of all the files to reflect the new company name. 2000-07-05 04:57:04 +00:00
src Added result code to error output for the NV and NVWRITE commands. 2000-11-19 16:31:25 +00:00
CHANGES Updated for the 0.1.7 release. 2000-08-13 06:31:55 +00:00
COPYING Changed the comment header at the top of all the files to reflect the new company name. 2000-07-05 04:57:04 +00:00
Configure Added support to Configdata script to read IP addresses from input file before prompting user or doing the automated configuration. Added -h|help options to all Configure scripts to be able to print the usage info for the Configure script. 2000-07-08 19:48:51 +00:00
LICENSE Initial add of the MPL version 1.1. 2000-02-07 19:26:25 +00:00
Makefile Added auto_config target to Makefile in all sub-directories. Added target to top-level Makefile to clean, auto configure and recompile just the kernel, pcmcia and linux-wlan. Fixed bug in Configure scripts to allow the auto configure option to not require an input file (i.e. uses config.out or config.in as default). 2000-07-07 18:59:34 +00:00
README Updated for the 0.1.7 release. 2000-08-13 06:31:55 +00:00
TODO Added TODOs for the t0.2.6 release. 2000-08-23 15:41:21 +00:00
config.in Added CROSS_COMPILE_ENABLED variable to config.in. Changed the default file name in the default_config file of Makefile to be a file in the top-level directory of the linux-wlan package. 2000-07-05 05:20:42 +00:00

README

* README
*
* Copyright (C) 1999 AbsoluteValue Systems, Inc.  All Rights Reserved.
* --------------------------------------------------------------------
*
* linux-wlan
*
*   The contents of this file are subject to the Mozilla Public
*   License Version 1.1 (the "License"); you may not use this file
*   except in compliance with the License. You may obtain a copy of
*   the License at http://www.mozilla.org/MPL/
*
*   Software distributed under the License is distributed on an "AS
*   IS" basis, WITHOUT WARRANTY OF ANY KIND, either express or
*   implied. See the License for the specific language governing
*   rights and limitations under the License.
*
*   Alternatively, the contents of this file may be used under the
*   terms of the GNU Public License version 2 (the "GPL"), in which
*   case the provisions of the GPL are applicable instead of the
*   above.  If you wish to allow the use of your version of this file
*   only under the terms of the GPL and not to allow others to use
*   your version of this file under the MPL, indicate your decision
*   by deleting the provisions above and replace them with the notice
*   and other provisions required by the GPL.  If you do not delete
*   the provisions above, a recipient may use your version of this
*   file under either the MPL or the GPL.
*
* --------------------------------------------------------------------
*
* Inquiries regarding the linux-wlan Open Source project can be
* made directly to:
*
* AbsoluteValue Systems Inc.
* info@linux-wlan.com
* http://www.linux-wlan.com
*
* --------------------------------------------------------------------
*
* Portions of the development of this software were funded by 
* Intersil Corporation as part of PRISM(R) chipset product development.
*
* --------------------------------------------------------------------

Description:
The linux-wlan 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.

For a list of elements that are still undone, see the TODO file in 
this directory

License:
See the COPYING and LICENSE files.

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.

This software has currently been tested on the following
configurations:

Intel:
   linux-2.2.9  + pcmcia-cs-3.1.8  + RedHat6.0
   linux-2.2.12 + pcmcia-cs-3.0.14 + RedHat6.1
   linux-2.3.99-pre9 + pcmcia-cs-3.1.11 + RedHat 6.2
   linux-2.2.16 + pcmcia-cs-

PowerPC:
   linux-2.2.12 + pcmcia-cs-3.1.12 + LinuxPPC2000

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 currently have running.

Build Instructions:

1)  untar the package using the command:

    tar zxvf linux-wlan-ng-X.Y.Z.tar.gz

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'.  If make clean behaves badly (infinite loop, for
    example), you may have a date/time mismatch.  Run the command:

    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 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 set up your IP settings.  Note: for a 
    station, the SSID you're connecting to will be appended to the 
    current pcmcia scheme name.  You can use this to have different
    IP setups for different wireless LANs you connect to (e.g. home vs. work).

9)  Restart pcmcia-cs with the command:

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

10) Insert the card.  For most cards, 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.