stackedVlan
stackedVlan - configure a stack of VLAN entries
SYNOPSIS
stackedVlan sub-command options
DESCRIPTION
The stackedVlan command is used to configure an ordered stack of VLAN entries. This command is only used when the enable802dot1qTag in the protocol command is set to vlanStacked. Elements of the stack are constructed in the vlan command. The top two elements of the stack are always present and may be modified by using the setVlan sub-command. Other elements are added to the bottom of the stack using addVlan; they may later be modified with the setVlan sub-command.
The top two VLANs in a stack may be configured to increment or decrement their VLAN ID. They may either increment/decrement independently or operate in a special nested mode. To use nested mode, the top (outer) VLAN should be set to one of the non-nested increment/decrements modes and the second (inner) VLAN should be set to the nested increment or decrement mode. In this mode the inner VLAN's ID changes most rapidly.
STANDARD OPTIONS
numVlans
Read-only. The number of VLANs in the stack.
COMMANDS
The stackedVlan command is invoked with the following sub-commands. If no sub-command is specified, returns a list of all sub-commands available.
stackedVlan addVlan
The VLAN specification found in the vlan command is pushed onto the bottom of the stack. Any use of increment/decrement modes is ignored. Specific errors are:
- The VLAN could not be added.
stackedVlan cget option
Returns the current value of the configuration option given by option. Option may have any of the values accepted by the stackedVlan command.
stackedVlan decode capSlice chasID cardID portID
Decodes a captured slice/frame that contains VLAN(s), populating the vlan command with the top VLAN in the stack. Other VLANs may be accessed by using the getFirstVlan, getNextVlan and getVlan sub-commands. Specific errors are:
- No connection to a chassis
- The captured frame does not contain any VLANs.
stackedVlan delVlan index
Deletes the VLAN from the stack at the index'd position. The top of the stack is numbered 1. The top two stack elements may not be deleted. Specific errors include:
- The top two stack elements may not be deleted.
- There is no VLAN at the index'd position.
stackedVlan get chasID cardID portID
Gets the current configuration of the stackedVlan frame for port with id portID on card cardID, chassis chasID. from its hardware. Call this command before calling stackedVlan cget option value to get the value of the configuration option. Specific errors are:
- No connection to a chassis
- Invalid port number
- The port is not available.
- Stacked VLANs are not supported by the port.
- Stacked VLAN data is not available; a stream get may be needed.
stackedVlan getFirstVlan
Retrieves the first VLAN from the stack; the values are available in the vlan command. Specific errors include:
- There are no VLANs in the list.
stackedVlan getNextVlan
Retrieves the next VLAN from the stack; the values are available in the vlan command. Specific errors include:
- There are no more VLANs in the list.
stackedVlan getVlan index
Retrieves the VLAN from the stack at the index'd position; the values are available in the vlan command. The top of the stack is numbered 1. Specific errors include:
- There is no VLAN at the index'd position.
stackedVlan set chasID cardID portID
Sets the configuration of the stackedVlan in IxHAL for port with id portID on card cardID, chassis chasID by reading the configuration option values set by the stackedVlan config option value command. Specific errors are:
- No connection to a chassis
- Invalid port number
- The port is being used by another user
- Configured parameters are not valid for this setting
- Stacked VLANs are not supported by this port.
stackedVlan setDefault
Sets to IxTclHal default values for all configuration options.
stackedVlan setVlan index
Sets the VLAN from the stack at the index'd position using the values from the vlan command. The top of the stack is numbered 1. This may be used to change an existing VLAN stack element in place. Specific errors include:
- There is no VLAN at the index'd position.
EXAMPLES
See examples under vlan