Module Name: src
Committed By: bad
Date: Mon Oct 26 22:18:58 UTC 2015
Modified Files:
src/share/man/man4: vlan.4
Log Message:
Explain how exactly tagged packets are processed.
While here remove a bit of non-techref wording and assume that people know
what VLANs are good for..
XXX: pullup-7, pullup-6
To generate a diff of this commit:
cvs rdiff -u -r1.31 -r1.32 src/share/man/man4/vlan.4
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/share/man/man4/vlan.4
diff -u src/share/man/man4/vlan.4:1.31 src/share/man/man4/vlan.4:1.32
--- src/share/man/man4/vlan.4:1.31 Thu Dec 16 18:29:47 2010
+++ src/share/man/man4/vlan.4 Mon Oct 26 22:18:57 2015
@@ -1,6 +1,6 @@
-.\" $NetBSD: vlan.4,v 1.31 2010/12/16 18:29:47 wiz Exp $
+.\" $NetBSD: vlan.4,v 1.32 2015/10/26 22:18:57 bad Exp $
.\"
-.\" Copyright (c) 2000 The NetBSD Foundation, Inc.
+.\" Copyright (c) 2000, 2015 The NetBSD Foundation, Inc.
.\" All rights reserved.
.\"
.\" This code is derived from software contributed to The NetBSD Foundation
@@ -27,7 +27,7 @@
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd December 16, 2010
+.Dd October 26, 2015
.Dt VLAN 4
.Os
.Sh NAME
@@ -43,9 +43,8 @@ interface provides support for
802.1Q Virtual Local Area Networks
.Pq Tn VLAN .
This supports the
-trunking of more than one network on a single network interface.
-This is particularly useful on routers or on hosts which must be
-connected to many different networks through a single physical interface.
+trunking of more than one network on a single network interface by using
+802.1Q tagged and untagged frames.
.Pp
To use a
.Nm vlan
@@ -58,7 +57,9 @@ distinguishes each
.Tn VLAN
from any others
.Pc
-and physical interface associated with the
+and
+.Pq parent
+physical interface associated with the
.Tn VLAN .
This can be done by using the
.Xr ifconfig 8
@@ -75,6 +76,35 @@ and
.Dv SIOCSIFVLAN
arguments.
.Pp
+Packets sent through a
+.Nm
+interface are tagged with the VID and passed to the parent interface for
+transmission.
+Tagged packets received on the parent interface are passed to the
+.Nm
+interface with the corresponding VID associated with the parent interface.
+Packets sent directly through the parent interface are transmitted as
+untagged frames.
+Untagged frames received on the parent interface are handled by the
+parent interface.
+Tagged frames received on the parent interface with a VID of 0 and an
+EtherType of IP or IPv6 are processed on the parent interface.
+Tagged frames received on the parent interface for which no
+.Nm
+interface with a matching VID exists are dropped and counted as
+.Dq unknown protocol .
+.Po
+These are displayed by the
+.Xr ifconfig 8
+.Fl -v
+option.
+.Pc
+.Pp
+If the
+.Nm
+pseudo-device is not configured in the kernel only packets tagged with a
+VID of 0 are processed.
+.Pp
To be compatible with other
.Tn IEEE
802.1Q devices, the
