xref: /freebsd/share/man/man4/em.4 (revision 54ab3ed82b639b593fb0fe6db845e38a9d18970e)
1.\" Copyright (c) 2001 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.\" $FreeBSD$
28
29
30.Dd October, 2001
31.Dt EM 4
32.Os FreeBSD
33.Sh NAME
34.Nm em
35.Nd
36Intel(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 82542, 82543 and 82544 ethernet controller chip.
44The driver supports Transmit/Receive checksum offload
45and jumbo frames only on 82543 and 82544-based adapters.
46For a list of supported adapters, see the README
47included with the driver.
48.Pp
49For questions related to hardware requirements,
50refer to the documentation supplied with your Intel PRO/1000 adapter.
51All hardware requirements listed apply to use with FreeBSD.
52.Pp
53Support for jumbo frames is provided via the interface MTU setting.
54Selecting an MTU larger than 1500 bytes with the
55.Xr ifconfig 8
56utility configures the adapter to receive and transmit jumbo frames.
57The maximum MTU size for jumbo frames is 9000.
58.Pp
59The
60.Nm
61driver supports the following media types:
62.Pp
63.Bl -tag -width xxxxxxxxxxxxxxxxxxxx
64.It autoselect
65Enables auto-negotiation for speed and duplex.
66.It 10baseT/UTP
67Sets 10Mbps operation.
68The
69.Ar mediaopt
70option can also be used to select either
71.Ar full-duplex
72or
73.Ar half-duplex
74modes.
75.It 100baseTX
76Sets 100Mbps operation.
77The
78.Ar mediaopt
79option can also be used to select either
80.Ar full-duplex
81or
82.Ar half-duplex
83modes.
84.It 1000baseSX
85Sets 1000Mbps operation.
86Only
87.Ar full-duplex
88mode is supported at this speed.
89.It 1000baseTX
90Sets 1000Mbps operation.
91Only
92.Ar full-duplex
93mode is supported at this speed.
94.El
95.Pp
96The
97.Nm
98driver supports the following media options:
99.Pp
100.Bl -tag -width xxxxxxxxxxxxxxxxxxxx
101.It full-duplex
102Forces full duplex operation
103.It half-duplex
104Forces half duplex operation.
105.El
106.Pp
107For more information on configuring this device, see
108.Xr ifconfig 8 .
109.Sh DIAGNOSTICS
110.Bl -diag
111.It "em%d: Unable to allocate bus resource: memory"
112A fatal initialization error has occurred.
113.It "em%d: Unable to allocate bus resource: interrupt"
114A fatal initialization error has occurred.
115.It "em%d: No memory for jumbo buffers!"
116The driver failed to allocate memory for jumbo frames during
117initialization.
118.It "em%d: watchdog timeout -- resetting"
119The device has stopped responding to the network, or there is a problem with
120the network connection (cable).
121.El
122.Sh SUPPORT
123For additional information regarding building and installation,
124see the README included with the driver. For general information and support,
125go to the Intel support Website at:
126.Ar http://support.intel.com.
127.Pp
128If an issue is identified with the released source code on the supported kernel
129with a supported adapter, email the specific information related to the
130issue to freebsdnic@mailbox.intel.com.
131.El
132.Sh SEE ALSO
133.Xr arp 4 ,
134.Xr netintro 4 ,
135.Xr vlan 4 ,
136.Xr ng_ether 4 ,
137.Xr ifconfig 8
138.Sh HISTORY
139The
140.Nm
141device driver first appeared in
142.Fx 4.4 .
143.Sh AUTHORS
144The
145.Nm
146driver was written by
147.An Intel Corporation Aq freebsdnic@mailbox.intel.com .
148