75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi$FreeBSD$
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert MustacchiFreeBSD* Driver for Intel Network Connection
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi=============================================
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert MustacchiMay 30, 2007
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert MustacchiContents
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi========
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi- Overview
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi- Identifying Your Adapter
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi- Building and Installation
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi- Speed and Duplex Configuration
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi- Additional Configurations
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi- Known Limitations
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi- Support
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi- License
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert MustacchiOverview
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi========
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert MustacchiThis file describes the FreeBSD* driver for Intel Network Connection.
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert MustacchiThis driver has been developed for use with FreeBSD, Release 7.x.
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert MustacchiFor questions related to hardware requirements, refer to the documentation
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchisupplied with your Gigabit adapter. All hardware requirements listed
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchiapply to use with FreeBSD.
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert MustacchiIdentifying Your Adapter
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi========================
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert MustacchiFor information on how to identify your adapter, go to the Adapter &
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert MustacchiDriver ID Guide at:
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchihttp://support.intel.com/support/network/sb/cs-012904.htm
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert MustacchiFor the latest Intel network drivers for FreeBSD, see:
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchihttp://downloadfinder.intel.com/scripts-df-external/support_intel.aspx
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert MustacchiNOTE: Mobile adapters are not fully supported.
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert MustacchiNOTE: The Intel(R) 82562v 10/100 Network Connection only provides 10/100
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchisupport.
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert MustacchiBuilding and Installation
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi=========================
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert MustacchiNOTE: The driver can be installed as a dynamic loadable kernel module or
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi compiled into the kernel. You must have kernel sources installed in
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi order to compile the driver module.
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert MustacchiIn the instructions below, x.x.x is the driver version as indicated in the
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchiname of the driver tar file.
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi1. Move the base driver tar file to the directory of your choice. For
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi example, use /home/username/em or /usr/local/src/em.
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi2. Untar/unzip the archive:
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi tar xzvf em-x.x.x.tar.gz
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi This will create an em-x.x.x directory.
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi3. To create a loadable module, perform the following steps.
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi NOTE: To compile the driver into the kernel, go directly to step 4.
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi a. To compile the module
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi cd em-x.x.x
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi make
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi b. To install the compiled module to the system directory:
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi make install
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi c. If you want the driver to load automatically when the system is booted:
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi 1. Edit /boot/loader.conf, and add the following line:
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi if_em_load="YES"
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi4. To compile the driver into the kernel, enter:
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi cd em-x.x.x/src
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi cp *.[ch] /usr/src/sys/dev/em
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi Edit the kernel configuration file (i.e., GENERIC or MYKERNEL) in
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi /usr/src/sys/i386/conf, and ensure the following line is present:
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi device em
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi Compile and install the kernel. The system must be rebooted for the
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi kernel updates to take effect. For additional information on compiling
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi the kernel, consult the FreeBSD operating system documentation.
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi5. To assign an IP address to the interface, enter the following:
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi ifconfig em<interface_num> <IP_address>
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi6. Verify that the interface works. Enter the following, where <IP_address>
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi is the IP address for another machine on the same subnet as the interface
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi that is being tested:
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi ping <IP_address>
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi7. To configure the IP address to remain after reboot, edit /etc/rc.conf,
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi and create the appropriate ifconfig_em<interface_num>entry:
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi ifconfig_em<interface_num>="<ifconfig_settings>"
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi Example usage:
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi ifconfig_em0="inet 192.168.10.1 netmask 255.255.255.0"
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi NOTE: For assistance, see the ifconfig man page.
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert MustacchiSpeed and Duplex Configuration
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi==============================
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert MustacchiBy default, the adapter auto-negotiates the speed and duplex of the
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchiconnection. If there is a specific need, the ifconfig utility can be used to
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchiconfigure the speed and duplex settings on the adapter. Example usage:
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi ifconfig em<interface_num> <IP_address> media 100baseTX mediaopt
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi full-duplex
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi NOTE: Only use mediaopt to set the driver to full-duplex. If mediaopt is
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi not specified and you are not running at gigabit speed, the driver
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi defaults to half-duplex.
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert MustacchiIf the interface is currently forced to 100 full duplex, in order to change
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchito half duplex you must use this command:
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi ifconfig em<interface_num> <IP_address> media 100baseTX -mediaopt
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi full-duplex
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert MustacchiThis driver supports the following media type options:
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi autoselect - Enables auto-negotiation for speed and duplex.
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi 10baseT/UTP - Sets speed to 10 Mbps. Use the ifconfig mediaopt
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi option to select full-duplex mode.
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi 100baseTX - Sets speed to 100 Mbps. Use the ifconfig mediaopt
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi option to select full-duplex mode.
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi 1000baseTX - Sets speed to 1000 Mbps. In this case, the driver
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi supports only full-duplex mode.
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi 1000baseSX - Sets speed to 1000 Mbps. In this case, the driver
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi supports only full-duplex mode.
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert MustacchiFor more information on the ifconfig utility, see the ifconfig man page.
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert MustacchiAdditional Configurations
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi=========================
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert MustacchiThe driver supports Transmit/Receive Checksum Offload and Jumbo Frames on
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchiall but the 82542-based adapters. For specific adapters, refer to the
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert MustacchiIdentifying Your Adapter section.
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi Jumbo Frames
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi ------------
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi To enable Jumbo Frames, use the ifconfig utility to set the Maximum
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi Transport Unit (MTU) frame size above its default of 1500 bytes.
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi The Jumbo Frames MTU range for Intel Adapters is 1500 to 16110. To modify
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi the setting, enter the following:
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi ifconfig em<interface_num> <hostname or IP address> mtu 9000
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi To confirm the MTU used between two specific devices, use:
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi route get <destination_IP_address>
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi Notes:
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi - Only enable Jumbo Frames if your network infrastructure supports them.
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi - To enable Jumbo Frames, increase the MTU size on the interface beyond
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi 1500.
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi - The Jumbo Frames setting on the switch must be set to at least 22 bytes
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi larger than that of the MTU.
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi - The maximum MTU setting for Jumbo Frames is 16110. This value coincides
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi with the maximum Jumbo Frames size of 16128.
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi - Some Intel gigabit adapters that support Jumbo Frames have a frame size
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi limit of 9238 bytes, with a corresponding MTU size limit of 9216 bytes.
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi The adapters with this limitation are based on the Intel(R) 82571EB,
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi 82572EI, 82573L, 82566, 82562, and 80003ES2LAN controller. These
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi correspond to the following product names:
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi Intel(R) PRO/1000 PT Server Adapter
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi Intel(R) PRO/1000 PT Desktop Adapter
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi Intel(R) PRO/1000 PT Network Connection
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi Intel(R) PRO/1000 PT Dual Port Server Adapter
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi Intel(R) PRO/1000 PT Dual Port Network Connection
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi Intel(R) PRO/1000 PT Quad Port Server Adapter
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi Intel(R) PRO/1000 PF Quad Port Server Adapter
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi Intel(R) PRO/1000 PF Server Adapter
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi Intel(R) PRO/1000 PF Network Connection
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi Intel(R) PRO/1000 PF Dual Port Server Adapter
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi Intel(R) PRO/1000 PB Server Connection
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi Intel(R) PRO/1000 PL Network Connection
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi Intel(R) PRO/1000 EB Network Connection with I/O Acceleration
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi Intel(R) PRO/1000 EB Backplane Connection with I/O Acceleration
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi Intel(R) 82566DM-2 Gigabit Network Connection
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi - Adapters based on the Intel(R) 82542 and 82573V/E controller do not
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi support Jumbo Frames. These correspond to the following product names:
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi Intel(R) PRO/1000 Gigabit Server Adapter
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi Intel(R) PRO/1000 PM Network Connection
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi - Using Jumbo Frames at 10 or 100 Mbps may result in poor performance or
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi loss of link.
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi - The following adapters do not support Jumbo Frames:
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi Intel(R) 82562V 10/100 Network Connection
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi Intel(R) 82566DM Gigabit Network Connection
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi Intel(R) 82566DC Gigabit Network Connection
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi Intel(R) 82566MM Gigabit Network Connection
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi Intel(R) 82566MC Gigabit Network Connection
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi Intel(R) 82562GT 10/100 Network Connection
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi Intel(R) 82562G 10/100 Network Connection
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi Intel(R) 82566DC-2 Gigabit Network Connection
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi Intel(R) 82562V-2 10/100 Network Connection
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi Intel(R) 82562G-2 10/100 Network Connection
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi Intel(R) 82562GT-2 10/100 Network Connection
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi VLANs
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi -----
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi To create a new VLAN interface:
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi ifconfig <vlan_name> create
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi To associate the VLAN interface with a physical interface and
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi assign a VLAN ID, IP address, and netmask:
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi ifconfig <vlan_name> <ip_address> netmask <subnet_mask> vlan
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi <vlan_id> vlandev <physical_interface>
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi Example:
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi ifconfig vlan10 10.0.0.1 netmask 255.255.255.0 vlan 10 vlandev em0
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi In this example, all packets will be marked on egress with 802.1Q VLAN
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi tags, specifying a VLAN ID of 10.
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi To remove a VLAN interface:
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi Intel Network Connection ifconfig <vlan_name> destroy
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi Polling
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi -------
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi To enable polling in the driver, add the following options to the kernel
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi configuration, and then recompile the kernel:
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi options DEVICE_POLLING
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi options HZ=1000
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi At runtime use:
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi ifconfig emX polling (to turn polling on)
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi and:
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi ifconfig emX -polling (to turn it off)
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi Checksum Offload
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi ----------------
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi Checksum offloading is not supported on 82542 Gigabit adapters.
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi Checksum offloading supports both TCP and UDP packets and is
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi supported for both transmit and receive.
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi Checksum offloading can be enabled or disabled using ifconfig.
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi Both transmit and receive offloading will be either enabled or
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi disabled together. You cannot enable/disable one without the other.
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi To enable checksum offloading:
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi ifconfig <interface_num> rxcsum
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi To disable checksum offloading:
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi ifconfig <interface_num> -rxcsum
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi To confirm the current setting:
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi ifconfig <interface_num>
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi Look for the presence or absence of the following line:
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi options=3 <RXCSUM,TXCSUM>
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi See the ifconfig man page for further information.
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi TSO
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi ---
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi The FreeBSD driver offers support for TSO (TCP Segmentation Offload).
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi You can enable/disable it in two ways/places:
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi - sysctl net.inet.tcp.tso=0 (or 1 to enable it)
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi Doing this disables TSO in the stack and will affect all adapters.
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi - ifconfig emX -tso
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi Doing this will disable TSO only for this adapter.
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi To enable:
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi - ifconfig emX tso
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi NOTES: By default only PCI-Express adapters are ENABLED to do TSO. Others
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi can be enabled by the user at their own risk
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi TSO is not supported on 82547 and 82544-based adapters, as well as older adapters.
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert MustacchiKnown Limitations
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi=================
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi Detected Tx Unit Hang in Quad Port Adapters
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi -------------------------------------------
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi In some cases ports 3 and 4 wont pass traffic. Ports 1 and 2 don't show
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi any errors and will pass traffic.
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi This issue MAY be resolved by updating to the latest BIOS. You can
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi check your system's BIOS by downloading the Linux Firmware Developer Kit
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi that can be obtained at http://www.linuxfirmwarekit.org/
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi There are known performance issues with this driver when running UDP traffic
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi with Jumbo Frames.
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi ----------------------------------------------------------------------------
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi 82541/82547 can't link or is slow to link with some link partners
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi -----------------------------------------------------------------
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi There is a known compatibility issue where time to link is slow or link is not
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi established between 82541/82547 controllers and some switches. Known switches
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi include:
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi Planex FXG-08TE
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi I-O Data ETG-SH8
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi Netgear GS105v3
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi The driver can be compiled with the following changes:
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi Edit ./em.x.x.x/src/if_em.h to change the #define EM_MASTER_SLAVE
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi For example, change from:
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi #define EM_MASTER_SLAVE e1000_ms_hw_default
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi to:
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi #define EM_MASTER_SLAVE 2
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi Use one of the following options:
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi 1 = Master mode
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi 2 = Slave mode
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi 3 = Auto master/slave
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi Setting 2 is recommended.
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi Recompile the module:
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi a. To compile the module
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi cd em-x.x.x
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi make clean
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi make
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi b. To install the compiled module in system directory:
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi make install
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert MustacchiSupport
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi=======
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert MustacchiFor general information and support, go to the Intel support website at:
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi http://support.intel.com
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert MustacchiIf an issue is identified, support is through email only at:
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchifreebsd@intel.com
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert MustacchiLicense
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi=======
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert MustacchiThis software program is released under the terms of a license agreement
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchibetween you ('Licensee') and Intel. Do not use or load this software or any
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchiassociated materials (collectively, the 'Software') until you have carefully
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchiread the full terms and conditions of the LICENSE located in this software
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchipackage. By loading or using the Software, you agree to the terms of this
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert MustacchiAgreement. If you do not agree with the terms of this Agreement, do not
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchiinstall or use the Software.
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi
75eba5b6d79ed4d2ce3daf7b2806306b6b69a938Robert Mustacchi* Other names and brands may be claimed as the property of others.