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

February 5, 2003


Contents
========

- Caldera OpenLinux* 3.1
- Red Hat* 7.1
- SuSE* 7.1
- SuSE 7.3
- SuSE 8.0 Personal
- SuSE 8.1 with ACPI enable may cause adapters to fail
- Support


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* 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* 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.


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

  Compiling Intel ANS or PROCfg 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.


SuSE 7.3
========

  Compiling Intel Drivers
  -----------------------
  When trying to compile Intel e100, e1000, and ANS drivers on SuSE 7.3 
  systems, a compilation failure occurs due to a missing version.h file. As a 
  workaround, issue the following command at the root directory:

  copy /boot/vmlinux.version.h/lib/modules/'uname -r'/build/include/linux/version.h


SuSE 8.0 Personal
=================

  Compiling Intel Drivers on the 2.4.18 Kernel
  --------------------------------------------
  When trying to compile Intel e100, e1000, and ANS drivers on the 2.4.18 
  kernel on SuSE 8.0 systems a compilation failure occurs, and a message 
  regarding a mismatch between the running kernel and the kernel source tree 
  configuration appears. By default, SuSE installs the 2.4.18-64GB-SMP 
  kernel while the kernel source tree is configured for 2.4.18-4GB. A 
  possible solution is to issue the following commands:

  	cd /usr/src/linux/include/linux/
	mv version.h version.h.old
	cp /boot/vmlinuz.version.h version.h
	mv autoconf.h autoconf.h.old
	cp /boot/vmlinuz.autoconf.h autoconf.h

Linux ACPI enable causes Dual Port PRO/1000 Adapters to fail
============================================================

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

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.
