isl
isl - configure the Cisco Inter-Switch Link (ISL) parameters for a port on a card on a chassis
SYNOPSIS
isl sub-command options
DESCRIPTION
The isl command is used to configure the ISL-specific information used when building ISL-type packets. This is enabled using protocol config -enableISLtag true. The encapsulated frame's Source and Destination MAC addresses are configured through the stream config -da and -sa commands. See stream. The previously documented options to the isl command encapDA and encapSA, should not be used to set the MAC addresses but may be used to view the values.
STANDARD OPTIONS
bpdu
Set for all Bridge Protocol Data Units that are encapsulated by the ISL packet. (default = 0)
encapDA
Read-only. This value is set through the use of stream config -da.
encapSA
Read-only. This value is set through the use of stream config -sa.
frameType
The type field indicates the type of frame that is encapsulated. Options include:
Option |
Value |
Usage |
---|---|---|
islFrameEthernet |
0 |
(default) |
islFrameTokenRing |
1 |
|
islFrameFDDI |
2 |
|
islFrameATM |
3 |
|
index
Value of the selected register. (default = 0)
islDA
The address is a multicast address whose value in the first 40 bits of the DA indicate to the receiver that the packet is in ISL format. (default = {01 00 0C 00 00})
islSA
The source MAC address. The upper 3 bytes of this field are reflected in the hsa field. (default = {00 00 0C 00 00 00})
length
Read-Only. The calculated length of the ISL header.
reserved
The reserved field of the ISL header. (default = {00 00})
userPriority
The low order two bits of this field indicate the priority of the packet as it passes through the switch. Priorities 0 to 7 are valid. (default = 0)
vlanID
The Virtual LAN Identifier. (default = 1)
COMMANDS
The isl command is invoked with the following sub-commands. If no sub-command is specified, returns a list of all sub-commands available.
isl cget option
Returns the current value of the configuration option given by option. Option may have any of the values accepted by the isl command.
isl config option value
Modify the ISL configuration options of the port. If no option is specified, returns a list describing all of the available ISL options (see STANDARD OPTIONS) for port.
isl decode capFrame [chasID cardID portID]
Decodes a captured frame in the capture buffer and updates TclHal. isl cget option command can be used after decoding to get the option data. Specific errors are:
- No connection to a chassis
- Invalid port number
- The captured frame is not a valid ISL frame
isl get chasID cardID portID
Gets the current ISL configuration of the port with id portID on card cardID, chassis chasID. Call this command before calling isl cget option to get the value of the configuration option. Specific errors are:
- No connection to a chassis
- Invalid port number
isl set chasID cardID portID
Sets the ISL configuration of the port with id portID on card cardID, chassis chasID by reading the configuration option values set by the isl config option value command. Specific errors are:
- No connection to a chassis
- Invalid port number
- The port is being used by another user
- The configured parameters are not valid for this port
isl setDefault
Sets to IxTclHal default values for all configuration options.
EXAMPLES
package require IxTclHal
set host localhost
set username user
# Check if we're running on UNIX - connect to the TCL Server
# which must be running on the chassis
if [isUNIX] {
if [ixConnectToTclServer $host] {
ixPuts "Could not connect to $host"
return 1
}
}
# Now connect to the chassis
if [ixConnectToChassis $host] {
ixPuts $::ixErrorInfo
return 1
}
# Get the chassis ID to use in port lists
set chas [ixGetChassisID $host]
set card 1
set port 1
set portList [list [list $chas $card $port]]
# Login before taking ownership
if [ixLogin $username] {
ixPuts $::ixErrorInfo
return 1
}
# Take ownership of the ports we'll use
if [ixTakeOwnership $portList] {
ixPuts $::ixErrorInfo
return 1
}
stream setDefault
protocol setDefault
protocol config -name ipV4
protocol config -ethernetType ethernetII
protocol config -enableISLtag true
isl setDefault
isl config -vlanID 42
isl set $chas $card $port
stream config -sa {01 02 03 04 05 06}
stream config -da {02 03 04 05 06 07}
stream set $chas $card $port 1
ixWriteConfigToHardware portList
# Let go of the ports that we reserved
ixClearOwnership $portList
# Disconnect from the chassis we're using
ixDisconnectFromChassis $host
# If we're running on UNIX, disconnect from the TCL Server
if [isUNIX] {
ixDisconnectTclServer $host
}