xref: /freebsd/share/man/man4/em.4 (revision 7d9c45655d568b3d2423e4d42b0a5f14b98d9701)
1c2183496SPrafulla Deuskar.\" Copyright (c) 2001-2003, Intel Corporation
21ac88dc0SPrafulla Deuskar.\" All rights reserved.
3c2183496SPrafulla Deuskar.\"
4c2183496SPrafulla Deuskar.\" Redistribution and use in source and binary forms, with or without
5c2183496SPrafulla Deuskar.\" modification, are permitted provided that the following conditions are met:
6c2183496SPrafulla Deuskar.\"
7c2183496SPrafulla Deuskar.\" 1. Redistributions of source code must retain the above copyright notice,
8c2183496SPrafulla Deuskar.\"    this list of conditions and the following disclaimer.
9c2183496SPrafulla Deuskar.\"
10c2183496SPrafulla Deuskar.\" 2. Redistributions in binary form must reproduce the above copyright
11c2183496SPrafulla Deuskar.\"    notice, this list of conditions and the following disclaimer in the
12c2183496SPrafulla Deuskar.\"    documentation and/or other materials provided with the distribution.
13c2183496SPrafulla Deuskar.\"
14c2183496SPrafulla Deuskar.\" 3. Neither the name of the Intel Corporation nor the names of its
15c2183496SPrafulla Deuskar.\"    contributors may be used to endorse or promote products derived from
16c2183496SPrafulla Deuskar.\"    this software without specific prior written permission.
171ac88dc0SPrafulla Deuskar.\"
181ac88dc0SPrafulla Deuskar.\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
191ac88dc0SPrafulla Deuskar.\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
201ac88dc0SPrafulla Deuskar.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
21c2183496SPrafulla Deuskar.\" ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
22c2183496SPrafulla Deuskar.\" LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
23c2183496SPrafulla Deuskar.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
24c2183496SPrafulla Deuskar.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
25c2183496SPrafulla Deuskar.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
26c2183496SPrafulla Deuskar.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
27c2183496SPrafulla Deuskar.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
28c2183496SPrafulla Deuskar.\" POSSIBILITY OF SUCH DAMAGE.
291ac88dc0SPrafulla Deuskar.\"
30e4fe103dSPrafulla Deuskar.\" * Other names and brands may be claimed as the property of others.
31802a4af8SRuslan Ermilov.\"
32e4fe103dSPrafulla Deuskar.\" $FreeBSD$
335461e585SPrafulla Deuskar.\"
347d9c4565SChristian Brueffer.Dd January 5, 2005
351ac88dc0SPrafulla Deuskar.Dt EM 4
36802a4af8SRuslan Ermilov.Os
371ac88dc0SPrafulla Deuskar.Sh NAME
381ac88dc0SPrafulla Deuskar.Nm em
397d9c4565SChristian Brueffer.Nd "Intel(R) PRO/1000 Gigabit Ethernet adapter driver"
401ac88dc0SPrafulla Deuskar.Sh SYNOPSIS
411ac88dc0SPrafulla Deuskar.Cd "device em"
421ac88dc0SPrafulla Deuskar.Sh DESCRIPTION
431ac88dc0SPrafulla DeuskarThe
441ac88dc0SPrafulla Deuskar.Nm
4591461de4SChristian Bruefferdriver provides support for PCI Gigabit Ethernet adapters based on
467d9c4565SChristian Bruefferthe Intel 82540, 82541ER, 82541PI, 82542, 82543, 82544, 82545, 82546,
477d9c4565SChristian Brueffer82546EB, 82546GB and 82547 Ethernet controller chips.
481ac88dc0SPrafulla DeuskarThe driver supports Transmit/Receive checksum offload
495155b8e2SPrafulla Deuskarand Jumbo Frames only on 82540, 82543, 82544 and 82546-based adapters.
5091461de4SChristian BruefferFor further hardware information, see the
51802a4af8SRuslan Ermilov.Pa README
521ac88dc0SPrafulla Deuskarincluded with the driver.
531ac88dc0SPrafulla Deuskar.Pp
541ac88dc0SPrafulla DeuskarFor questions related to hardware requirements,
551ac88dc0SPrafulla Deuskarrefer to the documentation supplied with your Intel PRO/1000 adapter.
56802a4af8SRuslan ErmilovAll hardware requirements listed apply to use with
57802a4af8SRuslan Ermilov.Fx .
581ac88dc0SPrafulla Deuskar.Pp
59a59716d2SPrafulla DeuskarSupport for Jumbo Frames is provided via the interface MTU setting.
601ac88dc0SPrafulla DeuskarSelecting an MTU larger than 1500 bytes with the
611ac88dc0SPrafulla Deuskar.Xr ifconfig 8
62a59716d2SPrafulla Deuskarutility configures the adapter to receive and transmit Jumbo Frames.
63a59716d2SPrafulla DeuskarThe maximum MTU size for Jumbo Frames is 16114.
641ac88dc0SPrafulla Deuskar.Pp
655461e585SPrafulla DeuskarThis driver version supports VLANs.
665461e585SPrafulla DeuskarFor information on enabling VLANs, see the
675155b8e2SPrafulla Deuskar.Pa README .
681ac88dc0SPrafulla DeuskarThe
691ac88dc0SPrafulla Deuskar.Nm
701ac88dc0SPrafulla Deuskardriver supports the following media types:
71802a4af8SRuslan Ermilov.Bl -tag -width ".Cm 10baseT/UTP"
72802a4af8SRuslan Ermilov.It Cm autoselect
731ac88dc0SPrafulla DeuskarEnables auto-negotiation for speed and duplex.
74802a4af8SRuslan Ermilov.It Cm 10baseT/UTP
751ac88dc0SPrafulla DeuskarSets 10Mbps operation.
76a59716d2SPrafulla DeuskarUse the
77802a4af8SRuslan Ermilov.Cm mediaopt
78a59716d2SPrafulla Deuskaroption to select
79802a4af8SRuslan Ermilov.Cm full-duplex
80a59716d2SPrafulla Deuskarmode.
81802a4af8SRuslan Ermilov.It Cm 100baseTX
821ac88dc0SPrafulla DeuskarSets 100Mbps operation.
83a59716d2SPrafulla DeuskarUse the
84802a4af8SRuslan Ermilov.Cm mediaopt
85a59716d2SPrafulla Deuskaroption to select
86802a4af8SRuslan Ermilov.Cm full-duplex
87a59716d2SPrafulla Deuskarmode.
88802a4af8SRuslan Ermilov.It Cm 1000baseSX
891ac88dc0SPrafulla DeuskarSets 1000Mbps operation.
901ac88dc0SPrafulla DeuskarOnly
91802a4af8SRuslan Ermilov.Cm full-duplex
921ac88dc0SPrafulla Deuskarmode is supported at this speed.
93802a4af8SRuslan Ermilov.It Cm 1000baseTX
941ac88dc0SPrafulla DeuskarSets 1000Mbps operation.
951ac88dc0SPrafulla DeuskarOnly
96802a4af8SRuslan Ermilov.Cm full-duplex
971ac88dc0SPrafulla Deuskarmode is supported at this speed.
981ac88dc0SPrafulla Deuskar.El
991ac88dc0SPrafulla Deuskar.Pp
1001ac88dc0SPrafulla DeuskarThe
1011ac88dc0SPrafulla Deuskar.Nm
1021ac88dc0SPrafulla Deuskardriver supports the following media options:
103802a4af8SRuslan Ermilov.Bl -tag -width ".Cm full-duplex"
104802a4af8SRuslan Ermilov.It Cm full-duplex
105a59716d2SPrafulla DeuskarForces full-duplex operation
106802a4af8SRuslan Ermilov.It Cm half-duplex
107a59716d2SPrafulla DeuskarForces half-duplex operation.
1081ac88dc0SPrafulla Deuskar.El
1091ac88dc0SPrafulla Deuskar.Pp
110802a4af8SRuslan ErmilovOnly use
111802a4af8SRuslan Ermilov.Cm mediaopt
112802a4af8SRuslan Ermilovto set the driver to
113802a4af8SRuslan Ermilov.Cm full-duplex .
114802a4af8SRuslan ErmilovIf
115802a4af8SRuslan Ermilov.Cm mediaopt
116802a4af8SRuslan Ermilovis not specified, the driver defaults to
117802a4af8SRuslan Ermilov.Cm half-duplex .
118a59716d2SPrafulla Deuskar.Pp
1191ac88dc0SPrafulla DeuskarFor more information on configuring this device, see
1201ac88dc0SPrafulla Deuskar.Xr ifconfig 8 .
12191461de4SChristian Brueffer.Sh HARDWARE
12291461de4SChristian BruefferThe
12391461de4SChristian Brueffer.Nm
12491461de4SChristian Bruefferdriver supports Gigabit Ethernet adapters based on the Intel
1257d9c4565SChristian Brueffer82540, 82541ER, 82541PI, 82542, 82543, 82544, 82545, 82546, 82546EB,
1267d9c4565SChristian Brueffer82546GB and 82547 controller chips:
12791461de4SChristian Brueffer.Pp
12891461de4SChristian Brueffer.Bl -bullet -compact
12991461de4SChristian Brueffer.It
13091461de4SChristian BruefferIntel PRO/1000 CT Network Connection (82547)
13191461de4SChristian Brueffer.It
13291461de4SChristian BruefferIntel PRO/1000 F Server Adapter (82543)
13391461de4SChristian Brueffer.It
13491461de4SChristian BruefferIntel PRO/1000 Gigabit Server Adapter (82542)
13591461de4SChristian Brueffer.It
13691461de4SChristian BruefferIntel PRO/1000 GT Desktop Adapter (82541PI)
13791461de4SChristian Brueffer.It
13891461de4SChristian BruefferIntel PRO/1000 MF Dual Port Server Adapter (82546)
13991461de4SChristian Brueffer.It
14091461de4SChristian BruefferIntel PRO/1000 MF Server Adapter (82545)
14191461de4SChristian Brueffer.It
14291461de4SChristian BruefferIntel PRO/1000 MF Server Adapter (LX) (82545)
14391461de4SChristian Brueffer.It
14491461de4SChristian BruefferIntel PRO/1000 MT Desktop Adapter (82540)
14591461de4SChristian Brueffer.It
14691461de4SChristian BruefferIntel PRO/1000 MT Desktop Adapter (82541)
14791461de4SChristian Brueffer.It
14891461de4SChristian BruefferIntel PRO/1000 MT Dual Port Server Adapter (82546)
14991461de4SChristian Brueffer.It
15091461de4SChristian BruefferIntel PRO/1000 MT Quad Port Server Adapter (82546EB)
15191461de4SChristian Brueffer.It
15291461de4SChristian BruefferIntel PRO/1000 MT Server Adapter (82545)
15391461de4SChristian Brueffer.It
15491461de4SChristian BruefferIntel PRO/1000 T Desktop Adapter (82544)
15591461de4SChristian Brueffer.It
15691461de4SChristian BruefferIntel PRO/1000 T Server Adapter (82543)
15791461de4SChristian Brueffer.It
15891461de4SChristian BruefferIntel PRO/1000 XF Server Adapter (82544)
15991461de4SChristian Brueffer.It
16091461de4SChristian BruefferIntel PRO/1000 XT Server Adapter (82544)
16191461de4SChristian Brueffer.El
1621ac88dc0SPrafulla Deuskar.Sh DIAGNOSTICS
1631ac88dc0SPrafulla Deuskar.Bl -diag
1641ac88dc0SPrafulla Deuskar.It "em%d: Unable to allocate bus resource: memory"
1651ac88dc0SPrafulla DeuskarA fatal initialization error has occurred.
1661ac88dc0SPrafulla Deuskar.It "em%d: Unable to allocate bus resource: interrupt"
1671ac88dc0SPrafulla DeuskarA fatal initialization error has occurred.
1681ac88dc0SPrafulla Deuskar.It "em%d: watchdog timeout -- resetting"
1691ac88dc0SPrafulla DeuskarThe device has stopped responding to the network, or there is a problem with
1701ac88dc0SPrafulla Deuskarthe network connection (cable).
1711ac88dc0SPrafulla Deuskar.El
1721ac88dc0SPrafulla Deuskar.Sh SUPPORT
1731ac88dc0SPrafulla DeuskarFor additional information regarding building and installation,
174802a4af8SRuslan Ermilovsee the
175802a4af8SRuslan Ermilov.Pa README
176802a4af8SRuslan Ermilovincluded with the driver.
177802a4af8SRuslan ErmilovFor general information and support,
178a59716d2SPrafulla Deuskargo to the Intel support website at:
179802a4af8SRuslan Ermilov.Pa http://support.intel.com .
1801ac88dc0SPrafulla Deuskar.Pp
1811ac88dc0SPrafulla DeuskarIf an issue is identified with the released source code on the supported kernel
1821ac88dc0SPrafulla Deuskarwith a supported adapter, email the specific information related to the
183802a4af8SRuslan Ermilovissue to
184802a4af8SRuslan Ermilov.Aq freebsdnic@mailbox.intel.com .
1851ac88dc0SPrafulla Deuskar.Sh SEE ALSO
1861ac88dc0SPrafulla Deuskar.Xr arp 4 ,
1871ac88dc0SPrafulla Deuskar.Xr netintro 4 ,
188e4fe103dSPrafulla Deuskar.Xr ng_ether 4 ,
189a6c410e7SChristian Brueffer.Xr polling 4 ,
190999e589bSRuslan Ermilov.Xr vlan 4 ,
1911ac88dc0SPrafulla Deuskar.Xr ifconfig 8
1921ac88dc0SPrafulla Deuskar.Sh HISTORY
1931ac88dc0SPrafulla DeuskarThe
1941ac88dc0SPrafulla Deuskar.Nm
1951ac88dc0SPrafulla Deuskardevice driver first appeared in
196a59716d2SPrafulla Deuskar.Fx 4.4 .
1971ac88dc0SPrafulla Deuskar.Sh AUTHORS
1981ac88dc0SPrafulla DeuskarThe
1991ac88dc0SPrafulla Deuskar.Nm
2001ac88dc0SPrafulla Deuskardriver was written by
2011ac88dc0SPrafulla Deuskar.An Intel Corporation Aq freebsdnic@mailbox.intel.com .
202