xref: /openbsd/share/man/man4/em.4 (revision 2a4cf147)
1.\" $OpenBSD: em.4,v 1.38 2008/10/25 03:44:14 jsg Exp $
2.\" Copyright (c) 2002 Intel Corporation
3.\" All rights reserved.
4.\" Redistribution and use in source and binary forms of the Software, with or without
5.\" modification, are permitted provided that the following conditions
6.\" are met:
7.\" 1. Redistributions of source code of the Software may retain the above
8.\" copyright notice, this list of conditions and the following disclaimer.
9.\" 2. Redistributions in binary form of the Software may reproduce the
10.\" above copyright notice, this list of conditions and the following
11.\" disclaimer in the documentation and/or other materials provided with the
12.\" distribution.
13.\" 3. Neither the name of the Intel Corporation nor the names of its contributors
14.\" shall be used to endorse or promote products derived from this Software
15.\" without specific prior written permission.
16.\"
17.\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
18.\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
19.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
20.\" ARE DISCLAIMED. IN NO EVENT SHALL THE INTEL OR ITS CONTRIBUTORS BE LIABLE
21.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
22.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
23.\" SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
24.\" CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
25.\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
26.\" USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
27.\"
28.\" * Other names and brands may be claimed as the property of others.
29.\"
30.\" $FreeBSD: em.4,v 1.18 2005/01/30 12:29:06 yar Exp $
31.Dd $Mdocdate: October 25 2008 $
32.Dt EM 4
33.Os
34.Sh NAME
35.Nm em
36.Nd Intel PRO/1000 10/100/Gigabit Ethernet device
37.Sh SYNOPSIS
38.Cd "em* at pci?"
39.Sh DESCRIPTION
40The
41.Nm
42driver provides support for PCI, PCI-X and PCI Express Gigabit Ethernet adapters
43based on the Intel 82540EM, 82540EP, 82541EI, 82541ER, 82541GI, 82541PI, 82542,
4482543GC, 82544EI, 82544GC, 82545EM, 82545GM, 82546EB, 82546GB, 82547EI, 82547GI,
4582562V, 82563EB, 82564EB, 82566DC, 82566DM, 82571EB, 82571GB, 82572EI, 82572GI,
4682573E, 82573L and
4782573V Ethernet controller chips.
48The driver supports IPv4 receive IP/TCP/UDP checksum offload on all but
4982542-based adapters and Jumbo frames on all but 82562V, 82566DC/82566DM and
5082573E/82573L/82573V-based adapters.
51The 82562V Ethernet controller chip only supports 10/100 media types.
52This includes the following models:
53.Pp
54.Bl -item -offset indent -compact
55.It
56HP ProLiant NC110T PCI Express Gigabit NIC
57.It
58HP ProLiant NC310F PCI-X Gigabit NIC (SX Fiber)
59.It
60HP ProLiant NC340T PCI-X Quad Port Gigabit NIC
61.It
62HP ProLiant NC360T PCI Express Dual Port Gigabit NIC
63.It
64HP ProLiant NC364T PCI Express Quad Port Gigabit NIC
65.It
66HP ProLiant NC6132 Upgrade Module (SX Fiber)
67.It
68HP ProLiant NC6133 Upgrade Module (LX Fiber)
69.It
70HP ProLiant NC6134 PCI Gigabit NIC (SX Fiber)
71.It
72HP ProLiant NC6136 PCI Gigabit NIC (SX Fiber)
73.It
74HP ProLiant NC6170 PCI-X Gigabit NIC (SX Fiber)
75.It
76HP ProLiant NC7131 PCI Gigabit NIC
77.It
78HP ProLiant NC7132 Upgrade Module
79.It
80HP ProLiant NC7170 PCI-X Dual Port Gigabit NIC
81.It
82HP ProLiant NC7170LP PCI-X Dual Port Gigabit NIC
83.It
84Intel PRO/1000 Gigabit Server Adapter (SX Fiber) (PWLA8490)
85.It
86Intel PRO/1000F Gigabit Server Adapter (SX Fiber) (PWLA8490SX)
87.It
88Intel PRO/1000T Server Adapter (PWLA8490T)
89.It
90Intel PRO/1000XT Server Adapter (PWLA8490XT)
91.It
92Intel PRO/1000XS Server Adapter (SX Fiber) (PWLA8490XF)
93.It
94Intel PRO/1000T Desktop Adapter (PWLA8390T)
95.It
96Intel PRO/1000XTL Low Profile PCI Server (PWLA8490XTL)
97.It
98Intel PRO/1000MT Desktop Adapter (PWLA8390MT)
99.It
100Intel PRO/1000MT Server Adapter (PWLA8490MT)
101.It
102Intel PRO/1000MT Dual Port Server Adapter (PWLA8492MT)
103.It
104Intel PRO/1000MF Server Adapter (SX Fiber) (PWLA8490MF)
105.It
106Intel PRO/1000MF Dual Port Server Adapter (SX Fiber) (PWLA8492MF)
107.It
108Intel PRO/1000MF Server Adapter (LX Fiber) (PWLA8490LX)
109.It
110Intel PRO/1000MT Quad PCI-X Adapter (PWLA8494MT)
111.It
112Intel PRO/1000GT Quad PCI-X Adapter (PWLA8494GT)
113.It
114Intel PRO/1000PT Desktop Adapter
115.It
116Intel PRO/1000PT Server Adapter
117.It
118Intel PRO/1000PT Dual Port Server Adapter
119.It
120Intel PRO/1000PT Quad Port Server Adapter
121.It
122Intel PRO/1000PF Server Adapter (SX Fiber)
123.It
124Intel PRO/1000PF Dual Port Server Adapter (SX Fiber)
125.It
126Sun PCI-E Dual Gigabit Ethernet LP UTP Adapter
127.It
128Sun PCI-E Dual Gigabit Ethernet LP MMF Adapter
129.It
130Sun PCI-E Dual Gigabit Ethernet EM UTP Adapter
131.It
132Sun PCI-E Dual Gigabit Ethernet EM MMF Adapter
133.It
134Sun PCI-E Dual Gigabit Ethernet ExpressModule
135.It
136Sun x4 PCI-E Quad Gigabit Ethernet LP UTP Adapter
137.It
138Sun x4 PCI-E Quad Gigabit Ethernet ExpressModule
139.It
140Sun x8 PCI-E Quad Gigabit Ethernet ExpressModule
141.El
142.Pp
143The
144.Nm
145driver supports the following media types:
146.Bl -tag -width autoselect -offset indent
147.It autoselect
148Enables auto-negotiation for speed and duplex.
149.It 10baseT Cm mediaopt No full-duplex
150Sets 10Mbps operation.
151.It 100baseTX Cm mediaopt No full-duplex
152Sets 100Mbps operation.
153.It 1000baseLX
154Sets 1000Mbps operation.
155Only full-duplex mode is supported at this speed.
156.It 1000baseSX
157Sets 1000Mbps operation.
158Only full-duplex mode is supported at this speed.
159.It 1000baseT
160Sets 1000Mbps operation.
161Only full-duplex mode is supported at this speed.
162.El
163.Pp
164For more information on configuring this device, see
165.Xr ifconfig 8 .
166.Sh SEE ALSO
167.Xr arp 4 ,
168.Xr ifmedia 4 ,
169.Xr intro 4 ,
170.Xr netintro 4 ,
171.Xr pci 4 ,
172.Xr hostname.if 5 ,
173.Xr ifconfig 8
174.Sh HISTORY
175The
176.Nm
177device driver first appeared in
178.Ox 3.2 .
179.Sh AUTHORS
180The
181.Nm
182driver was written by
183.An Intel Corporation .
184.Sh BUGS
185There are known performance issues with this driver when running UDP traffic
186with Jumbo frames.
187.Pp
188There is a known compatibility issue where time to link is slow or link is not
189established between 82541/82547 controllers and some switches.
190Known switches include:
191.Pp
192.Bl -item -offset indent -compact
193.It
194I-O Data ETG-SH8
195.It
196Planex FXG-08TE
197.El
198