1.\" 2.\" Copyright (c) 2001 Yar Tikhiy 3.\" All rights reserved. 4.\" 5.\" Redistribution and use in source and binary forms, with or without 6.\" modification, are permitted provided that the following conditions 7.\" are met: 8.\" 1. Redistributions of source code must retain the above copyright 9.\" notice, this list of conditions and the following disclaimer. 10.\" 2. Redistributions in binary form must reproduce the above copyright 11.\" notice, this list of conditions and the following disclaimer in the 12.\" documentation and/or other materials provided with the distribution. 13.\" 14.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND 15.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 16.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 17.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE 18.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 19.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 20.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 21.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 22.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 23.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 24.\" SUCH DAMAGE. 25.\" 26.\" $FreeBSD$ 27.\" 28.Dd August 11, 2006 29.Dt VLAN 4 30.Os 31.Sh NAME 32.Nm vlan 33.Nd "IEEE 802.1Q VLAN network interface" 34.Sh SYNOPSIS 35To compile this driver into the kernel, 36place the following lines in your 37kernel configuration file: 38.Bd -ragged -offset indent 39.Cd "device miibus" 40.Cd "device vlan" 41.Ed 42.Pp 43Alternatively, to load the driver as a 44module at boot time, place the following line in 45.Xr loader.conf 5 : 46.Bd -literal -offset indent 47if_vlan_load="YES" 48.Ed 49.Sh DESCRIPTION 50The 51.Nm 52driver demultiplexes frames tagged according to 53the IEEE 802.1Q standard into logical 54.Nm 55network interfaces, which allows routing/bridging between 56multiple VLANs through a single switch trunk port. 57.Pp 58Each 59.Nm 60interface is created at runtime using interface cloning. 61This is 62most easily done with the 63.Xr ifconfig 8 64.Cm create 65command or using the 66.Va cloned_interfaces 67variable in 68.Xr rc.conf 5 . 69.Pp 70To function, a 71.Nm 72interface must be assigned a parent interface and 73numeric VLAN tag using 74.Xr ifconfig 8 . 75A single parent can be assigned to multiple 76.Nm 77interfaces provided they have different tags. 78The parent interface is likely to be an Ethernet card connected 79to a properly configured switch port. 80The VLAN tag should match one of those set up in the switched 81network. 82.Pp 83Initially 84.Nm 85assumes the same minimum length for tagged and untagged frames. 86This mode is selected by the 87.Xr sysctl 8 88variable 89.Va net.link.vlan.soft_pad 90set to 0 (default). 91However, there are network devices that fail to adjust frame length, 92should it fall below the allowed minimum due to untagging. 93Such devices should be able to interoperate with 94.Nm 95after changing the value of 96.Va net.link.vlan.soft_pad 97to 1. 98In the latter mode, 99.Nm 100will pad short frames before tagging them 101so that their length stays not less than the minimum value 102after untagging by the non-compliant devices. 103.Sh HARDWARE 104The 105.Nm 106driver supports efficient operation over parent interfaces that can provide 107help in processing VLANs. 108Such interfaces are automatically recognized by their capabilities. 109Depending on the level of sophistication found in a physical 110interface, it may do full VLAN processing or just be able to 111receive and transmit frames exceeding the maximum Ethernet frame size 112by the length of a 802.1Q header. 113The capabilities may be user-controlled by the respective parameters to 114.Xr ifconfig 8 , 115.Cm vlanhwtag 116and 117.Cm vlanmtu . 118However, a physical interface is not obliged to react to them: 119It may have either capability enabled permanently without 120a way to turn it off. 121The whole issue is very specific to a particular device and its driver. 122.Pp 123By now, the list of physical interfaces able of full VLAN processing 124in the hardware is limited to the following devices: 125.Xr bge 4 , 126.Xr em 4 , 127.Xr ixgb 4 , 128.Xr nge 4 , 129.Xr re 4 , 130.Xr stge 4 , 131.Xr ti 4 , 132.Xr txp 4 , 133and 134.Xr vge 4 . 135.Pp 136The rest of the Ethernet interfaces can run 137VLANs using software emulation in the 138.Nm 139driver. 140However, most of them lack the capability 141of transmitting and receiving oversized frames. 142Assigning such an interface as the parent to 143.Nm 144will result in a reduced MTU on the corresponding 145.Nm 146interfaces. 147In the modern Internet, this is likely to cause 148.Xr tcp 4 149connectivity problems due to massive, inadequate 150.Xr icmp 4 151filtering that breaks the Path MTU Discovery mechanism. 152.Pp 153The interfaces that support oversized frames are as follows: 154.Bl -tag -width ".Xr fxp 4 " -offset indent 155.It Xr bfe 4 156supports long frames for 157.Nm 158natively. 159.It Xr dc 4 160supports long frames for 161.Nm 162natively. 163.It Xr de 4 164requires defining 165.Dv BIG_PACKET 166in the 167.Pa /usr/src/sys/pci/if_de.c 168source file and rebuilding the kernel 169or module. 170The hack works only for the 21041, 21140, and 21140A chips. 171.It Xr fxp 4 172supports long frames for 173.Nm 174natively. 175.It Xr gem 4 176supports long frames for 177.Nm 178natively. 179.It Xr hme 4 180supports long frames for 181.Nm 182natively. 183.It Xr le 4 184supports long frames for 185.Nm 186natively. 187.It Xr rl 4 188supports long frames for 189.Nm 190natively. 191.It Xr sis 4 192supports long frames for 193.Nm 194natively. 195.It Xr sk 4 196supports long frames for 197.Nm 198natively. 199.It Xr ste 4 200supports long frames for 201.Nm 202natively. 203.It Xr tl 4 204has support for long frames. 205.It Xr tx 4 206supports long frames for 207.Nm 208natively. 209.It Xr xl 4 210supports long frames only if the card is built on a newer chip 211(Cyclone and above). 212.El 213.Pp 214The 215.Nm 216driver automatically recognizes devices that natively support oversized frames 217for 218.Nm 219use and calculates the appropriate frame MTU based on the 220capabilities of the parent interface. 221The other interfaces listed above can handle oversized frames, 222but they do not advertise this ability of theirs. 223The MTU setting on 224.Nm 225can be corrected manually if used in conjunction with such parent interface. 226.Sh SEE ALSO 227.Xr kqueue 2 , 228.Xr miibus 4 , 229.Xr ifconfig 8 , 230.Xr sysctl 8 231.Sh BUGS 232No 802.1Q features except VLAN tagging are implemented. 233.Pp 234.Dv EVFILT_NETDEV 235events on a 236.Nm 237interface will be sent through 238.Xr kqueue 2 239only if the parent interface uses 240.Xr miibus 4 241for link state notification. 242