Provided by: vlan_1.9-3ubuntu3_i386 bug

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  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
       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)