From a832259c238caa8bb9098c0eb3d993fe6a87318e Mon Sep 17 00:00:00 2001 From: thorpej Date: Thu, 28 Sep 2000 06:59:58 +0000 Subject: [PATCH] Manual page for the vlan(4) interface. --- share/man/man4/Makefile | 4 +- share/man/man4/vlan.4 | 97 +++++++++++++++++++++++++++++++++++++++++ 2 files changed, 99 insertions(+), 2 deletions(-) create mode 100644 share/man/man4/vlan.4 diff --git a/share/man/man4/Makefile b/share/man/man4/Makefile index ed5d6ad318eb..bb6a756325bf 100644 --- a/share/man/man4/Makefile +++ b/share/man/man4/Makefile @@ -1,4 +1,4 @@ -# $NetBSD: Makefile,v 1.165 2000/09/23 04:34:55 augustss Exp $ +# $NetBSD: Makefile,v 1.166 2000/09/28 06:59:58 thorpej Exp $ # @(#)Makefile 8.1 (Berkeley) 6/18/93 MAN= adv.4 adw.4 ahb.4 ahc.4 aria.4 atalk.4 audio.4 auvia.4 \ @@ -16,7 +16,7 @@ MAN= adv.4 adw.4 ahb.4 ahc.4 aria.4 atalk.4 audio.4 auvia.4 \ rtk.4 scsi.4 sd.4 siop.4 sl.4 sm.4 speaker.4 spp.4 \ sqphy.4 ss.4 st.4 sv.4 strip.4 tb.4 tcp.4 termios.4 \ ti.4 tl.4 tlp.4 tlphy.4 tp.4 tr.4 tty.4 tun.4 tqphy.4 \ - udp.4 uha.4 uk.4 ukphy.4 unix.4 vga.4 vnd.4 vr.4 wd.4 \ + udp.4 uha.4 uk.4 ukphy.4 unix.4 vga.4 vlan.4 vnd.4 vr.4 wd.4 \ wdc.4 wi.4 wscons.4 wsdisplay.4 wskbd.4 wsmouse.4 \ wsmux.4 ym.4 zero.4 zstty.4 diff --git a/share/man/man4/vlan.4 b/share/man/man4/vlan.4 new file mode 100644 index 000000000000..bef8c9246f87 --- /dev/null +++ b/share/man/man4/vlan.4 @@ -0,0 +1,97 @@ +.\" $NetBSD: vlan.4,v 1.1 2000/09/28 06:59:58 thorpej Exp $ +.\" +.\" Copyright (c) 2000 The NetBSD Foundation, Inc. +.\" All rights reserved. +.\" +.\" This code is derived from software contributed to The NetBSD Foundation +.\" by Jason R. Thorpe of Zembu Labs, Inc. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" 3. All advertising materials mentioning features or use of this software +.\" must display the following acknowledgement: +.\" This product includes software developed by the NetBSD +.\" Foundation, Inc. and its contributors. +.\" 4. Neither the name of The NetBSD Foundation nor the names of its +.\" contributors may be used to endorse or promote products derived +.\" from this software without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS +.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED +.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR +.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS +.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR +.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF +.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS +.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN +.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) +.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE +.\" POSSIBILITY OF SUCH DAMAGE. +.\" +.Dd September 27, 2000 +.Dt VLAN 4 +.Os +.Sh NAME +.Nm vlan +.Nd 802.1Q Virtual LAN network device +.Sh SYNOPSIS +.Cd "pseudo-device vlan" +.Sh DESCRIPTION +The +.Nm +interface provides support 802.1Q Virtual LANs. This allows 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. +.Pp +To use +.Nm vlan , +the administrator must first create the interface and then +specify the VLAN tag and physical interface associated with +the VLAN. +This can be done by using the +.Xr ifconfig 8 +.Sq create , +.Sq vlan , +and +.Sq vlanif +subcommands, or +.Dv SIOCSIFCREATE +and +.Dv SIOCSIFVLAN +ioctls. +.Sh SEE ALSO +.Xr ifconfig 8 +.Sh HISTORY +The +.Nm +first appeared in +.Nx 1.5. +.Sh BUGS +The +.Nm +interfaces do not currently inherit changes made to the physical +interfaces's MTU. +.Pp +Promiscuous mode does not currently work on +.Nm +interfaces. +.Sh AUTHOR +The +.Nm +driver was integrated by +.An Andrew Doran +.Aq ad@netbsd.org +and +.An Jason R. Thorpe +.Aq thorpej@zembu.com . +It was derived from a VLAN implementation that appeared in +.Fx +and +.Ox .