Using Intel(R) Network Adapters with Linux* --
Information for Specific Linux Distributions
==============================================

January 4, 2002


Contents
========

- Caldera OpenLinux* 3.1
  - Installing Intel ANS
  - Compiling Intel Drivers on Itanium(TM)-Based Systems
- Red Hat* 7.0
   - Compiling Intel Drivers
- Red Hat 7.0 Enterprise* Edition
   - Matching the Kernel Source
- Red Hat 7.2
   - Driver Installation on Itanium-Based Systems
- SuSE* 7.1
  - Compiling Intel ANS or PROCfg on the 2.4.0 Kernel
- Support


Caldera* OpenLinux 3.1
======================

  Installing Intel ANS
  --------------------

  In Caldera OpenLinux* 3.1, the super-user's executable path does not include
  /usr/sbin/, the default location selected by the makefile for Intel ANS
  installation. This causes problems later during the configuration stage. To
  solve this, either permanently add /usr/sbin to root's executable path, or
  modify the makefile to set BIN_DIR to a preferred directory that is super-
  user specific and that appears in $PATH.

  Compiling Intel Drivers on Itanium(TM)-Based Systems
  ----------------------------------------------------

  When compiling the e100 and e1000 drivers, various unresolved symbol errors
  may appear. These messages may be disregarded as the drivers will install
  and function properly on Caldera OpenLinux 3.1 Itanium(TM)-based systems.


Red Hat* 7.0
============

  Compiling Intel Drivers
  -----------------------

  To install Intel's e100, e1000, and iANS drivers on systems running Red Hat*
  Linux 7.0, you MUST have the kernel source package and kgcc. Without kgcc,
  the modules compiled for the stock kernel are compiled with gcc and may be
  unstable.

  You can check for the required packages by typing:

     rpm -q kernel-source
     rpm -q kgcc

  If you are missing a package, install it with the following commands:

     mount /dev/cdrom /mnt/cdrom  (or copy from the web)
     cd /mnt/cdrom/RedHat/RPMS/  (or directory copied from the web)
     rpm -i kernel-source-2.2.16-22.i386.rpm
     rpm -i kgcc-1.1.2-40.i386.rpm

  Then, you MUST reboot. This ensures that version.h is updated. You may then
  install the Intel driver(s) as indicated in the driver's readme file.


Red Hat 7.0 Enterprise* Edition
==============================

  Matching the Kernel Source
  --------------------------

  The 7.0 Enterprise* kernel version was built using extra patches and does
  not match the kernel-RPM installed source. You must install and apply the
  patches from the kernel SRPM to recreate the proper source tree.

  NOTE: The Enterprise kernel was developed to allow the 2.2.16 kernel large
        memory access and other Enterprise features. If you require Enterprise
        capability, we strongly suggest using the 2.4.X series of kernels,
        which have native large memory support.

  Use the following instructions to recreate the 2.2.16-22 Enterprise kernel
  source:

  1) Install kernel-2.2.16-22.src.rpm and kernel-source-2.2.16-22.i386.rpm.

  2) Make a copy of the source tree installed from kernel-source-2.2.16-22.i386.rpm.

  3) Apply the following patches from the kernel SRPM to the new kernel source
     tree:

        /usr/src/RedHat/SOURCES/linux-2.2.16-lfs.patch
        /usr/src/RedHat/SOURCES/linux-2.2.16-lfs-bigmem.patch

     NOTE: Unresolved failure message have been observed on some systems. These
           message may be ignored as the patches do install cleanly.

  4) Clean out the kernel source tree and reconfigure for the Enterprise
     kernel:

	make mrproper
	cp configs/kernel-2.2.16-i686-enterprise.config .config
	make oldconfig
	make dep

  5) Ensure /usr/src/linux is a symlink pointing to the new Enterprise kernel
     source.

  6) Build the driver.


Red Hat 7.2
===========

  Driver Installation on Itanium-Based Systems with Red Hat 7.2 or Higher
  ---------------------------------------------------------------------------

  When compiling the e100 and e1000 drivers with 'make install', the binary is
  installed as:

     For e100:  /lib/modules/[KERNEL_VERSION]/kernel/drivers/addon/e100.o

     For e1000: /lib/modules/[KERNEL_VERSION]/kernel/drivers/addon/e1000.o


SuSE* 7.1
=========

  Compiling Intel ANS on the 2.4.0 Kernel
  ---------------------------------------

  When trying to compile Intel ANS on the 2.4.0 kernel on SuSE* 7.1 systems, a
  compilation failure occurs, and a message regarding a missing config.h file
  is displayed. This failure occurs because the kernel source trees supplied,
  Linux-2.4.0.SuSE and Linux-2.4.0-4GB, are both empty and do not contain the
  necessary config.h and version.h files. A possible solution is to install
  either a new kernel from http://www.kernel.org or a new kernel tree package
  supplied by SuSE.

  When installing and compiling openssl, a prerequisite for PROCfg, a
  compilation failure occurs, and a message regarding a missing errno.h file
  is displayed. This is another instance of the missing kernel source tree
  described above for ANS. Use the solution above to restore the missing
  file.


Support
=======

For general information and support, go to the Intel support Website at:

     http://support.intel.com

If an issue is identified with the released source code on the supported
kernel with a supported adapter, email the specific information related to the
issue to linux.nics@intel.com.


* Other names and brands may be claimed as the property of others.
