This directory contains drivers for network adapters based on the
ASIX Electronics AX88140A ethernet controller chip, including
the following:

- Alfa Inc. GFC2204

There are several other boards based on the ASIX chip which will
also work fine; this just happens to be the one I have for testing.
Don't be alarmed if your board is not listed here: if it has an ASIX
chip, it will work.

This driver has been incorporated into FreeBSD-current, but will
be maintained here for those who wish to add driver support to
older versions. The driver will be included with the next 3.x
release.

Here are instructions on how to add the ASIX driver to an
existing FreeBSD system:

- Download the version of if_ax.c and if_axreg.h that goes with your
  version of FreeBSD. The 3.0 directory contains code for FreeBSD 3.0.
  The 2.2 directory is for FreeBSD 2.2.5, 2.2.6, 2.2.7 and 2.2.8.

- Make sure you have the kernel source unpacked under /usr/src.  

- Copy if_ax.c and if_axreg.h to /sys/pci.

- Edit /sys/conf/files and add a line that says: 

pci/if_ax.c             optional ax device-driver

- Edit your kernel config file (e.g. /sys/i386/conf/GENERIC) and add
  a line that says: 

device  ax0

- config and compile a new kernel

- copy the kernel to the root directory, then reboot.

Interfaces should be detected as ax0, ax1, etc... You should edit 
/etc/rc.conf to have the interface brought up automatically when the
system boots.

If you experience problems with the driver, please send mail to
wpaul@skynet.ctr.columbia.edu with the following information:

- The version of FreeBSD you're using 
- The rcsid string from the version of if_ax.c you're using
- The type of system you have (CPU type and speed)
- The exact type of NIC you have
- Whether you have an add-in PCI card or if the NIC is built into your
  system somehow (integrated on motherboard or docking station)
- A copy of the dmesg output for your system showing the messages
  where your card is probed
- A complete description of the problem, with error messages if any.
- Optionally, boot your system with the -v flag to obtain verbose boot
  messages and include all the messages related to the rl device.

The copies of the code here may be updated to add fixes. Notices
of new versions will be posted to committers@freebsd.org.