svn commit: r236774 - stable/8/share/man/man4
wblock at FreeBSD.org
Sat Jun 9 01:42:23 UTC 2012
Author: wblock (doc committer)
Date: Sat Jun 9 01:42:22 2012
New Revision: 236774
Wording corrections and simplifications.
Approved by: gjb (mentor)
stable/8/share/man/man4/ (props changed)
--- stable/8/share/man/man4/vlan.4 Sat Jun 9 01:41:41 2012 (r236773)
+++ stable/8/share/man/man4/vlan.4 Sat Jun 9 01:42:22 2012 (r236774)
@@ -25,7 +25,7 @@
-.Dd October 25, 2011
+.Dd June 4, 2012
.Dt VLAN 4
@@ -33,7 +33,7 @@
.Nd "IEEE 802.1Q VLAN network interface"
To compile this driver into the kernel,
-place the following lines in your
+place the following line in your
kernel configuration file:
.Bd -ragged -offset indent
.Cd "device vlan"
@@ -79,16 +79,16 @@ to a properly configured switch port.
The VLAN tag should match one of those set up in the switched
-assumes the same minimum length for tagged and untagged frames.
-This mode is selected by the
+initially assumes the same minimum length for tagged and untagged frames.
+This mode is selected by setting the
.Xr sysctl 8
-set to 0 (default).
-However, there are network devices that fail to adjust frame length,
-should it fall below the allowed minimum due to untagging.
+.Pq default .
+However, there are network devices that fail to adjust frame length
+when it falls below the allowed minimum due to untagging.
Such devices should be able to interoperate with
after changing the value of
@@ -97,7 +97,7 @@ to 1.
In the latter mode,
will pad short frames before tagging them
-so that their length stays not less than the minimum value
+so that their length is not less than the minimum value
after untagging by the non-compliant devices.
@@ -111,7 +111,7 @@ receive and transmit long frames (up to
header and FCS).
The capabilities may be user-controlled by the respective parameters to
.Xr ifconfig 8 ,
+.Cm vlanhwtag ,
.Cm vlanmtu .
However, a physical interface is not obliged to react to them:
@@ -119,8 +119,8 @@ It may have either capability enabled pe
a way to turn it off.
The whole issue is very specific to a particular device and its driver.
-By now, the list of physical interfaces able of full VLAN processing
-in the hardware is limited to the following devices:
+At present, these devices are capable of full VLAN processing
.Xr ae 4 ,
.Xr age 4 ,
.Xr alc 4 ,
@@ -146,11 +146,10 @@ in the hardware is limited to the follow
.Xr vge 4 .
-The rest of the Ethernet interfaces can run
-VLANs using software emulation in the
+Other Ethernet interfaces can run VLANs using software emulation in the
-However, some of them lack the capability
+However, some lack the capability
of transmitting and receiving long frames.
Assigning such an interface as the parent to
@@ -163,9 +162,8 @@ connectivity problems due to massive, in
.Xr icmp 4
filtering that breaks the Path MTU Discovery mechanism.
-The following interfaces support long frames for
+These interfaces natively support long frames for
.Xr axe 4 ,
.Xr bfe 4 ,
.Xr cas 4 ,
@@ -198,7 +196,7 @@ for
use and calculates the appropriate frame MTU based on the
capabilities of the parent interface.
Some other interfaces not listed above may handle long frames,
-but they do not advertise this ability of theirs.
+but they do not advertise this ability.
The MTU setting on
can be corrected manually if used in conjunction with such a parent interface.
More information about the svn-src-stable-8