Create VLAN

Synopsis

  vcreate --tag <tag> [--priority <priority>] <trunk interface>

Examples

Create VLAN 123 on interface "net0"

  vcreate --tag 123 net0

Boot from VLAN 123 on interface "net0"

  vcreate --tag 123 net0
  autoboot net0-123

Description

Create a VLAN network interface on an existing trunk network interface. The new network interface will be named by appending a hyphen and the VLAN tag value to the trunk network interface name. For example, if you execute

  vcreate --tag 123 net0

then this will create a VLAN network interface named net0-123.

You may optionally specify a default priority for outbound packets using the --priority option. If this option is omitted, it will default to zero.

Command status

Success The VLAN interface was successfully created
Failure The VLAN interface could not be created

See also

Build options

This command is available only when the build option VLAN_CMD is enabled.

Notes

Valid VLAN tag values are in the range 0 to 4094 inclusive. iPXE does not prevent you from creating a VLAN with tag 0 or tag 1, though some network switches may treat these VLAN tags as reserved.

You can use vcreate to redefine an existing VLAN interface. For example, you could create a VLAN interface with the default priority value of zero using

  vcreate --tag 123 net0

and then modify the priority using

  vcreate --tag 123 --priority 2 net0

Not all network link layers support VLANs. iPXE will refuse to create a VLAN network interface unless the trunk network interface uses Ethernet-style six-byte MAC addresses.

You cannot create nested VLAN interfaces.

cmd/vcreate.txt ยท Last modified: 2012/03/24 20:31 by mcb30
Recent changes RSS feed CC Attribution-Share Alike 4.0 International Driven by DokuWiki
All uses of this content must include an attribution to the iPXE project and the URL https://ipxe.org
References to "iPXE" may not be altered or removed.