This directory contains drivers for network adapters based on the
RealTek 8139 and 8129 fast ethernet controller chips, including the
following:

- Allied Telesyn AT2550
- Genius GF100TXR (RTL8139)
- NDC Communications NE100TX-E
- OvisLink LEF-8129TX
- OvisLink LEF-8139TX
- Netronix Inc. EA-1210 NetEther 10/100
- KTX-9130TX 10/100 Fast Ethernet
- Encore ENL832-TX 10/100 M PCI
- Longshine LCS-8038TX-R
- Cards manufactured by RealTek itself

This driver is still undergoing testing and has not yet neem integrated
into the FreeBSD source tree, however it will be eventually (probably
after FreeBSD 3.0 is released). So far I have only been able to test
it with an 8139 adapter.

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

- Download the version of if_rl.c and if_rlreg.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 and 2.2.7.

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

- Copy if_rl.c and if_rlreg.h to /sys/pci.

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

pci/if_rl.c             optional rl device-driver

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

device  rl0

- config and compile a new kernel

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

Interfaces should be detected as rl0, rl1, 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_rl.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 hackers@freebsd.org.