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