xref: /openbsd/share/man/man4/ixgb.4 (revision 76d0caae)
1.\" $OpenBSD: ixgb.4,v 1.14 2014/09/14 00:17:09 brad 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 14 2014 $
32.Dt IXGB 4
33.Os
34.Sh NAME
35.Nm ixgb
36.Nd Intel PRO/10GbE 10Gb Ethernet device
37.Sh SYNOPSIS
38.Cd "ixgb* at pci?"
39.Sh DESCRIPTION
40The
41.Nm
42driver provides support for PCI-X 10Gb Ethernet adapters based on the
43Intel 82597EX Ethernet controller chips.
44The driver supports IPv4 receive IP/TCP/UDP checksum offload, VLAN tag
45insertion and stripping, and jumbo frames.
46This includes the following models:
47.Pp
48.Bl -item -offset indent -compact
49.It
50Intel PRO/10GbE CX4 Server Adapter (PXLA8591CX4)
51.It
52Intel PRO/10GbE LR Server Adapter (PXLA8591LR)
53.It
54Intel PRO/10GbE SR Server Adapter (PXLA8591SR)
55.It
56Sun 10 Gigabit Ethernet PCI-X Adapter (X5544A-4)
57.El
58.Pp
59The
60.Nm
61driver supports the following media types:
62.Bl -tag -width autoselect -offset indent
63.It autoselect
64Enables auto-negotiation for speed and duplex.
65.It 10GbaseLR
66Sets 10Gbps operation.
67Only full-duplex mode is supported at this speed.
68.It 10GbaseSR
69Sets 10Gbps operation.
70Only full-duplex mode is supported at this speed.
71.El
72.Pp
73For more information on configuring this device, see
74.Xr ifconfig 8 .
75.Sh SEE ALSO
76.Xr arp 4 ,
77.Xr ifmedia 4 ,
78.Xr intro 4 ,
79.Xr netintro 4 ,
80.Xr pci 4 ,
81.Xr hostname.if 5 ,
82.Xr ifconfig 8
83.Sh HISTORY
84The
85.Nm
86device driver first appeared in
87.Ox 3.9 .
88.Sh AUTHORS
89The
90.Nm
91driver was written by
92.An Intel Corporation .
93.Sh BUGS
94Under small packet UDP stress tests with 10GbE driver, the
95.Ox
96system will drop UDP packets due to the fullness of the socket buffers.
97You may want to change the driver's Flow Control variables to the minimum
98value for controlling packet reception.
99.Pp
100Excessive CRC errors may be observed if the Intel PRO/10GbE CX4 Server
101adapter is connected to a Fujitsu XENPAK CX4 module in a SmartBits chassis
102using 15m/24AWG cable assemblies manufactured by Fujitsu or Leoni.
103The CRC errors may be received either by the Intel PRO/10GbE CX4 Server
104adapter or the SmartBits.
105If this situation occurs, using a different cable assembly may resolve the
106issue.
107.Pp
108Excessive CRC errors may be observed if the Intel PRO/10GbE CX4 Server
109adapter is connected to an HP Procurve 3400cl switch port using short cables
110(1m or shorter).
111If this situation occurs, using a longer cable may resolve the issue.
112.Pp
113Excessive CRC errors may be observed using Fujitsu 24AWG cable assemblies that
114are 10m or longer or where using a Leoni 15 m/24AWG cable assembly.
115The CRC errors may be received either by the CX4 Server adapter
116or at the switch.
117If this situation occurs, using a different cable assembly
118may resolve the issue.
119