vlanconfig(8)vlanconfig(8)NAMEvlanconfig - Configures or displays virtual Local Area Network (VLAN)
interfaces
SYNOPSIS
For creating a VLAN interface, use the following syntax:
/usr/sbin/vlanconfig -c interface-id [attribute,attribute,...]
For deleting a VLAN interface, use the following syntax:
/usr/sbin/vlanconfig -d interface-id
For displaying VLAN information, use the following syntax:
/usr/sbin/vlanconfig -s interface-id
OPTIONS
Creates a VLAN virtual interface. The interface-id is the VLAN virtual
interface name in the form vlann, where n is the unit number (for exam‐
ple, vlan1). It must be unique among all VLAN virtual interfaces on
the system. You must specify the following attributes (separated by
commas) to this option: Specifies the name of the lower interface (for
example, ee0) on which to configure a VLAN virtual interface; the VLAN
virtual interface is logically above interface-name. Specifies the
identifier of the VLAN in which to participate. This VLAN ID is con‐
tained in IEEE 802.1q tagged Ethernet frames. The ID must be unique
among all VLAN virtual interfaces configured on the same lower inter‐
face. If you specify the ID attribute, do not specify the untagged
attribute. Indicates that the VLAN virtual interface will use untagged
frames. A lower interface can have only one untagged VLAN virtual
interface created on it. If you specify the untagged attribute, do not
specify the id attribute. Deletes the specified VLAN virtual inter‐
face. Displays the attributes for the specified VLAN virtual interface
or an interface on which VLANs have been configured.
DESCRIPTION
The vlanconfig command allows you to perform the following tasks: Cre‐
ate VLAN virtual interfaces. Display attributes for a specified VLAN
virtual interface or an interface on which VLANs have been configured.
Delete VLAN virtual interfaces.
A VLAN provides the administrator with the ability to create logical
groups of systems that can communicate as if they were on the same LAN.
Multiple VLANs can exist on the same physical network. Traffic between
VLANs is restricted. Bridges forward all traffic, including broadcast
traffic, only to LAN segments that serve the VLAN to which the traffic
belongs.
You enable a network interface to participate in a particular VLAN by
creating a VLAN virtual interface. Upper-layer software uses these VLAN
virtual interfaces.
If you want to enable an interface for VLAN, you must not configure an
IP address on the interface, either through the Network Setup Wizard
(netconfig) or SysMan. You must configure IP addresses on the VLAN vir‐
tual interfaces.
Modifications made with the vlanconfig command do not persist across
reboots of the operating system. To configure the interface or modify
the parameters automatically each time the system is booted, edit the
inet.local file and add the vlanconfig command and ifconfig command
entries to it.
Any user can query the status of a VLAN; only the superuser can create
and modify the configuration of network interfaces.
EXAMPLES
To enable ee0 to participate in VLAN 12 using the vlan12 virtual inter‐
face, enter: vlanconfig-c vlan12 on=ee0,id=12 To enable ee0 to also
participate in VLAN 1004 using the vlan4 virtual interface, enter:
vlanconfig-c vlan4 on=ee0,id=1004 To enable ee0 to also receive
untagged frames the vlan0 virtual interface, enter: vlanconfig-c vlan0
on=ee0,untagged To enable a NetRAIN set with the virtual interface num‐
ber of nr3 to participate in VLAN 44 using the vlan44 virtual inter‐
face, enter: vlanconfig-c vlan44 on=nr3,id=44
Note
Both ee0 and nr3 must not have an IP address configured prior to
issuing the vlanconfig-c command. To display information about
the vlan4 virtual interface, enter: vlanconfig-s vlan4
VLAN interface vlan4 on ee0, untagged To verify that the
ee0 interface is in use by VLAN, enter: vlanconfig-s ee0
interface ee0 is in use by VLAN. To configure IP address
10.1.2.3 on the VLAN virtual interface vlan12 and bring the
interface up, enter: ifconfig vlan12 10.1.2.3 up To remove vir‐
tual interface vlan12, enter: vlanconfig-d vlan12
Note
The vlan12 virtual interface must not have an IP address config‐
ured and must not be UP prior to issuing the vlanconfig-d com‐
mand.
DIAGNOSTICS
You specified an invalid VLAN ID when you used the id=vlan-id
attribute. Valid VLAN IDs are from 1 to 4094, inclusive. You specified
a VLAN ID that was already in use on the lower interface when you used
the id=vlan-id or the untagged attribute. You specified an interface
that was either already reserved or on which IP addresses were already
configured when you used the on=interface-name attribute. You
attempted to create a VLAN virtual interface that already exists. You
specified a non-Ethernet interface when you used the on=interface-name
attribute. You specified a nonexistent interface for the -d or -s
option. You tried to use the -c or -d option, but were not superuser.
SEE ALSO
Commands: netstat(1), ifconfig(8), pfconfig(8), sysconfig(8)
Interfaces: vlan(7)
System Attributes: sys_attrs_vlan(5)
Network Administration: Connections
vlanconfig(8)