man > vlan-interfaces(5)

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  inter‐
       faces(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´ pa‐
       rameter.  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 ether‐
              net like devices.

       ip-rp-filter 0|1|2
              Set the return path filter for this specific interface.  This also works on plain eth‐
              ernet 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 AT kwaak.net>

SEE ALSO
       vconfig(8) interfaces(5)

vlan                                      September 30 2007                       VLAN-INTERFACES(5)