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

June 15, 2004

Contents
========

- SuSE SLES 8 IA64 cause unresolved symbols
- SuSE Linux Enterprise Server 9 warning message during driver build   
- Caldera OpenLinux* 3.1
- Red Hat* Linux 7.1
- ACPI enable may cause Dual Port Pro/1000 adapters to fail
- Linux SNMP: Set operation fails on Red Hat* Enterprise Linux 3
- Red Hat* Enterprise Linux AS Release 2.1 Distribution
- Support

SuSE SLES 8 IA64 cause unresolved symbols
=========================================

If you get unresolved symbol errors when loading the e1000 driver, perform
the following:

1. cd /usr/src/linux
2. make cloneconfig
3. make dep

Then rebuild the driver.

SuSE Linux Enterprise Server 9 warning message during driver build
==================================================================

While building the driver on SuSE Linux Enterprise Server 9 installations, the
following warning may be displayed. It is safe to ignore this message. The
driver will load and function normally.

Symbol version dump /usr/src/linux-2.6.5-7.69-obj/ia64/default/Module.symvers
is  missing, modules will have CONFIG_MODVERSIONS disabled. 

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

  Installing Intel ANS
  --------------------
  In Caldera OpenLinux* 3.1, the super-user's executable path does not 
  include /usr/sbin/, which is 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* Linux 7.1
==================

  Creating an RPM from tar / zipped File
  --------------------------------------
  When trying to generate an RPM from the .tar.gz file, a segmentation fault 
  (core dump) occurs. This failure occurs because Red Hat* Linux 7.1 uses 
  version 4.0.2 of the RPM utility. This version does not have the ability to 
  handle parameterized macros, which are used within the e100 and e1000 spec 
  files to generate an RPM. Updating the RPM utility to a more current version 
  resolves the issue. The utility can be obtained from http://www.rpm.org.

ACPI enable may cause Dual Port PRO/1000 Adapters to fail
=========================================================

  If ACPI is turned on in the kernel, dual port adapters may not work. 
  This is due to a limitation in ACPI. Currently, this affects all new 
  versions of SuSE.

Linux SNMP: Set operation fails on Red Hat* Enterprise Linux 3
==============================================================

  Running the set operation using Red Hat* Enterprise Linux 3 fails when 
  using the net-snmp-5.0.8 package. This issue has been fixed in 
  net-snmp-5.0.9 package.

Red Hat* Enterprise Linux AS Release 2.1 Distribution
=====================================================

  If there are errors while compiling the driver, do the following
  (step 3 is optional):

    1. cd /usr/src/linux-2.4.9-e.34
    2. run 'uname -r' to obtain determine the configuration of the running
       kernel.
    3. cp an appropriate config file from configs directory.
    4. make {oldconfig | menuconfig}

  All that needs to be done is to accept the given values (that is,
  enter menuconfig and exit immediately if so desired) and save the
  resulting configuration.

    5. edit the Makefile and fix the EXTRAVERSION to match the one from step 2.
    6. make dep

  While building the driver, ignore the warning:

     /lib/modules/2.4.9-e.34/build/include/linux/rhconfig.h:31:60:
     operator '(' has no left operand

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.


Copyright and Legal Disclaimers
===============================

Copyright(c) 2003 Intel Corporation. All rights reserved. 

Intel Corporation, 5200 N.E. Elam Young Parkway, Hillsboro, OR 97124-6497 

Intel Corporation assumes no responsibility for errors or omissions in this 
document. Nor does Intel make any commitment to update the information 
contained herein. 

Intel, Itanium, and Pentium are trademarks or registered trademarks of Intel 
Corporation or its subsidiaries in the United States and other countries. 

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