Show, Clear, Monitor, and Debug Command Reference

Command Hierarchies

Show Commands

show
— filter
dhcp [filter-id]
dhcp6 [filter-id]
ip [filter-type filter-type]
ip embedded [inactive]
ip ip-filter-id embedded [inactive]
ip ip-filter-id [detail]
ip ip-filter-id associations
ip ip-filter-id type entry-type
ip ip-filter-id counters [type entry-type][detail]
ip ip-filter-id entry entry-id [counters] [detail]
ipv6 [filter-type filter-type]
ipv6 embedded [inactive]
ipv6 ipv6-filter-id embedded [inactive]
ipv6 ipv6-filter-id [detail]
ipv6 ipv6-filter-id associations
ipv6 ipv6-filter-id type entry-type
ipv6 ipv6-filter-id counters [type entry-type]
ipv6 ipv6-filter-id entry entry-id [counters][detail]
log [bindings]
log log-id [match string]
mac {mac-filter-id [entry entry-id] [association | counters]}
ip-prefix-list [prefix-list-name]
ip-prefix-list prefix-list-name references
ipv6-prefix-list [prefix-list-name]
ipv6-prefix-list prefix-list-name references
port-list [port-list-name]
port-list port-list-name references
redirect-policy [redirect-policy-name {dest ip-address|associations}]
system-filter [chained-to]

Clear Commands

clear
— filter
ip filter-id [entry entry-id] [ingress | egress]
ipv6 ipv6-filter-id [entry entry-id] [ingress | egress]
log log-id
mac mac-filter-id [entry entry-id] [ingress | egress]

Monitor Commands

monitor
— filter
ip filter-id entry entry-id [interval seconds] [repeat repeat] [absolute | rate]
ipv6 ipv6-filter-id entry entry-id [interval seconds] [repeat repeat] [absolute | rate]
mac mac-filter-id entry entry-id [interval seconds] [repeat repeat] [absolute | rate]

Debug Commands

tools
— dump
— filter
— resources
cpm
dest-tracking {sap | sdp | ip | ipv6} [detail]
egress-pbr [detail]
iom [slot-number]
ip filter-id
ipv6 filter-id
mac filter-id

Tools Commands

tools
— perform
— filter
— ip-filter
— entry
— ipv6-filter
— entry
— mac-filter
— entry
— redirect-policy

Command Descriptions

Show Commands

The following command outputs are examples only; actual displays may differ depending on supported functionality and user configuration.

dhcp

Syntax 
dhcp [filter-id]
Context 
show>filter
Description 

This command displays DHCP filter information.

Parameters 
filter-id—
Displays detailed information for the specified filter ID and its filter entries.
Values—
1 — 65535
Output 

The following is a sample command output for the command when no filter ID is specified.

Sample Output
*B:TechPubs>config# show filter dhcp
===============================================================================
DHCP Filters
===============================================================================
Filter-Id   Applied Description
-------------------------------------------------------------------------------
10          No      test-dhcp-filter
-------------------------------------------------------------------------------
Num filter entries: 1
===============================================================================
*B:TechPubs>config#
 
 
*B:TechPubs>config# show filter dhcp 10
===============================================================================
DHCP Filter
===============================================================================
Filter-Id    : 10                       Applied      : No
Entries      : 0
Description  : test-dhcp-filter
-------------------------------------------------------------------------------
Filter Match Criteria
-------------------------------------------------------------------------------
No Match Criteria Found
===============================================================================
*B:TechPubs>config#

dhcp6

Syntax 
dhcp6 [filter-id]
Context 
show>filter
Description 

This command displays DHCP6 filter information.

Parameters 
filter-id—
displays detailed information for the specified filter ID and its filter entries
Values—
1 to 65535

ip

Syntax 
ip [filter-type filter-type]
ip embedded [inactive]
ip ip-filter-id embedded [inactive]
ip ip-filter-id [detail]
ip ip-filter-id associations
ip ip-filter-id type entry-type
ip ip-filter-id counters [type entry-type][detail]
ip ip-filter-id entry entry-id [counters]
Context 
show>filter
Description 

This command shows IPv4 filter information.

Parameters 
filter-type filter-type—
specifies the type of filter to display
Values—
config, flowspec, host-common, tms, openflow, vsd
ip-filter-id—
specifies the IPv4 filter policy for which to display information. Values can be expressed in different formats; the following shows decimal integer format.
Values—
1 to 65535
entry entry-id
specifies the filter policy entry (of the specified filter policy) for which to display information
Values—
1 to 65535
associations—
appends, to the detailed filter policy output, information about where the specified filter policy is applied
counters—
displays counter information for the specified filter ID. Egress counters count the packets without Layer 2 encapsulation. Ingress counters count the packets with Layer 2 encapsulation.
type entry-type
specifies type of filter entry to display:
Values—
fixed, radius-insert, credit-control-insert, flow-spec, embedded, radius-shared, pcc rule (applies only to the 7750 SR)
embedded [inactive]—
shows all embeddings, optionally shows inactive embedding only, if ip-filter-id is not specified shows all embedded filters
Output 

Show Filter (no filter-id specified) — The following is a sample output of IPv4 filter information when no filter ID is specified. Table 52 describes the command output fields.

Sample Output
A:ALA-49# show filter ip
===============================================================================
Configured IP Filters                                            Total:     2
===============================================================================
Filter-Id   Scope     Applied Description
-------------------------------------------------------------------------------
5           Template  Yes
6           Template  Yes
 
===============================================================================
Host Common IP Filters                                           Total:     2
===============================================================================
Filter-Id                     Description
-------------------------------------------------------------------------------
5:P4                          Auto-created PCC-Rule Ingress Filter
6:P5                          Auto-created PCC-Rule Egress Filter
===============================================================================
Num IP filters: 4
===============================================================================
Table 52:  Filter IP Output Fields (No Filter ID Specified) 

Label

Description

Filter Id

the IP filter ID

Scope

Template

The filter policy is of type template.

Exclusive

The filter policy is of type exclusive.

Applied

No

The filter policy ID has not been applied.

Yes

The filter policy ID is applied.

Description

the IP filter policy description

Show Filter (no filter-id specified, embedded keyword specified) — The following is a sample output of IPv4 filter information when no filter ID is specified but the embedded keyword is specified. Table 53 describes the command output fields.

Sample Output
*A:Dut-C>config>filter# show filter ip embedded
==================================================================================
IP Filter embedding
==================================================================================
In    From      Priority       Inserted      Status
----------------------------------------------------------------------------------
10    2           50          1/1           OK
      1           100         1/2           OK- 1 entry overwritten
 
20    2           100         0/5           Failed – out of resources
==================================================================================
Table 53:  Filter IP Output Fields (No Filter ID Specified, Embedded Keyword Specified) 

Label

Description

In

shows embedding filter index

From

shows embedded filters included

Priority

shows priority of embedded filter

Inserted

shows embedded/total number of entries from embedded filter

Status:

OK—embedding operation successful, if any entries are overwritten this will also be indicated

Failed—embedding failed, the reason is displayed (out of resources)

Show Filter (with filter-id specified) — The following is a sample output of IPv4 filter information with the filter ID specified. Table 54 describes the command output fields.

Sample Output
*A:dut-a_a>config>filter>ip-filter>entry>action$ show filter ip 2 
===============================================================================
IP Filter
===============================================================================
Filter Id           : 2                            Applied        : No
Scope               : Template                     Def. Action    : Drop
System filter       : Unchained
Radius Ins Pt       : n/a
CrCtl. Ins Pt       : n/a
RadSh. Ins Pt       : n/a
PccRl. Ins Pt       : n/a
Entries             : 1
Description         : (Not Specified)
-------------------------------------------------------------------------------
Filter Match Criteria : IP
-------------------------------------------------------------------------------
Entry               : 1
Description         : (Not Specified)
Log Id              : n/a
Src. IP             : 0.0.0.0/0
Src. Port           : n/a
Dest. IP            : 0.0.0.0/0
Dest. Port          : n/a
Protocol            : Undefined                    Dscp           : Undefined
ICMP Type           : Undefined                    ICMP Code      : Undefined
Fragment            : Off                          Src Route Opt  : Off
Sampling            : Off                          Int. Sampling  : On
IP-Option           : 0/0                          Multiple Option: Off
TCP-syn             : Off                          TCP-ack        : Off
Option-pres         : Off
Egress PBR          : Disabled
Primary Action      : Forward (Next Hop VRF)
   Next Hop          : 1.2.3.4
   Router            : Base
   PBR Target Status : Down
   Extended Action   : Remark DSCP "be"
Secondary Action    : Forward (Next Hop VRF)
   Next Hop          : 3.4.5.6
   Router            : 32
   PBR Target Status : Down
   Extended Action   : Remark DSCP "ef"
PBR Down Action     : Drop (entry-default)
Downloaded Action   : None
Dest. Stickiness    : None                         Hold Remain    : 0
Ing. Matches        : 0 pkts
Egr. Matches        : 0 pkts
===============================================================================
Table 54:  Show Filter IP (with Filter ID Specified) Output Fields 

Label

Description

Filter Id

the IP filter policy ID

Applied

No

The filter policy ID has not been applied.

Yes

The filter policy ID is applied.

Scope

Template

The filter policy is of type template.

Exclusive

The filter policy is of type exclusive.

Def. Action

Forward

The default action for the filter ID for packets that do not match the filter entries is to forward.

Drop

The default action for the filter ID for packets that do not match the filter entries is to drop.

System filter

indicates if the filter has been chained to a system filter

Radius Ins Pt

indicates the Radius insertion point, if any

CrCtl. Ins Pt

indicates the Credit Control insertion point, if any

RadSh. Ins Pt

indicates the Radius shared insertion point, if any

PccRl. Ins Pt

indicates the PCC rule insertion point, if any

Entries

the number of entries configured in this filter ID

Description

the IP filter policy entry description string

Filter Match Criteria

IP

indicates the filter is an IP filter policy

Entry

the filter ID filter entry ID. If the filter entry ID indicates the entry is (Inactive), then the filter entry is incomplete as no action has been specified.

Description

the IP filter policy entry description string

Log Id

the filter log ID

Src. IP

the source IPv4 address and prefix length match criterion

Src. Port

the source TCP, UDP, or SCTP port number, port range, or port match list

Dest. IP

the destination IPv4 address and prefix length match criterion

Dest. Port

the destination TCP, UDP, or SCTP port number, port range, or port match list

Protocol

the protocol for the match criteria. Undefined indicates no protocol specified.

Dscp

the DiffServ Code Point (DSCP) name

ICMP Type

the ICMP type match criterion. Undefined indicates no ICMP type specified.

ICMP Code

the ICMP code field in the ICMP header of an IP packet

Fragment

False

configures a match on all non-fragmented IP packets

True

configures a match on all fragmented IP packets

Off

Fragments are not a matching criteria. All fragments and non-fragments implicitly match.

Src Route Opt

indicates if the source route option has been set

Sampling

Off

specifies that traffic sampling is disabled

On

specifies that traffic matching the associated IP filter entry is sampled

Int. Sampling

Off

Interface traffic sampling is disabled.

On

Interface traffic sampling is enabled.

IP-Option

specifies matching packets with a specific IP option or a range of IP options in the IP header for IP filter match criteria

Multiple Option

Off

The option fields are not checked.

On

Packets containing one or more option fields in the IP header will be used as IP filter match criteria.

TCP-syn

False

configures a match on packets with the SYN flag set to false

True

configured a match on packets with the SYN flag set to true

Off

The state of the TCP SYN flag is not considered as part of the match criteria.

TCP-ack

False

configures a match on packets with the ACK flag set to false

True

configures a match on packets with the ACK flag set to true

Off

The state of the TCP ACK flag is not considered as part of the match criteria.

Option-present

Off

specifies not to search for packets that contain the option field or have an option field of zero

On

matches packets that contain the option field or have an option field of zero be used as IP filter match criteria

Egress PBR

indicates if the egress-pbr flag is set for this entry

Primary Action

indicates the configured action, if any. Indented sub-labels in the show output provide configured parameters for this action

Secondary Action

indicates the configured secondary action, if any. Indented sub-labels in the show output provide configured parameters for this action.

       PBR Target Status

the status of the target of the secondary action

       Extended Action

indicates the configured extended action, if any

PBR Down Action

indicates the matching action packets that the entry criteria will be subject to if the targets of the main actions are down

Downloaded Action

the action downloaded by CPM to IOM

Dest. Stickiness

indicates whether stickiness is configured

Hold Remain

the stickiness timer

Ing. Matches

the number of ingress filter matches/hits for the filter entry

Egr. Matches

the number of egress filter matches/hits for the filter entry

Show Filter Associations — The following is a sample output of IPv4 filter information when the associations keyword is specified. Table 55 describes the command output fields.

Sample Output
A:ALA-49# show filter ip 1 associations
===============================================================================
IP Filter
===============================================================================
Filter Id           : 4                            Applied        : Yes
Scope               : Template                     Def. Action    : Drop
System filter       : Unchained
Radius Ins Pt       : n/a
CrCtl. Ins Pt       : n/a
RadSh. Ins Pt       : n/a
PccRl. Ins Pt       : n/a
Entries             : 1
Description         : (Not Specified)
-------------------------------------------------------------------------------
Filter Association : IP
-------------------------------------------------------------------------------
Service Id          : 2                            Type           : VPLS
  - SAP    1/2/2   (Ingress)
-------------------------------------------------------------------------------
Filter associated with IOM: 1
===============================================================================
Table 55:  Filter IP Associations Output Fields 

Label

Description

Filter Id

the IP filter policy ID

Applied

No

the filter policy ID has not been applied

Yes

the filter policy ID is applied

Scope

Template

the filter policy is of type Template

Exclusive

the filter policy is of type Exclusive

Def. Action

Forward

the default action for the filter ID for packets that do not match the filter entries is to forward

Drop

the default action for the filter ID for packets that do not match the filter entries is to drop

System filter

indicates if the filter has been chained to a system filter

Radius Ins Pt

indicates the Radius insertion point, if any

CrCtl. Ins Pt

indicates the Credit Control insertion point, if any

RadSh. Ins Pt

indicates the Radius shared insertion point, if any

PccRl. Ins Pt

indicates the PCC rule insertion point, if any

Entries

the number of entries configured in this filter ID

Description

the IP filter policy description

Filter Association

indicates the filter is an IP filter policy

Service Id

the service ID on which the filter policy ID is applied

Type

the type of service of the service ID

SAP

the Service Access Point on which the filter policy ID is applied

(Ingress)

the filter policy ID is applied as an ingress filter policy on the interface

(Egress)

the filter policy ID is applied as an egress filter policy on the interface

Show Filter Counters — The following is a sample output of IPv4 filter information when the counters keyword is specified. Table 56 describes the command output fields.

Egress counters count the packets without Layer 2 encapsulation. Ingress counters count the packets with Layer 2 encapsulation.

Sample Output
*A:ALA-48# show filter ip 100 counters
===============================================================================
IP Filter
===============================================================================
Filter Id           : 4                            Applied        : Yes
Scope               : Template                     Def. Action    : Drop
System filter       : Unchained
Radius Ins Pt       : n/a
CrCtl. Ins Pt       : n/a
RadSh. Ins Pt       : n/a
PccRl. Ins Pt       : n/a
Entries             : 1
Description         : (Not Specified)
-------------------------------------------------------------------------------
Filter Match Criteria : IP
-------------------------------------------------------------------------------
Entry               : 4001
Ing. Matches        : 9788619 pkts (978861900 bytes)
Egr. Matches        : 9788619 pkts (978861900 bytes)
===============================================================================
Table 56:  Filter IP Counters Output Field Descriptions 

Label

Description

Filter Id

the IP filter policy ID

Applied

No

The filter policy ID has not been applied.

Yes

The filter policy ID is applied.

Scope

Template

The filter policy is of type Template.

Exclusive

The filter policy is of type Exclusive.

Def. Action

Forward

the default action for the filter ID for packets that do not match the filter entries is to forward

Drop

the default action for the filter ID for packets that do not match the filter entries is to drop

System filter

indicates if the filter has been chained to a system filter

Radius Ins Pt

indicates the Radius insertion point, if any

CrCtl. Ins Pt

indicates the Credit Control insertion point, if any

RadSh. Ins Pt

indicates the Radius shared insertion point, if any

PccRl. Ins Pt

indicates the PCC rule insertion point, if any

Entries

the number of entries configured in this filter ID

Description

the IP filter policy description

Filter Match Criteria

IP

indicates the filter is an IP filter policy

Entry

the filter ID filter entry ID. If the filter entry ID indicates the entry is (Inactive), then the filter entry is incomplete as no action has been specified.

Ing. Matches

the number of ingress filter matches/hits for the filter entry

Egr. Matches

the number of egress filter matches/hits for the filter entry

ipv6

Syntax 
ipv6 [filter-type filter-type]
ipv6 embedded [inactive]
ipv6 ipv6-filter-id embedded [inactive]
ipv6 ipv6-filter-id [detail]
ipv6 ipv6-filter-id associations
ipv6 ipv6-filter-id type entry-type
ipv6 ipv6-filter-id counters [type entry-type] [detail]
ipv6 ipv6-filter-id entry entry-id [counters] [detail]
Context 
show>filter
Description 

This command shows IPv6 filter information.

Parameters 
ipv6-filter-id—
Specifies the IPv6 filter policy for which to display information. Values can be expressed in different formats. The following only shows decimal integer format.
Values—
1 to 65535
entry entry-id
Specifies the filter policy entry (of the specified filter policy) for which only to display information..
Values—
1 to 65535
filter-type filter-type
Specifies the type of filter to display.
Values—
config, flowspec, host-common, tms, openflow, vsd.
associations—
Appends, to the detailed filter policy output, information as to where the specified filter policy ID is applied.
counters—
Displays counter information. Egress counters count the packets without Layer 2 encapsulation. Ingress counters count the packets with Layer 2 encapsulation.
embedded [inactive]—
Shows all embeddings, optionally shows inactive embedding only, if ipv6-filter-id is not specified shows all embedded filters.
type entry-type
Specifies type of filter entry to display:
Values—
fixed, radius-insert, credit-control-insert, embedded, radius-shared
Output 

Show Filter (no filter-id specified) — The following output is an example of IPv6 filter information when no filter ID is specified, and Table 57 describes the fields.

Sample Output
A:ALA-48# show filter ipv6
===============================================================================
IP Filters
===============================================================================
Filter-Id Scope      Applied Description
-------------------------------------------------------------------------------
100       Template   Yes     test
200       Exclusive  Yes
-------------------------------------------------------------------------------
Num IPv6 filters: 2
===============================================================================
A:ALA-48# show filter ipv6 embedded
================================================
IP Filter embedding
================================================
In    From      Priority       Inserted      Status
----------------------------------------------------------------------------------
10    2           50          1/1           OK
      1           100         1/2           OK- 1 entry overwritten
 
20    2           100         0/5           Failed – out of resources
================================================
A:ALA-48#
===============================================================================
Configured IP Filters                                            Total:     4
===============================================================================
Filter-Id   Scope     Applied Description
-------------------------------------------------------------------------------
1           Template  No      
5           Exclusive No      
10          Template  Yes     
100         Embedded  N/A     
===============================================================================
System IP Filters                                                Total:     1
===============================================================================
Filter-Id                     Description
-------------------------------------------------------------------------------
_tmnx_ofs_test                of-switch 'test' embedded filter
-------------------------------------------------------------------------------
Num IP filters: 5
==============================================================================
Table 57:  Filter IPv6 Output Fields  

Label

Description

Filter Id

the IP filter ID

Scope

Template

The filter policy is of type template.

Exclusive

The filter policy is of type exclusive.

Applied

No

The filter policy ID has not been applied.

Yes

The filter policy ID is applied.

Description

the IP filter policy description

In

shows embedding filter index

From

shows embedded filters included

Priority

shows priority of embedded filter

Inserted

shows embedded/total number of entries from embedded filter

Status:

OK—embedding operation successful, if any entries are overwritten this will also be indicated

Failed—embedding failed, the reason is displayed (out of resources)

In

shows embedding filter index

Show Filter (with filter-id specified) — The following output is an example of IPv6 filter information when filter-id is specified, and Table 58 describes the fields.

Sample Output
A:ALA-48# show filter ipv6 100
===============================================================================
IPv6 Filter
===============================================================================
Filter Id    : 100                              Applied        : Yes
Scope        : Template                         Def. Action    : Forward
Entries      : 1
Description : test
-------------------------------------------------------------------------------
Filter Match Criteria : IPv6
-------------------------------------------------------------------------------
Entry        : 10
Log Id       : 101
Src. IP      : ::/0                             Src. Port      : None
Dest. IP     : ::/0                             Dest. Port     : None
Next Header  : Undefined                        Dscp           : Undefined
ICMP Type    : Undefined                        ICMP Code      : Undefined
TCP-syn      : Off                              TCP-ack        : Off
Match action : Drop
Ing. Matches : 0                                Egr. Matches   : 0
===============================================================================
A:ALA-48#
Table 58:  Filter IPv6 with Filter-ID Specified Output Fields 

Label

Description

Filter Id

the IP filter policy ID

Scope

Template

The filter policy is of type template.

Exclusive

The filter policy is of type exclusive.

Entries

the number of entries configured in this filter ID

Description

the IP filter policy description

Applied

No

The filter policy ID has not been applied.

Yes

The filter policy ID is applied.

Def. Action

Forward

the default action for the filter ID for packets that do not match the filter entries is to forward

Drop

the default action for the filter ID for packets that do not match the filter entries is to drop

Filter Match Criteria

IP

indicates the filter is an IP filter policy

Entry

the filter ID filter entry ID. If the filter entry ID indicates the entry is (Inactive), then the filter entry is incomplete as no action has been specified.

Log Id

the filter log ID

Src. IP

the source IP address and mask match criterion. 0.0.0.0/0 indicates no criterion specified for the filter entry.

Dest. IP

the destination IP address and mask match criterion. 0.0.0.0/0 indicates no criterion specified for the filter entry.

Protocol

the protocol ID for the match criteria. Undefined indicates no protocol specified.

ICMP Type

the ICMP type match criterion. Undefined indicates no ICMP type specified.

Fragment

False

configures a match on all non-fragmented IP packets

True

configures a match on all fragmented IP packets

Off

fragments are not a matching criteria. All fragments and nonfragments implicitly match.

Sampling

Off

specifies that traffic sampling is disabled

On

specifies that traffic matching the associated IP filter entry is sampled

IP-Option

specifies matching packets with a specific IP option or a range of IP options in the IP header for IP filter match criteria

TCP-syn

False

configures a match on packets with the SYN flag set to false

True

configured a match on packets with the SYN flag set to true

Off

The state of the TCP SYN flag is not considered as part of the match criteria

Match action

Default

The filter does not have an explicit forward or drop match action specified. If the filter entry ID indicates the entry is (Inactive), then the filter entry is incomplete as no action has been specified.

Drop

drop packets matching the filter entry

Forward

The explicit action to perform is forwarding of the packet. If the action is Forward, then if configured the nexthop information should be displayed, including Nexthop: <IP address>, Indirect: <IP address> or Interface: <IP interface name>.

Ing. Matches

the number of ingress filter matches/hits for the filter entry

Src. Port

the source TCP, UDP, or SCTP port number, port range, or port match list

Dest. Port

the destination TCP, UDP, or SCTP port number, port range, or port match list

Dscp

the DiffServ Code Point (DSCP) name

ICMP Code

the ICMP code field in the ICMP header of an IP packet

Option-present

Off

specifies not to search for packets that contain the option field or have an option field of zero

On

matches packets that contain the option field or have an option field of zero be used as IP filter match criteria

Int. Sampling

Off

Interface traffic sampling is disabled.

On

Interface traffic sampling is enabled.

Multiple Option

Off

The option fields are not checked.

On

Packets containing one or more option fields in the IP header will be used as IP filter match criteria.

TCP-ack

False

configures a match on packets with the ACK flag set to false

True

configured a match on packets with the ACK flag set to true

Off

the state of the TCP ACK flag is not considered as part of the match criteria

Egr. Matches

the number of egress filter matches/hits for the filter entry

Ing. Rate-limiter

the number of offered, forwarded, and dropped packet matches for the filter entry

Show Filter Associations — The following output is an example of IPv6 filter information when the associations keyword is specified, and Table 59 describes the fields.

Sample Output
A:ALA-48# show filter ipv6 1 associations
===============================================================================
IPv6 Filter
===============================================================================
Filter Id    : 1                                Applied        : Yes
Scope        : Template                         Def. Action    : Drop
Entries      : 1
-------------------------------------------------------------------------------
Filter Association : IPv6
-------------------------------------------------------------------------------
Service Id   : 2000                             Type           : IES
 - SAP    1/1/1:2000   (Ingress)
===============================================================================
Filter Match Criteria : IPv6
-------------------------------------------------------------------------------
Entry        : 10
Log Id       : 101
Src. IP      : ::/0                             Src. Port      : None
Dest. IP     : ::/0                             Dest. Port     : None
Next Header  : Undefined                        Dscp           : Undefined
ICMP Type    : Undefined                        ICMP Code      : Undefined
TCP-syn      : Off                              TCP-ack        : Off
Match action : Drop
Ing. Matches : 0                                Egr. Matches   : 0
===============================================================================
A:ALA-48#
Table 59:  Filter IPv6 Associations Output Fields 

Label

Description

Filter Id

the IPv6 filter policy ID

Scope

Template

The filter policy is of type Template.

Exclusive

The filter policy is of type Exclusive.

Entries

the number of entries configured in this filter ID

Applied

No

the filter policy ID has not been applied

Yes

the filter policy ID is applied

Def. Action

Forward

the default action for the filter ID for packets that do not match the filter entries is to forward

Drop

the default action for the filter ID for packets that do not match the filter entries is to drop

Service Id

the service ID on which the filter policy ID is applied

SAP

the Service Access Point on which the filter policy ID is applied

(Ingress)

The filter policy ID is applied as an ingress filter policy on the interface.

(Egress)

The filter policy ID is applied as an egress filter policy on the interface.

Type

the type of service of the service ID

Entry

the filter ID filter entry ID. If the filter entry ID indicates the entry is Inactive, the filter entry is incomplete, no action was specified.

Log Id

the filter log ID.

Src. IP

the source IP address and mask match criterion. 0.0.0.0/0 indicates no criterion specified for the filter entry.

Dest. IP

the destination IP address and mask match criterion. 0.0.0.0/0 indicates no criterion specified for the filter entry.

Protocol

the protocol ID for the match criteria. Undefined indicates no protocol specified.

ICMP Type

the ICMP type match criterion. Undefined indicates no ICMP type specified.

Fragment

False

configures a match on all non-fragmented IP packets

True

configures a match on all fragmented IP packets

Off

Fragments are not a matching criteria. All fragments and nonfragments implicitly match.

Sampling

Off

specifies that traffic sampling is disabled

On

specifies that traffic matching the associated IP filter entry is sampled

IP-Option

specifies matching packets with a specific IP option or a range of IP options in the IP header for IP filter match criteria

TCP-syn

False

configures a match on packets with the SYN flag set to false

True

configures a match on packets with the SYN flag set to true

Off

The state of the TCP SYN flag is not considered as part of the match criteria.

Match action

Default

The filter does not have an explicit forward or drop match action specified. If the filter entry ID indicates the entry is Inactive, the filter entry is incomplete, no action was specified.

Drop

drop packets matching the filter entry

Forward

the explicit action to perform is forwarding of the packet. If the action is Forward, then if configured the nexthop information should be displayed, including Nexthop: <IP address>, Indirect: <IP address> or Interface: <IP interface name>.

Ing. Matches

the number of ingress filter matches/hits for the filter entry

Src. Port

the source TCP, UDP, or SCTP port number, port range, or port match list

Dest. Port

the destination TCP, UDP, or SCTP port number, port range, or port match list

Dscp

the DiffServ Code Point (DSCP) name

ICMP Code

the ICMP code field in the ICMP header of an IP packet

Option-present

Off

specifies not to search for packets that contain the option field or have an option field of zero

On

matches packets that contain the option field or have an option field of zero be used as IP filter match criteria

Int. Sampling

Off

Interface traffic sampling is disabled.

On

Interface traffic sampling is enabled.

Multiple Option

Off

The option fields are not checked.

On

Packets containing one or more option fields in the IP header will be used as IP filter match criteria.

TCP-ack

False

configures a match on packets with the ACK flag set to false

True

configured a match on packets with the ACK flag set to true

Off

the state of the TCP ACK flag is not considered as part of the match criteria

Egr. Matches

the number of egress filter matches/hits for the filter entry

Show Filter Counters — The following output is an example of IPv6 filter information when the counters keyword is specified, and Table 60 describes the output fields.

Egress count the packets without Layer 2 encapsulation. Ingress counters count the packets with Layer 2 encapsulation.

Sample Output
A:ALA-48# show filter ipv6 8 counters
===============================================================================
IPv6 Filter
===============================================================================
Filter Id    : 8                                Applied        : Yes
Scope        : Template                         Def. Action    : Forward
Entries      : 4
Description  : Description for Ipv6 Filter Policy id # 8
-------------------------------------------------------------------------------
Filter Match Criteria : IPv6
-------------------------------------------------------------------------------
Entry        : 5
Ing. Matches : 0 pkts
Egr. Matches : 0 pkts
  
Entry        : 6
Ing. Matches : 0 pkts
Egr. Matches : 0 pkts
  
Entry        : 8
Ing. Matches : 160 pkts (14400 bytes)
Egr. Matches : 80 pkts (6880 bytes)
                                       
Entry        : 10
Ing. Matches : 80 pkts (7200 bytes)
Egr. Matches : 80 pkts (6880 bytes)
  
====================================================================================
A:ALA-48#
Table 60:  Filter IPv6 Counters Output Fields 

Label

Description

IP Filter

Filter Id

the IP filter policy ID

Scope

Template

the filter policy is of type template

Exclusive

the filter policy is of type exclusive

Applied

No

the filter policy ID has not been applied

Yes

the filter policy ID is applied

Def. Action

Forward

the default action for the filter ID for packets that do not match the filter entries is to forward

Drop

the default action for the filter ID for packets that do not match the filter entries is to drop

Filter Match Criteria

IP

indicates the filter is an IP filter policy

Entry

The filter ID filter entry ID. If the filter entry ID indicates the entry is (Inactive), then the filter entry is incomplete as no action has been specified.

Ing. Matches

the number of ingress filter matches/hits for the filter entry

Egr. Matches

the number of egress filter matches/hits for the filter entry

Egress count the packets without Layer 2 encapsulation. Ingress counters count the packets with Layer 2 encapsulation.

log

Syntax 
log log-id [match string]
log [bindings]
Context 
show>filter
Description 

This command shows the contents of a memory-based or a file-based filter log.

If the optional keyword match and string parameter are given, the command displays the given filter log from the first occurrence of the given string.

Parameters 
log-id—
The filter log ID destination expressed as a decimal integer.
Values—
101 to 199
match string
Specifies to start displaying the filter log entries from the first occurrence of string.
bindings—
Displays the number of filter logs currently instantiated.
Output 

The following output is an example of filter log entry information, and Table 61 describes the fields. If log summary is active, the filter log mini-tables contain the information described in Table 62.

Sample Output
2007/04/13 16:23:09  Filter: 100:100  Desc: Entry-100                  
Interface: to-ser1  Action: Forward                                    
Src MAC: 04-5b-01-01-00-02  Dst MAC: 04-5d-01-01-00-02  EtherType: 0800
Src IP: 10.10.0.1:646  Dst IP: 10.10.0.4:49509  Flags:   TOS: c0       
Protocol: TCP  Flags: ACK                                              
                                                                       
2007/04/13 16:23:10  Filter: 100:100  Desc: Entry-100                  
Interface: to-ser1  Action: Forward                                    
Src MAC: 04-5b-01-01-00-02  Dst MAC: 04-5d-01-01-00-02  EtherType: 0800
Src IP: 10.10.0.1:646  Dst IP: 10.10.0.3:646  Flags:   TOS: c0         
Protocol: UDP                                                          
 
2007/04/13 16:23:12  Filter: 100:100  Desc: Entry-100                  
Interface: to-ser1  Action: Forward                                    
Src MAC: 04-5b-01-01-00-02  Dst MAC: 01-00-5e-00-00-05  EtherType: 0800
Src IP: 10.10.13.1  Dst IP: 224.0.0.5  Flags:   TOS: c0                
Protocol: 89                                                           
Hex: 02 01 00 30 0a 0a 00 01 00 00 00 00 ba 90 00 00                   
     00 00 00 00 00 00 00 00 ff ff ff 00 00 03 02 01                   
 
A:ALA-A>config# show filter log bindings
===============================================================================
Filter Log Bindings
===============================================================================
Total Log Instances (Allowed)          : 2046
Total Log Instances (In Use)           : 0
Total Log Bindings                     : 0
-------------------------------------------------------------------------------
Type  FilterId EntryId   Log    Instantiated
-------------------------------------------------------------------------------
No Instances found
===============================================================================
A:ALA-A>config#
 

A summary log will be printed only in case TotCnt is different from 0. Only the address types with at least 1 entry in the minitable will be printed.

A:ALA-A>config# show filter log 190
===============================================================================
Summary Log[190] Crit1: SrcAddr TotCnt:       723 ArpCnt:     83
 Mac          8  06-06-06-06-06-06
 Mac          8  06-06-06-06-06-05
 Mac          8  06-06-06-06-06-04
 Mac          8  06-06-06-06-06-03
 Mac          8  06-06-06-06-06-02
  Ip         16  6.6.6.1
  Ip         16  6.6.6.2
  Ip         16  6.6.6.3
  Ip         16  6.6.6.4
  Ip          8  6.6.6.5
Ipv6          8  3FE:1616:1616:1616:1616:1616::
Ipv6          8  3FE:1616:1616:1616:1616:1616:FFFF:FFFF
Ipv6          8  3FE:1616:1616:1616:1616:1616:FFFF:FFFE
Ipv6          8  3FE:1616:1616:1616:1616:1616:FFFF:FFFD
Ipv6          8  3FE:1616:1616:1616:1616:1616:FFFF:FFFC 
===============================================================================
A:ALA-A

Log Message Formatting — Each filter log entry contains the following information in case summary log feature is not active (as appropriate).

Table 61:  Filter Log Output Fields 

Label

Description

yyyy/mm/dd hh:mm:ss

The date and timestamp for the log filter entry where yyyy is the year, mm is the month, dd is the day, hh is the hour, mm is the minute and ss is the second.

Filter

The filter ID and the entry ID which generated the filter log entry in the form Filter_ID:Entry_ID.

Desc

The description of the filter entry ID which generated the filter log entry.

Interface

The IP interface on which the filter ID and entry ID was associated which generated the filter log entry.

Action

The action of the filter entry on the logged packet.

Src MAC

The source MAC address of the logged packet.

Dst MAC

The destination MAC of the logged packet.

EtherType

The Ethernet type of the logged Ethernet type II packet.

Src IP

The source IP address of the logged packet. The source port will be displayed after the IP address as appropriate separated with a colon.

Dst IP

The destination IP address of the logged packet. The source port will be displayed after the IP address as appropriate separated with a colon.

Flags

(IP flags)

M — The more fragments IP flag is set in the logged packet.

DF — The do not fragment IP flag is set in the logged packet.

TOS

The TOS byte value in the logged packet.

Protocol

The IP protocol of the logged packet (TCP, UDP, ICMP or a protocol number in hex).

Flags

(TCP flags)

URG — Urgent bit set.

ACK — Acknowledgment bit set.

RST — Reset bit set.

SYN — Synchronize bit set.

FIN — Finish bit set.

HEX

If an IP protocol does not have a supported decode, the first 32 bytes following the IP header are printed in a hex dump.

Log entries for non-IP packets include the Ethernet frame information and a hex dump of the first 40 bytes of the frame after the Ethernet header.

Total Log Instances (Allowed)

Specifies the maximum allowed instances of filter logs allowed on the system.

Total Log Instances (In Use)

Specifies the instances of filter logs presently existing on the system.

Total Log Bindings

Specifies the count of the filter log bindings presently existing on the system.

Type

The type of service of the service ID.

Filter ID

Uniquely identifies an IP filter as configured on the system.

Entry ID

The identifier which uniquely identifies an entry in a filter table.

Log

Specifies an entry in the filter log table.

Instantiated

Specifies if the filter log for this filter entry has or has not been instantiated.

If the packet being logged does not have a source or destination MAC address (that is, POS) then the MAC information output line is omitted from the log entry.

If log summary is active, the filter log mini-tables contain the information described in Table 62.

Table 62:  Filter Log Summary Mini-Table Fields 

Label

Description

Summary Log LogID

Displays the log ID.

Crit1

Summary criterion that is used as index into the mini-tables of the log.

TotCnt

The total count of logs.

ArpCnt

Displays the total number of ARP messages logged for this log ID.

Src...

Dst...

The address type indication of the key in the mini-table.

count

The number of messages logged with the specified source/destination address.

address

The address for which count messages where received.

mac

Syntax 
mac mac-filter-id
mac mac-filter-id associations
mac mac-filter-id associations [type entry-type] counters [detail]
mac [mac-filter-id ] embedded [inactive]
mac mac-filter-id entry entry-id [counters] [detail]
mac [filter-type filter-type ]
mac mac-filter-id type entry-type ]
Context 
show>filter
Description 

This command displays MAC filter information.

Parameters 
mac-filter-id—
Displays detailed information for the specified filter ID and its filter entries.
Values—
1 to 65535
associations—
Appends information as to where the filter policy ID is applied to the detailed filter policy ID output.
counters—
Displays counter information for the specified filter ID.
entry entry-id
Displays information on the specified filter entry ID for the specified filter ID only.
Values—
1 to 65535
type entry-type
Specify the type of filter entries as “fixed” or “embedded”.
filter-type filter-type
Specify the type of filter entries as “config” or “vsd”.
Output 

No Parameters Specified — A brief listing of MAC filters is produced when no parameters are specified; Table 63 describes the output fields.

Sample Output
Table 63:  Filter MAC Output Fields 

Label

Description

Filter Id

The MAC filter ID

Scope

Template

The filter policy is of type Template.

Exclusive

The filter policy is of type Exclusive.

Applied

No

The filter policy ID has not been applied.

Yes

The filter policy ID is applied.

Description

The MAC filter policy description.

Filter ID Specified — The following output is an example of MAC filter information when the filter ID is specified, and Table 64 describes the fields. Detailed filter information for the filter ID and its entries is produced when the filter ID is specified.

Sample Output
===============================================================================
Mac Filter : 200
===============================================================================
Filter Id       : 200               Applied       : No
Scope       : Exclusive               D. Action       : Drop
Description : Forward SERVER sourced packets
-------------------------------------------------------------------------------
Filter Match Criteria : Mac
-------------------------------------------------------------------------------
Entry       : 200              FrameType       : 802.2SNAP
Description       : Not Available
Src Mac       : 00:00:5a:00:00:00 ff:ff:ff:00:00:00
Dest Mac       : 00:00:00:00:00:00 00:00:00:00:00:00
Dot1p       : Undefined               Ethertype       : 802.2SNAP
DSAP       : Undefined              SSAP       : Undefined
Snap-pid       : Undefined               ESnap-oui-zero : Undefined
Match action      : Forward
Ing. Matches      : 0              Egr. Matches       : 0
Entry       : 300 (Inactive)               FrameType       : Ethernet
Description       : Not Available
Src Mac       : 00:00:00:00:00:00 00:00:00:00:00:00
Dest Mac       : 00:00:00:00:00:00 00:00:00:00:00:00
Dot1p       : Undefined               Ethertype       : Ethernet
DSAP       : Undefined               SSAP       : Undefined
Snap-pid       : Undefined               ESnap-oui-zero : Undefined
Match action      : Default
Ing. Matches      : 0               Egr. Matches       : 0
===============================================================================
Table 64:  Filter MAC with Filter-ID Specified Output Fields 

Label

Description

MAC Filter

Filter Id

The MAC filter policy ID.

Scope

Template

The filter policy is of type Template.

Exclusive

The filter policy is of type Exclusive.

Description

The MAC filter policy description.

Applied

No

The filter policy ID has not been applied.

Yes

The filter policy ID is applied.

Def. Action

Forward

The default action for the filter ID for packets that do not match the filter entries is to forward.

Drop

The default action for the filter ID for packets that do not match the filter entries is to drop.

Filter Match Criteria

MAC

Indicates the filter is an MAC filter policy.

Entry

The filter ID filter entry ID. If the filter entry ID indicates the entry is (Inactive), then the filter entry is incomplete as no action has been specified.

Description

The filter entry description.

FrameType

Ethernet

The entry ID match frame type is Ethernet IEEE 802.3.

Ethernet II

The entry ID match frame type is Ethernet Type II.

Src MAC

The source MAC address and mask match criterion. When both the MAC address and mask are all zeros, no criterion specified for the filter entry.

Dest MAC

The destination MAC address and mask match criterion. When both the MAC address and mask are all zeros, no criterion specified for the filter entry.

Dot1p

The IEEE 802.1p value for the match criteria. Undefined indicates no value is specified.

Ethertype

The Ethertype value match criterion.

DSAP

The DSAP value match criterion.

Undefined indicates no value specified.

SSAP

SSAP value match criterion. Undefined indicates no value specified.

Snap-pid

The Ethernet SNAP PID value match criterion. Undefined indicates no value specified.

Esnap-oui-zero

Non-Zero

Filter entry matches a non-zero value for the Ethernet SNAP OUI.

Zero

Filter entry matches a zero value for the Ethernet SNAP OUI.

Undefined

No Ethernet SNAP OUI value specified.

Match action

Default

The filter does not have an explicit forward or drop match action specified. If the filter entry ID indicates the entry is Inactive, the filter entry is incomplete, no action was specified.

Drop

Packets matching the filter entry criteria will be dropped.

Forward

Packets matching the filter entry criteria is forwarded.

Ing. Matches

The number of ingress filter matches/hits for the filter entry.

Egr. Matches

The number of egress filter matches/hits for the filter entry.

Filter Associations — The associations for a filter ID will be displayed if the associations keyword is specified. The association information is appended to the filter information.

The following output is an example of MAC filter information when the associations keyword is specified, and Table 65 describes the fields.

Sample Output
A:ALA-49# show filter mac 3 associations
===============================================================================
Mac Filter
===============================================================================
Filter ID    : 3              Applied      : Yes
Scope    : Template              Def. Action      : Drop
Entries    : 1
-------------------------------------------------------------------------------
Filter Association : Mac
-------------------------------------------------------------------------------
Service Id  : 1001                Type      : VPLS
- SAP   1/1/1:1001      (Egress)
===============================================================================
Table 65:  Filter MAC Associations Output Fields 

Label

Description

Filter Association

Mac

The filter associations displayed are for a MAC filter policy ID.

Service Id

The service ID on which the filter policy ID is applied.

SAP

The Service Access Point or spoke/mesh SDP on which the filter policy ID is applied.

Type

The type of service of the Service ID.

(Ingress)

The filter policy ID is applied as an ingress filter policy on the interface.

(Egress)

The filter policy ID is applied as an egress filter policy on the interface.

Filter Entry Counters Output — When the counters keyword is specified, the filter entry output displays the filter matches/hit information. The following table describes the command output for the command.

A:ALA-49# show filter mac 8 counters
===============================================================================
Mac Filter
===============================================================================
Filter Id   : 8                                Applied         : Yes
Scope       : Template                         Def. Action     : Forward
Entries     : 2
Description : Description for Mac Filter Policy id # 8
-------------------------------------------------------------------------------
Filter Match Criteria : Mac
-------------------------------------------------------------------------------
Entry       : 8                                FrameType       : Ethernet
Ing. Matches: 80 pkts (5440 bytes)
Egr. Matches: 62 pkts (3968 bytes)
  
Entry       : 10                               FrameType       : Ethernet
Ing. Matches: 80 pkts (5440 bytes)
Egr. Matches: 80 pkts (5120 bytes)
Table 66:  Filter MAC Counters Output Field Descriptions 

Label

Description

Mac Filter

Filter Id

The MAC filter policy ID.

Scope

Template

The filter policy is of type Template.

Exclusive

The filter policy is of type Exclusive.

Description

The MAC filter policy description.

Applied

No

The filter policy ID has not been applied.

Yes

The filter policy ID is applied.

Def. Action

Forward

The default action for the filter ID for packets that do not match the filter entries is to forward.

Drop

The default action for the filter ID for packets that do not match the filter entries is to drop.

Filter Match Criteria

Mac

Indicates the filter is an MAC filter policy.

Entry

The filter ID filter entry ID. If the filter entry ID indicates the entry is (Inactive), then the filter entry is incomplete as no action has been specified.

FrameType

Ethernet

The entry ID match frame type is Ethernet IEEE 802.3.

802.2LLC

The entry ID match frame type is Ethernet IEEE 802.2 LLC.

802.2SNAP

The entry ID match frame type is Ethernet IEEE 802.2 SNAP.

Ethernet II

The entry ID match frame type is Ethernet Type II.

Ing. Matches

The number of ingress filter matches/hits for the filter entry.

Egr. Matches

The number of egress filter matches/hits for the filter entry.

redirect-policy

Syntax 
redirect-policy [redirect-policy-name {dest ip-address] [associations}]
Context 
show>filter
Description 

This command shows redirect filter information.

Parameters 
redirect-policy-name—
Displays information for the specified redirect policy.
dest ip-address
Directs the router to use a specified IP address for communication.
associations—
Appends association information.
Output 

Redirect Policy Output — The following output is an example of redirect policy information, and Table 67 describes the fields.

Sample Output
A:ALA-A>config>filter# show filter redirect-policy
===============================================================================
Redirect Policies
===============================================================================
Redirect Policy                  Applied Description
-------------------------------------------------------------------------------
wccp                             Yes
redirect1                        Yes     New redirect info
redirect2                        Yes     Test test test test
===============================================================================
ALA-A>config>filter#
               
 
ALA-A>config>filter# show filter redirect-policy redirect1
===============================================================================
Redirect Policy
===============================================================================
Redirect Policy: redirect1                        Applied      : Yes
Description    : New redirect info
Active Dest    : 10.10.10.104
-------------------------------------------------------------------------------
Destination    : 10.10.10.104
-------------------------------------------------------------------------------
Description    : SNMP_to_104
Admin Priority : 105                              Oper Priority: 105
Admin State    : Up                               Oper State   : Up
 
SNMP Test      : SNMP-1
Interval       : 30                               Timeout      : 1
Drop Count     : 30
Hold Down      : 120                              Hold Remain  : 0
Last Action at : None Taken
-------------------------------------------------------------------------------
Destination    : 10.10.10.105
-------------------------------------------------------------------------------
Description    : another test
Admin Priority : 95                               Oper Priority: 105
Admin State    : Up                               Oper State   : Down
 
Ping Test
Interval       : 1                                Timeout      : 30
Drop Count     : 5
Hold Down      : 0                                Hold Remain  : 0
Last Action at : 03/19/2007 00:46:55              Action Taken : Disable
-------------------------------------------------------------------------------
Destination    : 10.10.10.106
-------------------------------------------------------------------------------
Description    : (Not Specified)
Admin Priority : 90                               Oper Priority: 90
Admin State    : Up                               Oper State   : Down
 
URL Test       : URL_to_Proxy
Interval       : 10                               Timeout      : 10
Drop Count     : 3
Hold Down      : 0                                Hold Remain  : 0
Last Action at : 03/19/2007 05:04:15              Action Taken : Disable
Priority Change: 0                                Return Code  : 0
===============================================================================
A:ALA-A>config>filter#
 
 
A:ALA-A>show filter redirect-policy redirect1 dest 10.10.10.106
===============================================================================
Redirect Policy
===============================================================================
Redirect Policy: redirect1                        Applied      : Yes
Description    : New redirect info
Active Dest    : 10.10.10.104
-------------------------------------------------------------------------------
Destination    : 10.10.10.106
-------------------------------------------------------------------------------
Description    : (Not Specified)
Admin Priority : 90                               Oper Priority: 90
Admin State    : Up                               Oper State   : Down
 
URL Test       : URL_to_Proxy
Interval       : 10                               Timeout      : 10
Drop Count     : 3
Hold Down      : 0                                Hold Remain  : 0
Last Action at : 03/19/2007 05:04:15              Action Taken : Disable
Priority Change: 0                                Return Code  : 0
===============================================================================
ALA-A#
Table 67:  Filter Redirect-Policy Output Fields 

Label

Description

Redirect Policy

Specifies a specific redirect policy.

Applied

Specifies whether the redirect policy is applied to a filter policy entry.

Description

Displays the user-provided description for this redirect policy.

Active Destination

ip address

Specifies the IP address of the active destination.

none

Indicates that there is currently no active destination.

Destination

Specifies the destination IP address.

Oper Priority

Specifies the operational value of the priority for this destination. The highest operational priority across multiple destinations is used as the preferred destination.

Admin Priority

Specifies the configured base priority for the destination.

Admin State

Specifies the configured state of the destination.

Out of Service

Tests for this destination will not be conducted.

Oper State

Specifies the operational state of the destination.

Ping Test

Specifies the name of the ping test.

Timeout

Specifies the amount of time in seconds that is allowed for receiving a response from the far-end host. If a reply is not received within this time the far-end host is considered unresponsive.

Interval

Specifies the amount of time in seconds between consecutive requests sent to the far end host.

Drop Count

Specifies the number of consecutive requests that must fail for the destination to declared unreachable.

Hold Down

Specifies the amount of time in seconds that the system should be held down if any of the test has marked it unreachable.

Hold Remain

Specifies the amount of time in seconds that the system will remain in a hold down state before being used again.

Last Action at

Displays a time stamp of when this test received a response for a probe that was sent out.

SNMP Test

Specifies the name of the SNMP test.

URL Test

Specifies the name of the URL test.

system-filter

Syntax 
system-filter [chained-to]
Context 
show>filter
Description 

This command shows system filter information.

Parameters 
chained-to—
This option displays filters that chain to a given system filter.
Output 

No Parameters Specified — When no parameters are specified, the output is grouped for IPv4 and IPv6, and displays information about the active system filter and all filters with scope system.

The following output is an example of system filter information when no parameters are specified.

Sample Output
*A:Dut-C>show>filter# system-filter
 
===============================================================================
IP system filters
===============================================================================
Filter-Id                     Active
-------------------------------------------------------------------------------
100                           Yes
65535                         No
-------------------------------------------------------------------------------
No. of IP system filters (total / active): 2 / 1
===============================================================================
 
===============================================================================
IPv6 system filters
===============================================================================
Filter-Id                     Active
-------------------------------------------------------------------------------
No Matching Entries
-------------------------------------------------------------------------------
No. of IPv6 system filters (total / active): 0 / 0
===============================================================================
 
 

With chained-to Option Specified — The following output is an example of system filter information when the chained-to option is specified, .

*A:Dut-C>show>filter# system-filter chained-to
 
============================================================================
IP filters that chain to the active IP system filter
============================================================================
3                  4                  5                  6
5:23               6:24
----------------------------------------------------------------------------
No. of IP filters that chain to the active IP system filter: 6
============================================================================
 
============================================================================
IPv6 filters that chain to the active IPv6 system filter
============================================================================
No Matching Entries
----------------------------------------------------------------------------
No. of IPv6 filters that chain to the active IPv6 system filter: 0
============================================================================
 

match-list

Syntax 
match-list
Context 
show>filter
Description 

This command enables the context to display information for match lists used in filter policies (IOM/FP and CPM).

ip-prefix-list

Syntax 
ip-prefix-list [prefix-list-name]
ip-prefix-list prefix-list-name references
Context 
show>filter>match-list
Description 

This command displays IPv4 prefixes information for match criteria in IPv4 ACL and CPM filter policies.

Parameters 
prefix-list-name—
A string of up to 32 characters of printable ASCII characters. If special characters are used, the string must be enclosed within double quotes.

ipv6-prefix-list

Syntax 
ipv6-prefix-list [prefix-list-name]
ipv6-prefix-list prefix-list-name references
Context 
show>filter>match-list
Description 

This command displays IPv6 prefixes information for match criteria in IPv6 ACL and CPM filter policies.

Parameters 
prefix-list-name—
A string of up to 32 characters of printable ASCII characters. If special characters are used, the string must be enclosed within double quotes.

port-list

Syntax 
port-list [port-list-name]
port-list port-list-name references
Context 
show>filter>match-list
Description 

This command displays TCP/UDP/SCTP port values or ranges for match criteria in IPv4 and IPv6 ACL and CPM filter policies.

Parameters 
port-list-name—
A string of up to 32 characters of printable ASCII characters. If special characters are used, the string must be enclosed within double quotes.

Clear Commands

ip

Syntax 
ip filter-id [entry entry-id] [ingress | egress]
Context 
clear>filter
Description 

Clears the counters associated with the entries of the specified IPv4 filter policy.

By default, the counters associated with each entry of the specified filter policy are all cleared. The scope of which counters are cleared can be narrowed using the command line parameters.

Default 

Clears all counters associated with each entry of the specified IPv4 filter policy.

Parameters 
filter-id—
The IPv4 filter policy ID for which to clear the entry counters. Values can be expressed in different formats. The following shows decimal integer format.
Values—
1 to 65535
entry entry-id—
Specifies that only the counters associated with the specified filter policy entry will be cleared.
Values—
1 to 65535
ingress—
Specifies to only clear the ingress counters.
egress—
Specifies to only clear the egress counters.

ipv6

Syntax 
ipv6 ipv6-filter-id [entry entry-id] [ingress | egress]
Context 
clear>filter
Description 

Clears the counters associated with the entries of the specified IPv6 filter policy.

By default, the counters associated with each entry of the specified filter policy are all cleared. The scope of which counters are cleared can be narrowed using the command line parameters.

Default 

Clears all counters associated with each entry of the specified IPv6 filter policy.

Parameters 
ipv6-filter-id—
The IPv6 filter policy ID for which to clear the entry counters. Values can be expressed in different formats. The following only shows decimal integer format.
Values—
1 to 65535
entry entry-id—
Specifies that only the counters associated with the specified filter policy entry will be cleared.
Values—
1 to 65535
ingress—
Specifies to only clear the ingress counters.
egress—
Specifies to only clear the egress counters.

log

Syntax 
log log-id
Context 
clear>filter
Description 

Clears the contents of a memory or file based filter log.

This command has no effect on a syslog based filter log.

Parameters 
log-id—
The filter log ID expressed as a decimal integer.
Values—
101 to 199

mac

Syntax 
mac mac-filter-id [entry entry-id] [ingress | egress]
Context 
clear>filter
Description 

Clears the counters associated with the entries of the specified MAC filter policy.

By default, the counters associated with each entry of the specified filter policy are all cleared. The scope of which counters are cleared can be narrowed using the command line parameters.

Default 

Clears all counters associated with each entry of the specified MAC filter policy.

Parameters 
mac-filter-id—
The MAC filter policy ID for which to clear the entry counters. Values can either be expressed as a decimal integer or as an ASCII string of up to 64 characters. The following values only shows decimal integer.
Values—
1 to 65535
entry entry-id—
Specifies that only the counters associated with the specified filter policy entry will be cleared. The values are expressed as a decimal integer.
Values—
1 to 65535
ingress—
Specifies to only clear the ingress counters.
egress—
Specifies to only clear the egress counters.

Monitor Commands

The following command outputs are examples only; actual displays may differ depending on supported functionality and user configuration.

ip

Syntax 
ip ip-filter-id entry entry-id [interval seconds] [repeat repeat] [absolute | rate]
Context 
monitor>filter
Description 

This command monitors the counters associated with the specified entry of the specified IP filter policy.

Parameters 
filter-id—
The IPv4 filter policy ID. Values can be expressed in different formats. The following only shows decimal integer format values.
Values—
1 to 65535
entry entry-id—
Specifies the filter policy entry to monitor, as a decimal integer. .
Values—
1 to 65535
interval seconds
Configures the interval for each display in seconds.
Values—
10 seconds
Values—
3 to 60
repeat repeat—
Configures how many times the command is repeated.
Values—
10
Values—
1 to 999
absolute—
When the absolute keyword is specified, the raw statistics are displayed, without processing. No calculations are performed on the delta or rate statistics.
rate—
When the rate keyword is specified, the rate-per-second for each statistic is displayed instead of the delta.
Values—
absolute

ipv6

Syntax 
ipv6 ipv6-filter-id entry entry-id [interval seconds] [repeat repeat] [absolute | rate]
Context 
monitor>filter
Description 

This command monitors the counters associated with the IPv6 filter policy.

Parameters 
ipv6-filter-id—
The IPv6 filter policy ID. Values can be expressed in different formats. The following only shows decimal integer format values.
Values—
1 to 65535
entry entry-id—
Specifies the filter policy entry to monitor, as a decimal integer. .
Values—
1 to 65535
interval seconds
Configures the interval for each display in seconds.
Values—
10 seconds
Values—
3 to 60
repeat repeat—
Configures how many times the command is repeated.
Values—
10
Values—
1 to 999
absolute—
When the absolute keyword is specified, the raw statistics are displayed, without processing. No calculations are performed on the delta or rate statistics.
rate—
When the rate keyword is specified, the rate-per-second for each statistic is displayed instead of the delta.
Values—
absolute

mac

Syntax 
mac mac-filter-id entry entry-id [interval seconds] [repeat repeat] [absolute | rate]
Context 
monitor>filter
Description 

This command monitors the counters associated with the specified entry of the specified MAC filter policy.

Parameters 
mac-filter-id—
The MAC filter policy ID. Values can be expressed in different formats. The following only shows decimal integer format values.
Values—
1 to 65535
entry entry-id—
Specifies the filter policy entry to monitor, as a decimal integer. .
Values—
1 to 65535
interval seconds
Configures the interval for each display in seconds.
Values—
10 seconds
Values—
3 to 60
repeat repeat—
Configures how many times the command is repeated.
Values—
10
Values—
1 to 999
absolute—
When the absolute keyword is specified, the raw statistics are displayed, without processing. No calculations are performed on the delta or rate statistics.
rate—
When the rate keyword is specified, the rate-per-second for each statistic is displayed instead of the delta.
Values—
absolute

Debug Commands

The following command outputs are examples only; actual displays may differ depending on supported functionality and user configuration.

cpm

Syntax 
cpm
Context 
tools>dump>filter>resources
Description 

This command displays information about filter resource utilization on the CPM, consumption by filter-using services like TMS, OpenFlow, and the filters that use the most resources.

Output 

The following output is an example of filter resource utilization information.

Sample Output
*A:Dut-C>tools>dump>filter>resources># cpm
 
===========================================================================
Number of ACL filters defined on CPM
===========================================================================
Owner                     MAC             IP           IPv6          Total
---------------------------------------------------------------------------
Configuration               0              7              0              7
Host Common                 0              2              0              2
Tms                         0              1              1              2
Openflow                    0              2              1              3
---------------------------------------------------------------------------
Total                       0             14              4             18
===========================================================================
Available filters (except openflow): 16369
Available openflow filters:          16381
 
=============================================================================
Number of ACL filter entries / subentries defined on CPM
=============================================================================
Inserted by                             MAC       IP     IPv6          Total
-----------------------------------------------------------------------------
User configuration                        0       21        1             22
                                          0       21        1             22
Radius                                    0        0        0              0
                                          0        0        0              0
Credit Control                            0        0        0              0
                                          0        0        0              0
Embedded                                  0        0        0              0
                                          0        0        0              0
Radius shared host                        0        2        0              2
                                          0        2        0              2
Openflow                                  0        0        0              0
                                          0        0        0              0
PCC-Rule                                  0        0        0              0
                                          0        0        0              0
Other                                     0        0        0              0
                                          0        0        0              0
-----------------------------------------------------------------------------
Total                                     0       23        1             24
                                          0       23        1             24
=============================================================================
Available subentries (except openflow): 262120
Available openflow subentries:          262144
 
===============================================================================
Filters utilizing most resources (ordered by CPM entries)
===============================================================================
Type Id                                  Entries     Subentries   TCAM entries
                                                                (per FlexPath)
-------------------------------------------------------------------------------
No Mac filters found
-------------------------------------------------------------------------------
Ip   100                                       5              5              5
Ip   65535                                     5              5              5
Ip   1                                         4              4              4
Ip   5:23                                      2              2              2
Ip   6:24                                      2              2              2
-------------------------------------------------------------------------------
Ipv6 _tmnx_tms-ing-5/1-F                       1              1              1
Ipv6 fSpec-0                                   0              0              0
Ipv6 fSpec-2345                                0              0              0
Ipv6 _tmnx_ofs_system:1                        0              0              0
No more Ipv6 filters
===============================================================================
 
===============================================================================
Filters utilizing most resources (ordered by CPM subentries)
===============================================================================
Type Id                                  Entries     Subentries   TCAM entries
                                                                (per FlexPath)
-------------------------------------------------------------------------------
No Mac filters found
-------------------------------------------------------------------------------
Ip   100                                       5              5              5
Ip   65535                                     5              5              5
Ip   1                                         4              4              4
Ip   5:23                                      2              2              2
Ip   6:24                                      2              2              2
-------------------------------------------------------------------------------
Ipv6 _tmnx_tms-ing-5/1-F                       1              1              1
Ipv6 fSpec-0                                   0              0              0
Ipv6 fSpec-2345                                0              0              0
Ipv6 _tmnx_ofs_system:1                        0              0              0
No more Ipv6 filters
===============================================================================
 

dest-tracking

Syntax 
dest-tracking {sap | sdp | ip | ipv6} [detail]
Context 
tools>dump>filter>resources
Description 

This command displays information about resources pertaining to tracked targets.

Parameters 
sap | sdp| ip | ipv6—
displays information about SAP, SDP, IPv4, or IPv6 targets
detail—
displays detailed information
Output 

The following output is an example of filter resource SAP destination tracking information.

Sample Output
dest-tracking sap
===============================================================================
Unique SAPs with tracked forwarding states ====================================
Used  : 1
Free  : 4095
Total : 4096
===============================================================================

The following output is an example of filter resource SAP destination tracking detailed information.

 
dest-tracking# sap detail
===============================================================================
Unique SAPs with tracked forwarding states ====================================
Num  Destination                                      Ref. count
-------------------------------------------------------------------------------
    1 sap 1/2/2                                        1
===============================================================================
Unique SAPs with tracked forwarding states ====================================
Used  : 1
Free  : 4095
Total : 4096
===============================================================================

egress-pbr

Syntax 
egress-pbr [detail]
Context 
tools>dump>filter>resources
Description 

This command displays the number of allocated unique egress PBR destinations.

Parameters 
detail—
Displays number of allocated unique egress PBR destinations together with a list of destinations and their ref counts.
Output 

The following output is an example of filter resource egress PBR destination information.

Sample Output
*A:Dut-C>tools dump filter resources egress-pbr
 
===============================
Egress PBR destinations
===============================
Name                     Count
-------------------------------
All destinations             8
Unique destinations          4
===============================
 
 
*A:Dut-C# tools dump filter resources egress-pbr detail
 
===============================================================================
Unique egress PBR destinations
===============================================================================
Num Action       Ref. count Parameters
-------------------------------------------------------------------------------
  1 Esi L3       1          esi  00:00:00:00:00:00:00:00:00:01
                            ip   5.5.1.5
                            if   VasToFromAccess
                            rtr  123
-------------------------------------------------------------------------------
  2 Esi L3       2          esi  00:00:00:00:00:00:00:00:00:02
                            ip   5.5.0.5
                            if   VasToFromNetwork
                            rtr  123
-------------------------------------------------------------------------------
  3 Red-pol      3          name egress-pbr
-------------------------------------------------------------------------------
  4 Red-pol      2          name ingress-pbr
===============================================================================
 

iom

Syntax 
iom [slot-number]
Context 
tools>dump>filter>resources
Description 

This command shows information about filter resource utilization on all IOMs or a specified IOM. Resource utilization per filter type is available, as well as filters using most resources on a given line card.

Parameters 
slot-number—
specifies that only the filter resource utilization associated with the IOM card in this slot will be displayed
Values—
1 to 10
Output 

The following output is an example of filter resource utilization information for all IOMs.

Sample Output
*A:Dut-C>tools>dump>filter>resources># iom
 
=======================================================
Number of ACL filter entries used / available on IOMs
=======================================================
Slot                          Used           Available
-------------------------------------------------------
1                               11               65524
2                                5               65530
3                                5               65530
=======================================================
 
===========================================================================
Number of ACL filters and filter entries used / available on FlexPaths
===========================================================================
Slot FlexPath    Dir  Filters  Filters   MAC/IP   MAC/IP     IPv6     IPv6
                         used    avail  entries  entries  entries  entries
                                           used    avail     used    avail
---------------------------------------------------------------------------
1    1          Ingr        2     2045       10    65526        2    28670
                 Egr        2     2045        5    32763        2    16382
2    1          Ingr        4     2043        7    65529        2    28670
                 Egr        0     2047        2    32766        2    16382
3    1          Ingr        0     2047        7    65529        2    28670
                 Egr        0     2047        2    32766        2    16382
===========================================================================
 
===============================================================================
Filters utilizing most resources (ordered by TCAM entries per FlexPath)
Only filters present on any IOM are displayed
===============================================================================
Type Id                                  Entries     Subentries   TCAM entries
                                                                (per FlexPath)
-------------------------------------------------------------------------------
No Mac filters found
-------------------------------------------------------------------------------
Ip   100                                       5              5              5
Ip   5:23                                      2              2              2
Ip   6:24                                      2              2              2
Ip   3                                         1              1              1
Ip   4                                         1              1              1
-------------------------------------------------------------------------------
Ipv6 _tmnx_tms-ing-5/1-F                       1              1              1
Ipv6 fSpec-0                                   0              0              0
Ipv6 fSpec-2345                                0              0              0
No more Ipv6 filters
===============================================================================
 

ip

Syntax 
ip <filter-id>
Context 
tools>dump>filter>resources
Description 

This command displays information about the specified IP filter including resource utilization on CPM and IOM, the IOMs on which the filter is used, and the entries using the most resources.

Parameters 
filter-id—
specifies that only the filter resource utilization associated with this IP filter will be displayed.
Values—
1 to 65535
Output 

The following output is an example of IP filter resource utilization information.

Sample Output
*A:Dut-C>tools>dump>filter>resources># ip 100
 
===============================================================================
Resource utilization details for Ip filter 100
===============================================================================
CPM entries used                       : 5
CPM subentries used                    : 5
TCAM entries used (per FlexPath)       : 5
Associated with IOMs                   : 1,2,3,4,5,6,7,8,9,10
 
---------------------------------------------------------------------------
Largest 5 entries
---------------------------------------------------------------------------
Entry ID                                        Active        TCAM entries
                                                            (per FlexPath)
---------------------------------------------------------------------------
3                                                  Yes                   1
4                                                  Yes                   1
5                                                  Yes                   1
6                                                  Yes                   1
100                                                Yes                   1
---------------------------------------------------------------------------
===============================================================================
 

ipv6

Syntax 
ipv6 <filter-id>
Context 
tools>dump>filter>resources
Description 

This command displays information about the specified IPv6 filter including resource utilization on CPM and IOM, the IOMs on which the filter is used, and the entries using the most resources.

Parameters 
filter-id—
specifies that only the filter resource utilization associated with this IPv6 filter will be displayed.
Values—
1 to 65535
Output 

The following output is an example of IPv6 filter resource utilization information.

Sample Output
*A:Dut-C>tools>dump>filter>resources># ipv6 "fSpec-0"
 
===============================================================================
Resource utilization details for Ipv6 filter fSpec-0
===============================================================================
CPM entries used                       : 0
CPM subentries used                    : 0
TCAM entries used (per FlexPath)       : 0
Associated with IOMs                   : 2
 
---------------------------------------------------------------------------
Largest 5 entries
---------------------------------------------------------------------------
Entry ID                                        Active        TCAM entries
                                                            (per FlexPath)
---------------------------------------------------------------------------
No Matching Entries
---------------------------------------------------------------------------
===============================================================================
 

mac

Syntax 
mac <filter-id>
Context 
tools>dump>filter>resources
Description 

This command displays information about the specified MAC filter including resource utilization on CPM and IOM, the IOMs on which the filter is used, and the entries using the most resources.

Parameters 
filter-id—
specifies that only the filter resource utilization associated with this IPv6 filter will be displayed
Values—
1 to 65535
Output 

The following output is an example of MAC filter resource utilization information.

Sample Output
*A:Dut-C>tools>dump>filter>resources># mac 1
 
===============================================================================
Resource utilization details for Mac filter 1
===============================================================================
CPM entries used                       : 1
CPM subentries used                    : 1
TCAM entries used (per FlexPath)       : 1
Associated with IOMs                   : 1
 
---------------------------------------------------------------------------
Largest 5 entries
---------------------------------------------------------------------------
Entry ID                                        Active        TCAM entries
                                                            (per FlexPath)
---------------------------------------------------------------------------
1                                                  Yes                   1
No more entries defined
---------------------------------------------------------------------------
===============================================================================

sticky-dest

Syntax 
sticky-dest
Context 
tools>dump>filter>resources
Description 

This command displays information about resources pertaining to sticky destinations timers.

Output 

The following output is an example of sticky destination filter action information.

Sample Output
===============================================================================
Filter action - Sticky-dest resources
===============================================================================
Used  : 1
Free  : 2047
Total : 2048
===============================================================================

activate-best-dest

Syntax 
activate-best-dest
Context 
tools>perform>filter>redirect-policy
Description 

This command allows the operator to force a PBR switch to the best destination selected by the redirect policy when that destination is not currently active as result of sticky destination functionality being enabled for the specified redirect policy. If hold-time-up is running, the timer is also expired.

activate-primary-action

Syntax 
activate-primary-action
Context 
tools>perform>filter>ip-filter>entry
tools>perform>filter>ipv6-filter>entry
tools>perform>filter>mac-filter>entry
Description 

This command allows an operator to activate the primary action for the given filter policy entry. If the primary action is already active, the command has no effect. If a secondary action is active, the primary action will be activated unless the primary target is down. If the sticky destination timer is running for the primary action entry, it will expire.