3 FreeBSD* Driver for the Intel(R) PRO/1000 Family of Adapters
4 ============================================================
14 - Building and Installation
15 - Speed and Duplex Configuration
16 - Additional Configurations
25 This file describes the FreeBSD* driver, version 1.3.x, for the Intel(R)
26 PRO/1000 Family of Adapters. This driver has been developed for use with
29 The driver supports Transmit/Receive Checksum Offload and Jumbo Frames on
30 all but the 82542-based adapters. For specific adapters, refer to the
31 Supported Adapters section below.
33 Support for VLANs has been added as a new feature in this driver version.
35 For questions related to hardware requirements, refer to the documentation
36 supplied with your Intel PRO/1000 adapter. All hardware requirements listed
37 apply to use with FreeBSD.
43 The following Intel network adapters are compatible with the drivers in this
46 Controller Adapter Name Board IDs
47 ---------- ------------ ---------
49 82542 PRO/1000 Gigabit Server Adapter 700262-xxx, 717037-xxx
51 82543 PRO/1000 F Server Adapter 738640-xxx, A38888-xxx,
54 82543 PRO/1000 T Server Adapter A19845-xxx, A33948-xxx
56 82544 PRO/1000 XT Server Adapter A51580-xxx
58 82544 PRO/1000 XF Server Adapter A50484-xxx
60 82544 PRO/1000 T Desktop Adapter A62947-xxx
62 82540 PRO/1000 MT Desktop Adapter A78708-xxx
64 82545 PRO/1000 MT Server Adapter A92165-xxx
66 82545 PRO/1000 MF Server Adapter A91622-xxx
68 82545 PRO/1000 MF Server Adapter(LX) A91624-xxx
70 82546 PRO/1000 MT Dual Port Server Adapter A92111-xxx
72 82546 PRO/1000 MF Dual Port Server Adapter A91620-xxx
75 To verify your Intel adapter is supported, find the board ID number on the
76 adapter. Look for a label that has a barcode and a number in the format of
77 123456-001 (six digits hyphen three digits). Match this to the list of
80 For more information on how to identify your adapter, go to the Adapter &
83 http://support.intel.com/support/network/adapter/pro100/21397.htm
85 For the latest Intel network drivers for FreeBSD, see:
87 http://appsr.intel.com/scripts-df/support_intel.asp
90 Building and Installation
91 =========================
93 NOTE: You must have kernel sources installed in order to compile the driver
96 In the instructions below, x.x.x is the driver version as indicated in
97 the name of the driver tar.
100 1. Move the base driver tar file to the directory of your choice. For
101 example, use /home/username/em or /usr/local/src/em.
103 2. Untar/unzip the archive:
105 tar xfz em-x.x.x.tar.gz
107 3. To load the driver onto a running system:
112 4. To assign an IP address to the interface, enter the following:
114 ifconfig em<interface_num> <IP_address>
116 5. Verify that the interface works. Enter the following, where <IP_address>
117 is the IP address for another machine on the same subnet as the interface
118 that is being tested:
122 6. If you want the driver to load automatically when the system is booted:
127 Edit /boot/loader.conf, and add the following line:
133 compile the driver into the kernel (see item 7).
136 Edit /etc/rc.conf, and create the appropriate ifconfig_em<interface_num>
139 ifconfig_em<interface_num>="<ifconfig_settings>"
143 ifconfig_em0="inet 192.168.10.1 netmask 255.255.255.0"
145 NOTE: For assistance, see the ifconfig man page.
147 7. If you want to compile the driver into the kernel, enter:
149 mkdir /usr/src/sys/dev/em
151 cp if_em* /usr/src/sys/dev/em
152 mkdir /usr/src/sys/modules/em
153 cp Makefile /usr/src/sys/modules/em
155 Edit Makefile at /usr/src/sys/modules to add the em subdirectory.
157 Edit your config file and add the following line, if it is not already
162 Edit your config file, and remove the 'device wx' line from the file.
164 Edit the /usr/src/sys/conf/files.i386 file, and add the following lines:
166 dev/em/if_em.c optional em
167 dev/em/if_em_hw.c optional em
169 Remove the following files from the /usr/src/sys/conf/files.i386 file, if
175 Compile and install the kernel.
178 Speed and Duplex Configuration
179 ==============================
181 By default, the adapter auto-negotiates the speed and duplex of the
182 connection. If there is a specific need, the ifconfig utility can be used to
183 configure the speed and duplex settings on the adapter. Example usage:
185 ifconfig em<interface_num> <IP_address> media 100baseTX mediaopt
188 NOTE: Only use mediaopt to set the driver to full-duplex. If mediaopt is
189 not specified and you are not running at gigabit speed, the driver
190 defaults to half-duplex.
193 This driver supports the following media type options:
195 autoselect - Enables auto-negotiation for speed and duplex.
197 10baseT/UTP - Sets speed to 10 Mbps. Use the ifconfig mediaopt
198 option to select full-duplex mode.
200 100baseTX - Sets speed to 100 Mbps. Use the ifconfig mediaopt
201 option to select full-duplex mode.
203 1000baseTX - Sets speed to 1000 Mbps. In this case, the driver
204 supports only full-duplex mode.
206 1000baseSX - Sets speed to 1000 Mbps. In this case, the driver
207 supports only full-duplex mode.
209 For more information on the ifconfig utility, see the ifconfig man page.
212 Additional Configurations
213 =========================
218 To enable Jumbo Frames, use the ifconfig utility to increase the MTU
221 NOTE: Only enable Jumbo Frames if your network infrastructure supports
224 The MTU range for Jumbo Frames is 1500 to 16114. For example, enter the
227 ifconfig em<interface_num> mtu 9000
232 To enable VLANs in the kernel, modify the config file as follows:
234 pseudo-device vlan <num_VLANs>
236 Then, recompile the kernel and reboot.
238 To see the VLAN device entries, use ifconfig.
240 To attach a VLAN to the driver enter the following:
242 ifconfig vlan0 inet 10.0.0.1 netmask 255.255.255.0 vlan 1 vlandev
245 Also, bring the driver up by entering:
253 There are known performance problems with this driver when running UDP
254 traffic with Jumbo Frames. Intel recommends not using Jumbo Frames for UDP
261 For general information and support, go to the Intel support website at:
263 http://support.intel.com
265 If an issue is identified with the released source code on the supported
266 kernel with a supported adapter, email the specific information related to
267 the issue to freebsdnic@mailbox.intel.com.
273 This software program is released under the terms of a license agreement
274 between you ('Licensee') and Intel. Do not use or load this software or any
275 associated materials (collectively, the 'Software') until you have carefully
276 read the full terms and conditions of the LICENSE located in this software
277 package. By loading or using the Software, you agree to the terms of this
278 Agreement. If you do not agree with the terms of this Agreement, do not
279 install or use the Software.
281 * Other names and brands may be claimed as the property of others.