vlan-interfaces(5) [debian man page]

VLAN-INTERFACES(5)						   File formats 						VLAN-INTERFACES(5)

NAME

       /etc/network/interfaces (vlan) - vlan extensions for the interfaces(5) file format

DESCRIPTION

       /etc/network/interfaces	contains  network  interface  configuration  information  for  the  ifup(8)  and ifdown(8) commands.  This manpage
       describes the vlan extensions to the standard interfaces(5) file format.

       Primary extensions exist to make and destroy vlan interfaces, secondary extensions exist for ipv4 interface manipulation which  are  gener-
       ally needed when using (a lot of) vlans.

VLAN CREATION

       Vlan  interface	definitions  exist  of the vlan interface name, and an optional 'raw-device' parameter.  Vlan interfaces are numbered 1 to
       4095.  You have the option to have interface names zero-padded to 4 numbers, or just the plain digits without leading zero.  The  following
       example shows four ways to create a vlan with id 1 on interface eth0.  They all result in different names.

	iface eth0.1 inet static
	    address 192.168.1.1
	    netmask 255.255.255.0

	iface vlan1 inet static
	    vlan-raw-device eth0
	    address 192.168.1.1
	    netmask 255.255.255.0

	iface eth0.0001 inet static
	    address 192.168.1.1
	    netmask 255.255.255.0

	iface vlan0001 inet static
	    vlan-raw-device eth0
	    address 192.168.1.1
	    netmask 255.255.255.0

	# We don't have br support out of the box
	iface br0.2 inet static
	    vlan-raw-device br0
	    address 192.168.1.1
	    netmask 255.255.255.0

	# Aliases are ignored
	iface br0.2:1 inet static
	    address 192.168.1.1
	    netmask 255.255.255.255

EXTRA IFACE OPTIONS

       Usually someone who uses vlans also wants to do some other manipulations with the ip stack or interface.

       vlan-raw-device devicename
	      Indicates the device to create the vlan on.  This is ignored when the devicename is part of the vlan interface name.

       ip-proxy-arp 0|1
	      Turn proxy-arp off or on for this specific interface.  This also works on plain ethernet like devices.

       ip-rp-filter 0|1|2
	      Set the return path filter for this specific interface.  This also works on plain ethernet like devices.

       hw-mac-address mac-address
	      This sets the mac address of the interface before bringing it up.  This works on any device that allows setting the hardware address
	      with the ip command.

AUTHOR

       This manpage was adapted from interfaces(5) by Ard van Breemen <ard@kwaak.net>

SEE ALSO

       vconfig(8) interfaces(5)

vlan								 September 30 2007						VLAN-INTERFACES(5)

VCONFIG(8)						      System Manager's Manual							VCONFIG(8)

NAME

       vconfig - VLAN (802.1q) configuration program.

SYNOPSIS

       vconfig [lots of long options]

DESCRIPTION

       The  vconfig program allows you to create and remove vlan-devices on a vlan enabled kernel. Vlan-devices are virtual ethernet devices which
       represents the virtual lans on the physical lan.

OPTIONS

       add [interface-name] [vlan-id]
	      Creates a vlan-device on [interface-name]. The resulting vlan-device will be called according to the nameing convention set.

       rem [vlan-device]
	      Removes the named vlan-device.

       set_flag [vlan-device] 0 | 1
	      When 1, ethernet header reorders are turned on. Dumping the device will appear as a  common  ethernet  device  without  vlans.  When
	      0(default)  however,  ethernet  headers are not reordered, which results in vlan tagged packets when dumping the device. Usually the
	      default gives no problems, but some packet filtering programs might have problems with it.

       set_egress_map [vlan-device] [skb-priority] [vlan-qos]
	      This flags that outbound packets with a particular skb-priority should be tagged with the particular  vlan  priority  vlan-qos.  The
	      default vlan priority is 0.

       set_ingress_map [vlan-device] [skb-priority] [vlan-qos]
	      This  flags  that  inbound  packets  with the particular vlan priority vlan-qos should be queued with a particular skb-priority. The
	      default skb-priority is 0.

       set_name_type VLAN_PLUS_VID | VLAN_PLUS_VID_NO_PAD | DEV_PLUS_VID | DEV_PLUS_VID_NO_PAD
	      Sets the way vlan-device names are created. Use vconfig without arguments to see the different formats.

       NOTES  VLAN will use Broadcom's NICE interface when the network device supports it. This is necessary, since usually the hardware of  these
	      devices  already	removes the vlan tag from the ethernet packet. The set_flag option on vlan-devices created on such a physical net-
	      work device will be ignored.  Dumping the network-device will show only untagged(non-vlan) traffic,  and	dumping  the  vlan-devices
	      will only show traffic intended for that vlan, without the tags.

FILES

       /proc/net/vlan/config
       /proc/net/vlan/[vlan-device]

SEE ALSO

       ip(8), ifconfig(8)

AUTHORS

       This manual page was written by Ard van Breemen <ard@kwaak.net>
       The vlan patch is written by Ben Greear <greearb@candelatech.com>

																	VCONFIG(8)