Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   9211 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

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 infor‐
       mation  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 generally
       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 manipula‐
       tions 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)

Vote for polarhome