ixStopCapture

ixStopCapture - stop capture on a group of ports simultaneously

SYNOPSIS

ixStopCapture portList

DESCRIPTION

The ixStopCapture command sends a message to the IxServer to stop capture on a group of ports simultaneously. The ports may span multiple chassis.

ARGUMENTS
portList

(By reference) The list of ports in one of the following formats:

one2oneArray, one2manyArray, many2oneArray, many2manyArray

Or a reference to a list. For example, pl after

set pl {{1 1 1} {1 1 2} {1 1 3} {1 1 4}} -or-

set pl {1,1,1 1,1,2 1,1,3 1,1,4}

RETURNS
0

No error; the command was successfully delivered to the IxServer.

1

Error; the command was delivered to the IxServer but it could not process the message.

EXAMPLES

package require IxTclHal

set host galaxy

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 cardA 1

set portA 1

set cardB 1

set portB 2

# Examples of four ways to make a port list

set portList1 [list $chas,$cardA,$portA]

set portList2 [list $chas,$cardA,$portA $chas,$cardB,$portB]

set portList3 [list [list $chas $cardA $portA] [list $chas $cardB $portB]]

set portList4 [list [list $chas,$cardA,$portA] [list $chas,$cardB,$portB]]

# Login before taking ownership

if [ixLogin $username] {

ixPuts $::ixErrorInfo

return 1

}

# Take ownership of the ports we'll use

if [ixTakeOwnership $portList4] {

ixPuts $::ixErrorInfo

return 1

}

map new -type one2one

map config -type one2one

map add $chas $cardA $portA $chas $cardB $portB

map add $chas $cardB $portB $chas $cardA $portA

port setDefault

port set $chas $cardA $portA

port set $chas $cardB $portB

ixWritePortsToHardware one2oneArray

after 1000

if {[ixCheckLinkState one2oneArray] != 0} {

ixPuts "Link is not up"

}

if {[ixStopCapture portList1] != 0} {

ixPuts "Could not Stop capture on $portList1"

}

if {[ixStopCapture portList2] != 0} {

ixPuts "Could not Stop capture on $portList2"

}

if {[ixStopCapture portList3] != 0} {

ixPuts "Could not Stop capture on $portList3"

}

if {[ixStopCapture portList4] != 0} {

ixPuts "Could not Stop capture on $portList4"

}

if {[ixStopCapture one2oneArray] != 0} {

ixPuts "Could not Stop capture on $one2oneArray"

}

# Stop transmit and wait a bit

ixStopTransmit one2oneArray

after 1000

# Let go of the ports that we reserved

ixClearOwnership $portList4

# 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

ixStartCapture, ixStartPortCapture, ixStopPortCapture