1.\" Copyright (c) 2001-2003, Intel Corporation 2.\" All rights reserved. 3.\" 4.\" Redistribution and use in source and binary forms, with or without 5.\" modification, are permitted provided that the following conditions are met: 6.\" 7.\" 1. Redistributions of source code must retain the above copyright notice, 8.\" this list of conditions and the following disclaimer. 9.\" 10.\" 2. Redistributions in binary form must reproduce the above copyright 11.\" notice, this list of conditions and the following disclaimer in the 12.\" documentation and/or other materials provided with the distribution. 13.\" 14.\" 3. Neither the name of the Intel Corporation nor the names of its 15.\" contributors may be used to endorse or promote products derived from 16.\" this software without specific prior written permission. 17.\" 18.\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" 19.\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 20.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 21.\" ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE 22.\" LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 23.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 24.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 25.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 26.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 27.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 28.\" POSSIBILITY OF SUCH DAMAGE. 29.\" 30.\" * Other names and brands may be claimed as the property of others. 31.\" 32.\" $FreeBSD: src/share/man/man4/em.4,v 1.2.2.6 2003/02/01 01:21:31 pdeuskar Exp $ 33.\" $DragonFly: src/share/man/man4/em.4,v 1.9 2007/03/08 11:20:56 swildner Exp $ 34.\" 35.Dd March 4, 2007 36.Dt EM 4 37.Os 38.Sh NAME 39.Nm em 40.Nd "Intel(R) PRO/1000 gigabit Ethernet driver" 41.Sh SYNOPSIS 42.Cd "device em" 43.Sh DESCRIPTION 44The 45.Nm 46driver provides support for PCI gigabit Ethernet adapters based on 47the Intel 82540, 82541, 82542, 82543, 82544, 82546, and 82547 Ethernet 48controller chips. 49The driver does not support Transmit/Receive checksum offload and 50Jumbo Frames on adapters based on the Intel 82542 and 82573 LAN controllers. 51For a list of supported adapters, see the 52.Pa README 53included with the driver. 54.Pp 55For questions related to hardware requirements, 56refer to the documentation supplied with your Intel PRO/1000 adapter. 57All hardware requirements listed apply to use with 58.Dx . 59.Pp 60Support for Jumbo Frames is provided via the interface MTU setting. 61Selecting an MTU larger than 1500 bytes with the 62.Xr ifconfig 8 63utility configures the adapter to receive and transmit Jumbo Frames. 64The maximum MTU setting for Jumbo Frames is 16110. 65This value coincides with the maximum Jumbo Frames size of 16128. 66Some Intel gigabit adapters that support Jumbo Frames have a frame size 67limit of 9238 bytes, with a corresponding MTU size limit of 9216 bytes. 68The adapters with this limitation are based on the Intel(R) 6982571EB, 82572EI, 82573L, 82563EB and 82564EI LAN controllers. 70.Pp 71The following Intel gigabit LAN devices do not support Jumbo Frames: 72.Pp 73Intel(R) PRO/1000 PM Network Connection 74.Pp 75Adapters based on the Intel(R) 82542 and 82573 LAN controllers. 76.Pp 77This driver version supports VLANs. 78For information on enabling VLANs, 79see the 80.Pa README . 81The 82.Nm 83driver supports the following media types: 84.Bl -tag -width ".Cm 10baseT/UTP" 85.It Cm autoselect 86Enables auto-negotiation for speed and duplex. 87.It Cm 10baseT/UTP 88Sets 10Mbps operation. 89Use the 90.Cm mediaopt 91option to select 92.Cm full-duplex 93mode. 94.It Cm 100baseTX 95Sets 100Mbps operation. 96Use the 97.Cm mediaopt 98option to select 99.Cm full-duplex 100mode. 101.It Cm 1000baseSX 102Sets 1000Mbps operation. 103Only 104.Cm full-duplex 105mode is supported at this speed. 106.It Cm 1000baseT 107Sets 1000Mbps operation. 108Only 109.Cm full-duplex 110mode is supported at this speed. 111.El 112.Pp 113The 114.Nm 115driver supports the following media options: 116.Bl -tag -width ".Cm full-duplex" 117.It Cm full-duplex 118Forces full-duplex operation 119.It Cm half-duplex 120Forces half-duplex operation. 121.El 122.Pp 123Only use 124.Cm mediaopt 125to set the driver to 126.Cm full-duplex . 127If 128.Cm mediaopt 129is not specified, the driver defaults to 130.Cm half-duplex . 131.Pp 132For more information on configuring this device, see 133.Xr ifconfig 8 . 134.Sh TUNABLES 135.Bl -tag -width ".Va hw.em.int_throttle_ceil" 136.It Va hw.em.int_throttle_ceil 137Hardware interrupt throttling rate. 138The default value is 10000Hz. 139.It Va hw.em.rxd 140Number of receive descriptors allocated by the driver. 141The default value is 256. 142The 82542 and 82543-based adapters can handle up to 256 descriptors, 143while others can have up to 4096. 144.It Va hw.em.txd 145Number of transmit descriptors allocated by the driver. 146The default value is 256. 147The 82542 and 82543-based adapters can handle up to 256 descriptors, 148while others can have up to 4096. 149.It Va hw.em.rx_int_delay 150This value delays the generation of receive interrupts in units of 1511.024 microseconds. 152The default value is 0, since adapters may hang with this feature 153being enabled. 154.It Va hw.em.rx_abs_int_delay 155If 156.Va hw.em.rx_int_delay 157is non-zero, this tunable limits the maximum delay in which a receive 158interrupt is generated. 159.It Va hw.em.tx_int_delay 160This value delays the generation of transmit interrupts in units of 1611.024 microseconds. 162The default value is 64. 163.It Va hw.em.tx_abs_int_delay 164If 165.Va hw.em.tx_int_delay 166is non-zero, this tunable limits the maximum delay in which a transmit 167interrupt is generated. 168.El 169.Sh DIAGNOSTICS 170.Bl -diag 171.It "em%d: Unable to allocate bus resource: memory" 172A fatal initialization error has occurred. 173.It "em%d: Unable to allocate bus resource: interrupt" 174A fatal initialization error has occurred. 175.It "em%d: watchdog timeout -- resetting" 176The device has stopped responding to the network, or there is a problem with 177the network connection (cable). 178.El 179.Sh SUPPORT 180For additional information regarding building and installation, 181see the 182.Pa README 183included with the driver. 184For general information and support, 185go to the Intel support website at: 186.Pa http://support.intel.com . 187.Pp 188If an issue is identified with the released source code on the supported kernel 189with a supported adapter, email the specific information related to the 190issue to 191.Aq freebsdnic@mailbox.intel.com . 192.Sh SEE ALSO 193.Xr arp 4 , 194.Xr gx 4 , 195.Xr ifmedia 4 , 196.Xr netintro 4 , 197.Xr ng_ether 4 , 198.Xr polling 4 , 199.Xr vlan 4 , 200.Xr ifconfig 8 201.Sh HISTORY 202The 203.Nm 204device driver first appeared in 205.Fx 4.4 . 206.Sh AUTHORS 207The 208.Nm 209driver was written by 210.An Intel Corporation Aq freebsdnic@mailbox.intel.com . 211