{
    "mode": "man",
    "parameter": "VLAN-INTERFACES",
    "section": "5",
    "url": "https://www.chedong.com/phpMan.php/man/VLAN-INTERFACES/5/json",
    "generated": "2026-06-15T18:52:36Z",
    "sections": {
        "NAME": {
            "content": "/etc/network/interfaces (vlan) - vlan extensions for the interfaces(5) file format\n",
            "subsections": []
        },
        "DESCRIPTION": {
            "content": "/etc/network/interfaces  contains network interface configuration information for the ifup(8)\nand ifdown(8) commands.  This manpage describes the vlan extensions to  the  standard  inter-\nfaces(5) file format.\n\nPrimary  extensions exist to make and destroy vlan interfaces, secondary extensions exist for\nipv4 interface manipulation which are generally needed when using (a lot of) vlans.\n",
            "subsections": []
        },
        "VLAN CREATION": {
            "content": "Vlan interface definitions exist of the vlan interface name, and an optional 'raw-device' pa-\nrameter.   Vlan  interfaces  are  numbered  1 to 4095.  You have the option to have interface\nnames zero-padded to 4 numbers, or just the plain digits without leading zero.  The following\nexample  shows  four  ways  to create a vlan with id 1 on interface eth0.  They all result in\ndifferent names.\n\niface eth0.1 inet static\naddress 192.168.1.1\nnetmask 255.255.255.0\n\niface vlan1 inet static\nvlan-raw-device eth0\naddress 192.168.1.1\nnetmask 255.255.255.0\n\niface eth0.0001 inet static\naddress 192.168.1.1\nnetmask 255.255.255.0\n\niface vlan0001 inet static\nvlan-raw-device eth0\naddress 192.168.1.1\nnetmask 255.255.255.0\n\n# We don't have br support out of the box\niface br0.2 inet static\nvlan-raw-device br0\naddress 192.168.1.1\nnetmask 255.255.255.0\n\n# Aliases are ignored\niface br0.2:1 inet static\naddress 192.168.1.1\nnetmask 255.255.255.255\n",
            "subsections": []
        },
        "EXTRA IFACE OPTIONS": {
            "content": "Usually someone who uses vlans also wants to do some other manipulations with the ip stack or\ninterface.\n\nvlan-raw-device devicename\nIndicates  the  device  to create the vlan on.  This is ignored when the devicename is\npart of the vlan interface name.\n\nip-proxy-arp 0|1\nTurn proxy-arp off or on for this specific interface.  This also works on plain ether-\nnet like devices.\n\nip-rp-filter 0|1|2\nSet the return path filter for this specific interface.  This also works on plain eth-\nernet like devices.\n\nhw-mac-address mac-address\nThis sets the mac address of the interface before bringing it up.  This works  on  any\ndevice that allows setting the hardware address with the ip command.\n",
            "subsections": []
        },
        "AUTHOR": {
            "content": "This manpage was adapted from interfaces(5) by Ard van Breemen <ard@kwaak.net>\n",
            "subsections": []
        },
        "SEE ALSO": {
            "content": "vconfig(8) interfaces(5)\n\nvlan                                    September 30 2007                      VLAN-INTERFACES(5)",
            "subsections": []
        }
    },
    "summary": "/etc/network/interfaces (vlan) - vlan extensions for the interfaces(5) file format",
    "flags": [],
    "examples": [],
    "see_also": [
        {
            "name": "vconfig",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/vconfig/8/json"
        },
        {
            "name": "interfaces",
            "section": "5",
            "url": "https://www.chedong.com/phpMan.php/man/interfaces/5/json"
        }
    ]
}