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:

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:

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:

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

}

 

SEE ALSO

protocol, stream.