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:
- No entry for the VPI/VCI - port
- Port is not available
- ATM is not supported on this port
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:
- No connection to the chassis
- Invalid port - not available or in use
- Invalid VPI/VCI
- Invalid filter parameters
- ATM feature is not supported on this port
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"
}