atmFilter

atmFilter - set up capture filters based on ATM packet contents.

SYNOPSIS

atmFilter sub-command options

DESCRIPTION

The atmFilter command is used to set up capture/filter values for use with ATM ports. The frame data from one or more VPI/VCIs may be used to set the User Defined Statistics 1/2 (UDS 1, UDS 2), capture trigger or capture filter. The settings for a particular VPI/VCI on a port are set up with the STANDARD OPTIONS and then memorized by the set sub-command.

STANDARD OPTIONS
comparisonData

The data to compare the received frame against, using the comparisonMask to mask the value. (default = {00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00})

comparisonMask

The mask to be used in comparing received frame data. A bit value of `1' in the mask causes that corresponding bit in comparisonData to be ignored. (default = {FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF })

enable true | false

If true, this entry is used. (default = false)

enableUds1 true | false

If true, this entry is used as the user defined statistic 1 source. (default = false)

enableUds2 true | false

If true, this entry is used as the user defined statistic 2 source. (default = false)

enableFilter true | false

If true, this entry is used as the capture filter source. (default = false)

enableTrigger
true | false

If true, this entry is used as the capture trigger source. (default = false)

COMMANDS

The atmFilter command is invoked with the following sub-commands. If no sub-command is specified, returns a list of all sub-commands available.

atmFilter cget option

Returns the current value of the configuration option given by option. Option may have any of the values accepted by the atmFilter command.

atmFilter config option value

Modify the configuration options of the atmFilter. If no option is specified, returns a list describing all of the available options (see STANDARD OPTIONS) for atmFilter.

atmFilter get chasID cardID portID vpi vci

Gets the options associated with a particular VPI/VCI on a port. Specific errors are as follows:

atmFilter set chasID cardID portID vpi vci

Sets the options associated with a particular VPI/VCI on a port. The port should be in the current reassembly list (atmReassembly) before setting the filter. Specific errors are as follows:

atmFiltersetDefault

Sets to IxTclHal default values for all configuration options.

EXAMPLES

package require IxTclHal

set chassis 1

set card 42

set vpi 1

set vci 17

# Set port 1 to UDS1, match on Ox42 in the first 7 bits

atmFilter setDefault

atmFilter config -enable true

atmFilter config -enableUds1 true

atmFilter config -comparisonData {42}

atmFilter config -comparisonMask {01}

if [atmFilter set $chassis $card 1 $vpi $vci] {

ixPuts "Error in atmFilter set"

}

# Set port 2 to capture trigger, match on 8th bit on

atmFilter setDefault

atmFilter config -enable true

atmFilter config -enableTrigger true

atmFilter config -comparisonData {01}

atmFilter config -comparisonMask {FE}

if [atmFilter set $chassis $card 2 $vpi $vci] {

ixPuts "Error in atmFilter set"

}

SEE ALSO

atmReassembly, atmStat