]>
Commit | Line | Data |
---|---|---|
431488e6 | 1 | .\" -*- nroff -*- |
9bccc3ff | 2 | .so lib/ovs.tmac |
d2cb6c95 | 3 | .TH ovs\-vlan\-bug\-workaround 8 "@VERSION@" "Open vSwitch" "Open vSwitch Manual" |
431488e6 BP |
4 | .ds PN ovs\-vlan\-bug\-workaround |
5 | . | |
6 | .SH NAME | |
7 | ovs\-vlan\-bug\-workaround \- utility for configuring Linux VLAN driver bug workaround | |
8 | . | |
9 | .SH SYNOPSIS | |
10 | \fBovs\-vlan\-bug\-workaround \fInetdev\fR \fBon\fR | |
11 | .br | |
12 | \fBovs\-vlan\-bug\-workaround \fInetdev\fR \fBoff\fR | |
13 | .br | |
14 | \fBovs\-vlan\-bug\-workaround \-\-help | |
15 | .br | |
16 | \fBovs\-vlan\-bug\-workaround \-\-version | |
17 | .SH DESCRIPTION | |
18 | . | |
19 | .PP | |
20 | Some Linux network drivers support a feature called ``VLAN | |
21 | acceleration''. VLAN acceleration is associated with a data structure | |
22 | called a \fBvlan_group\fR that is, abstractly, a dictionary that maps | |
23 | from a VLAN ID (in the range 0 to 4095) to a VLAN device, that is, a | |
24 | Linux network device associated with a particular VLAN, | |
25 | e.g. \fBeth0.9\fR for VLAN 9 on \fBeth0\fR. | |
26 | .PP | |
27 | Some drivers that support VLAN acceleration have bugs that fall | |
28 | roughly into the categories listed below. \fBovs\-vlan\-test\fR(8) | |
29 | can test for these driver bugs. | |
30 | .so utilities/ovs-vlan-bugs.man | |
31 | .PP | |
32 | .PP | |
33 | The correct long term solution is to fix these driver bugs. | |
34 | .PP | |
35 | For now, \fBovs\-vlan\-bug\-workaround\fR can enable a special-purpose | |
36 | workaround for devices with buggy VLAN acceleration. A kernel patch | |
37 | must be applied for this workaround to work. | |
38 | .PP | |
39 | Use the command \fBovs\-vlan\-bug\-workaround \fInetdev\fR \fBon\fR to | |
40 | enable the VLAN driver bug workaround for network device \fInetdev\fR. | |
41 | Use the command \fBovs\-vlan\-bug\-workaround \fInetdev\fR \fBoff\fR to | |
42 | disable the VLAN driver bug workaround for network device \fInetdev\fR. | |
43 | .SH "DRIVER DETAILS" | |
44 | .PP | |
45 | The following drivers in Linux version | |
46 | 2.6.32.12-0.7.1.xs1.0.0.311.170586 implement VLAN acceleration and are | |
47 | relevant to Open vSwitch on XenServer. We have not tested any version | |
48 | of most of these drivers, so we do not know whether they have a VLAN | |
49 | problem that needs to be fixed. The drivers are listed by the name | |
50 | that they report in, e.g., \fBethtool \-i\fR output; in a few cases | |
51 | this differs slightly from the name of the module's \fB.ko\fR file: | |
52 | . | |
53 | .nf | |
54 | .ta T 1i | |
55 | \fB8139cp acenic amd8111e atl1c ATL1E atl1 | |
56 | atl2 be2net bna bnx2 bnx2x cnic | |
57 | cxgb cxgb3 e1000 e1000e enic forcedeth | |
58 | igb igbvf ixgb ixgbe jme ml4x_core | |
59 | ns83820 qlge r8169 S2IO sky2 starfire | |
60 | tehuti tg3 typhoon via-velocity vxge | |
61 | .fi | |
62 | .PP | |
63 | The following drivers use \fBvlan_group\fR but are irrelevant to Open | |
64 | vSwitch on XenServer: | |
65 | .IP "\fBbonding\fR" | |
66 | Not used with Open vSwitch on XenServer. | |
67 | .IP "\fBgianfar\fR" | |
68 | Not shipped with XenServer. A FreeScale CPU-integrated device. | |
69 | .IP "\fBehea\fR" | |
70 | Cannot be built on x86. IBM Power architecture only. | |
71 | .IP "\fBstmmac\fR" | |
72 | Cannot be built on x86. SH4 architecture only. | |
73 | .IP "\fBvmxnet3\fR" | |
74 | Not shipped with XenServer. For use inside VMware VMs only. | |
75 | . | |
76 | .SH OPTIONS | |
77 | . | |
78 | .so lib/common.man | |
79 | . | |
80 | .SH BUGS | |
81 | . | |
82 | Obviously. | |
83 | . | |
84 | .SH "SEE ALSO" | |
85 | . | |
86 | .BR ovs\-vlan\-test (8). |