{
    "content": [
        {
            "type": "text",
            "text": "# vlan-interfaces(5) (man)\n\n**Summary:** /etc/network/interfaces (vlan) - vlan extensions for the interfaces(5) file format\n\n## See Also\n\n- VLAN-INTERFACES(5)\n\n## Section Outline\n\n- **NAME** (2 lines)\n- **DESCRIPTION** (7 lines)\n- **VLAN CREATION** (36 lines)\n- **EXTRA IFACE OPTIONS** (19 lines)\n- **AUTHOR** (2 lines)\n- **SEE ALSO** (1 lines) — 1 subsections\n  - vconfig(8) interfaces(5) (1 lines)\n\n## Full Content\n\n### NAME\n\n/etc/network/interfaces (vlan) - vlan extensions for the interfaces(5) file format\n\n### DESCRIPTION\n\n/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\n### VLAN CREATION\n\nVlan 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\n### EXTRA IFACE OPTIONS\n\nUsually 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\n### AUTHOR\n\nThis manpage was adapted from interfaces(5) by Ard van Breemen <ard@kwaak.net>\n\n### SEE ALSO\n\n#### vconfig(8) interfaces(5)\n\nvlan                                      September 30 2007                       VLAN-INTERFACES(5)\n\n"
        }
    ],
    "structuredContent": {
        "command": "vlan-interfaces",
        "section": "5",
        "mode": "man",
        "summary": "/etc/network/interfaces (vlan) - vlan extensions for the interfaces(5) file format",
        "synopsis": null,
        "flags": [],
        "examples": [],
        "see_also": [
            {
                "name": "VLAN-INTERFACES",
                "section": "5",
                "url": "https://www.chedong.com/phpMan.php/man/VLAN-INTERFACES/5/json"
            }
        ],
        "section_outline": [
            {
                "name": "NAME",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "DESCRIPTION",
                "lines": 7,
                "subsections": []
            },
            {
                "name": "VLAN CREATION",
                "lines": 36,
                "subsections": []
            },
            {
                "name": "EXTRA IFACE OPTIONS",
                "lines": 19,
                "subsections": []
            },
            {
                "name": "AUTHOR",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "SEE ALSO",
                "lines": 1,
                "subsections": [
                    {
                        "name": "vconfig(8) interfaces(5)",
                        "lines": 1
                    }
                ]
            }
        ]
    }
}