MAN page from openSUSE Tumbleweed wicked-0.6.45-1.1.i586.rpm

IFCFG-VLAN

Section: Network configuration (5)
Updated: January 2014
Index

 

NAME

ifcfg-vlan - virtual LAN interface configuration 

SYNOPSIS

/etc/sysconfig/network/ifcfg-*

 

Virtual LANs (802.1q)

To setup a vlan interface you need a configuration file that contains atleast the mandatory

ETHERDEVICE

variable with the real interface used for the virtual LAN.

It may contain the optional

VLAN_PROTOCOL

variable that may be set to one of the supported protocols: "ieee802-1Q", "ieee802-1ad".

Further, it may contain the optional

VLAN_ID

variable that specifies the VLAN ID.

By default and when the VLAN_ID variable is not set, thenumber at the end of the interface name is the VLAN ID.

Preferably the interface name and the configuration file follow theVLAN interface name schemes (types), that is either:

ifcfg-name.<VLAN-ID> (e.g. ifcfg-eth0.42)

or

ifcfg-vlan<VLAN-ID> (e.g. ifcfg-vlan42)

The ifcfg-name.<VLAN-ID> scheme is default on Linux.Note also, that the ifcfg-vlan<VLAN-ID> scheme makesit impossible to use same VLAN-ID on more than one interface(e.g. ifcfg-eth0.42 and ifcfg-eth1.42).

The VLAN-ID can be also 0-padded (e.g. ifcfg-vlan0042 or ifcfg-eth0.0042).

Also in case of custom names, trailing digits are interpreted as VLAN-IDby default (e.g. ifcfg-dmz42). When VLAN_ID is set in the config,the interface name can have any name (e.g. ifcfg-foobar).

Note: The drawback of custom interface names and VLAN_ID usage is,that a rename of the interface is required and that they violatethe vlan name scheme.

An ifcfg- file for the interface specified by ETHERDEVICE mustalso be provided. In the most basic case, it should at least containSTARTMODE='auto'.

The rest of the VLAN interface IP and routes configuration do not differfrom ordinary interfaces. See also man ifcfg and man routesfor details.

 

EXAMPLES

Sets up eth0.3 vlan interface on top of eth0:

ifcfg-eth0.3

   STARTMODE='auto'   ETHERDEVICE='eth0'   IPADDR='192.168.3.27/24'

Sets up vlan3 vlan interface on top of eth0:

ifcfg-vlan3

   STARTMODE='auto'   ETHERDEVICE='eth0'   IPADDR='192.168.3.27/24'

Sets up lan1 vlan interface with ID 42 on top of eth0:

ifcfg-lan1

   STARTMODE='auto'   ETHERDEVICE='eth0'   VLAN_ID='42'   IPADDR='192.168.3.27/24'

 

BUGS

Please report bugs at <http://www.suse.de/feedback> 

AUTHOR

Mads Martin Joergensen <mmjAATTsuse.de>Marius Tomaschewski <mtAATTsuse.de>

 

SEE ALSO

routes(5),ifcfg(5),wicked(8).

---

 

Index

NAME

SYNOPSIS

Virtual LANs (802.1q)

EXAMPLES

BUGS

AUTHOR

SEE ALSO

---

This document was created byman2html,using the manual pages.