# vlan-interfaces(5) - man - phpMan

[VLAN-INTERFACES(5)](https://www.chedong.com/phpMan.php/man/VLAN-INTERFACES/5/markdown)                          File formats                          [VLAN-INTERFACES(5)](https://www.chedong.com/phpMan.php/man/VLAN-INTERFACES/5/markdown)



## NAME
       /etc/network/interfaces (vlan) - vlan extensions for the [**interfaces**(5)](https://www.chedong.com/phpMan.php/man/interfaces/5/markdown) file format

## DESCRIPTION
       /etc/network/interfaces  contains network interface configuration information for the [**ifup**(8)](https://www.chedong.com/phpMan.php/man/ifup/8/markdown)
       and [**ifdown**(8)](https://www.chedong.com/phpMan.php/man/ifdown/8/markdown) commands.  This manpage describes the vlan extensions to  the  standard  **inter**‐‐
       [**faces**(5)](https://www.chedong.com/phpMan.php/man/faces/5/markdown) 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)](https://www.chedong.com/phpMan.php/man/interfaces/5/markdown) by Ard van Breemen <<ard@kwaak.net>>

## SEE ALSO
### [vconfig(8)](https://www.chedong.com/phpMan.php/man/vconfig/8/markdown) [interfaces(5)](https://www.chedong.com/phpMan.php/man/interfaces/5/markdown)



vlan                                      September 30 2007                       [VLAN-INTERFACES(5)](https://www.chedong.com/phpMan.php/man/VLAN-INTERFACES/5/markdown)