Index Index for
Section 8
Index Alphabetical
listing for V
Bottom of page Bottom of
page		 

vlanconfig(8)


NAME

  vlanconfig - 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

  -c  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
      example, 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:

      on=interface-name
	  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.

      id=vlan-id
	  Specifies the identifier of the VLAN in which to participate. This
	  VLAN ID is contained in IEEE 802.1q tagged Ethernet frames. The ID
	  must be unique among all VLAN virtual interfaces configured on the
	  same lower interface.	 If you specify the ID attribute, do not
	  specify the untagged attribute.

      untagged
	  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.

  -d  Deletes the specified VLAN virtual interface.

  -s  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:

    ·  Create 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 virtual
  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

   1.  To enable ee0 to participate in VLAN 12 using the vlan12 virtual
       interface, enter:
	    vlanconfig -c vlan12 on=ee0,id=12

   2.  To enable ee0 to also participate in VLAN 1004 using the vlan4 virtual
       interface, enter:
	    vlanconfig -c vlan4 on=ee0,id=1004

   3.  To enable ee0 to also receive untagged frames the vlan0 virtual
       interface, enter:
	    vlanconfig -c vlan0 on=ee0,untagged

   4.  To enable a NetRAIN set with the virtual interface number of nr3 to
       participate in VLAN 44 using the vlan44 virtual interface, 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.

   5.  To display information about the vlan4 virtual interface, enter:
	    vlanconfig -s vlan4
		 VLAN interface vlan4 on ee0, untagged

   6.  To verify that the ee0 interface is in use by VLAN, enter:
	    vlanconfig -s ee0
		 interface ee0 is in use by VLAN.

   7.  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

   8.  To remove virtual interface vlan12, enter:
	    vlanconfig -d vlan12

					Note

	 The vlan12 virtual interface must not have an IP address configured
	 and must not be UP prior to issuing the vlanconfig -d command.


DIAGNOSTICS

  vlanconfig: invalid VLAN ID id
      You specified an invalid VLAN ID when you used the id=vlan-id
      attribute. Valid VLAN IDs are from 1 to 4096, inclusive.

  vlanconfig: subsystem error: Address already in use
      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.

  vlanconfig: subsystem error: Device busy
      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.

  vlanconfig: subsystem error: File exists
      You attempted to create a VLAN virtual interface that already exists.

  vlanconfig: subsystem error: Invalid argument
      You specified a non-Ethernet interface when you used the on=interface-
      name attribute.

  vlanconfig: subsystem error: No such device
      You specified a nonexistent interface for the -d or -s option.

  vlanconfig: subsystem error: Permission denied
      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

Index Index for
Section 8
Index Alphabetical
listing for V
Top of page Top of
page