xref: /openbsd/share/man/man4/em.4 (revision d415bd75)
1.\" $OpenBSD: em.4,v 1.55 2021/09/08 20:29:21 jmc 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: September 8 2021 $
32.Dt EM 4
33.Os
34.Sh NAME
35.Nm em
36.Nd Intel PRO/1000 10/100/1Gb 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, 82573V, 82574L, 82575EB, 82575GB, 82576EB, 82577LC, 82577LM,
4782578DC, 82578DM, 82579LM, 82579V, 82580DB, 82580EB, 82583V, I210, I211, I217,
48I218, I219, I350, I354
49Ethernet controller chips and the embedded chips found on EP80579 platform,
50including the following:
51.Pp
52.Bl -item -offset indent -compact
53.It
54Axiomtek NA-200 EP80579 based board
55.It
56HP ProLiant NC110T PCI Express Gigabit NIC
57.It
58HP ProLiant NC112T PCI Express Gigabit NIC
59.It
60HP ProLiant NC310F PCI-X Gigabit NIC (SX Fiber)
61.It
62HP ProLiant NC340T PCI-X Quad Port Gigabit NIC
63.It
64HP ProLiant NC360T PCI Express Dual Port Gigabit NIC
65.It
66HP ProLiant NC364T PCI Express Quad Port Gigabit NIC
67.It
68HP ProLiant NC365T PCI Express Quad Port Gigabit NIC
69.It
70HP ProLiant NC6132 Upgrade Module (SX Fiber)
71.It
72HP ProLiant NC6133 Upgrade Module (LX Fiber)
73.It
74HP ProLiant NC6134 PCI Gigabit NIC (SX Fiber)
75.It
76HP ProLiant NC6136 PCI Gigabit NIC (SX Fiber)
77.It
78HP ProLiant NC6170 PCI-X Gigabit NIC (SX Fiber)
79.It
80HP ProLiant NC7131 PCI Gigabit NIC
81.It
82HP ProLiant NC7132 Upgrade Module
83.It
84HP ProLiant NC7170 PCI-X Dual Port Gigabit NIC
85.It
86HP ProLiant NC7170LP PCI-X Dual Port Gigabit NIC
87.It
88Intel PRO/1000 Gigabit Server Adapter (SX Fiber) (PWLA8490)
89.It
90Intel PRO/1000F Gigabit Server Adapter (SX Fiber) (PWLA8490SX)
91.It
92Intel PRO/1000T Server Adapter (PWLA8490T)
93.It
94Intel PRO/1000XT Server Adapter (PWLA8490XT)
95.It
96Intel PRO/1000XS Server Adapter (SX Fiber) (PWLA8490XF)
97.It
98Intel PRO/1000T Desktop Adapter (PWLA8390T)
99.It
100Intel PRO/1000XTL Low Profile PCI Server (PWLA8490XTL)
101.It
102Intel PRO/1000MT Desktop Adapter (PWLA8390MT)
103.It
104Intel PRO/1000MT Server Adapter (PWLA8490MT)
105.It
106Intel PRO/1000MT Dual Port Server Adapter (PWLA8492MT)
107.It
108Intel PRO/1000MF Server Adapter (SX Fiber) (PWLA8490MF)
109.It
110Intel PRO/1000MF Dual Port Server Adapter (SX Fiber) (PWLA8492MF)
111.It
112Intel PRO/1000MF Server Adapter (LX Fiber) (PWLA8490LX)
113.It
114Intel PRO/1000MT Quad PCI-X Adapter (PWLA8494MT)
115.It
116Intel PRO/1000GT Quad PCI-X Adapter (PWLA8494GT)
117.It
118Intel PRO/1000PT Desktop Adapter
119.It
120Intel PRO/1000PT Server Adapter
121.It
122Intel PRO/1000PT Dual Port Server Adapter
123.It
124Intel PRO/1000PT Quad Port Server Adapter
125.It
126Intel PRO/1000PF Server Adapter (SX Fiber)
127.It
128Intel PRO/1000PF Dual Port Server Adapter (SX Fiber)
129.It
130Intel PRO/1000ET Dual Port Server Adapter
131.It
132Intel PRO/1000ET Quad Port Server Adapter
133.It
134Intel PRO/1000EF Quad Port Server Adapter (SX Fiber)
135.It
136Intel I340-T4 PCI Express Quad Port Gigabit NIC
137.It
138Intel I350-T2 PCI Express Dual Port Gigabit NIC
139.It
140Intel I350-T4 PCI Express Quad Port Gigabit NIC
141.It
142Soekris Engineering lan1841
143.It
144Sun PCI-E Dual Gigabit Ethernet LP UTP Adapter
145.It
146Sun PCI-E Dual Gigabit Ethernet LP MMF Adapter
147.It
148Sun PCI-E Dual Gigabit Ethernet EM UTP Adapter
149.It
150Sun PCI-E Dual Gigabit Ethernet EM MMF Adapter
151.It
152Sun PCI-E Dual Gigabit Ethernet ExpressModule
153.It
154Sun x4 PCI-E Quad Gigabit Ethernet LP UTP Adapter
155.It
156Sun x4 PCI-E Quad Gigabit Ethernet ExpressModule
157.It
158Sun x8 PCI-E Quad Gigabit Ethernet ExpressModule
159.It
160Supermicro AOC-SG-i2 Dual Port Server Adapter
161.It
162Supermicro AOC-PG-I2+ Dual Port Server Adapter
163.El
164.Pp
165The
166.Nm
167driver supports IPv4 receive IP/TCP/UDP checksum offload and transmit TCP/UDP
168checksum offload on all but 82542-based adapters, VLAN tag insertion and
169stripping, and jumbo frames on all but 82562V, 82566DC/82566DM and
17082573E/82573L/82573V-based adapters.
171The 82562V Ethernet controller chip only supports 10/100 media types.
172.Pp
173The
174.Nm
175driver supports the following media types:
176.Bl -tag -width autoselect -offset indent
177.It autoselect
178Enables auto-negotiation for speed and duplex.
179.It 10baseT Cm mediaopt No full-duplex
180Sets 10Mbps operation.
181.It 100baseTX Cm mediaopt No full-duplex
182Sets 100Mbps operation.
183.It 1000baseLX
184Sets 1000Mbps operation.
185Only full-duplex mode is supported at this speed.
186.It 1000baseSX
187Sets 1000Mbps operation.
188Only full-duplex mode is supported at this speed.
189.It 1000baseT
190Sets 1000Mbps operation.
191Only full-duplex mode is supported at this speed.
192.El
193.Pp
194For more information on configuring this device, see
195.Xr ifconfig 8 .
196.Sh SEE ALSO
197.Xr arp 4 ,
198.Xr gcu 4 ,
199.Xr ifmedia 4 ,
200.Xr intro 4 ,
201.Xr netintro 4 ,
202.Xr pci 4 ,
203.Xr hostname.if 5 ,
204.Xr ifconfig 8
205.Sh HISTORY
206The
207.Nm
208device driver first appeared in
209.Ox 3.2 .
210.Sh AUTHORS
211The
212.Nm
213driver was written by
214.An Intel Corporation .
215.Sh BUGS
216There are known performance issues with this driver when running UDP traffic
217with jumbo frames.
218.Pp
219There is a known compatibility issue where time to link is slow or link is not
220established between 82541/82547 controllers and some switches.
221Known switches include:
222.Pp
223.Bl -item -offset indent -compact
224.It
225I-O Data ETG-SH8
226.It
227Planex FXG-08TE
228.El
229