1.\" Copyright (c) 2002 Intel Corporation 2.\" All rights reserved. 3.\" Redistribution and use in source and binary forms of the Software, with or without 4.\" modification, are permitted provided that the following conditions 5.\" are met: 6.\" 1. Redistributions of source code of the Software may retain the above 7.\" copyright notice, this list of conditions and the following disclaimer. 8.\" 2. Redistributions in binary form of the Software may reproduce the 9.\" above copyright notice, this list of conditions and the following 10.\" disclaimer in the documentation and/or other materials provided with the 11.\" distribution. 12.\" 3. Neither the name of the Intel Corporation nor the names of its contributors 13.\" shall be used to endorse or promote products derived from this Software 14.\" without specific prior written permission. 15.\" 16.\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" 17.\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 18.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 19.\" ARE DISCLAIMED. IN NO EVENT SHALL THE INTEL OR ITS CONTRIBUTORS BE LIABLE 20.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 21.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR 22.\" SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER 23.\" CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, 24.\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE 25.\" USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 26.\" 27.\" * Other names and brands may be claimed as the property of others. 28.\" 29.\" $FreeBSD$ 30.\" 31.Dd April 5, 2002 32.Dt EM 4 33.Os 34.Sh NAME 35.Nm em 36.Nd "Intel(R) PRO/1000 gigabit Ethernet driver for the FreeBSD operating system" 37.Sh SYNOPSIS 38.Cd "device em" 39.Sh DESCRIPTION 40The 41.Nm 42driver provides support for PCI gigabit Ethernet adapters based on 43the Intel 82540, 82542, 82543 and 82544 Ethernet controller chip. 44The driver supports Transmit/Receive checksum offload 45and Jumbo Frames only on 82540, 82543 and 82544-based adapters. 46For a list of supported adapters, see the 47.Pa README 48included with the driver. 49.Pp 50For questions related to hardware requirements, 51refer to the documentation supplied with your Intel PRO/1000 adapter. 52All hardware requirements listed apply to use with 53.Fx . 54.Pp 55Support for Jumbo Frames is provided via the interface MTU setting. 56Selecting an MTU larger than 1500 bytes with the 57.Xr ifconfig 8 58utility configures the adapter to receive and transmit Jumbo Frames. 59The maximum MTU size for Jumbo Frames is 16114. 60.Pp 61The 62.Nm 63driver supports the following media types: 64.Bl -tag -width ".Cm 10baseT/UTP" 65.It Cm autoselect 66Enables auto-negotiation for speed and duplex. 67.It Cm 10baseT/UTP 68Sets 10Mbps operation. 69Use the 70.Cm mediaopt 71option to select 72.Cm full-duplex 73mode. 74.It Cm 100baseTX 75Sets 100Mbps operation. 76Use the 77.Cm mediaopt 78option to select 79.Cm full-duplex 80mode. 81.It Cm 1000baseSX 82Sets 1000Mbps operation. 83Only 84.Cm full-duplex 85mode is supported at this speed. 86.It Cm 1000baseTX 87Sets 1000Mbps operation. 88Only 89.Cm full-duplex 90mode is supported at this speed. 91.El 92.Pp 93The 94.Nm 95driver supports the following media options: 96.Bl -tag -width ".Cm full-duplex" 97.It Cm full-duplex 98Forces full-duplex operation 99.It Cm half-duplex 100Forces half-duplex operation. 101.El 102.Pp 103Only use 104.Cm mediaopt 105to set the driver to 106.Cm full-duplex . 107If 108.Cm mediaopt 109is not specified, the driver defaults to 110.Cm half-duplex . 111.Pp 112For more information on configuring this device, see 113.Xr ifconfig 8 . 114.Sh DIAGNOSTICS 115.Bl -diag 116.It "em%d: Unable to allocate bus resource: memory" 117A fatal initialization error has occurred. 118.It "em%d: Unable to allocate bus resource: interrupt" 119A fatal initialization error has occurred. 120.It "em%d: watchdog timeout -- resetting" 121The device has stopped responding to the network, or there is a problem with 122the network connection (cable). 123.El 124.Sh SUPPORT 125For additional information regarding building and installation, 126see the 127.Pa README 128included with the driver. 129For general information and support, 130go to the Intel support website at: 131.Pa http://support.intel.com . 132.Pp 133If an issue is identified with the released source code on the supported kernel 134with a supported adapter, email the specific information related to the 135issue to 136.Aq freebsdnic@mailbox.intel.com . 137.Sh SEE ALSO 138.Xr arp 4 , 139.Xr gx 4 , 140.Xr netintro 4 , 141.Xr ng_ether 4 , 142.Xr vlan 4 , 143.Xr ifconfig 8 144.Sh HISTORY 145The 146.Nm 147device driver first appeared in 148.Fx 4.4 . 149.Sh AUTHORS 150The 151.Nm 152driver was written by 153.An Intel Corporation Aq freebsdnic@mailbox.intel.com . 154