-
Notifications
You must be signed in to change notification settings - Fork 0
/
ixgbe.7
226 lines (225 loc) · 7.09 KB
/
ixgbe.7
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
.\" LICENSE
.\"
.\" This software program is released under the terms of a license agreement between you ('Licensee') and Intel. Do not use or load this software or any associated materials (collectively, the 'Software') until you have carefully read the full terms and conditions of the LICENSE located in this software package. By loading or using the Software, you agree to the terms of this Agreement. If you do not agree with the terms of this Agreement, do not install or use the Software.
.\"
.\" * Other names and brands may be claimed as the property of others.
.\"
.TH ixgbe 1 "April 1, 2013"
.SH NAME
ixgbe \-This file describes the Linux* Base Driver for the 10 Gigabit Family of Adapters.
.SH SYNOPSIS
.PD 0.4v
modprobe ixgbe [<option>=<VAL1>,<VAL2>,...]
.br
.PD 1v
.LP
.SH DESCRIPTION
This driver supports the \fB2.6.x\fR kernel, and includes support for any Linux supported system, including Itanium(R)2, x86_64, i686, and PPC
.LP
This driver is only supported as a loadable module at this time. Intel is not supplying patches against the kernel source to allow for static linking of the driver. For questions related to hardware requirements, refer to the documentation supplied with your 10 Gigabit adapter. All hardware requirements listed apply to use with Linux.
.SH OPTIONS
The following optional parameters are used by entering them on the command line with the modprobe command. For example:
.IP
.B modprobe ixgbe InterruptThrottleRate=16000,16000
.PP
.LP
.B RSS - Receive Side Scaling (or multiple queues for receives)
.IP
.B Valid Range:
0 - 16
.br
.B Default Value:
0
.IP
0 = Sets the descriptor queue count to whichever is less, number of CPUS or 16
1-16 = Sets the descriptor queue count to 1-16
.IP
RSS also effects the number of transmit queues allocated on 2.6.23 and
newer kernels with CONFIG_NETDEVICES_MULTIQUEUE set in the kernel .config file.
CONFIG_NETDEVICES_MULTIQUEUE only exists from 2.6.23 to 2.6.26. Other options
enable multiqueue in 2.6.27 and newer kernels.
.LP
.B MQ - Multi Queue
.IP
.LP
.B Valid Range:
0, 1
.IP
.B Default Value:
1
.IP
0 = Disables Multiple Queue support
1 = Enabled Multiple Queue support (a prerequisite for RSS)
.LP
.B DCA - Direct Cache Access
.IP
.B Valid Range:
0, 1
.IP
.B Default Value:
1 (when IXGBE_DCA is enabled)
0 = Disables DCA support in the driver
1 = Enables DCA support in the driver
.IP
See the instructions in the README for enabling DCA. If the driver is enabled for
DCA this parameter allows load-time control of the feature.
.LP
.B IntMode
.IP
.B Valid Range:
0-2 0 = Legacy Int, 1 = MSI and 2 = MSIX
.br
.B Default Value:
2
.IP
IntMode controls allow load time control over the type of interrupt
registered for by the driver. MSI-X is required for multiple queue
support, and some kernels and combinations of kernel .config options will
force a lower level of interrupt support. 'cat /proc/interrupts' will show
different values for each type of interrupt.
.LP
.B InterruptThrottleRate
.IP
.B Valid Range:
956-488281 (0=off, 1=dynamic)
.br
.B Default Value: 1
.IP
Interrupt Throttle Rate (interrupts/sec)
.br
The ITR parameter controls how many interrupts each interrupt vector can
generate per second. On MQ/RSS enabled kernels with MSI-X interrupts this
means that each RX vector can generate (by default) 8000 interrupts per second
and each TX vector can generate (by default) 4000 interrupts per second.
Increasing ITR lowers latency at the cost of increased CPU utilization, though
it may help throughput in some circumstances.
.br
1 = Dynamic mode attempts to moderate interrupts per vector while maintaining
very low latency. This can sometimes cause extra CPU utilization. If planning
on deploying ixgbe in a latency sensitive environment please consider this
parameter.
.br
0 = Setting InterruptThrottleRate to 0 turns off any interrupt moderation and
may improve small packet latency, but is generally not suitable for bulk
throughput traffic due to the increased cpu utilization of the higher interrupt
rate. Please note that on 82599-based adapters, disabling InterruptThrottleRate
will also result in the driver disabling HW RSC. On 82598-based adapters,
disabling InterruptThrottleRate will also result in disabling LRO (Large Receive
Offloads).
.LP
.B LLIPort
.IP
.B Valid Range:
0-65535
.br
.B Default Value:
0 (disabled)
.IP
LLI is configured with the LLIPort command-line parameter, which specifies which TCP port should generate Low Latency Interrupts. For example, using LLIPort=80 would cause the board to generate an immediate interrupt upon receipt of any packet sent to TCP port 80 on the local machine.
.IP
WARNING: Enabling LLI can result in an excessive number of interrupts/second
that may cause problems with the system and in some cases may cause a kernel
panic.
.LP
.B LLIPush
.IP
.B Valid Range:
0-1
.br
.B Default Value:
0 (disabled)
.IP
LLIPush can be set to be enabled or disabled (default). It is most effective in
an environment with many small transactions. NOTE: Enabling LLIPush may allow a
denial of service attack.
.LP
.B LLISize
.IP
.B Valid Range:
0-1500
.br
.B Default Value:
0 (disabled)
.IP
LLISize causes an immediate interrupt if the board receives a packet smaller
than the specified size.
.LP
.B LLIEType
.IP
.B Valid Range:
0-x8fff
.br
.B Default Value:
0 (disabled)
.IP
Low Latency Interrupt Ethernet Protocol Type.
.LP
.B LLIVLANP
.IP
.B Valid Range:
0-7
.br
.B Default Value:
0 (disabled)
.IP
Low Latency Interrupt on VLAN priority threshold.
.LP
.B FdirPballoc
.IP
.B Valid Range:
0-2 (0=64k, 1=128k, 2=256k)
.br
.B Default Value:
0
.IP
Flow Director allocated packet buffer size.
.LP
.B AtrSampleRate
.IP
.B Valid Range:
0-255
.br
.B Default Value:
20
.IP
Software ATR Tx packet sample rate. For example, when set to 20, every 20th
packet, looks to see if the packet will create a new flow.
.LP
.B L2LBen
.IP
.B Valid Range:
0 = disable, 1 = enable
.br
.B Default Value:
1 (enable)
.IP
This parameter controls the internal switch (L2 loopback between pf and vf).
By default the switch is enabled.
.LP
.B LRO
.IP
Enable/disable Large Receive Offload.
.B Valid Range:
0(off), 1(on)
.B Default Value:
1
.LP
.SH JUMBO FRAMES
The driver supports Jumbo Frames for all adapters. Jumbo Frames support is enabled by changing the MTU to a value larger than the default of 1500. Use the ifconfig command to increase the MTU size. For example, enter the following where <x> is the interface number:
.IP
ifconfig eth<x> mtu 9000 up
.IP
The maximum MTU setting for Jumbo Frames is 9710. This value coincides
with the maximum Jumbo Frames size of 9728. This driver will attempt to
use multiple page sized buffers to receive each jumbo packet. This
should help to avoid buffer starvation issues when allocating receive
packets.
.SH SUPPORT
For additional information, including supported adapters, building, and installation, see the README file included with the driver.
.LP
For general information and support, go to the Intel support website at:
.IP
.B http://support.intel.com
.LP
If an issue is identified with the released source code on the supported kernel with a supported adapter, email the specific information related to the issue to [email protected].
.LP