- show pxf accounting through test cef table consistency
- show pxf accounting
- show pxf cpu access-lists
- show pxf cpu atom
- show pxf cpu bba
- show pxf cpu buffers
- show pxf cpu cef
- show pxf cpu context
- show pxf cpu feedback
- show pxf cpu iedge
- show pxf cpu ipv6
- show pxf cpu mpls
- show pxf cpu mroute
- show pxf cpu pbr action
- show pxf cpu police
- show pxf cpu policy-data
- show pxf cpu qos
- show pxf cpu queue
- show pxf cpu reasm_index
- show pxf cpu statistics
- show pxf cpu subblocks
- show pxf cpu vcci
- show pxf crash
- show pxf dma
- show pxf feature cef
- show pxf feature cef vrf
- show pxf feature nat
- show pxf interface
- show pxf microcode
- show pxf netflow
- show pxf stall-monitoring
- show pxf statistics
- show pxf xcm
- show route-map ipc
- show xdr
- snmp mib cef throttling-interval
- snmp-server enable traps cef
- snmp-server host
- switchover pxf restart
- test cef table consistency
show pxf accounting through test cef table consistency
- show pxf accounting
- show pxf cpu access-lists
- show pxf cpu atom
- show pxf cpu bba
- show pxf cpu buffers
- show pxf cpu cef
- show pxf cpu context
- show pxf cpu feedback
- show pxf cpu iedge
- show pxf cpu ipv6
- show pxf cpu mpls
- show pxf cpu mroute
- show pxf cpu pbr action
- show pxf cpu police
- show pxf cpu policy-data
- show pxf cpu qos
- show pxf cpu queue
- show pxf cpu reasm_index
- show pxf cpu statistics
- show pxf cpu subblocks
- show pxf cpu vcci
- show pxf crash
- show pxf dma
- show pxf feature cef
- show pxf feature cef vrf
- show pxf feature nat
- show pxf interface
- show pxf microcode
- show pxf netflow
- show pxf stall-monitoring
- show pxf statistics
- show pxf xcm
- show route-map ipc
- show xdr
- snmp mib cef throttling-interval
- snmp-server enable traps cef
- snmp-server host
- switchover pxf restart
- test cef table consistency
show pxf accounting
To show Parallel eXpress Forwarding (PXF) switching statistics for individual interfaces, use the show pxf accounting command in user EXEC or privileged EXEC mode.
show pxf accounting interface [ slot/port ]
Syntax Description
interface |
Specifies the type of interface to display. |
slot / |
(Optional) Backplane slot number. On the Cisco 7200 VXR series routers, the value can be from 0 to 6. |
port |
(Optional) Port number of the interface. On the Cisco 7200 VXR series routers, the value can be from 0 to 5. |
Command Modes
User EXEC (>)
Privileged EXEC (#)
Command History
Release |
Modification |
---|---|
12.1(1)E |
This command was introduced. |
12.1(5)T |
This command was integrated into Cisco IOS Release 12.1(5)T.’ |
12.2(33)SRA |
This command was integrated into Cisco IOS Release 12.2(33)SRA. |
12.2SX |
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware. |
Usage Guidelines
You can display information about the interface types shown in the table below using the show pxf accounting command:
Keyword |
Interface Type |
---|---|
atm |
ATM interface |
ethernet |
Ethernet interface |
fastethernet |
FastEthernet interface |
hssi |
High Speed Serial interface |
null |
Null interface |
pos |
Packet-over-SONET interface |
serial |
Synchronous serial interface |
summary |
PXF summary statistics |
Examples
The following is sample output from the show pxf accounting ?command:
Router# show pxf accounting ? ATM ATM interface Ethernet IEEE 802.3 FastEthernet FastEthernet IEEE 802.3 Hssi High Speed Serial Interface Null Null interface POS Packet over Sonet Serial Serial summary PXF summary statistics
The following is sample output from the show pxf accounting ethernet command with an Ethernet interface in slot 4 on a Cisco 7200 VXR series router:
Router# show pxf accounting ethernet 4/0 Interface Pkts In Chars In Pkts Out Chars Out Punted Dropped Ethernet4/0 0 0 122 11490 4 0
The following is sample output from the show pxf accounting null command with a null interface in slot 0 on a Cisco 7200 VXR series router:
Router# show pxf accounting null 0/0 Interface Pkts In Chars In Pkts Out Chars Out Punted Dropped nu0/0 0 0 0 0 4932 0
The following is sample output from the show pxf accounting pos command with a Packet-over-SONET interface in slot 4 on a Cisco 7200 VXR series router:
Router# show pxf accounting pos Interface Pkts In Chars In Pkts Out Chars Out Punted Dropped POS4/0 19 1064 0 0 44 0
The following is sample output from the show pxf accounting serial command with a serial interface in slot 5 on a Cisco 7200 VXR series router:
Router# show pxf accounting serial 5/0 Interface Pkts In Chars In Pkts Out Chars Out Punted Dropped Serial5/0 0 0 0 0 0 0
The following is sample output from the show pxf accounting summary command:
Router# show pxf accounting summary Pkts Dropped RP Processed Ignored Total 0 48360 0 PXF Statistic: Packets RP -> PXF: switch ip: 0 switch raw: 30048360 qos fastsend: 0 qos enqueue: 1938 Total: 30050298 Packets PXF -> RP: qos pkts: 1938 fast pkts: 30000000 drops:total 0 punts:total 48360 " not IP : 40572 " CEF no adjacency : 7788 Total: 30050298 Packets ignored: 0 | ring space: shadow ring full: 0 | shadow ring: 16384 in ring full: 0 | inring: 968 PXF inactive: 0 tx credits: 16230330 | delayed credits: 0 holdq enqueues: 0 | requeue drops: 0 interrupts: 40538 | interrupt misses: 1947 interrupt packets: 53326 pending read bytes: 0 Interface Pkts In Chars In Pkts Out Chars Out Punted Dropped Fa0/0 0 0 30000000 1740000000 970 0 Et1/0 0 0 0 0 21309 0 Et1/1 0 0 0 0 0 0 Et1/2 0 0 0 0 0 0 Et1/3 0 0 0 0 0 0 Se2/0 0 0 0 0 963 0 Se2/1 0 0 0 0 0 0 Se2/2 0 0 0 0 0 0 Se2/3 0 0 0 0 0 0 Fa3/0 0 0 0 0 963 0 PO4/0 30000000 1440000000 0 0 963 0 AT5/0 0 0 0 0 23192 0 Vi1 0 0 0 0 0 0 Vt1 0 0 0 0 0 0 Vi2 0 0 0 0 0 0
Related Commands
Command |
Description |
---|---|
show pxf crash |
Displays PXF crash information. |
show pxf feature |
Displays the PXF routing feature tables for enabled PXF features. |
show pxf interface |
Displays a summary of the interfaces in the router and the PXF features or capabilities enabled on these interfaces. |
show pxf cpu access-lists
To display Parallel eXpress Forwarding (PXF) memory information for access control lists (ACLs), use the show pxf cpu access-lists command in privileged EXEC mode.
show pxf cpu access-lists [ security | qos | pbr | compiled ]
Cisco 10000 Series Router
show pxf cpu access-lists [ security [ [ tcam acl-name [detail] ] | flex-sum | children ] | qos | pbr | compiled ]
Syntax Description
security |
(Optional) Displays information about the security ACLs defined in Cisco IOS and compiled to the PXF. Also displays information about split ACLs, such as how much memory has been used. |
tcam acl-name |
(Optional) Displays information about the specified security ACL stored in ternary content addressable memory (TCAM). This option is only available on the PRE3 for the Cisco 10000 series router. |
detail |
(Optional) Displays decoded information about the packet fields used for matching in the TCAM. |
flex-sum |
(Optional) Displays summary information describing the amount of memory allocated in the parallel express forwarding (PXF) engine for use by the flexible key construction microcode. This information is useful for design teams. This option is only available on the PRE3 for the Cisco 10000 series router. |
children |
(Optional) Displays information for child policies. If an ACL is a template child, the output typically does not display the child information. Specifying the children keyword displays data for child policies, too, and shows the children and the parent policy of each child. Use caution when using the children keyword as there might be thousands of child policies configured, which could have negative effects on the command output. |
qos |
(Optional) Displays information about the QoS ACLs defined in Cisco IOS and compiled to the PXF. |
pbr |
(Optional) Displays information about ACLs for policy-based routing (PBR). |
compiled |
(Optional) Displays information for all compiled Turbo-ACLs. The PRE2 supports Turbo-ACLs and the compiled option. The PRE3 accepts the PRE2 compiled option, but does not implement Turbo-ACLs. |
Command Modes
Privileged EXEC (#)
Command History
Release |
Modification |
---|---|
12.2S |
This command was introduced. |
12.3(7)XI1 |
This command was introduced on the PRE2 for the Cisco 10000 series router. |
12.2(31)SB2 |
This command was introduced on the PRE3 for the Cisco 10000 series router. |
Usage Guidelines
Cisco 10000 Series Router (PRE2)
Because memory is shared between TurboACLs and MiniACLs, they can interfere with each other’s capacities. The Mini-ACL is automatically set up with space for 8191 Mini-ACLs at router start. If more than 8191 Mini-ACLs are created, another block of MiniACLs (4096) is allocated. This process is repeated as necessary until the router is out of External Column Memory (XCM) in any one bank that the Mini-ACLs need.
Cisco 10000 Series router (PRE3)
The PRE3 implements only TCAM ACLs. Turbo-ACLs and Mini-ACLs are not supported.
Examples
The sample output from the show pxf cpu access-lists security command (see Sample Output) is based on the configuration of the access control list (ACL) called test_list (see ACL Configuration). The sample output is divided into several sections with a description of the type of information displayed in each.
ACL Configuration
Router# show pxf cpu access-lists test_list Extended IP access list test_list (Compiled) 10 permit ip any host 10.1.1.1 20 permit ip any host 10.1.1.2 30 permit ip any host 10.1.1.3 40 permit ip any host 10.1.1.4 50 permit ip any host 10.1.1.5 60 permit ip any host 10.1.1.6 70 permit ip any host 10.1.1.7 80 permit ip any host 10.1.1.8 90 permit ip any host 10.1.1.9 100 permit ip any host 10.1.1.11 110 permit ip any host 10.1.1.12
Sample Output
The following sample output describes the information displayed in the first section of the command output from the show pxf cpu access-lists security command:
Router# show pxf cpu access-lists security PXF Security ACL statistics: ACL State Tables Entries Config Fragment Redundant Memory ACL_index 1 Operational 1 - - - - 0Kb 1 sl_def_acl Operational 2 - - - - 0Kb 2 test Operational 3 - - - - 0Kb 3 test_list Operational 1 12 11 0 0 7Kb 1
The table below describes the significant fields shown in the display.
The following sample output describes the information displayed in the next section of the command output from the show pxf cpu access-lists security command:
First level lookup tables: Block Use Rows Columns Memory used 0 TOS/Protocol 1/128 1/32 16384 1 IP Source (MS) 1/128 1/32 16384 2 IP Source (LS) 1/128 1/32 16384 3 IP Dest (MS) 2/128 1/32 16384 4 IP Dest (LS) 12/128 1/32 16384 5 TCP/UDP Src Port 1/128 1/32 16384 6 TCP/UDP Dest Port 1/128 1/32 16384 7 TCP Flags/Fragment 1/128 1/32 16384
The table below describes the significant fields shown in the display.
Field |
Description |
---|---|
Block |
Indicates the block number. |
Use |
Describes the IP packet field that is being matched. |
Rows |
An indication of where the largest variety of values are in use in the ACLs that are being applied. In the output, 12/128 means that there are 12 different values of significance in the field. If there are other rules added and the value exceeds 128, more memory will be needed to accommodate the new rules. |
Columns |
An indication of the number of TurboACLs in PXF memory. In the output, 1/32 means there is only one TurboACL in PXF memory. If there are more than 31 added, another chunk of memory is needed to accommodate the new ACLs. |
Memory used |
Displays the total amount of memory used for this particular lookup table. |
The following sample output describes the information displayed in the next section of the command output from the show pxf cpu access-lists security command. There are 16 banks of XCM in each PXF column. This output section shows the usage level of each bank.
Banknum Heapsize Freesize %Free 0 4718592 4702208 99 1 8126464 6012928 73 2 8388608 6290432 74 3 8388608 6290432 74 4 5898240 5881856 99 5 8126464 6012928 73 6 8388608 6290432 74 7 8126464 6012928 73 8 4456448 4440064 99 9 8126464 6012928 73
The table below describes the significant fields shown in the display.
Field |
Description |
---|---|
Banknum |
The block of memory used for this particular lookup table. |
Heapsize |
The total amount of memory, in bytes, allocated for this block. |
Freesize |
The amount of memory, in bytes, that is currently available for use by this block of memory. |
%Free |
The percentage of memory that is free and available for use for this block of memory. When the %Free drops to 0, the router cannot hold any more ACLs in PXF memory, and any new ACL will not pass traffic. |
This section of the sample command output indicates the memory usage of the MiniACLs in the router. All of the rows state about the same thing. To determine the actual number of MiniACLs in play, divide the memory used in any of blocks 1 to 10 by 256, or blocks 11 to 14 by 16.
MiniACL XCM Tables: Block Use Memory Used %Free 0 IP Src 1 768 99 1 IP Src 2 768 99 2 IP Src 3 768 99 3 IP Src 4 768 99 4 IP Dest 1 768 99 5 IP Dest 2 768 99 6 IP Dest 3 768 99 7 IP Dest 4 768 99 8 ToS 768 99 9 Protocol 768 99 10 TCP Flags/Fragment 768 99 11 Source Port 1 48 99 12 Source Port 2 48 99 13 Destination Port 2 48 99 14 Destination Port 2 48 99
The following describes the information displayed in the last section of the sample output from the show pxf cpu access-lists security command:
Available MiniACL count = 8191 Usable ranges(inclusive): 1->8191
The table below describes the significant fields shown in the display.
Field |
Description |
---|---|
Available MiniACL |
The number of ACLs currently available for allocation in XCM. |
Usable ranges |
The ACL indexes that will be assigned to MiniACLs. |
PRE2 and PRE3 Security ACLs Examples (Cisco 10000 Series Router)
This section compares the output from the show pxf cpu access-lists security command when issued on the PRE2 and PRE3.
For the PRE2, the following sample output displays VMR (value, plus a mask and result) data for the ACL named ICMP_IGMP_MATCH:
Router# show pxf cpu access-lists security tcam ICMP_IGMP_MATCH detail ------------------------------------------------------------- VMR Format - handle: 524607B4 Format has 5 fields, refcount = 1 Field: Format, FIXED, start_bit = 69, end_bit = 71 Field: ACL index, FIXED, start_bit = 54, end_bit = 68 Field: Flags, FIXED, start_bit = 43, end_bit = 53 Field: L4 proto, FIXED CNV, start_bit = 16, end_bit = 23 Field: L4 source port, FIXED CNV, start_bit = 0, end_bit = 15 Total bits = 53, format = 72 GMR used: 5 Col 2 LKBP Vector: 544 ------------------------------------------------------------- VMRs ------ VMR 0 ------ V: 001B0000 0000010B 00 M: FFFFC000 0000FFFF FF R: 00010001 Format: 00000000/00000007 ACL index: 0000006C/00007FFF L4 source port: 00000B00/0000FFFF L4 proto: 00000001/000000FF Flags: 00000000/00000000 ------ VMR 1 ------ V: 001B0000 00000103 01 M: FFFFC000 0000FFFF FF R: 00010002 Format: 00000000/00000007 ACL index: 0000006C/00007FFF L4 source port: 00000301/0000FFFF L4 proto: 00000001/000000FF Flags: 00000000/00000000 ------ VMR 2 ------ V: 001B0000 00000213 00 M: FFFFC000 0000FFFF 00 R: 00010003 Format: 00000000/00000007 ACL index: 0000006C/00007FFF L4 source port: 00001300/0000FF00 L4 proto: 00000002/000000FF Flags: 00000000/00000000 ------ VMR 3 ------ V: 001B0000 00000214 00 M: FFFFC000 0000FFFF 00 R: 00010004 Format: 00000000/00000007 ACL index: 0000006C/00007FFF L4 source port: 00001400/0000FF00 L4 proto: 00000002/000000FF Flags: 00000000/00000000
For the PRE3, the following sample output displays for the show pxf cpu access-lists security command. Notice that the output does not include the columns shown above that are relevant to only the PRE2 and the output no longer displays first-level lookup tables.
Router# show pxf cpu access-lists security PXF Security ACL statistics: ACL State ACL_index STANDARD_MATCH_PERMIT Operational 116 SRC_IP_MATCH144 Operational 102 DST_IP_MATCH Operational 113 DST_IP_MATCH144 Operational 112 PROTOCOL_MATCH Operational 104 PROTOCOL_MATCH144 Operational 103 FRAG_MATCH Operational 109 PRECEDENCE_TOS_MATCH Operational 106 PRECEDENCE_TOS_MATCH144 Operational 105
Related Commands
Command |
Description |
---|---|
show pxf cpu statistics |
Displays PXF CPU statistics. |
show pxf statistics |
Displays a chassis-wide summary of PXF statistics. |
show pxf cpu atom
To display Parallel eXpress Forwarding (PXF) CPU Any Transport over MPLS (AToM) forwarding information for an interface or Virtually Cool Common Index (VCCI), use the show pxf cpu atomcommand in privileged EXEC mode.
show pxf cpu atom [ interface-name | vcci ]
Syntax Description
interface-name |
(Optional) Name of the interface. |
vcci |
(Optional) VCCI entry identifier. |
Command Modes
Privileged EXEC (#)
Command History
Release |
Modification |
---|---|
12.2(31)SB |
This command was introduced on the Cisco 10000 series router. |
Examples
The following example shows AToM forwarding information for Gigabit Ethernet interface 6/0/0. The fields shown in the display are self-explanatory.
Router#: show pxf cpu atom gigabitethernet 6/0/0 Imposition Information for VCCI 0x9E2: Output VCCI: 0x0 Mac rewrite index: 0x0 extension: 0x0 Ingress Flags: 0x0 PTI Action Table: 0x0
Related Commands
Command |
Description |
---|---|
show mpls l2transport vc |
Displays information about AToM VCs that are enabled to route Layer 2 packets on a router. |
show pxf cpu mpls |
Displays PXF MPLS FIB entry information. |
show pxf cpu subblocks |
Displays subblocks information that includes column 0 of AToM. |
show pxf cpu bba
To display information on Parallel eXpress Forwarding (PXF) CPU Broadband Aggregation (BBA) groups, use the show pxf cpu bbacommand in privileged EXEC mode.
show pxf cpu bba
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC (#)
Command History
Release |
Modification |
---|---|
12.2S |
This command was introduced. |
12.2(31)SB2 |
This command was integrated into Cisco IOS Release 12.2(31)SB2. |
Examples
The following example shows BBA groups information in the PXF CPU:
Router# show pxf cpu bba 6w3d: show_pxf_bba 6w3d: %IPCOIR-4-REPEATMSG: IPC handle already exists for 1/0 6w3d: %IPCOIR-2-CARD_UP_DOWN: Card in slot 1/0 is down. Notifying 4oc3atm-1 dr. 6w3d: %C10K_ALARM-6-INFO: ASSERT CRITICAL slot 1 Card Stopped Responding OIR Al 6w3d: %IPCOIR-5-CARD_DETECTED: Card type 4oc3atm-1 (0x2D8) in slot 1/0 6w3d: %IPCOIR-5-CARD_LOADING: Loading card in slot 1/0 sw version 1.1 code MD5 C 6w3d: %C10K-5-LC_NOTICE: Slot[1/0] 4oc3atm-1 Image Downloaded...Booting... 6w3d: %IPCOIR-5-CARD_DETECTED: Card type 4oc3atm-1 (0x2D8) in slot 1/0 6w3d: %C10K_ALARM-6-INFO: CLEAR CRITICAL slot 1 Card Stopped Responding OIR Ala 6w3d: %IPCOIR-2-CARD_UP_DOWN: Card in slot 1/0 is up. Notifying 4oc3atm-1 driv.
Related Commands
Command |
Description |
---|---|
bba-group pppoe |
Configures a BBA group to establish PPPoE sessions. |
show pxf cpu buffers
To display packet buffer memory for temporary packet storage in the Cisco Internetwork Performance Monitor (IPM) of the Parallel eXpress Forwarding (PXF), use the show pxf cpu buffers command in privileged EXEC mode.
show pxf cpu buffers
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC (#)
Command History
Release |
Modification |
---|---|
12.2S |
This command was introduced on the Cisco 10000 series router. |
12.2(31)SB |
This command was integrated into Cisco IOS Release 12.2(31)SB. |
Usage Guidelines
This command provides information about the number of handles that are used and available. Handles are outstanding packets in the virtual time management system (VTMS).
Examples
The following example shows the number of handles that are used and available:
Router# show pxf cpu buffers Cobalt2 ttc running. Calculations could be off by (+/-) cache sizes. cache size small 512 large 128 pool # handles available -------------------------------- small 524288 523808 large 32768 32624
The table below describes the fields shown in the display.
Field |
Description |
---|---|
pool |
Identifies the buffer pool. |
# handles |
The number of handles that are currently used. |
available |
The number of handles that are currently available. |
Related Commands
Command |
Description |
---|---|
clear pxf |
Clears PXF counters and statistics. |
show pxf statistics |
Displays chassis-wide, summary PXF statistics. |
show pxf cpu cef
The show pxf cpu cefcommand is replaced by the show ip cef platform command on the Cisco 10000 series router. See the show ip cef platformcommand for more information.
show pxf cpu context
To display the current and historical loads on the Parallel eXpress Forwarding (PXF), use the show pxf cpu context command in privileged EXEC mode.
show pxf cpu context
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC (#)
Command History
Release |
Modification |
---|---|
12.2S |
This command was introduced on the Cisco 10000 series router. |
12.3(7)XI1 |
This command was integrated into Cisco IOS Release 12.3(7)XI1. |
12.2(31)SB |
This command was integrated into Cisco IOS Release 12.2(31)SB. |
Examples
The show pxf cpu contextcommand shows how busy the PXF forwarding process (FP) is with the current traffic load. The first section displays the number of contexts of each type that have entered the PXF engine since it was last reloaded. If counters are idle, the PXF pipeline is not operating properly.
Router# show pxf cpu context FP context statistics count rate (since last time command was run) --------------------- ------------- ---------- feed_back 168635 0 new_work_from_lc 7474477 13 new_work_from_rp 964679 1 new_work_from_replay 0 0 null_context 3797097495884 6312156 ---------- 6312170 FP average context/sec 1min 5min 60min --------------------- ---------- ---------- ---------- feed_back 0 0 0 cps new_work_from_lc 8 8 8 cps new_work 1 1 1 cps new_work_from_replay 0 0 0 cps null_context 6312260 6312261 6312250 cps --------------------- ---------- ---------- ---------- Total 6312270 6312271 6312260 cps FP context utilization 1min 5min 60min --------------------- ---------- ---------- ---------- Actual 0 % 0 % 0 % Theoretical 0 % 0 % 0 % Maximum 98 % 98 % 98 %
The table below describes the significant fields shown in the display.
Field |
Description |
---|---|
FP context statistics |
|
feed_back |
Packets requiring additional passes through the pipeline. This counter is incremented once for each additional pass. |
new_work |
New packets input to the PXF pipeline. This counter represents a snapshot of the amount of incoming traffic being processed by the processor. |
null_context |
An indication of unused forwarding bandwidth (idle time). This counter is incremented for every context during which the PXF pipeline is not processing traffic. This counter represents the processor’s potential to handle additional traffic. As the processor becomes more busy, the value for null decreases until it becomes zero, at which point the processor has reached its maximum usage. |
FP average context/sec |
|
feed_back |
Displays the rate, in terms of the number of contexts per second (cps) for the feed_back counter for the last 1-minute, 5-minute, and 60-minute time periods. |
new_work |
Displays the rate, in terms of the number of contexts per second (cps) for the new_work counter for the last 1-minute, 5-minute, and 60-minute time periods. |
null_context |
Displays the rate, in terms of the number of contexts per second (cps) for the null_counter for the last 1-minute, 5-minute, and 60-minute time periods. |
FP context utilization |
|
Actual |
Displays the actual percentage of processor usage per second, compared to the theoretical maximum, for the last 1-minute, 5-minute, and 60-minute time periods. |
Theoretical |
Displays the percentage of processor usage compared to the ideal theoretical capacities for the last 1-minute, 5-minute, and 60-minute time periods. The theoretical maximum for the PXF processors is 3,125,000 contexts per second (cps). |
Maximum |
Displays the actual maximum percentage of processor usage that has occurred for the last 1-minute, 5-minute, and 60-minute time periods. |
Related Commands
Command |
Description |
---|---|
clear pxf |
Clears PXF counters and statistics. |
show pxf statistics |
Displays chassis-wide, summary PXF statistics. |
show pxf cpu feedback
To display the total number of feedbacks through the Parallel eXpress Forwarding (PXF) by all packets, use the show pxf cpu feedback command in privileged EXEC mode.
show pxf cpu feedback
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC (#)
Command History
Release |
Modification |
---|---|
12.2S |
This command was introduced on the Cisco 10000 series router. |
12.2(31)SB |
This command was integrated into Cisco IOS Release 12.2(31)SB. |
Examples
The following example shows feedback counters information:
Router# show pxf cpu feedback Load for five secs: 5%/0%; one minute: 6%; five minutes: 2% Time source is hardware calendar, *21:13:02.615 UTC Tue Nov 29 2005 FP column 0 feedback counts Global packet handle retry counter = 0 Name Current Difference (since last show) --------------------- ---------- ---------- bypass = 0 0 schedule retry = 0 0 WRED sample = 0 0 MLPPP linkq update = 0 0 IP frag = 0 0 ICMP = 0 0 layer2 divert = 0 0 tunnel lookup = 0 0 tunnel RX = 0 0 tunnel TX = 0 0 output qos = 0 0 tag not ip = 0 0 netflow accumulate = 0 0 netflow age = 0 0 netflow swap = 0 0 netflow export = 0 0 PBR = 0 0 input secACL log = 0 0 input secACL split = 0 0 output secACL log = 0 0 output secACL split = 0 0 IPC response = 0 0 IPC MLPPP flush = 0 0 input qos split = 0 0 output qos split = 0 0 MLPPP fwd packet = 0 0 MLPPP background = 0 0 MLPPP flush = 0 0 drop = 0 0 QPPB = 0 0 mcast lookup = 0 0 mcast replicate = 0 0 mcast rpf failed = 0 0 mcast bypass = 0 0 PBR split = 0 0 MLPPP lock retry = 0 0 output secACL = 0 0 qos divert split = 0 0 qos inject split = 0 0 secACL divert split = 0 0 MLPPP frag = 0 0 mpls deaggregation = 0 0 tunnel in secACL log = 0 0 tunnel out secACL log = 0 0 no packet handle = 0 0 PBR to FIB = 0 0 MLPPP flush lock retry = 0 0 MLPPP flush setup = 0 0 MLPPP sync flush req = 0 0 tail drop IP frag = 0 0 RP inject = 0 0 feedback retry = 0 0 MLPPP discard feedback = 0 0 MLPPP stats copy IPC = 0 0 IPM replay = 0 0 IPM replay drop = 0 0 IP reasm lock retry = 0 0 IP reasm recover punt = 0 0 IP reasm forward = 0 0 IP reasm insertion = 0 0 LAC switch = 0 0 L2TP decap = 0 0 IP reasm fb divert qos = 0 0 keepalive = 0 0 drop stats redirect = 0 0 AToM multiplexed = 0 0 LFI reassembly = 0 0 LFI remove entry = 0 0 iEdge translation = 0 0 iEdge divert = 0 0 multiple input qos = 0 0 multiple output qos = 0 0 iEdge PBHK DS trans = 0 0 LAC switch qos = 0 0 WRED sample init = 0 0 replay egress = 0 0 IPV6 FIB = 0 0 ICMPV6 = 0 0 IPV6 ACL = 0 0 IPV6 DIVERT ACL = 0 0 Total = 0 0
Related Commands
Command |
Description |
---|---|
show pxf cpu context |
Displays the current and historical loads on the PXF. |
show pxf cpu iedge
To display Parallel eXpress Forwarding (PXF) policy and template information, use the show pxf cpu iedgecommand in privileged EXEC mode.
show pxf cpu iedge [ detail | policy policy-name | template ]
Syntax Description
detail |
(Optional) Displays detailed information about policies and templates. |
policy policy-name |
(Optional) Displays summary policy information. |
template |
(Optional) Displays summary template information. |
Command Modes
Privileged EXEC (#)
Command History
Release |
Modification |
---|---|
12.2S |
This command was introduced. |
Examples
The following example shows PXF template information. The fields shown in the display are self-explanatory.
Router# show pxf cpu iedge template Super ACL name OrigCRC Class Count CalcCRC 1sacl_2 4EA94046 2 00000000 if_info 71BA3F20
Related Commands
Command |
Description |
---|---|
show pxf statistics |
Displays a summary of PXF statistics. |
show pxf cpu ipv6
To display Parallel eXpress Forwarding (PXF) IPv6 statistics, use the show pxf cpu ipv6 command in privileged EXEC mode.
show pxf cpu ipv6 [ ipv6:address [ prefix ] | acl-prefixes | hash | summary ]
Cisco 10000 Series Router
show pxf cpu ipv6 [ acl-prefixes | address | hash | summary | table | vrf ]
Syntax Description
ipv6: address [prefix] |
(Optional) Specifies the IPv6 address and optional IPv6 prefix for the information you want to display. |
acl-prefixes |
(Optional) Displays access control list (ACL) prefixes mapping information. |
address |
(Optional) Displays PXF IPv6 address-specific information. |
hash |
(Optional) Displays hash table summary information. |
summary |
(Optional) Displays a summary of the PXF IPv6 statistics. |
table |
(Optional) Displays detailed information about the PXF IPv6 forwarding table. |
vrf |
(Optional) Displays PXF IPv6 VRF information. |
Command Modes
Privileged EXEC (#)
Command History
Release |
Modification |
---|---|
12.2S |
This command was introduced. |
12.2(31)SB |
This command was integrated in Cisco IOS Release 12.2(31)SB. |
12.2(33)SB |
This command was enhanced to provide the address, table, and vrf options, and implemented on the Cisco 10000 series router for the PRE3 and PRE4. |
Usage Guidelines
Cisco 10000 Series Router
In Cisco IOS Release 12.2(33)SB, the show pxf cpu ipv6 table command displays the global table, but does not display the leafs that correspond to the IPv6 prefixes ::1/128 (Loopback) and ::/128 (All Zero). The microcode checks for these prefixes.
The show pxf cpu ipv6 table command replaces the show pxf cpu ipv6 command in Cisco IOS Release 12.2(31)SB.
Examples
The following example shows the PXF IPv6 statistics:
Router# show pxf cpu ipv6 Mtrie Leaf Data: Prefix/Length Leaf prefix ::/0,ACL Index = 0 Leaf elt_addr: 0x70D20001 SW_OBJ_FIB_ENTRY: 0x20A6E404 acl_index: 0 Refcount: 514 Flags: 0x2 Parent: None First Covered: None Right Peer: None ======================================== 0 routes in Mtrie with less specific overlapping parent route Hash Table Leaf Data: Prefix/Length Leaf prefix ::1/128,ACL Index = 0 Leaf elt_addr: 0x70D20011 SW_OBJ_FIB_ENTRY: 0x0 acl_index: 0 128-bit Table Hash Value: 0xC7F7 Refcount: 3 Flags: 0x2 Parent: None First Covered: None Right Peer: None Leaf prefix ::/128,ACL Index = 0 Leaf elt_addr: 0x70D20009 SW_OBJ_FIB_ENTRY: 0x0 acl_index: 0 128-bit Table Hash Value: 0xC2719 Refcount: 3 Flags: 0x2 Parent: None First Covered: None Right Peer: None ======================================== 0 routes in Hash Table with less specific overlapping parent route
Related Commands
Command |
Description |
---|---|
show pxf cpu statistics |
Displays PXF CPU statistics. |
show pxf cpu mpls
To display Parallel eXpress Forwarding (PXF) Multiprotocol Label Switching (MPLS) Forwarding Information Base (FIB) information, use the show pxf cpu mplscommand in privileged EXEC mode.
show pxf cpu mpls [ labels label-value | vrf ]
Syntax Description
labels label-value |
(Optional) Displays the transport type and output features associated with the specified label value or label range. The label-valuerange is 0 to 524288. |
vrf |
(Optional) Displays virtual routing and forwarding (VRF) root information. |
Command Modes
Privileged EXEC (#)
Command History
Release |
Modification |
---|---|
12.2S |
This command was introduced. |
Examples
The following example shows VRF root information. The fields shown in the display are self-explanatory.
Router# show pxf cpu mpls vrf VRF_ID 0 FIB_ROOT(RP) 0x72400000
Related Commands
Command |
Description |
---|---|
ping mpls |
Checks MPLS LSP connectivity. |
show mpls interfaces |
Displays information about the interfaces configured for label switching. |
show pxf cpu statistics |
Displays PXF CPU statistics. |
trace mpls |
Discovers MPLS LSP routes that packets will take when traveling to their destinations. |
show pxf cpu mroute
To display Parallel eXpress Forwarding (PXF) multicast route (mroute) information, use the show pxf cpu mroutecommand in privileged EXEC mode.
show pxf cpu mroute [ipaddress1] [ipaddress2]
Syntax Description
ipaddress1 ipaddress2 |
(Optional) Displays PXF mroute information for a particular group or range of groups. |
Command Modes
Privileged EXEC (#)
Command History
Release |
Modification |
---|---|
12.2S |
This command was introduced. |
Examples
The following example shows PXF mroute information:
Router# show pxf cpu mroute Shadow G/SG[5624]: s: 0.0.0.0 g: 224.0.1.40 uses: 0 bytes 0 flags: [D ] LNJ Interface vcci offset rw_index mac_header In : 0 0x000004 Shadow G/SG[3195]: s: 0.0.0.0 g: 234.5.6.7 uses: 0 bytes 0 flags: [5 ] NJ Interface vcci offset rw_index mac_header In : 0 0x000008 Out: Cable5/1/0 5 0x00002C 1B 00000026800001005E05060700010 Out: Cable6/1/1 9 0x000028 1A 00000026800001005E05060700010 Out: Cable6/0/0 6 0x000024 19 00000026800001005E05060700010 Out: Cable5/0/0 3 0x000020 18 00000026800001005E05060700010 Out: Cable7/0/0 A 0x00001C 17 00000026800001005E05060700010 Out: Cable7/1/1 C 0x000018 16 00000026800001005E05060700010 Out: Cable7/1/0 B 0x000014 15 00000026800001005E05060700010 Out: Cable6/1/0 8 0x000010 14 00000026800001005E05060700010 Out: Cable6/0/1 7 0x00000C 13 00000026800001005E05060700010 Out: Cable5/0/1 4 0x000008 12 00000026800001005E05060700010
The table below describes the fields shown in the display.
Field |
Description |
---|---|
Interface |
Interface or subinterface. |
vcci |
Virtually Cool Common Index (VCCI) for the interface or subinterface. |
rw index |
Index used to read and write into the multicast table for this entry. |
mac_header |
MAC header that is used when rewriting the packet for output. |
Related Commands
Command |
Description |
---|---|
show ip mroute |
Displays the Cisco IOS version of a multicast routing table entry. |
show pxf statistics |
Displays chassis-wide, summary PXF statistics. |
show pxf cpu pbr action
To display policy-based routing (PBR) actions configured in the Parallel eXpress Forwarding (PXF), use the show pxf cpu pbr action command in privileged EXEC mode.
show pxf cpu pbr action map-name
Cisco 10000 Series Router (PRE3)
show pxf cpu pbr [ action map-name | tcam map-name | flex-sum ]
Syntax Description
Command Modes
Privileged EXEC (#)
Command History
Release |
Modification |
---|---|
12.2S |
This command was introduced. |
12.3(7)XI1 |
This command was introduced on the Cisco 10000 series router for the PRE2. |
12.2(31)SB2 |
This command was introduced on the Cisco 10000 series router for the PRE3. |
Usage Guidelines
This command is useful to determine if an adjacency has been found for a set ip next-hop ip-address route map configuration command.
Examples
The following example shows the PBR route maps configured in the PXF:
Router# show pxf cpu pbr action foo Show PBR Action: ---------------------------------------------------------------------- Policy number: 1 route-map foo, permit, sequence 10 map number = 0 action index = 0 primary action : SET_ROUTE secondary action : - none - mac-rewr index = 0x0000 0015 vcci = 0x09D4, qos group = 0, tos prec = 0 tt_pkt_count = 0 tt_byte_count = 0 Adjacency data 0x20D29968 XCM adjacency from 0x70000120(RP) 0xA0000120(FP) index 0x24:
Examples
The following configuration example shows a PBR configuration in which traffic classification is based on the IP access list named pbr_length. The route map permits traffic based on the specified matching criteria and sets the next hop address of each packet.
ip access-list extended pbr_length permit tcp any any ! route-map pbr_length permit 10 match ip address pbr_length match length 100 200 set ip next-hop 2.0.95.5 ! route-map pbr_length permit 20 match ip address pbr_length match length 200 300 set ip next-hop 2.0.95.5 ! route-map pbr_length permit 30 match length 300 400 set ip next-hop 2.0.95.5 !
The following sample output from the show pxf cpu pbr command shows the type of information that displays based on the above PBR configuration:
Router# show pxf cpu pbr action pbr_length Show PBR Action: ---------------------------------------------------------------------- Policy number: 3 route-map pbr_length, permit, sequence 10 map number = 0 action index = 64 map vcci out = 0x0 tt_pkt_count = 0 tt_byte_count = 0 primary action : NULL_ACTION secondary action : - none - mac-rewr index = 0x0000 0000 vcci = 0x0000, qos group = 0, tos prec = 0 ...................................................................... route-map pbr_length, permit, sequence 20 map number = 1 action index = 65 map vcci out = 0x0 tt_pkt_count = 0 tt_byte_count = 0 primary action : NULL_ACTION secondary action : - none - mac-rewr index = 0x0000 0000 vcci = 0x0000, qos group = 0, tos prec = 0 ...................................................................... route-map pbr_length, permit, sequence 30 map number = 2 action index = 66 map vcci out = 0x0 tt_pkt_count = 0 tt_byte_count = 0 primary action : NULL_ACTION secondary action : - none - mac-rewr index = 0x0000 0000 vcci = 0x0000, qos group = 0, tos prec = 0
The following sample output from the show pxf cpu pbr tcam command shows the type of detailed VMR (value, plus a mask and result) information that displays:
Router# show pxf cpu pbr tcam pbr_length detail VMR data for Route-map pbr_length ------------------------------------------------------------- VMR Format - handle: 5050BC90 Format has 5 fields, refcount = 1 Field: Format, FIXED, start_bit = 69, end_bit = 71 Field: ACL index, FIXED, start_bit = 54, end_bit = 68 Field: Flags, FIXED, start_bit = 43, end_bit = 53 Field: L4 proto, FIXED CNV, start_bit = 16, end_bit = 23 Field: Unknown, FLEX, start_bit = 0, end_bit = 15 Total bits = 53, format = 72 GMR used: 0 Col 3 LKBP Vector: 96C Status: Running ------------------------------------------------------------- VMRs ------ VMR 0 ------ V: 7000C000 00000600 70 M: FFFFD800 0000FFFF F0 R: 80000104 Format: 00000003/00000007 ACL index: 00004003/00007FFF L4 proto: 00000006/000000FF Flags: 00000000/00000300 Packet Length: 00000070/0000FFF0 ------ VMR 1 ------ V: 7000C000 00000600 68 M: FFFFD800 0000FFFF F8 R: 80000104 Format: 00000003/00000007 ACL index: 00004003/00007FFF L4 proto: 00000006/000000FF Flags: 00000000/00000300 Packet Length: 00000068/0000FFF8 ------ VMR 2 ------ V: 7000C000 00000600 64 M: FFFFD800 0000FFFF FC R: 80000104 Format: 00000003/00000007 ACL index: 00004003/00007FFF L4 proto: 00000006/000000FF Flags: 00000000/00000300 Packet Length: 00000064/0000FFFC . . . ------ VMR 18 ------ V: 7000C000 00000000 00 M: FFFFC000 00000000 00 R: 80000110 Format: 00000003/00000007 ACL index: 00004003/00007FFF L4 proto: 00000000/00000000 Flags: 00000000/00000000 Packet Length: 00000000/00000000
Related Commands
Command |
Description |
---|---|
show pxf cpu policy-data |
Displays QoS policy data index usage statistics. |
show pxf cpu vcci |
Displays VCCI to interface mapping information. |
show pxf cpu police
To display all active policer policies in the Parallel eXpress Forwarding (PXF), including active interface and policing parameters, use the show pxf cpu police command in privileged EXEC mode.
show pxf cpu police [policy-map-name]
Syntax Description
policy-map-name |
(Optional) Policy for which you want to display PXF policing statistics. |
Command Modes
Privileged EXEC (#)
Command History
Release |
Modification |
---|---|
12.2S |
This command was introduced. |
12.3(7)XI1 |
This command was integrated into Cisco IOS Release 12.3(7)XI1. |
Usage Guidelines
If a policy name is not specified, the command displays policing statistics for all policy maps.
Examples
The following example shows the PXF policing statistics for a policy called policetest. The fields shown in the display are self-explanatory.
Router# show pxf cpu police policetest Policy policetest: Class: police_class Interface VCCI 0x9DD Output Policy: police 8000 8000 15000 conform-action transmit exceed-action drop violate-action drop Class: class-default *** No police action ***
Related Commands
Command |
Description |
---|---|
show pxf cpu vcci |
Displays VCCI to interface mapping information. |
show pxf statistics |
Displays chassis-wide, summary PXF statistics. |
show pxf cpu policy-data
To display Parallel eXpress Forwarding (PXF) policy data index usage statistics, use the show pxf cpu policy-data command in privileged EXEC mode.
show pxf cpu policy-data
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC (#)
Command History
Release |
Modification |
---|---|
12.2S |
This command was introduced. |
12.3(7)XI1 |
This command was integrated into Cisco IOS Release 12.3(7)XI1. |
Examples
The following example shows PXF policy data which is information related to the number of classes in a policy and the reservation of unique indexes to support match statistics and token buckets. Policy data index statistics are related to free match statistics indexes. Exhaustion of these indexes means no more policies can be created in the router. Secondary policy data indexes are related to free token bucket indexes. The fields shown in the display are self-explanatory.
Router# show pxf cpu policy-data Service policy data index usage statistics: Total groups = 9, pool_defragmented = TRUE. Group size Chunk count 1 0 2 1 4 1 8 0 16 1 32 1 64 1 128 1 256 1023 Total free count = 262134. Total chunk count = 262144. Secondary policy data index usage statistics: Total groups = 9, pool_defragmented = TRUE. Group size Chunk count 2 1 4 1 8 0 16 1 32 1 64 1 128 1 256 1 512 2047 Total free count = 1048566. Total chunk count = 1048576.
The Group size field is the number of policy classes. The Chunk count field is the number of blocks the group holds.
Related Commands
Command |
Description |
---|---|
show pxf cpu pbr action |
Displays PBR actions configured in the PXF for all PBR route maps. |
show pxf cpu vcci |
Displays VCCI to interface mapping information. |
show pxf cpu qos
To display Parallel eXpress Forwarding (PXF) External Column Memory (XCM) contents related to a particular policy, use the show pxf cpu qos command in privileged EXEC mode.
show pxf cpu qos [ policy-map policy-name | vcci-maps ]
Cisco 10000 Series Router
show pxf cpu qos [ vcci | classifiers | flex-sum | policy-map policy-name | vcci-maps ]
Syntax Description
vcci |
(Optional) Virtual Channel Circuit Identifier (VCCI). Information about this specified VCCI will be displayed. |
||
classifiers |
(Optional) Displays information about the criteria used to classify traffic. |
||
flex-sum |
(Optional) Displays summary information describing the amount of memory allocated in the PXF engine for use by the flexible key construction microcode.
|
||
policy-map policy-name |
(Optional) Displays per-policy map information. |
||
vcci-maps |
(Optional) Displays VCCI map values. |
Command Modes
Privileged EXEC (#)
Command History
Release |
Modification |
---|---|
12.2S |
This command was introduced. |
12.3(7)XI1 |
This command was introduced on the Cisco 10000 series router for the PRE2. |
12.2(28)SB |
This command was integrated into Cisco IOS Release 12.2(28)SB. |
12.2(31)SB2 |
This command was introduced on the PRE3 for the Cisco 10000 series router. |
Usage Guidelines
This command is useful in verifying the presence of a policy on interfaces and indexes programmed in the PXF.
Examples
The following example shows XCM contents related to a policy called police_test, which is defined as follows:
policy-map police_test class high-priority priority class low-priority set atm-clp class class-default queue-limit 512 Router# show pxf cpu qos police_test Output Policymap: police_test Vcci: A05 Flags: 4 Policymap_index: 6 Policymap_data_index: 12 OUT AT1/0/0.111 (0x71764660) ref_count 1 Output Action Table Contents for vcci 0xA05 - Policymap index: 6 class-name: high-priority class_index: 0 action_flags: 0x00 srp_class_id: 0x01 prec/dscp: 0x00 cos: 0 discard_class: 0x00 exp_value: 0 class-name: low-priority class_index: 1 action_flags: 0x10 srp_class_id: 0x00 prec/dscp: 0x00 cos: 0 discard_class: 0x00 exp_value: 0 class-name: class-default class_index: 2 action_flags: 0x00 srp_class_id: 0x00 prec/dscp: 0x00 cos: 0 discard_class: 0x00 exp_value: 0
Related Commands
Command |
Description |
---|---|
show pxf cpu statistics qos |
Displays match statistics for a service policy on an interface. |
show pxf cpu queue
To display parallel express forwarding (PXF) queueing and link queue statistics, use the show pxf cpu queuecommand in privileged EXEC mode.
show pxf cpu queue [ interface | QID | summary ]
Cisco uBR10012 Universal Broadband Router
show pxf cpu queue [ interface | QID ]
Syntax Description
interface |
(Optional) The interface for which you want to display PXF queueing statistics. This displays PXF queueing statistics for the main interface and all subinterfaces and permanent virtual circuits (PVCs). It also displays packets intentionally dropped due to queue lengths. |
QID |
(Optional) The queue identifier. |
summary |
(Optional) Displays queue scaling information such as:
|
Command Modes
Privileged EXEC (#)
Command History
Release |
Modification |
---|---|
12.2S |
This command was introduced. |
12.2(28)SB |
This command was integrated into Cisco IOS Release 12.2(28)SB. |
12.3(7)XI1 |
This command was integrated into Cisco IOS Release 12.3(7)XI1. |
12.3(23)BC1 |
The "Link Queues" output field for dynamic bandwidth sharing-enabled modular cable and wideband cable interfaces was added on the Cisco uBR10012 universal broadband router. |
12.2(33)SB |
This command was modified for virtual access interfaces (VAIs) and the output was modified for the summary option, and implemented on the Cisco 10000 series router for the PRE3 and PRE4. |
12.2(33)SCB |
The output of this command has been updated or re-arranged (compared to the VTMS version) for DOCSIS Weighted Fair Queuing (WFQ) Scheduler feature and implemented on the Cisco uBR10012 router. |
Usage Guidelines
When neither the interface or QID is specified, the command displays queuing statistics for the route processors (RPs).
Cisco 10000 Series Router
The Cisco 10000 series router high-speed interfaces work efficiently to spread traffic flows equally over the queues. However, using single traffic streams in a laboratory environment might result in less-than-expected performance. To ensure accurate test results, test the throughput of the Gigabit Ethernet, OC-48 POS, or ATM uplink with multiple source or destination addresses. To determine if traffic is being properly distributed, use the show pxf cpu queue command.
In Cisco IOS Release 12.2(33)SB and later releases, the router no longer allows you to specify a virtual access interface (VAI) as viX.Y in the show pxf cpu queuecommand. Instead, you must spell out the VAI as virtual-access.
For example, the router accepts the following command:
Router# show pxf cpu queue virtual-access2.1
In releases prior to Cisco IOS Release 12.2(33)SB, the router accepts the abbreviated form of the VAI. For example, the router accepts the following command:
Router# show pxf cpu queue vi2.1
In Cisco IOS Release 12.2(33)SB and later releases, the output from the show pxf cpu queue interface summary command displays only the physical interface and the number of logical links. The output does not display the number of priority queues, class queues, and so on. This modification applies to the PRE3 and PRE4.
Cisco uBR10012 Universal Broadband Router
If dynamic bandwidth sharing (DBS) is enabled, the link queue information that is displayed refers to the specific type of interface that is configured--modular cable or wideband cable. The summary keyword option is not supported for the Cisco uBR10012 universal broadbandrRouter for wideband cable or modular cable interfaces. The ATM interface output is not available for this router.
See the table below for descriptions of the interface keyword fields.
Field |
Description |
||
---|---|---|---|
<0-131071> |
QID (queue identifier) |
||
ATM |
Asynchronous transfer mode interface
|
||
BVI |
Bridge-group virtual interface |
||
Bundle |
Cable virtual bundle interface |
||
CTunnel |
CTunnel interface |
||
Cable |
Cable modem termination service (CMTS) interface |
||
DTI |
Digital trunk interface |
||
Dialer |
Dialer interface |
||
Ethernet |
IEEE 802.3 |
||
FastEthernet |
FastEthernet IEEE 802.3 |
||
GigabitEthernet |
GigabitEthernet IEEE 802.3z |
||
Group-Async |
Async group interface |
||
Loopback |
Loopback interface |
||
MFR |
Multilink frame relay bundle interface |
||
Modular-Cable |
Modular cable interface |
||
Multilink |
Multilink group interface |
||
Null |
Null interface |
||
Port-channel |
Ethernet channel of interfaces |
||
RP |
Forwarding path (FP) to route processing (RP) queues |
||
Tunnel |
Tunnel interface |
||
Vif |
Pragmatic general multicast (PGM) host interface |
||
Virtual-Template |
Virtual template interface |
||
Virtual-TokenRing |
Virtual token ring |
||
WB-SPA |
line card to line card (LC-LC) queues |
||
Wideband-Cable |
Wideband CMTS interface |
Examples
The following example shows PXF queueing statistics for an ATM interface when a QID is not specified. The sample output includes the dropped and dequeued packets for the VCs, and for classes associated with sessions that inherit queues from VCs.
Router# show pxf cpu queue atm 5/0/2 VCCI 2517: ATM non-aggregated VC 1/229, VCD 1, Handle 1, Rate 500 kbps VCCI/ClassID ClassName QID Length/Max Res Dequeues Drops 0 2517/0 class-default 269 0/4096 11 3 0 0 2517/31 pak-priority 268 0/32 11 4 0 Queues Owned but Unused by VC (inheritable by sessions) ClassID ClassName QID Length/Max Res Dequeues Drops 0 class-default 275 0/32 11 100 0 31 pak-priority 268 0/32 11 4 0 VCCI 2517: ATM non-aggregated VC 1/233, VCD 4, Handle 4, Rate 50 kbps VCCI/ClassID ClassName QID Length/Max Res Dequeues Drops 0 2517/0 class-default 269 0/4096 11 3 0 0 2517/31 pak-priority 268 0/32 11 4 0 Queues Owned but Unused by VC (inheritable by sessions) ClassID ClassName QID Length/Max Res Dequeues Drops 0 class-default 274 0/32 11 0 0 31 pak-priority 268 0/32 11 4 0 VCCI 2520: ATM non-aggregated VC 1/232, VCD 3, Handle 3, Rate 500 kbps VCCI/ClassID ClassName QID Length/Max Res Dequeues Drops 0 2520/0 class-default 273 0/32 11 0 0 0 2520/31 pak-priority 268 0/32 11 4 0 VCCI 2519: ATM non-aggregated VC 1/231, VCD 2, Handle 2, Rate 500 kbps VCCI/ClassID ClassName QID Length/Max Res Dequeues Drops 0 2519/0 class-default 272 0/32 11 0 0 0 2519/31 pak-priority 268 0/32 11 4 0
The following example displays PXF queuing statistics for QID 267:
Router# show pxf cpu queue 267 ID : 267 Priority : Lo CIR (in-use/configured) : 0/65535 EIR (in-use/configured) : 0/0 MIR (in-use/configured) : 0/65535 Maximum Utilization configured : no Link : 2 Flowbit (period/offset) : 32768/32768 Burst Size : 1024 bytes Bandwidth : 133920 Kbps Channel : 0 Packet Descriptor Base : 0x00000100 ML Index : 0 Length/Average/Alloc : 0/0/32 Enqueues (packets/octets) : 293352/9280610 Dequeues (packets/octets) : 293352/9280610 Drops (tail/random/max_threshold) : 0/0/0 Drops (no_pkt_handle/buffer_low) : 0/0 WRED (weight/avg_smaller) : 0/0 WRED (next qid/drop factor) : 0/0 WRED (min_threshold/max_threshold/scale/slope): precedence 0 : 0/0/0/0 precedence 1 : 0/0/0/0 precedence 2 : 0/0/0/0 precedence 3 : 0/0/0/0 precedence 4 : 0/0/0/0 precedence 5 : 0/0/0/0 precedence 6 : 0/0/0/0 precedence 7 : 0/0/0/0
Examples
The following examples show link queue information for specific wideband cable and modular cable interfaces when dynamic bandwidth sharing is enabled.
Examples
Router(config)# interface modular-cable 1/0/0:1 . . . Router(config-if)# cable dynamic-bw-sharing . . . Router# show pxf cpu queue modular-cable 1/0/0:1 Link Queues : QID CIR(act/conf) EIR MIR RF Chan. Status 420 19661/19661 1/1 65535/65535 0 Inactive
Wideband Cable Interface
Router(config)# interface wideband-cable 1/0/0:0 . . . Router(config-if)# cable dynamic-bw-sharing . . . Router# show pxf cpu queue wideband-cable 1/0/0:0 Link Queues : QID CIR(act/conf) EIR MIR RF Chan. Status 419 32768/32768 1/1 65535/65535 0 Inactive 566 19661/19661 1/1 65535/65535 1 Inactive
The following example shows service flow queue information for modular cable interfaces.
Router# show pxf cpu queue modular-cable 1/2/0:0 Cable Interface Queues: QID Len/Max Dequeues TailDrops MinRt Wt/Quantum ShapeRt FlowId (Kbps) (Kbps) 131147 0/255 190 0 0 1/240 0 58 131148 0/255 33820 0 0 1/10000 0 32824 Cable Service Flow Queues: * Best Effort Queues QID Len/Max Dequeues TailDrops MinRt Wt/Quantum ShapeRt FlowId (Kbps) (Kbps) 131241 0/255 0 0 0 1/240 0 32881 * CIR Queues QID Len/Max Dequeues TailDrops MinRt Wt/Quantum ShapeRt FlowId (Kbps) (Kbps) 2049 254/255 131018 485751 99 1/1920 0 32880 * Low Latency Queues QID Len/Max Dequeues TailDrops
Related Commands
Command |
Description |
---|---|
cable dynamic-bw-sharing |
Enables DBS on a specific modular cable or wideband cable interface. |
show pxf cable controller |
Displays information about the RF channel VTMS links and link queues. |
show pxf cpu statistics queue |
Displays PXF CPU queueing counters for all interfaces. |
show pxf cpu reasm_index
To display information about reassembly of IP fragmented packets in the Parallel eXpress Forwarding (PXF), use the show pxf cpu reasm_index command in privileged EXEC mode.
show pxf cpu reasm_index [summary]
Syntax Description
summary |
(Optional) Displays summary reassembly information of IP fragmented packets in the PXF. |
Command Modes
Privileged EXEC (#)
Command History
Release |
Modification |
---|---|
12.2S |
This command was introduced. |
Examples
The following example shows reassembly summary information. The fields shown in the display are self-explanatory.
Router# show pxf cpu reasm_index summary Multilink Reassembly Index usage summary Maximum Used Available 1251 0 1251
Related Commands
Command |
Description |
---|---|
ip virtual-reassembly |
Enables VFR information on an interface. |
show ip virtual-reassembly |
Displays VFR configuration and statistical information. |
show pxf cpu statistics
To display Parallel eXpress Forwarding (PXF) CPU statistics, use the show pxf cpu statisticscommand in privileged EXEC mode.
show pxf cpu statistics [ atom | backwalk | clear | diversion | drop [ interface | vcci ] | ip | ipv6 | l2tp | mlp | qos [interface] | queue | rx [vcci] | security | arp-filter | drl [ cable-wan-ip | wan-non-ip ] ]
Cisco 10000 Series Router
show pxf cpu statistics diversion [ pxf [ interface { interface | vcci } ] | top number ]
Syntax Description
atom |
(Optional) Displays Any Transport over MPLS (AToM) statistics. |
backwalk |
(Optional) Displays backwalk requests statistics. |
clear |
(Optional) Clears PXF CPU statistics. |
diversion |
(Optional) Displays packets that the PXF diverted to the Route Processor (RP) for special handling. |
drop [interface] [vcci] |
(Optional) Displays packets dropped by the PXF for a particular interface or Virtual Circuit Connection Identifier (VCCI). |
ip |
(Optional) Displays IP statistics. |
ipv6 |
(Optional) Displays IPv6 statistics. |
l2tp |
(Optional) Displays packet statistics for an L2TP Access Concentrator (LAC) (Optional) and L2TP Network Server (LNS). |
mlp |
(Optional) Displays multilink PPP (MLP) statistics. |
pxf |
(Optional) Displays packets that the PXF diverted to the Route Processor (RP). Available on the Cisco 10000 series router only. |
pxf interface interface |
(Optional) Displays per-interface PXF statistical information for the divert cause policer on a particular interface. Available on the Cisco 10000 series router only. |
pxf interface vcci |
(Optional) Displays per-VCCI PXF statistical information for the divert cause policer on a particular Virtual Circuit Connection Identifier (VCCI). Available on the Cisco 10000 series router only. |
qos [interface] |
(Optional) Displays match statistics for a service policy on an interface. |
queue |
(Optional) Displays queueing counters for all interfaces. |
rx [vcci] |
(Optional) Displays receive statistics for a VCCI. |
security |
(Optional) Displays ACL matching statistics. |
top number |
(Optional) Displays PXF statistical information for the number of top punters you specify. Available on the Cisco 10000 series router only. Valid values are from 1 to 100. |
arp-filter |
(Optional) Displays the ARP filter statistics. |
drl |
(Optional) Displays the divert rate limit. |
cable-wan-ip |
(Optional) Displays cable / wan-ip statistics for dropped packets. |
wan-non-ip |
(Optional) Displays DRL wan-non-ip statistics for dropped packets. |
Command Modes
Privileged EXEC (#)
Command History
Release |
Modification |
---|---|
12.3(7)XI1 |
This command was integrated into Cisco IOS Release 12.3(7)XI1. |
12.2(28)SB |
This command was introduced on the Cisco 10000 series router and integrated into Cisco IOS Release 12.2(28)SB. |
12.2(31)SB2 |
This command was integrated into Cisco IOS Release 12.2(31)SB2. |
12.2(33)SB |
This command was enhanced to display per-interface or per-VCCI PXF statistical information for the divert cause policer on a particular interface or VCCI, to display the top punters on an interface, and to display the provisioned burst size for any divert causes. These enhancements were implemented on the Cisco 10000 series router for the PRE2, PRE3, and PRE4. |
12.2(33)SCB |
This command was integrated into Cisco IOS Release 12.2(33)SCB on the Cisco uBR7246VXR and Cisco uBR10012 universal broadband routers. Support for the Cisco uBR7225VXR router was added. The arp-filter, drl, cable-wan-ip, and wan-non-ipkeywords were added . |
12.2(33)SCE |
This command was modified in Cisco IOS Release 12.2(33)SCE. The cable-wan-ipkeyword was removed. |
Usage Guidelines
Cisco 10000 Series Router Usage Guidelines
The show pxf cpu statistics diversioncommand displays statistical information about diverted packets. Divert causes with the string "ipv6..." display as "v6..." in the output of all show pxf cpu statistics diversioncommands
The output from the show pxf cpu statistics diversion pxfcommand was enhanced in Cisco IOS Release 12.2(33)SB to display the provisioned burst size for any divert causes.
The show pxf cpu statistics diversion pxf interface interfacecommand displays statistical information about the divert cause policer on a specific interface. The output of this command is similar to the output displayed at the aggregated level. This command enables you to see the traffic types being punted from an inbound interface, subinterface, and session.
The show pxf cpu statistics diversion pxf interface vccicommand displays statistical information about the divert cause policer on a specific VCCI. The output of this command is similar to the output displayed at the aggregated level. This command enables you to see the traffic types being punted from an inbound interface, subinterface, and session.
The show pxf cpu statistics diversion top numbercommand displays the interfaces, subinterfaces, and sessions with the highest number of punter packets.
Examples
The following example shows PXF queueing counters information. These are aggregate counters for all interfaces. The Total column is the total for all columns.
Note | If you are troubleshooting link utilization issues, the deq_vtp_req, deq_flow_off, and deq_ocq_off counters may indicate what is causing the versatile time management scheduler (VTMS) to slow down. If you are troubleshooting overall PXF throughput issues, look at the High Next Time, Low Next Time, High Wheel Slot, and Low Wheel Slot counters. |
Router# show pxf cpu statistics queue Column 6 Enqueue/Dequeue Counters by Rows: dbg Counters 0 1 2 3 4 5 6 7 Total ============= ========== ========== ========== ========== ========== ========== ========== ========== ========== enq_pkt 0x0000FD9B 0x0000FC77 0x0000FE4A 0x0000FF81 0x0000FC53 0x0000FD2E 0x0000FF19 0x0000FDDE 0x0007EE55 tail_drop_pkt 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 deq_pkt 0x0000FD47 0x0000FEF2 0x0000FCB3 0x0000FF65 0x0000FCE7 0x0000FC45 0x0000FEE7 0x0000FDF1 0x0007EE55 deq_vtp_req 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 deq_flow_off 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 deq_ocq_off 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 enqdeq_conflict 0x0000003A 0x00000043 0x0000004A 0x00000039 0x0000003A 0x0000004F 0x00000036 0x00000031 0x000001F0 bndl_pkt 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 frag_pkt 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 dbg_frag_drop 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 dbg_bndl_sem 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 context_inhibit 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 bfifo_enq_fail 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 dbg1 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 dbg2 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 dbg3 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 dbg4 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 dbg5 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 dbg6 0x0000 0x0000 0x0000 0x0000 0x0000 0x0000 0x0000 0x0000 0x0000 dbg7 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 Column 7 Rescheduling State Counters by Rows: dbg Counters 0 1 2 3 4 5 6 7 Total ============= ========== ========== ========== ========== ========== ========== ========== ========== ========== High Next Time 0x524E1100 0x524E1140 0x524E1140 0x524E1180 0x524E11C0 0x524E11C0 0x524E1200 0x524E1240 - Low Next Time 0x524E1100 0x524E1140 0x524E1140 0x524E1180 0x524E11C0 0x524E1200 0x524E1200 0x524E1240 - High Wheel Slot 0x00000844 0x00000845 0x00000846 0x00000846 0x00000847 0x00000848 0x00000848 0x00000849 - Low Wheel Slot 0x00000844 0x00000845 0x00000846 0x00000846 0x00000847 0x00000848 0x00000848 0x00000849 - DEQ_WHEEL 0x0001F5D0 0x0001F4BD 0x0001F56B 0x0001F6BF 0x0001F396 0x0001F3E8 0x0001F6BF 0x0001F4A7 0x000FA99B DQ-lock Fails 0x0000039F 0x000003FD 0x000003B2 0x000003E1 0x000003CB 0x000003E2 0x000003FD 0x000003CD 0x00001EA6 TW ENQ Fails 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 Q_SCHED 0x0000FACD 0x0000FC6B 0x0000FA38 0x0000FCE4 0x0000FA66 0x0000F994 0x0000FC62 0x0000FB8B 0x0007DA3B FAST_SCHED 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 Q_DEACT 0x0000FB03 0x0000F852 0x0000FB33 0x0000F9DB 0x0000F930 0x0000FA54 0x0000FA5D 0x0000F91C 0x0007CF60 Q_ACTIVATE 0x0000F9B6 0x0000F8D4 0x0000FA6C 0x0000FBA9 0x0000F87E 0x0000F95B 0x0000FB0A 0x0000F9DE 0x0007CF60 Q_CHANGE 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 DEBUG1 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 DEBUG2 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 DEBUG3 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 DEBUG4 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 DEBUG5 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000
The table below describes the significant fields shown in the display.
Field |
Description |
---|---|
Column 6 Enqueue/Dequeue Counters by Rows: |
|
enq_pkt |
Packets the PXF enqueued. |
tail_drop_pkt |
Packets the PXF tails dropped. |
deq_pkt |
Packets the PXF dequeued. |
deq_vtp_req |
Number of times a dequeue was inhibited due to the virtual traffic policer. |
deq_flow_off |
Numbers of times a dequeue was inhibited due to a flowoff from the line card. |
deq_ocq_off |
Number of times a dequeue was inhibited due to link level flow control. |
enqdeq_conflict |
Shows a dequeue failed due to an enqueue to the same queue in progress. |
bndl_pkt |
Count of packets that were fragmented. |
frag_pkt |
Count of fragments sent. |
dbg_frag_drop |
Count of invalid multilink PPP (MLP) fragment handles. |
dbg_bndl_sem |
Count of semaphone collision (used for MLP). |
context_inhibit |
Number of times multilink transmit fragment processing was inhibited due to a lack of DMA resources. |
bfifo_enq_fail |
Count of bundle FIFO (BFIFO) enqueue failures. |
Column 7 Rescheduling State Counters by Rows: |
|
High Next Time |
Current next send time for the high priority wheel. |
Low Next Time |
Current next send time for the low priority wheel. |
High Wheel Slot |
Current high priority slot number. |
Low Wheel Slot |
Current low priority slot number. |
DEQ_WHEEL |
Count of successful dequeues from the timing wheel. |
DQ-lock Fails |
Count of timing wheel dequeue failures (both queue empty and race conditions). |
TW ENG Fails |
Timing wheel enqueue failures. |
Q_SCHED |
Count of queues scheduled/rescheduled onto the timing wheel. |
FAST_SCHED |
Count of queues fast scheduled/rescheduled onto the timing wheel. |
Q_DEACT |
Count of queue deactivations. |
Q_ACTIVATE |
Count of queue activations (activate state). |
Q_CHANGE |
Count of queue changes; for example, Route Processor (RP) inspired rates changes. |
The following example displays PXF L2TP packet statistics.
Note | For L2TP Access Concentrator (LAC) operation, all statistics are applicable. For L2TP Network Server (LNS) operation, only the PPP Control Packets, PPP Data Packets, and PPP Station Packets statistics are meaningful. |
Router# show pxf cpu statistics l2tp LAC Switching Global Debug Statistics: PPP Packets 51648 PPP Control Packets 51647 PPP Data Packets 1 Not IPv4 Packets 1 IP Short Hdr Packets 1 IP Valid Packets 0 IP Invalid Packets 1 DF Cleared Packets 0 Path MTU Packets 0 No Path MTU Packets 0 Within PMTU Packets 0 Fraggable Packets 0 PMTU Pass Packets 0 PMTU Fail Packets 0 Encapped Packets 51648 L2TP Classification Global Debug Statistics: LAC or Multihop Packets 151341 Multihop Packets 0 PPP Control Packets 51650 PPP Data Packets 99691 PPP Station Packets 151341
The following example displays match statistics for the police_test policy on an ATM interface. The Classmap Index differentiates classes within a policy while the Match Number differentiates match statements within a class.
Router# show pxf cpu statistics qos atm 6/0/0.81801 Classmap Match Pkts Bytes Index Number Matched Matched ------------ ----------- ------------ ---------- police_test (Output) service-policy : police_class (0) 0 0 0 1 0 0 2 0 0 3 0 0 class-default (1) 0 0 0
Examples
The following example displays the top 10 packet types diverted to the RP. The output displays the top punters by interface and by Layer 2 packet flow.
Router# show pxf cpu statistics diversion top 10 Top 10 punters by interface are: Rate (pps) Packets (diverted/dropped) vcci Interface 1 10/0 2606 Virtual-Access2.1 Last diverted packet type is none. Top 10 punters by Layer 2 flow are: Rate (pps) Packets (diverted/dropped) Interface Layer 2 info 1 15/0 ATM2/0/3 vpi 128/vci 4096/vcci 2591 Last diverted packet type is oam_f4. 1 15/0 ATM2/0/3 vpi 128/vci 4096/vcci 2593 Last diverted packet type is oam_f4.
Related Commands
Command |
Description |
---|---|
platform c10k divert- policer |
Configures the rate and burst size of the divert-policer. |
show pxf statistics |
Displays a summary of statistics in the PXF. |
show pxf cpu subblocks
To display Parallel eXpress Forwarding (PXF) CPU statistics for a bridged subinterface (encapsulation type), use the show pxf cpu subblocks command in privileged EXEC mode.
show pxf cpu subblocks interface-name
Syntax Description
interface-name |
Name of the interface. |
Command Modes
Privileged EXEC (#)
Command History
Release |
Modification |
---|---|
12.2(28)SB |
This command was introduced on the Cisco 10000 series router. |
12.3(14)T |
This command was enhanced to display more information for all subblocks. |
12.2(31)SB |
This command was integrated into Cisco IOS Release 12.2(31)SB. |
Examples
The following example shows subblocks information for Gigabit Ethernet interface 7/0/0:
Router# show pxf cpu subblocks g7/0/0 GigabitEthernet7/0/0 is up ICB = 1C000, LinkId = 6, interface PXF, enabled link next_send: 0x37022604 channel number: 0 link bandwidth mult: 33467 shift: 22 link bandwidth mult: 33467 shift: 22 link aggregate cir: 0x00000000 aggregate eir: 0x00000000 IOS encapsulation type 1 ARPA Min mtu: 14 Max mtu: 1528 VCCI maptable location = A3340000 VCCI 9D3 (802.1Q VLAN 1) icmp ipaddress 0.0.0.0 timestamp 0 fib_root 0x0, fib_root_rpf 0x0 cicb_flags 0x00, flags/netmask 0x02 VCCI 9DB (802.1Q VLAN 1) icmp ipaddress 0.0.0.0 timestamp 0 fib_root 0x0, fib_root_rpf 0x0 cicb_flags 0x00, flags/netmask 0x02
The following example shows subblocks information for all interfaces:
Router# show pxf cpu subblocks PXF Interface Status ICB WQB_ID Fwding Enc VCCI-map VCCI VC Control Plane up 0 1 PXF 0 A3000000 1 ATM1/0/0 initiali 6000 3 disabl 33 A3040000 9CF ATM1/0/1 initiali 6001 4 disabl 33 A3060000 9D0 ATM1/0/2 initiali 6002 5 disabl 33 A3080000 9D1 ATM1/0/3 initiali 6003 6 disabl 33 A30A0000 9D2 Serial2/0/0 initiali A000 7 disabl 16 A3000004 9D3 Serial2/0/1 initiali A001 8 disabl 16 A3000008 9D4 Serial2/0/2 initiali A002 9 disabl 5 A300000C 9D5 Serial2/0/3 initiali A800 10 disabl 5 A3000010 9D6 Serial2/0/4 initiali A801 11 disabl 5 A3000014 9D7 Serial2/0/5 initiali A802 12 disabl 5 A3000018 9D8 Serial2/0/6 initiali B000 13 disabl 5 A300001C 9D9 Serial2/0/7 initiali B001 14 disabl 5 A3000020 9DA POS3/0/0 up E000 15 PXF 5 A3000024 9DB Serial4/0/0.1/1/1/1:0 up 12000 27 PXF 16 A3000040 9E7 Serial4/0/0.1/1/1/1:1 up 12001 28 PXF 16 A3000044 9E8 POS5/0/0 down 16000 16 disabl 5 A3000028 9DC POS5/0/1 down 16001 17 disabl 5 A300002C 9DD POS5/0/2 down 16002 18 disabl 5 A3000030 9DE POS5/0/3 down 16003 19 disabl 5 A3000034 9DF POS5/0/4 down 16004 20 disabl 5 A3000038 9E0 POS5/0/5 down 16005 21 disabl 5 A300003C 9E1 GigabitEthernet6/0/0 down 1A000 22 disabl 1 A32C0000 9E2 1 GigabitEthernet6/0/0.100 down 1A000 22 disabl 1 A32C0000 9EB 100 ATM8/0/0 up 22000 23 PXF 33 A33C0000 9E3 ATM8/0/0.1 up 22000 23 PXF 33 A33C0000 0 0/33 ATM8/0/0.2 up 22000 23 PXF 33 A33C0000 0 0/34 ATM8/0/0.100 up 22000 23 PXF 33 A33C0000 9EC 30/32 ATM8/0/0.200 up 22000 23 PXF 33 A33C0000 9ED 0/32 ATM8/0/1 down 22001 24 disabl 33 A33E0000 9E4 ATM8/0/2 down 22002 25 disabl 33 A3400000 9E5 ATM8/0/3 down 22003 26 disabl 33 A3420000 9E6 Multilink1 up 0 29 PXF 16 A3000048 2 Multilink2 down 0 36 disabl 16 A300005C 4 Multilink20 up 0 30 PXF 16 A300004C 3 Multilink60230 down 0 31 disabl 16 A3000050 9E9 Multilink60130 down 0 32 disabl 16 A3000054 9EA
The table below describes the fields shown in the display.
Field |
Description |
---|---|
Interface |
Identifies the interface or subinterface. |
Status |
Displays the status of the interface:
|
ICB |
Displays the Interface Control Block (ICB) that is mapped to this interface. |
WQB_ID |
Displays the Work Queue Block (WQB) identifier for the interface. |
Fwding |
Displays whether traffic is being forwarded (PXF) or not (disable). |
Enc |
Identifies the type of encapsulation used on the interface. The most common encapsulation types are: 0 = None 1 = Ethernet ARPA 2 = Ethernet SAP 3 = 802.2 SNAP 5 = Serial, raw HDLC 8 = Serial, LAPB 9 = Serial, X.25 20 = Frame Relay 21 = SMDS 22 = MAC-level packets 27 = Logical Link Control (LLC) 2 28 = Serial, SDLC (primary) 30 = Async SLIP encapsulation 33 = ATM interface 35 = Frame Relay with IETF encapsulation 42 = Dialer encapsulation 46 = Loopback interface 51 = ISDN Q.921 59 = DOCSIS (previously known as MCNS) 61 = Transparent Mode 62 = TDM clear channel 64 = PPP over Frame Relay 65 = IEEE 802.1Q 67 = LAPB terminal adapter 68 = DOCSIS Cable Modem |
VCCI-map |
Displays the memory address for the Virtually Cool Common Index (VCCI) map table for this particular VCCI. |
VCCI |
Identifies the VCCI, in hexadecimal, assigned to the interface or subinterface. |
VC |
Identifies the virtual circuit (VC). |
Related Commands
Command |
Description |
---|---|
clear pxf |
Clears PXF counters and statistics. |
debug pxf |
Displays PXF debugging output. |
show ip mroute |
Displays the contents of the IP multicast routing table. |
show pxf cpu tbridge |
Displays PXF CPU statistics for transparent bridging. |
show pxf microcode |
Displays identifying information for the microcode currently loaded on the PXF. |
show pxf cpu vcci
To display Virtually Cool Common Index (VCCI) to interface mapping information on the Parallel eXpress Forwarding (PXF), use the show pxf cpu vcci command in privileged EXEC mode.
show pxf cpu vcci [summary]
Syntax Description
summary |
(Optional) Displays VCCI allocation information. |
Command Modes
Privileged EXEC (#)
Command History
Release |
Modification |
---|---|
12.2S |
This command was introduced. |
Usage Guidelines
The VCCI is an index that uniquely identifies each interface or subinterface in the PXF and it maps that interface to the appropriate set of services and features. This command is useful to verify the number of VCCIs that are used and available.
The Cisco 10000 series router has 65,536 VCCIs. A VCCI is assigned to each individual routed interface. A VCCI is not assigned to virtual template interfaces and loopbacks.
Examples
The following example shows how to display the number of used and available VCCIs. The fields shown in the display are self-explanatory.
Router# show pxf cpu vcci summary VCCI usage summary Maximum Used Available Multilink VCCI 2500 0 2500 Other VCCI 63023 14 63009
Related Commands
Command |
Description |
---|---|
show pxf cpu policy-data |
Displays QoS policy data index usage statistics. |
show pxf crash
To display Parallel eXpress Forwarding (PXF) crash information, use the show pxf crash command in privileged EXEC mode.
show pxf crash
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC (#)
Command History
Release |
Modification |
---|---|
12.1(1)E |
This command was introduced on the Cisco 10000 series router. |
12.1(5)T |
This command was integrated into Cisco IOS Release 12.1(5)T. |
12.2(31)SB |
This command was integrated into Cisco IOS Release 12.2(31)SB. |
12.2SX |
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware. |
Examples
The following example shows crash information as a result of a PXF direct memory access (DMA) error. The PXF crash information is typically stored in bootflash.
Router# show pxf crash Summary of bootflash:pxf_crashinfo_20060117-152035 Time of crash was 15:20:35 UTC Tue Jan 17 2006 PXF DMA Error - End of Descriptor Before Cmd Byte Length Exhausted Current microcode: file=system:pxf/c10k2-11-ucode.108.0.0.0, version=108.0.0.0, description=Nightly Build Software created Sat 19-Nov-05 00:12
The table below describes the significant fields shown in the display.
Field |
Description |
---|---|
Summary of bootflash: |
Displays the filename in bootflash where the PXF crash information is stored. The filename format includes the date and time of the PXF crash. |
Time of crash |
Displays the date of the PXF crash. |
UTC |
Displays the Universal Coordinated Time (UTC) of the PXF crash. |
Current microcode |
Displays identifying information for the microcode currently running on the PXF. |
Related Commands
Command |
Description |
---|---|
show pxf statistics |
Displays a summary of PXF statistics. |
show pxf dma
To display the current state of direct memory access (DMA) buffers, error counters, and registers on the Parallel eXpress Forwarding (PXF), use the show pxf dmacommand in privileged EXEC mode.
show pxf dma [ buffers | counters | reassembly | registers ]
Cisco 10000 Series Router (PRE3 only)
show pxf dma [ buffers | counters | reassembly | registers ] [ brief | config | errors | status ]
Syntax Description
buffers |
(Optional) Displays PXF DMA buffers information. |
||
counters |
(Optional) Displays packet and error counters for the PXF DMA engine. |
||
reassembly |
(Optional) Displays PXF reassembly table usage information. |
||
registers |
(Optional) Displays PXF DMA registers information. |
||
brief |
(Optional) Displays PXF DMA information, including the initialization state of each block in the PXF API and any errors that occurred.
|
||
config |
(Optional) Displays a configuration summary of the registers in each of the PXF DMA blocks.
|
||
errors |
(Optional) Displays the errors that occurred in each of the PXF DMA blocks.
|
||
status |
(Optional) Displays the initialization state of each PXF DMA block. In normal operation, all blocks display the enabled state.
|
Command Modes
Privileged EXEC (#)
Command History
Release |
Modification |
---|---|
12.2S |
This command was introduced. |
12.3(7)XI |
This command was integrated into Cisco IOS Release 12.3(7)XI and implemented on the Cisco 10000 series router for the PRE2. |
12.2(31)SB2 |
This command was integrated into Cisco IOS Release 12.2(31)SB2 and implemented on the Cisco 10000 series router for the PRE3. |
Examples
The following example shows PXF DMA buffers information:
Router# show pxf dma buffers PXF To-RP DMA Ring Descriptors & Buffers: Descriptor Buffer Buffer Descriptor Address Address Length(b) Flags 0 0x0CA06340 0x0AC097C0 512 0x0002 1 0x0CA06350 0x0AC088C0 512 0x0002 2 0x0CA06360 0x0AC07C40 512 0x0002 3 0x0CA06370 0x0AC0B5C0 512 0x0002 4 0x0CA06380 0x0AC0CC40 512 0x0002 5 0x0CA06390 0x0AC08640 512 0x0002 6 0x0CA063A0 0x0AC0C240 512 0x0002 7 0x0CA063B0 0x0AC08B40 512 0x0002 8 0x0CA063C0 0x0AC0AE40 512 0x0002 9 0x0CA063D0 0x0AC0BAC0 512 0x0002 10 0x0CA063E0 0x0AC0C9C0 512 0x0002 11 0x0CA063F0 0x0AC09CC0 512 0x0002 12 0x0CA06400 0x0AC0C740 512 0x0002 13 0x0CA06410 0x0AC0A6C0 512 0x0002 14 0x0CA06420 0x0AC0B0C0 512 0x0002 15 0x0CA06430 0x0AC09040 512 0x0002 16 0x0CA06440 0x0AC0A440 512 0x0002 17 0x0CA06450 0x0AC065C0 512 0x0002 18 0x0CA06460 0x0AC06FC0 512 0x0002 19 0x0CA06470 0x0AC06340 512 0x0002 20 0x0CA06480 0x0AC07240 512 0x0002 21 0x0CA06490 0x0AC092C0 512 0x0002 22 0x0CA064A0 0x0AC0D140 512 0x0002 23 0x0CA064B0 0x0AC0C4C0 512 0x0002 24 0x0CA064C0 0x0AC07740 512 0x0002 25 0x0CA064D0 0x0AC09540 512 0x0002 26 0x0CA064E0 0x0AC0A940 512 0x0002 27 0x0CA064F0 0x0AC06840 512 0x0002 28 0x0CA06500 0x0AC08140 512 0x0002 29 0x0CA06510 0x0AC06D40 512 0x0002 30 0x0CA06520 0x0AC07EC0 512 0x0002 31 0x0CA06530 0x0AC0ABC0 512 0x0003 PXF From-RP DMA Ring Descriptors & Buffers: Descriptor Buffer Buffer Descriptor Context Address Address Length(b) Flags Bit 0 0x0CA06580 0x00000000 0 0x0000 Not set 1 0x0CA06590 0x00000000 0 0x0000 Not set 2 0x0CA065A0 0x00000000 0 0x0000 Not set 3 0x0CA065B0 0x00000000 0 0x0000 Not set 4 0x0CA065C0 0x00000000 0 0x0000 Not set 5 0x0CA065D0 0x00000000 0 0x0000 Not set 6 0x0CA065E0 0x00000000 0 0x0000 Not set 7 0x0CA065F0 0x00000000 0 0x0000 Not set 8 0x0CA06600 0x00000000 0 0x0000 Not set 9 0x0CA06610 0x00000000 0 0x0000 Not set 10 0x0CA06620 0x00000000 0 0x0000 Not set 11 0x0CA06630 0x00000000 0 0x0000 Not set 12 0x0CA06640 0x00000000 0 0x0000 Not set 13 0x0CA06650 0x00000000 0 0x0000 Not set 14 0x0CA06660 0x00000000 0 0x0000 Not set 15 0x0CA06670 0x00000000 0 0x0001 Not set
The table below describes the fields shown in the display.
Field |
Description |
---|---|
Descriptor Address |
Memory address pointing to the descriptor for this buffer. |
Buffer Address |
Address of this buffer in memory. |
Buffer Length |
Length, in bytes, of this particular buffer. |
Descriptor Flags |
Internal flags identifying this buffer’s use and status. |
Context Bit |
State of the context bit which is set when the buffer is currently in use by a context (the basic unit of packet processing). |
Related Commands
Command |
Description |
---|---|
clear pxf |
Clears PXF counters and statistics. |
show pxf cpu |
Displays PXF CPU statistics. |
show pxf microcode |
Displays the microcode version running on the PXF. |
show pxf feature cef
To display Parallel eXpress Forwarding (PXF) routing feature tables for Cisco Express Forwarding, use the show pxf feature cef command in user EXEC or privileged EXEC mode.
show pxf feature cef entry
Syntax Description
entry |
Display the PXF entry. |
Command Modes
User EXEC (>)
Privileged EXEC (#)
Command History
Release |
Modification |
---|---|
12.1(1)E |
This command was introduced. |
12.1(5)T |
This command was integrated into Cisco IOS Release 12.1(5)T. |
12.2(33)SRA |
This command was integrated into Cisco IOS Release 12.2(33)SRA. |
12.2SX |
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware. |
Examples
The following is sample output from the show pxf feature cef command. The fields shown in the display are self-explanatory.
Router# show pxf feature cef entry Shadow 16-4-4-8 PXF Mtrie: 41 leaves, 1968 leaf bytes, 15 nodes, 267000 node bytes 5 invalidations 46 prefix updates refcounts: 66746 leaf, 66720 node Prefix/Length Refcount Parent 0.0.0.0/0 62282 0.0.0.0/32 3 0.0.0.0/0 171.22.12.128/27 34 0.0.0.0/0 171.22.12.128/32 3 171.22.12.128/27 171.22.12.129/32 3 171.22.12.128/27 171.22.12.130/32 3 171.22.12.128/27 171.22.12.131/32 3 171.22.12.128/27 171.22.12.147/32 3 171.22.12.128/27
Related Commands
Command |
Description |
---|---|
show pxf feature nat |
Displays PXF routing feature tables for NAT. |
show pxf feature cef vrf
To display the routing feature tables for Virtual Private Network (VPN) routing and forwarding instances (VRFs) on the Parallel eXpress Forwarding (PXF) path, use the show pxf feature cef vrfcommand in privileged EXEC mode.
show pxf feature cef vrf vpn-name
Syntax Description
vpn-name |
Name of the VPN to display. |
Command Modes
Privileged EXEC (#)
Command History
Release |
Modification |
---|---|
12.2(15)B |
This command was introduced. |
12.3(4)T |
This command was integrated into Cisco IOS Release 12.3(4)T. |
Usage Guidelines
Use this command to display VRF PXF routing feature tables for a specified VPN for Cisco Express Forwarding. This command also displays information about prefix and MTRIE resource usage.
Examples
The following is sample output for the show pxf feature cef vrfcommand when it is used to display information about VRF vpn1:
Router# show pxf feature cef vrf vpn1 Shadow 8-8-4-4-8 PXF Mtrie: 51 leaves, 2448 leaf bytes, 92 nodes, 56352 node bytes 10 invalidations 61 prefix updates refcounts: 3666 leaf, 3733 node Prefix/Length Refcount Parent Address Shadow 0.0.0.0/32 3 0xC0047218 0x62CAF2E8 10.5.0.0/16 558 0xC0047278 0x62CAF108 10.5.0.0/32 3 10.5.0.0/16 0xC0047268 0x62CAEE08 10.5.0.1/32 3 10.5.0.0/16 0xC0047260 0x62CAEA18 10.5.0.2/32 3 10.5.0.0/16 0xC0047388 0x62CAEA48 10.5.0.255/32 3 10.5.0.0/16 0xC0047270 0x62CAF0D8 10.30.1.0/16 288 0xC0047360 0x62CAEB38 10.30.1.1/32 3 10.30.1.0/16 0xC0047350 0x62CAEB98 10.70.0.0/32 3 0xC00472C0 0x62CAEEF8 10.70.1.1/32 3 0xC0047358 0x62CAEB68 10.70.1.2/32 3 0xC0047368 0x62CAEB08 10.70.1.3/32 3 0xC0047370 0x62CAEAD8 10.70.1.4/32 3 0xC0047378 0x62CAEAA8 70.1.1.5/32 3 0xC0047380 0x62CAEA78 224.0.0.0/24 3 0xC0047228 0x62CAF288 255.255.255.255/32 3 0xC0047220 0x62CAF2B8 ======================================== 5 routes with less specific overlapping parent route
The table below describes the significant fields shown in the display.
Field |
Description |
---|---|
Shadow 8-8-4-4-8 PXF Mtrie |
MTRIE lookup table index structures. |
51 leaves |
All created leaves for all MTRIEs. |
2448 leaf bytes |
Leaf byte counter. When a new leaf is created, the leaf byte counter is incremented by the size of the leaf structure. |
92 nodes |
All created nodes for all MTRIEs. |
56352 node bytes |
Node byte counter. When a new node is created, the node byte counter is incremented. |
10 invalidations |
Invalidations counter. When a route (represented by a leaf) is deleted from an MTRIE, the invalidations counter is incremented. This counter includes all MTRIEs. |
61 prefix updates |
IP prefix counter. When an IP prefix (represented by a leaf) is added to the MTRIE, the IP prefix counter is incremented. This counter includes all MTRIEs. |
refcounts |
Counters associated with references between leaves. |
3666 leaf |
MTRIEs have a leaf lock and a leaf free function. The leaf lock function increments the leaf refcount. The leaf free function decrements the leaf refcount. The leaf lock and leaf free functions prevent a leaf from being freed (deleted) while the leaf is still being referenced. This counter includes all MTRIEs. |
3733 node |
Node counter. When a child node is added to another node, the node to which the child node is added becomes a parent node. The node counter is decremented when a child node is deleted. This counter includes all MTRIEs. |
Prefix/Length |
The IP address and subnet mask of a leaf. |
Refcount |
The number of leaves that reference a specified leaf. The refcount counter is incremented when the leaf lock function is called and decremented when the leaf free function is called. |
Parent |
When you add a less specific route to a more specific route, the more specific route has a back pointer that points to the less specific route. |
Address |
The address of the memory for the specified leaf. |
Shadow |
The shadow address in Route Processor memory for the specified leaf. |
Related Commands
Command |
Description |
---|---|
show pxf feature cef |
Displays PXF routing feature tables for CEF. |
show pxf feature nat |
Displays PXF routing feature tables for NAT. |
show pxf feature nat
To display Parallel eXpress Forwarding (PXF) routing tables for Network Address Translation (NAT), use the show pxf feature nat command in user EXEC or privileged EXEC mode.
show pxf feature nat [ entry | stat | tcp ]
Syntax Description
entry |
Displays NAT information. |
stat |
Displays NAT processing information. |
tcp |
Displays NAT TCP logging information. |
Command Modes
User EXEC (>)
Privileged EXEC (#)
Command History
Release |
Modification |
---|---|
12.1(1)E |
This command was introduced. |
12.1(5)T |
This command was integrated into Cisco IOS Release 12.1(5)T. |
12.2(33)SRA |
This command was integrated into Cisco IOS Release 12.2(33)SRA. |
12.2SX |
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware. |
Examples
The following is sample output from the show pxf feature natcommand. The fields shown in the display are self-explanatory.
Router# show pxf feature nat --- 171.22.12.175 192.168.0.129 --- --- --- 171.22.12.163 192.168.0.7 --- --- --- 171.22.12.161 192.168.0.13 --- --- --- 171.22.12.162 192.168.0.3 --- --- --- 171.22.12.165 192.168.0.8 --- --- --- 171.22.12.168 192.168.0.14 --- --- --- 171.22.12.170 192.168.0.12 --- --- --- 171.22.12.166 192.168.0.15 --- --- --- 171.22.12.164 192.168.0.16 --- ---
Related Commands
Command |
Description |
---|---|
show pxf feature cef |
Displays PXF routing feature tables for Cisco Express Forwarding. |
show pxf interface
To display a summary of the interfaces on the router and the Parallel eXpress Forwarding (PXF) features and capabilities enabled on these interfaces, use the show pxf interface command in privileged EXEC mode.
show pxf interface interface-name [ detail ]
Syntax Description
interface-name |
Name of the interface. |
detail |
(Optional) Displays detailed information for all PXF interfaces on the router. |
Command Modes
Privileged EXEC (#)
Command History
Release |
Modification |
---|---|
12.2S |
This command was introduced. |
12.3(7)XI1 |
This command was integrated into Cisco IOS Release 12.3(7)XI1. |
12.2SX |
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware. |
Usage Guidelines
If you do not specify an interface, the command displays a summary of the statistics for all PXF interfaces on the router.
Examples
The following example shows PXF statistics for serial interface 1/0/0. The significant fields shown in the display are self-explanatory.
Router# show pxf interface s1/0/0 ed10#sho pxf interface s1/0/0 Serial1/0/0 is up, enabled, PXF enabled, IOS encap PPP (16) Last clearing of Serial1/0/0 counters: 00:06:29 91 packets input, (1934 bytes) Total PXF input errors (pkts/bytes): 0/0 PXF output queues: Class ID Length/Max Outputs (pkts/bytes) Drops 0 class-default 276 0/1024 0/0 0 15 - 275 0/32 91/1953 0 Slot 1/0: FBB Rx:0x00000000 OCQ debug:0x00001040, qN_entry_cnt[5:0]: 0 PXF DMA RE drops: 0/0, Null config drops: 0/0 Last clearing of slot 1/0 counters: 00:06:29
Related Commands
Command |
Description |
---|---|
clear pxf |
Clears PXF counters and statistics. |
show pxf statistics |
Displays chassis-wide, summary PXF statistics. |
show pxf microcode
To display identifying information for the microcode currently loaded on the Parallel eXpress Forwarding (PXF), use the show pxf microcodecommand in privileged EXEC mode.
show pxf microcode
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC (#)
Command History
Release |
Modification |
---|---|
12.2S |
This command was introduced. |
12.3(7)XI |
This command was integrated into Cisco IOS Release 12.3(7)XI. |
Examples
The following example shows the microcode version that is currently loaded on the PXF:
Router# show pxf microcode PXF complex: 4 Toasters 8 Columns total PXF processor tmc0 is running. PXF processor tmc1 is running. PXF processor tmc2 is running. PXF processor tmc3 is running. Loaded microcode: system:pxf/c10k2-11-ucode.6.1.3 Version: 6.1.3 Release Software created Sun 20-Nov-05 14:06 Signature: 0d2b395c1083872793586f9cec47d7b3 Microcode load attempted 1 time(s), latest 2w6d ago tmc0 FG_PC=0 BG_PC=6 WDog=1024 MinPhase=23 SecPreScalerTimer=11542680 MS ecPreScalerTimer=153600 tmc1 FG_PC=0 BG_PC=6 WDog=1024 MinPhase=23 SecPreScalerTimer=11542680 MS ecPreScalerTimer=153600 tmc2 FG_PC=0 BG_PC=6 WDog=1024 MinPhase=23 SecPreScalerTimer=11542680 MS ecPreScalerTimer=153600 tmc3 FG_PC=0 BG_PC=6 WDog=1024 MinPhase=23 SecPreScalerTimer=11542680 MS ecPreScalerTimer=154
The table below describes the fields shown in the display.
Field |
Description |
---|---|
PXF complex |
The number of PXF processors, their associate memory columns, and their current status. |
Loaded microcode |
The source and filename for the microcode that is currently loaded on the PXF processor. |
Version |
The microcode version. |
Release Software created |
The time and date the current microcode was compiled. |
Signature |
The signature in the microcode version. |
Microcode load attempted |
The number of times the PXF processor has loaded the microcode since the Cisco IOS image was loaded at system boot. Also, shows the time (in days and hours) since the last successful load of the microcode. |
tmc# |
The current program counters and configuration for the PXF processors. |
Related Commands
Command |
Description |
---|---|
clear pxf |
Clears PXF counters and statistics. |
show pxf cpu statistics |
Displays PXF CPU statistics. |
show pxf dma |
Displays PXF DMA information. |
show pxf netflow
To display the NetFlow Parallel eXpress Forwarding (PXF) counters, use the show pxf netflow command in privileged EXEC mode.
show pxf netflow
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC (#)
Command History
Release |
Modification |
---|---|
12.2S |
This command was introduced. |
12.3(7)XI |
This command was integrated into Cisco IOS Release 12.3(7)XI. |
Examples
The following example shows the NetFlow PXF statistics. The fields shown in the display are self-explanatory.
Router# show pxf netflow NetFlow debug counters timeout activity: 0 timeout inactivity: 9785 forced age: 0 export busy: 1 export locked: 62 export noswap: 2 accumulate: 1296898 new flow: 9808 (unreliable) ICM counters records pending : 0 live flows : 0 NetFlow PXF Config Registers PXF Inactive Timeout: 90000 PXF Active Timeout: 90000
Related Commands
Command |
Description |
---|---|
show pxf cpu statistics |
Displays PXF CPU statistics. |
show pxf statistics |
Displays chassis-wide, summary PXF statistics. |
show pxf stall-monitoring
To display the configuration and operating status details of the PXF stall monitor (PSM), use the show pxf stall-monitoring command in privileged EXEC mode. The show pxf stall-monitoring command also displays the number of stalls on the PSM after it was last enabled.
show pxf stall-monitoring [ counters | reset { active-status | cob-fib | cob-tib | pxf-drop } subslot sub-slot ]
Syntax Description
counters |
Displays statistical information for all counters. |
reset |
Displays the following counters:
|
Command Modes
Privileged EXEC (#)
Command History
Release |
Modification |
---|---|
12.2(33)XNE |
This command was introduced. |
Examples
The following example displays a sample output of the show pxf stall-monitoring command:
Router# show pxf stall-monitoring pxf stall-monitoring : Enabled Stall History ============= Stall Threshold Configuration ============================= Primary Action = LC-reset Threshold = 3 (default) Primary Action = HT-reset Threshold = 3 (default) Secondary action = SSO SwitchOverRouter# The fields displayed are self-explanatory.
The following example displays a sample output of the show pxf stall-monitoring counterscommand:
Router# show pxf stall-monitoring counters To RP Counters ============== IOS To RP Counter = 20665 PXF To RP Drop Counter = 0 Current Counter Values ====================== Slot 0 Subslot 0 Cob TIB = 0 Cob FIB = 0 PXF Drop = 0 Slot 0 Subslot 1 Cob TIB = 0 Cob FIB = 0 PXF Drop = 0 Slot 1 Subslot 0 Cob TIB = 2368 Cob FIB = 0 PXF Drop = 0 Slot 1 Subslot 1 Cob TIB = 0 Cob FIB = 0 PXF Drop = 0 Slot 2 Subslot 0 Cob TIB = 0 Cob FIB = 0 PXF Drop = 0 Slot 2 Subslot 1 Cob TIB = 0 Cob FIB = 0 PXF Drop = 0 Slot 3 Subslot 0 Cob TIB = 0 Cob FIB = 0 PXF Drop = 0 Slot 3 Subslot 1 Cob TIB = 0 Cob FIB = 0 PXF Drop = 0 Slot 4 Subslot 0 Cob TIB = 0 Cob FIB = 0 PXF Drop = 0 Slot 4 Subslot 1 Cob TIB = 0 Cob FIB = 0 PXF Drop = 0 Slot 5 Subslot 0 Cob TIB = 6162 Cob FIB = 6204 PXF Drop = 0 Slot 5 Subslot 1 Cob TIB = 6101 Cob FIB = 6065 PXF Drop = 0 Slot 5 Subslot 2 Cob TIB = 0 Cob FIB = 0 PXF Drop = 0 Slot 5 Subslot 3 Cob TIB = 0 Cob FIB = 0 PXF Drop = 0 Slot 7 Subslot 0 Cob TIB = 8402 Cob FIB = 8402 PXF Drop = 0 Slot 7 Subslot 1 Cob TIB = 0 Cob FIB = 0 PXF Drop = 0 Slot 8 Subslot 0 Cob TIB = 0 Cob FIB = 0 PXF Drop = 0 Slot 8 Subslot 1 Cob TIB = 0 Cob FIB = 0 PXF Drop = 0 Line Card Participant Status ============================ Slot 1 Subslot 0 = 1 Slot 1 Subslot 1 = 0 Slot 2 Subslot 0 = 0 Slot 2 Subslot 1 = 0 Slot 3 Subslot 0 = 0 Slot 3 Subslot 1 = 0 Slot 4 Subslot 0 = 0 Slot 4 Subslot 1 = 0 Slot 5 Subslot 0 = 0 Slot 5 Subslot 1 = 1 Slot 5 Subslot 2 = 0 Slot 5 Subslot 3 = 0 Slot 7 Subslot 0 = 1 Slot 7 Subslot 1 = 0 Slot 8 Subslot 0 = 1 Slot 8 Subslot 1 = 0 Line Card Active Status ======================= Slot 1 Subslot 0 = 0 Slot 1 Subslot 1 = 0 Slot 2 Subslot 0 = 0 Slot 2 Subslot 1 = 0 Slot 3 Subslot 0 = 0 Slot 3 Subslot 1 = 0 Slot 4 Subslot 0 = 0 Slot 4 Subslot 1 = 0 Slot 5 Subslot 0 = 0 Slot 5 Subslot 1 = 1 Slot 5 Subslot 2 = 0 Slot 5 Subslot 3 = 0 Slot 7 Subslot 0 = 0 Slot 7 Subslot 1 = 0 Slot 8 Subslot 0 = 0 Slot 8 Subslot 1 = 0
The fields displayed are self-explanatory.
The following example displays a sample output of the show pxf stall-monitoring resetcommand:
Router# show pxf stall-monitoring reset active-status subslot 1/0 pxf stall-monitoring : Enabled 0
Related Commands
Command |
Description |
---|---|
hw-module pxf stall-monitoring |
Enables PXF stall monitor on the Cisco 10000 series router and configures default threshold values before the LC and HTDP resets. |
show pxf statistics
To display summary Parallel eXpress Forwarding (PXF) statistics, use the show pxf statistics command in privileged EXEC mode.
show pxf statistics { context | diversion | drop [detail] | ip | ipv6 }
Syntax Description
context |
Displays context statistics. |
diversion |
Displays traffic diverted from the PXF. |
drop [detail] |
Displays packets dropped by the PXF. The detailoption provides detailed information. |
ip |
Displays IP and ICMP statistics. |
ipv6 |
Displays IPv6 statistics. |
Command Modes
Privileged EXEC (#)
Command History
Release |
Modification |
---|---|
12.0(22)S |
This command was introduced on the Cisco 10000 series router. |
12.2(28)SB |
This command was integrated into Cisco IOS Release 12.2(28)SB. |
12.3(7)XI1 |
This command was integrated into Cisco IOS Release 12.3(7)XI1. |
12.2(31)SB |
This command was integrated into Cisco IOS Release 12.2(31)SB. |
Examples
The following example shows a summary of PXF IP statistics:
Router# show pxf statistics ip Chassis-wide PXF forwarding counts IP inputs 0, forwarded 0, punted 0 IP dropped 0, no adjacency 0, no route 0 IP unicast RPF 0, unresolved 0 ICMP created 0, Unreachable sent 0, TTL expired sent 0 ICMP echo requests 0, replies sent 0 ICMP checksum errors 0 IP packets fragmented 0, total fragments 0, failed 0 IP don't-fragment 0, multicast don't-fragment 0 IP mcast total 0, switched 0, punted 0, failed 0 IP mcast drops 0, RPF 0, input ACL 0, output ACL + taildrops 0 Last clearing of PXF forwarding counters:never
The following example shows a summary of PXF statistics for dropped packets:
Router# show pxf statistics drop PXF input drops: Unassigned drops (pkts/bytes): 0/0 Last clearing of drop counters: never
The following example shows detailed PXF statistics for dropped packets:
Router# show pxf statistics drop detail PXF input drops: Unassigned drops (pkts/bytes): 0/0 PXF Unassigned input drop details: (These input drops are not assigned to a particular PXF interface.) packets bytes generic 0 0 mpls_no_eos 0 0 fib_zero_dest 0 0 fib_drop_null 0 0 fib_icmp_no_adj 0 0 fib_icmp_bcast_dst 0 0 mfib_ttl_0 0 0 mfib_disabled 0 0 mfib_rpf_failed 0 0 mfib_null_oif 0 0 tfib_rp_flag 0 0 tfib_eos_violation 0 0 tfib_nonip_expose 0 0 tfib_label_invalid 0 0 tfib_path_unknown 0 0 tfib_nonip_ttl_exp 0 0 icmp_unrch_interval 0 0 icmp_on_icmp 0 0 icmp_bad_hdr 0 0 icmp_multicast 0 0 icmp_frag 0 0 macr_bad_tag_num 0 0 no_touch 0 0 enq_id_0 0 0 no_pkt_handles 0 0 l2_unsupp_drop 0 0 ipm_replay_full 0 0 bad_atm_arp 0 0 nested_fragmentation 0 0 l2less drop packets 0 l2tp_payload_encap 0 0 re_bit[00] 0 0 [01] 0 0 [02] 0 0 [03] 0 0 [04] 0 0 [05] 0 0 [06] 0 0 [07] 0 0 [08] 0 0 [09] 0 0 [10] 0 0 . . .
The following example shows summarized statistics for traffic diverted from the PXF:
Router# show pxf statistics diversion Diversion Cause Stats: divert = 0 encap = 0 clns_isis = 0 clns = 0 cdp = 0 cgmp = 0 arp = 1 rarp = 0 mpls_ctl = 0 keepalive = 0 ppp_cntrl = 449 fr_lmi = 0 atm ilmi = 0 oam f4 = 0 oam f5 ete= 0 oam f5 seg= 0 mlfr lip = 0 . . .
Related Commands
Command |
Description |
---|---|
clear pxf |
Clears PXF counters and statistics. |
show pxf cpu statistics |
Displays PXF CPU statistics. |
show pxf xcm
To display Parallel eXpress Forwarding (PXF) External Column Memory (XCM) information, use the show pxf xcm command in privileged EXEC mode.
show pxf xcm
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC (#)
Command History
Release |
Modification |
---|---|
12.2S |
This command was introduced. |
12.3(7)XI |
This command was integrated into Cisco IOS Release 12.3(7)XI. |
Examples
The following example shows XCM information for each PXF processor:
Router# show pxf xcm Toaster 0: Number of Columns: 2 Proc ID: 0x00000004 = TMC_X72 ASIC Revision: 0x00000001 = T3-ECC XCM0 type:FCRAM, size = 67108864 ECC is enabled for column 0 XCM AB Config Register: 0x024703B9 XCM CD Config Register: 0x024703B9 XCM Exception Type Register: 0x00000000 FCRAM-A Counters Number of ECC single bit errors: 0 FCRAM-B Counters Number of ECC single bit errors: 0 FCRAM-C Counters Number of ECC single bit errors: 0 FCRAM-D Counters Number of ECC single bit errors: 0 XCM1 type:FCRAM, size = 67108864 ECC is enabled for column 1 XCM AB Config Register: 0x024703B9 XCM CD Config Register: 0x024703B9 XCM Exception Type Register: 0x00000000 FCRAM-A Counters Number of ECC single bit errors: 0 FCRAM-B Counters Number of ECC single bit errors: 0 FCRAM-C Counters Number of ECC single bit errors: 0 FCRAM-D Counters Number of ECC single bit errors: 0 Toaster 1: Number of Columns: 2 Proc ID: 0x00000004 = TMC_X72 ASIC Revision: 0x00000001 = T3-ECC XCM0 type:FCRAM, size = 67108864 ECC is enabled for column 0 XCM AB Config Register: 0x024703B9 XCM CD Config Register: 0x024703B9 XCM Exception Type Register: 0x00000000 FCRAM-A Counters Number of ECC single bit errors: 0 FCRAM-B Counters Number of ECC single bit errors: 0 FCRAM-C Counters Number of ECC single bit errors: 0 FCRAM-D Counters Number of ECC single bit errors: 0 XCM1 type:FCRAM, size = 67108864 ECC is enabled for column 1 XCM AB Config Register: 0x024703B9 XCM CD Config Register: 0x024703B9 XCM Exception Type Register: 0x00000000 FCRAM-A Counters Number of ECC single bit errors: 0 FCRAM-B Counters Number of ECC single bit errors: 0 FCRAM-C Counters Number of ECC single bit errors: 0 FCRAM-D Counters Number of ECC single bit errors: 0 Toaster 2: Number of Columns: 2 Proc ID: 0x00000004 = TMC_X72 ASIC Revision: 0x00000001 = T3-ECC XCM0 type:FCRAM, size = 67108864 ECC is enabled for column 0 XCM AB Config Register: 0x024703B9 XCM CD Config Register: 0x024703B9 XCM Exception Type Register: 0x00000000 FCRAM-A Counters Number of ECC single bit errors: 0 FCRAM-B Counters Number of ECC single bit errors: 0 FCRAM-C Counters Number of ECC single bit errors: 0 FCRAM-D Counters Number of ECC single bit errors: 0 XCM1 type:FCRAM, size = 67108864 ECC is enabled for column 1 XCM AB Config Register: 0x024703B9 XCM CD Config Register: 0x024703B9 XCM Exception Type Register: 0x00000000 FCRAM-A Counters Number of ECC single bit errors: 0 FCRAM-B Counters Number of ECC single bit errors: 0 FCRAM-C Counters Number of ECC single bit errors: 0 FCRAM-D Counters Number of ECC single bit errors: 0 Toaster 3: Number of Columns: 2 Proc ID: 0x00000004 = TMC_X72 ASIC Revision: 0x00000001 = T3-ECC XCM0 type:FCRAM, size = 67108864 ECC is enabled for column 0 XCM AB Config Register: 0x024703B9 XCM CD Config Register: 0x024703B9 XCM Exception Type Register: 0x00000000 FCRAM-A Counters Number of ECC single bit errors: 0 FCRAM-B Counters Number of ECC single bit errors: 0 FCRAM-C Counters Number of ECC single bit errors: 0 FCRAM-D Counters Number of ECC single bit errors: 0 XCM1 type:FCRAM, size = 67108864 ECC is enabled for column 1 XCM AB Config Register: 0x024703B9 XCM CD Config Register: 0x024703B9 XCM Exception Type Register: 0x00000000 FCRAM-A Counters Number of ECC single bit errors: 0 FCRAM-B Counters Number of ECC single bit errors: 0 FCRAM-C Counters Number of ECC single bit errors: 0 FCRAM-D Counters Number of ECC single bit errors: 0
The table below describes the fields shown in the display.
Field |
Description |
---|---|
The following fields appear for each PXF processor. |
|
Toaster # |
Identifies the PXF processor. |
Number of Columns |
Displays the number of memory columns on the PXF processor. |
Proc ID |
Displays the processor type (TMC is Toaster Memory Column). |
ASIC Revision |
Displays the internal version number of the PXF processor. |
The following fields appear for each XCM memory column. |
|
XCM type |
Displays the type and size, in bytes, of memory used in this particular column. |
ECC is enabled for column |
Displays whether Error Code Correction (ECC) checking is enabled or disabled for this memory column. |
XCM Config Register and XCM Exception Type Register |
Displays the contents of these two registers for the memory column. |
Number of ECC single bit errors |
Displays the number of single-bit errors detected in memory. |
Related Commands
Command |
Description |
---|---|
show pxf cpu |
Displays PXF CPU statistics. |
show pxf microcode |
Displays the microcode version currently loaded on the PXF. |
show route-map ipc
To display counts of the one-way route map interprocess communication (IPC) messages sent from the rendezvous point (RP) to the Versatile Interface Processor (VIP) when NetFlow policy routing is configured, use the show route-map ipccommand in privileged EXEC mode.
show route-map ipc
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC (#)
Command History
Release |
Modification |
---|---|
12.0(3)T |
This command was introduced. |
12.2(33)SRA |
This command was integrated into Cisco IOS Release 12.2(33)SRA. |
12.2SX |
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware. |
Usage Guidelines
This command displays the counts of one-way route map IPC messages from the RP to the VIP when NetFlow policy routing is configured. If you execute this command on the RP, the messages are shown as "Sent." If you execute this command on the VIP console, the IPC messages are shown as "Received."
Examples
The following is sample output of the show route-map ipc command when it is executed on the RP:
Router# show route-map ipc Route-map RP IPC Config Updates Sent Name: 4 Match access-list: 2 Match length: 0 Set precedence: 1 Set tos: 0 Set nexthop: 4 Set interface: 0 Set default nexthop: 0 Set default interface: 1 Clean all: 2
The following is sample output of the show route-map ipc command when it is executed on the VIP:
Router# show route-map ipc Route-map LC IPC Config Updates Received Name: 4 Match access-list: 2 Match length: 0 Set precedence: 1 Set tos: 0 Set nexthop: 4 Set interface: 0 Set default nexthop: 0 Set default interface: 1 Clean all: 2
The table below describes the significant fields shown in the display.
Field |
Description |
---|---|
Route-map RP IPC Config Updates Sent |
Indicates that IPC messages are being sent from the RP to the VIP. |
Name |
Number of IPC messages sent about the name of the route map. |
Match access-list |
Number of IPC messages sent about the access list. |
Match length |
Number of IPC messages sent about the length to match. |
Set precedence |
Number of IPC messages sent about the precedence. |
Set tos |
Number of IPC messages sent about the type of service (ToS). |
Set nexthop |
Number of IPC messages sent about the next hop. |
Set interface |
Number of IPC messages sent about the interface. |
Set default nexthop |
Number of IPC messages sent about the default next hop. |
Set default interface |
Number of IPC messages sent about the default interface. |
Clean all |
Number of IPC messages sent about clearing the policy routing configuration from the VIP. When dCEF is disabled and reenabled, the configuration related to policy routing must be removed (cleaned) from the VIP before the new information is downloaded from the RP to the VIP. |
Related Commands
Command |
Description |
---|---|
set ip next-hop verify-availability |
Configures policy routing to verify if the next hops of a route map are CDP neighbors before policy routing to that next hop. |
show xdr
To display details about eXternal Data Representation (XDR), use the show xdr command in user EXEC or privileged EXEC mode.
show xdr { client { client-name | all } [statistics] | linecard [linecard-number] [internal] | multicast-group | timers }
Syntax Description
client {client-name | all} |
Displays client basic information or statistics for a client or all clients. |
statistics |
(Optional) Displays XDR statistics. |
linecard |
(Line cards only) (Route/Switch Processor (RSP) on Cisco 7500 series and Route Processor (RP) on Cisco 10000 series) Displays XDR information for all XDR line card peer instances or the specified XDR line card peer instance. |
linecard-number |
(Optional) Specifies the line card slot number. |
internal |
(Optional) (RSP only) Displays internal information. |
multicast-group |
Displays XDR multicast groups. |
timers |
Displays XDR timers. |
Command Default
XDR details are not displayed.
Command Modes
User EXEC (>)
Privileged EXEC (#)
Command History
Release |
Modification |
---|---|
12.2(25)S |
This command was introduced. |
12.2(28)SB |
This command was integrated into Cisco IOS Release 12.2(28)SB and implemented on the Cisco 10000 series routers. |
12.2(33)SRA |
This command was integrated into Cisco IOS Release 12.2(33)SRA. |
12.2(33)SXH |
This command was integrated into Cisco IOS Release 12.2(33)SXH. |
12.4(20)T |
This command was integrated into Cisco IOS Release 12.4(20)T. |
Usage Guidelines
This command is available only on distributed platforms (such as the Cisco 7500 series) and on the Cisco 10000 series routers.
Examples
The following example shows how to display XDR information for all clients:
Router# show xdr client all XDR Interrupt P(0) flag:1 decode:0x413B9804 pull:0x413B9AE8 context:8 XDR Process Pri(1) flag:1 decode:0x413B99A0 pull:0x413B9D3C context:6 FIBHWIDB broker(2) flag:1 decode:0x0 pull:0x413A7B7C context:2 FIBIDB broker (3) flag:1 decode:0x0 pull:0x413A844C context:2 FIBHWIDB Subblo(4) flag:1 decode:0x0 pull:0x413A8E20 context:2 FIBIDB Subblock(5) flag:1 decode:0x0 pull:0x413A97DC context:2 XDR High Queue (6) flag:3 decode:0x4031AFFC pull:0x4031B934 context:1 Adjacency updat(7) flag:1 decode:0x413B266C pull:0x413B261C context:2 XDR Medium Queu(8) flag:3 decode:0x4031B004 pull:0x4031B95C context:1 IPv4 table brok(9) flag:1 decode:0x0 pull:0x413B21F0 context:6 IPv6 table brok(10) flag:1 decode:0x0 pull:0x413ECA90 context:6 XDR Low Queue (11) flag:3 decode:0x4031B00C pull:0x4031B984 context:1 MFI RP Pull (12) flag:1 decode:0x0 pull:0x413E1174 context:1 Push Client One(13) flag:1 decode:0x413BA300 pull:0x0 context:4 CEF push (14) flag:1 decode:0x413A3D74 pull:0x0 context:124 MFI non-RP Push(15) flag:1 decode:0x413DFA34 pull:0x0 context:4 XDR ping (16) flag:1 decode:0x413BABB4 pull:0x0 context:1
The following example shows how to display XDR information for all XDR line card peer instances:
Router# show xdr linecard XDR slot number 1, status PEER UP IPC messages sent 48 Next sequence number to send 21 Maximum sequence number expected 36 XDR slot number 2, status PEER UP IPC messages sent 52 Next sequence number to send 31 Maximum sequence number expected 46 XDR slot number 3, status PEER UP IPC messages sent 55 Next sequence number to send 17 Maximum sequence number expected 32
The following example shows how to display XDR information for the XDR line card peer instance in slot number 1:
Router# show xdr linecard 1 XDR slot number 1, status PEER UP IPC messages sent 48 Next sequence number to send 21 Maximum sequence number expected 36
The following example shows how to display internal XDR information for the XDR line card peer instance in slot number 1:
Router# show xdr linecard 1 internal XDR slot number 1, status PEER UP IPC messages sent 48 Next sequence number to send 21 Maximum sequence number expected 36 Tx bytes Rx bytes XDR Interrupt Priori: 0 0 2391 11955 Window Message 21 336 0 0 Time Message 2 8 0 0 Resequence Message 0 0 1 6 CEF LC state XDR Process Priority: 0 0 1 3 Registration Signal 2 10 0 0 CEF running FIBHWIDB broker : 90 33570 0 0 fibhwidb update FIBIDB broker : 80 30960 0 0 fibidb update FIBIDB Subblock brok: 10 315 0 0 fibswsb update Adjacency update : 2 6 0 0 Adjacency update me 3 9 0 0 Adjacency repopulat IPv4 table broker : 16 558 0 0 prefix 4 24 0 0 epoch 2 36 0 0 table 4 44 0 0 multicast prefix IPv6 table broker : 1 18 0 0 table CEF push : 12 72 19 114 repopulation req 0 0 1 12 isl table update rq 0 0 1 12 dot1q table updateq 2 10 0 0 state 9 452 0 0 control 1 3 0 0 flow features deace 1 22 0 0 flow cache config 1 40 0 0 flow export config 6 470 0 0 access-list config 2 10 0 0 access-list delete 1 12 0 0 route-map 1 16 0 0 icmp limit 1 8 0 0 SSM RP to LC commas XDR ping : 3 12 3 12 ping message
The following is sample output from the show xdr multicast-groupcommand:
Router# show xdr multicast-group 0x4300DC00 READY Window: 15 Linecards: 2 XDR High Queue xdrs to push: 0 XDR Medium Queu xdrs to push: 0 XDR Low Queue xdrs to push: 0 0x4414BC60 READY Window: 15 Linecards: 1 XDR High Queue xdrs to push: 0 XDR Medium Queu xdrs to push: 0 XDR Low Queue xdrs to push: 0 0x44159420 READY Window: 15 Linecards: 3 XDR High Queue xdrs to push: 0 XDR Medium Queu xdrs to push: 0 XDR Low Queue xdrs to push: 0
The following is sample output from the show xdr timerscommand:
Router# show xdr timers XDR multicast timers Expiration Type | 0.000 (parent) XDR RP ping timers Expiration Type | 0.000 (parent) XDR RP timers Expiration Type | 1:19.236 (parent) | 1:19.236 Sending Time | 4:59.236 Keepalive timer slot: 2 | 4:59.236 Keepalive timer slot: 1 | 4:59.248 Keepalive timer slot: 3
Examples
The following example shows how to display XDR information for all clients:
Router# show xdr client all XDR Interrupt P(0) flag:RP|ISSU aware ISSU capable slot(s): 1 XDR Process Pri(1) flag:RP|ISSU aware ISSU capable slot(s): 1 FIBHWIDB broker(2) flag:RP|ISSU aware ISSU capable slot(s): 1 FIBIDB broker (3) flag:RP|ISSU aware ISSU capable slot(s): 1 FIBHWIDB Subblo(4) flag:RP|ISSU aware ISSU capable slot(s): 1 FIBIDB Subblock(5) flag:RP|ISSU aware ISSU capable slot(s): 1 XDR High Queue (6) flag:RP|LC Adjacency updat(7) flag:RP|ISSU aware ISSU capable slot(s): 1 XDR Medium Queu(8) flag:RP|LC IPv4 table brok(9) flag:RP|ISSU aware ISSU capable slot(s): 1 XDR Low Queue (11) flag:RP|LC MFI Pull (12) flag:RP|ISSU aware ISSU capable slot(s): 1 Push Client One(13) flag:RP CEF push (14) flag:RP|ISSU aware ISSU capable slot(s): 1 MFI Push (15) flag:RP|ISSU aware ISSU capable slot(s): 1 XDR ping (16) flag:RP MPLS Embedded M(17) flag:RP
The following example shows how to display XDR information for all XDR line card peer instances:
Router# show xdr linecard XDR slot number 1, status PEER UP IPC messages sent 569 This is the secondary RP Next sequence number to send 116 Maximum sequence number expected 160 ISSU state: Nego done, version 2, mtu 7, sid 31
The following example shows how to display XDR information for the XDR line card peer instance in slot number 1:
Router# show xdr linecard 1 XDR slot number 1, status PEER UP IPC messages sent 570 This is the secondary RP Next sequence number to send 116 Maximum sequence number expected 160 ISSU state: Nego done, version 2, mtu 7, sid 31
The following example shows how to display internal XDR information for the XDR line card peer instance in slot number 1:
Router# show xdr linecard 1 internal XDR slot number 1, status PEER UP IPC maximum mtu 1478 IPC messages sent 570 This is the secondary RP Next sequence number to send 116 Maximum sequence number expected 160 ISSU state: Nego done, version 2, mtu 7, sid 31 Tx bytes Rx bytes XDR Interrupt Priori: 0 0 10427 52135 Window Message 87 1392 0 0 Time Message 1 4 0 0 Resequence Message 19 444 11 264 ISSU nego XDR Process Priority: 17 51 11 33 Reg Signal 1 2 0 0 CEF running 0 0 1 4 CEF reload request 15 348 9 216 ISSU nego FIBHWIDB broker : 32 3588 0 0 fibhwidb update 7 156 5 120 ISSU nego FIBIDB broker : 49 6429 0 0 fibidb update 7 156 5 120 ISSU nego FIBHWIDB Subblock br: 7 156 5 120 ISSU nego FIBIDB Subblock brok: 41 1533 0 0 fibswsb update 13 300 8 192 ISSU nego Adjacency update : 62 3089 0 0 adj update 4 8 0 0 adj epoch 17 396 10 240 ISSU nego IPv4 table broker : 285 28557 0 0 prefix 8 48 0 0 epoch 5 78 0 0 table 5 55 0 0 multicast prefix 45 1068 24 576 ISSU nego MFI Pull : 12 456 0 0 pull update 75 1788 39 936 ISSU nego CEF push : 8 48 14 84 repopulation req 5 10 0 0 state 12 816 0 0 control 2 0 0 0 mpls_access-list delete 2 32 0 0 icmp limit 9 204 6 144 ISSU nego MFI Push : 3 101 0 0 service reply 2 34 0 0 client request 0 0 4 106 service request 2 16 0 0 enable/redist redistribution client 153 3660 78 1872 ISSU nego XDR ping : 6 24 6 24 ping message
Related Commands
Command |
Description |
---|---|
show cef broker |
Displays Cisco Express Forwarding information related to a selected update broker. |
snmp mib cef throttling-interval
To set the throttling interval for the CEF-MIB inconsistency notifications, use the snmp mib cef throttling-intervalcommand in global configuration mode. To remove the throttling interval, use the no form of this command.
snmp mib cef throttling-interval seconds
no snmp mib cef throttling-interval seconds
Syntax Description
seconds |
The time to allow before an inconsistency notification is sent during the process of updating forwarding information from the Routing Information Base (RIB) to the Route Processor (RP) and the line card databases. The valid values are from 0 to 3600 seconds. |
Command Default
Throttling is disabled by default (throttling interval is set to 0 seconds).
Command Modes
Global configuration (config)
Command History
Release |
Modification |
---|---|
12.2(31)SB |
This command was introduced. |
12.2(33)SRC |
This command was integrated into Cisco IOS Release 12.2(33)SRC. |
12.2(33)SB |
This command was integrated into Cisco IOS Release 12.2(33)SB. |
12.4(20)T |
This command was integrated into Cisco IOS Release 12.4(20)T. |
15.0(1)M |
This command was integrated into Cisco IOS Release 15.0(1)M. |
12.2(33)SRE |
This command was integrated into Cisco IOS Release 12.2(33)SRE. |
12.2(50)SY |
This command was integrated into Cisco IOS Release 12.2(50)SY. |
Usage Guidelines
Use this command in conjunction with the snmp-server enable traps cef inconsistency command to set the time that elapsed between the occurrence of a Cisco Express Forwarding database inconsistencies and the time when you want to receive an inconsistency notification.
If you set the throttling interval to 0 seconds, throttling is disabled.
Examples
The following example shows how to set the throttling interval for CEF-MIB inconsistency notification to 300 seconds:
configure terminal ! snmp-server enable traps cef inconsistency snmp mib cef throttling-interval 300
Related Commands
Command |
Description |
---|---|
snmp-server enable traps cef |
Enables CEF-MIB notifications that correspond to Cisco Express Forwarding events. |
snmp-server host |
Specifies the recipient of an SNMP notification operation. |
snmp-server enable traps cef
To enable Cisco Express Forwarding support of Simple Network Management Protocol (SNMP) notifications on a network management system (NMS), use the snmp-server enable traps cef command in global configuration mode. To disable Cisco Express Forwarding support of SNMP notifications, use the no form of this command.
snmp-server enable traps cef [peer-state-change] [resource-failure] [inconsistency] [peer-fib-state-change]
no snmp-server enable traps cef [peer-state-change] [resource-failure] [inconsistency] [peer-fib-state-change]
Syntax Description
peer-state-change |
(Optional) Enables the sending of CEF-MIB SNMP notifications for changes in the operational state of Cisco Express Forwarding peers. |
resource-failure |
(Optional) Enables the sending of CEF-MIB SNMP notifications for resource failures that affect Cisco Express Forwarding operations. |
inconsistency |
(Optional) Enables the sending of CEF-MIB SNMP notifications for inconsistencies that occur when routing information is updated from the Routing Information Base (RIB) to the Cisco Express Forwarding Forwarding Information Base (FIB) on the Route Processor (RP) and to the Cisco Express Forwarding FIB on the line cards. |
peer-fib-state-change |
(Optional) Enables the sending of CEF-MIB SNMP notifications for changes in the operational state of the Cisco Express Forwarding peer FIB. |
Command Default
All CEF-MIB notifications are disabled by default.
Command Modes
Global configuration (config)
Command History
Release |
Modification |
---|---|
12.2(31)SB2 |
This command was introduced. |
12.2(33)SRC |
This command was integrated into Cisco IOS Release 12.2(33)SRC. |
12.2(33)SB |
This command was integrated into Cisco IOS Release 12.2(33)SB. |
12.4(20)T |
This command was integrated into Cisco IOS Release 12.4(20)T. |
15.0(1)M |
This command was integrated into Cisco IOS Release 15.0(1)M. |
12.2(33)SRE |
This command was integrated into Cisco IOS Release 12.2(33)SRE. |
12.2(50)SY |
This command was integrated into Cisco IOS Release 12.2(50)SY. |
Usage Guidelines
You can use this command to enable CEF-MIB SNMP notifications that correspond to specific Cisco Express Forwarding events. To send the notifications to an NMS or host system, you must configure the snmp-server host command with the cef keyword.
You can enable all CEF-MIB SNMP notifications if you enter the snmp-server enable traps cefcommand without entering an optional keyword.
Examples
The following example shows how to enable a router to send Cisco Express Forwarding peer state changes and forwarding inconsistencies as informs to the NMS with IP address 10.56.125.47 and to use the community string defined as public:
configure terminal ! snmp-server enable traps cef peer-state-change inconsistency snmp-server host 10.56.125.47 informs version 2c public
Related Commands
Command |
Description |
---|---|
snmp-server community |
Configures a community access string to permit SNMP access to the local router by the remote SNMP software client. |
snmp-server host |
Specifies the recipient of an SNMP notification operation. |
snmp-server host
To specify the recipient of a Simple Network Management Protocol (SNMP) notification operation, use the snmp-server host command in global configuration mode. To remove the specified host from the configuration, use the no form of this command.
snmp-server host { hostname | ip-address } [ vrf vrf-name | informs | traps | version { 1 | 2c | 3 [ auth | noauth | priv ] } ] community-string [ udp-port port [notification-type] | notification-type ]
no snmp-server host { hostname | ip-address } [ vrf vrf-name | informs | traps | version { 1 | 2c | 3 [ auth | noauth | priv ] } ] community-string [ udp-port port [notification-type] | notification-type ]
Command Syntax on Cisco ME 3400, ME 3400E, and Catalyst 3750 Metro Switches
snmp-server host ip-address { community-string | informs | traps } { community-string | version { 1 | 2c | 3 { auth | noauth } } } { community-string | vrf vrf-name { informs | traps } } [ notification-type ]
no snmp-server host ip-address { community-string | informs | traps } { community-string | version { 1 | 2c | 3 { auth | noauth } } } { community-string | vrf vrf-name { informs | traps } } [ notification-type ]
Command Syntax on Cisco 7600 Series Router
snmp-server host ip-address { community-string | { informs | traps } { community-string | version { 1 | 2c | 3 { auth | noauth | priv } } community-string | version { 1 | 2c | 3 { auth | noauth | priv } } community-string | vrf vrf-name { informs | traps } { community-string | version { 1 | 2c | 3 { auth | noauth | priv } } community-string } } } [notification-type]
no snmp-server host ip-address { community-string | { informs | traps } { community-string | version { 1 | 2c | 3 { auth | noauth | priv } } community-string | version { 1 | 2c | 3 { auth | noauth | priv } } community-string | vrf vrf-name { informs | traps } { community-string | version { 1 | 2c | 3 { auth | noauth | priv } } community-string } } } [notification-type]
Syntax Description
hostname |
Name of the host. The SNMP notification host is typically a network management station (NMS) or SNMP manager. This host is the recipient of the SNMP traps or informs. |
||||
ip-address |
IPv4 address or IPv6 address of the SNMP notification host. |
||||
vrf |
(Optional) Specifies that a VPN routing and forwarding (VRF) instance should be used to send SNMP notifications. |
||||
vrf-name |
(Optional) VPN VRF instance used to send SNMP notifications. |
||||
informs |
(Optional) Specifies that notifications should be sent as informs. |
||||
traps |
(Optional) Specifies that notifications should be sent as traps. This is the default. |
||||
version |
(Optional) Specifies the version of the SNMP that is used to send the traps or informs. The default is 1.
If you use the version keyword, one of the following keywords must be specified:
One of the following three optional security level keywords can follow the 3 keyword:
|
||||
community-string |
Password-like community string sent with the notification operation.
|
||||
udp-port |
(Optional) Specifies that SNMP traps or informs are to be sent to an network management system (NMS) host. |
||||
port |
(Optional) User Datagram Protocol (UDP) port number of the NMS host. The default is 162. |
||||
notification-type
|
(Optional) Type of notification to be sent to the host. If no type is specified, all available notifications are sent. See the “Usage Guidelines” section for more information about the keywords available. |
Command Default
This command behavior is disabled by default. A recipient is not specified to receive notifications.
Command Modes
Global configuration (config)
Command History
Release |
Modification |
---|---|
10.0 |
This command was introduced. |
12.0(3)T |
This command was modified. |
12.1(3)T |
This command was modified. The calltracker notification-type keyword was added for the Cisco AS5300 and AS5800 platforms. |
12.2(2)T |
This command was modified. |
12.2(4)T |
This command was modified. |
12.2(8)T |
This command was modified. |
12.2(13)T |
This command was modified. |
12.3(2)T |
This command was modified. |
12.3(4)T |
This command was modified. |
12.3(8)T |
This command was modified. The iplocalpool notification-type keyword was added for the Cisco 7200 and 7301 series routers. |
12.3(11)T |
This command was modified. The vrrp keyword was added. |
12.3(14)T |
This command was modified. |
12.4(20)T |
This command was modified. The license notification-type keyword was added. |
15.0(1)M |
This command was modified. |
12.0(17)ST |
This command was modified. The mpls-traffic-eng notification-type keyword was added. |
12.0(21)ST |
This command was modified. The mpls-ldp notification-type keyword was added. |
12.0(22)S |
This command was modified. |
12.0(23)S |
This command was modified. The l2tun-session notification-type keyword was added. |
12.0(26)S |
This command was modified. The memory notification-type keyword was added. |
12.0(27)S |
This command was modified. |
12.0(31)S |
This command was modified. The l2tun-pseudowire-status notification-type keyword was added. |
12.2(18)S |
This command was integrated into Cisco IOS Release 12.2(18)S. |
12.2(25)S |
This command was modified. |
12.2(28)SB |
This command was integrated into Cisco IOS Release 12.2(28)SB. |
12.2(33)SRA |
This command was integrated into Cisco IOS Release 12.2(33)SRA. |
12.2(31)SB2 |
The cef notification-type keyword was added. |
12.2(33)SXH |
This command was integrated into Cisco IOS Release 12.2(33)SXH. |
12.2(33)SB |
This command was integrated into Cisco IOS Release 12.2(33)SB. |
12.2(33)SXI5 |
This command was modified. |
12.2(54)SE |
This command was modified. See the snmp-server host for the command syntax for these switches. |
12.2(33)SXJ |
This command was integrated into Cisco IOS Release 12.2(33)SXJ. The public storm-control notification-type keyword was added. |
15.0(1)S |
This command was modified. The flowmon notification-type keyword was added. |
Cisco IOS XE Release 2.1 |
This command was integrated into Cisco IOS XE Release 2.1. |
15.2(1)S |
This command was modified. The p2mp-traffic-eng notification-type keyword was added. |
Cisco IOS XE Release 3.2SE |
This command was implemented in Cisco IOS XE Release 3.2SE. |
Cisco IOS XE Release 3.3SE |
This command was implemented in Cisco IOS XE Release 3.3SE. |
Usage Guidelines
If you enter this command with no optional keywords, the default is to send all notification-type traps to the host. No informs will be sent to the host.
The no snmp-server host command with no keywords disables traps, but not informs, to the host. To disable informs, use the no snmp-server host informs command.
Note | If a community string is not defined using the snmp-server community command prior to using this command, the default form of the snmp-server community command will automatically be inserted into the configuration. The password (community string) used for this automatic configuration of the snmp-server community command will be the same as that specified in the snmp-server host command. This automatic command insertion and use of passwords is the default behavior for Cisco IOS Release 12.0(3) and later releases. However, in Cisco IOS Release 12.2(33)SRE and later releases, you must manually configure the snmp-server community command. That is, the snmp-server community command will not be seen in the configuration. |
SNMP notifications can be sent as traps or inform requests. Traps are unreliable because the receiver does not send acknowledgments when it receives traps. The sender cannot determine if the traps were received. However, an SNMP entity that receives an inform request acknowledges the message with an SNMP response protocol data unit (PDU). If the sender never receives the response, the inform request can be sent again. Thus, informs are more likely to reach their intended destination than traps.
Compared to traps, informs consume more resources in the agent and in the network. Unlike a trap, which is discarded as soon as it is sent, an inform request must be held in memory until a response is received or the request times out. Also, traps are sent only once; an inform may be tried several times. The retries increase traffic and contribute to a higher overhead on the network.
If you do not enter an snmp-server host command, no notifications are sent. To configure the router to send SNMP notifications, you must enter at least one snmp-server host command. If you enter the command with no optional keywords, all trap types are enabled for the host.
To enable multiple hosts, you must issue a separate snmp-server host command for each host. You can specify multiple notification types in the command for each host.
When multiple snmp-server host commands are given for the same host and kind of notification (trap or inform), each succeeding command overwrites the previous command. Only the last snmp-server host command will be in effect. For example, if you enter an snmp-server host inform command for a host and then enter another snmp-server host inform command for the same host, the second command will replace the first.
The snmp-server host command is used in conjunction with the snmp-server enable command. Use the snmp-server enable command to specify which SNMP notifications are sent globally. For a host to receive most notifications, at least one snmp-server enable command and the snmp-server host command for that host must be enabled.
Some notification types cannot be controlled with the snmp-server enable command. Some notification types are always enabled, and others are enabled by a different command. For example, the linkUpDown notifications are controlled by the snmp trap link-status command. These notification types do not require an snmp-server enable command.
The availability of notification-type options depends on the router type and the Cisco IOS software features supported on the router. For example, the envmon notification type is available only if the environmental monitor is part of the system. To see what notification types are available on your system, use the command help ? at the end of the snmp-server host command.
The vrf keyword allows you to specify the notifications being sent to a specified IP address over a specific VRF VPN. The VRF defines a VPN membership of a user so that data is stored using the VPN.
In the case of the NMS sending the query having a correct SNMP community but not having a read or a write view, the SNMP agent returns the following error values:
-
For a get or a getnext query, returns GEN_ERROR for SNMPv1 and AUTHORIZATION_ERROR for SNMPv2C.
-
For a set query, returns NO_ACCESS_ERROR.
Notification-Type Keywords
The notification type can be one or more of the following keywords.
Note | The available notification types differ based on the platform and Cisco IOS release. For a complete list of available notification types, use the question mark (?) online help function. |
-
aaa server --Sends SNMP authentication, authorization, and accounting (AAA) traps.
-
adslline --Sends Asymmetric Digital Subscriber Line (ADSL) LINE-MIB traps.
-
atm --Sends ATM notifications.
-
authenticate-fail --Sends an SNMP 802.11 Authentication Fail trap.
-
auth-framework --Sends SNMP CISCO-AUTH-FRAMEWORK-MIB notifications.
-
bgp --Sends Border Gateway Protocol (BGP) state change notifications.
-
bridge --Sends SNMP STP Bridge MIB notifications.
-
bstun --Sends Block Serial Tunneling (BSTUN) event notifications.
-
bulkstat --Sends Data-Collection-MIB notifications.
-
c6kxbar --Sends SNMP crossbar notifications.
-
callhome --Sends Call Home MIB notifications.
-
calltracker -- Sends Call Tracker call-start/call-end notifications.
-
casa --Sends Cisco Appliances Services Architecture (CASA) event notifications.
-
ccme --Sends SNMP Cisco netManager Event (CCME) traps.
-
cef --Sends notifications related to Cisco Express Forwarding.
-
chassis --Sends SNMP chassis notifications.
-
cnpd --Sends Cisco Network-based Application Recognition (NBAR) Protocol Discovery (CNPD) traps.
-
config --Sends configuration change notifications.
-
config-copy --Sends SNMP config-copy notifications.
-
config-ctid --Sends SNMP config-ctid notifications.
-
cpu --Sends CPU-related notifications.
-
csg --Sends SNMP Content Services Gateway (CSG) notifications.
-
deauthenticate --Sends an SNMP 802.11 Deauthentication trap.
-
dhcp-snooping --Sends DHCP snooping MIB notifications.
-
director --Sends notifications related to DistributedDirector.
-
disassociate --Sends an SNMP 802.11 Disassociation trap.
-
dlsw --Sends data-link switching (DLSW) notifications.
-
dnis --Sends SNMP Dialed Number Identification Service (DNIS) traps.
-
dot1x --Sends 802.1X notifications.
-
dot11-mibs --Sends dot11 traps.
-
dot11-qos --Sends SNMP 802.11 QoS Change trap.
-
ds1 --Sends SNMP digital signaling 1 (DS1) notifications.
-
ds1-loopback --Sends ds1-loopback traps.
-
dspu --Sends downstream physical unit (DSPU) notifications.
-
eigrp --Sends Enhanced Interior Gateway Routing Protocol (EIGRP) stuck-in-active (SIA) and neighbor authentication failure notifications.
-
energywise --Sends SNMP energywise notifications.
-
entity --Sends Entity MIB modification notifications.
-
entity-diag --Sends SNMP entity diagnostic MIB notifications.
-
envmon --Sends Cisco enterprise-specific environmental monitor notifications when an environmental threshold is exceeded.
-
errdisable --Sends error disable notifications.
-
ethernet-cfm --Sends SNMP Ethernet Connectivity Fault Management (CFM) notifications.
-
event-manager --Sends SNMP Embedded Event Manager notifications.
-
firewall --Sends SNMP Firewall traps.
-
flash --Sends flash media insertion and removal notifications.
-
flexlinks --Sends FLEX links notifications.
-
flowmon --Sends flow monitoring notifications.
-
frame-relay --Sends Frame Relay notifications.
-
fru-ctrl --Sends entity field-replaceable unit (FRU) control notifications.
-
hsrp --Sends Hot Standby Routing Protocol (HSRP) notifications.
-
icsudsu --Sends SNMP ICSUDSU traps.
-
iplocalpool --Sends IP local pool notifications.
-
ipmobile --Sends Mobile IP notifications.
-
ipmulticast --Sends IP multicast notifications.
-
ipsec --Sends IP Security (IPsec) notifications.
-
isakmp --Sends SNMP ISAKMP notifications.
-
isdn --Sends ISDN notifications.
-
l2tc --Sends SNMP L2 tunnel configuration notifications.
-
l2tun-pseudowire-status --Sends pseudowire state change notifications.
-
l2tun-session --Sends Layer 2 tunneling session notifications.
-
license --Sends licensing notifications as traps or informs.
-
llc2 --Sends Logical Link Control, type 2 (LLC2) notifications.
-
mac-notification --Sends SNMP MAC notifications.
-
memory --Sends memory pool and memory buffer pool notifications.
-
module --Sends SNMP module notifications.
-
module-auto-shutdown --Sends SNMP module autoshutdown MIB notifications.
-
mpls-fast-reroute --Sends SNMP Multiprotocol Label Switching (MPLS) traffic engineering fast reroute notifications.
-
mpls-ldp --Sends MPLS Label Distribution Protocol (LDP) notifications indicating status changes in LDP sessions.
-
mpls-traffic-eng --Sends MPLS traffic engineering notifications, indicating changes in the status of MPLS traffic engineering tunnels.
-
mpls-vpn --Sends MPLS VPN notifications.
-
msdp --Sends SNMP Multicast Source Discovery Protocol (MSDP) notifications.
-
mvpn --Sends multicast VPN notifications.
-
nhrp --Sends Next Hop Resolution Protocol (NHRP) notifications.
-
ospf --Sends Open Shortest Path First (OSPF) sham-link notifications.
-
pim --Sends Protocol Independent Multicast (PIM) notifications.
-
port-security --Sends SNMP port-security notifications.
-
power-ethernet --Sends SNMP power Ethernet notifications.
-
public storm-control --Sends SNMP public storm-control notifications.
-
pw-vc --Sends SNMP pseudowire virtual circuit (VC) notifications.
-
p2mp-traffic-eng--Sends SNMP MPLS Point to Multi-Point MPLS-TE notifications.
-
repeater --Sends standard repeater (hub) notifications.
-
resource-policy --Sends CISCO-ERM-MIB notifications.
-
rf --Sends SNMP RF MIB notifications.
-
rogue-ap --Sends an SNMP 802.11 Rogue AP trap.
-
rsrb --Sends remote source-route bridging (RSRB) notifications.
-
rsvp --Sends Resource Reservation Protocol (RSVP) notifications.
-
rtr --Sends Response Time Reporter (RTR) notifications.
-
sdlc --Sends Synchronous Data Link Control (SDLC) notifications.
-
sdllc --Sends SDLC Logical Link Control (SDLLC) notifications.
-
slb --Sends SNMP server load balancer (SLB) notifications.
-
snmp --Sends any enabled RFC 1157 SNMP linkUp, linkDown, authenticationFailure, warmStart, and coldStart notifications.
Note
To enable RFC-2233-compliant link up/down notifications, you should use the snmp server link trap command.
-
sonet --Sends SNMP SONET notifications.
-
srp --Sends Spatial Reuse Protocol (SRP) notifications.
-
stpx --Sends SNMP STPX MIB notifications.
-
srst --Sends SNMP Survivable Remote Site Telephony (SRST) traps.
-
stun --Sends serial tunnel (STUN) notifications.
-
switch-over --Sends an SNMP 802.11 Standby Switchover trap.
-
syslog --Sends error message notifications (Cisco Syslog MIB). Use the logging history level command to specify the level of messages to be sent.
-
syslog --Sends error message notifications (Cisco Syslog MIB). Use the logging history level command to specify the level of messages to be sent.
-
tty --Sends Cisco enterprise-specific notifications when a TCP connection closes.
-
udp-port --Sends the notification host’s UDP port number.
-
vlan-mac-limit --Sends SNMP L2 control VLAN MAC limit notifications.
-
vlancreate --Sends SNMP VLAN created notifications.
-
vlandelete --Sends SNMP VLAN deleted notifications.
-
voice --Sends SNMP voice traps.
-
vrrp --Sends Virtual Router Redundancy Protocol (VRRP) notifications.
-
vsimaster --Sends Virtual Switch Interface (VSI) Master notifications.
-
vswitch --Sends SNMP virtual switch notifications.
-
vtp --Sends SNMP VLAN Trunking Protocol (VTP) notifications.
-
wlan-wep --Sends an SNMP 802.11 Wireless LAN (WLAN) Wired Equivalent Privacy (WEP) trap.
-
x25 --Sends X.25 event notifications.
-
xgcp --Sends External Media Gateway Control Protocol (XGCP) traps.
SNMP-Related Notification-Type Keywords
The notification-type argument used in the snmp-server host command do not always match the keywords used in the corresponding snmp-server enable traps command. For example, the notification-type argument applicable to Multiprotocol Label Switching Protocol (MPLS) traffic engineering tunnels is specified as mpls-traffic-eng (containing two hyphens and no embedded spaces). The corresponding parameter in the snmp-server enable traps command is specified as mpls traffic-eng (containing an embedded space and a hyphen).
This syntax difference is necessary to ensure that the CLI interprets the notification-type keyword of the snmp-server host command as a unified, single-word construct, which preserves the capability of the snmp-server host command to accept multiple notification-type keywords in the command line. The snmp-server enable traps commands, however, often use two-word constructs to provide hierarchical configuration options and to maintain consistency with the command syntax of related commands. The table below maps some examples of snmp-server enable traps commands to the keywords used in the snmp-server host command.
snmp-server enable traps Command |
snmp-server host Command Keyword |
---|---|
snmp-server enable traps l2tun session |
l2tun-session |
snmp-server enable traps mpls ldp |
mpls-ldp |
snmp-server enable traps mpls traffic-eng 1 |
mpls-traffic-eng |
snmp-server enable traps mpls vpn |
mpls-vpn |
snmp-server host host-address community-string udp-port port p2mp-traffic-eng |
snmp-server enable traps mpls p2mp-traffic-eng [down | up] |
Examples
If you want to configure a unique SNMP community string for traps but prevent SNMP polling access with this string, the configuration should include an access list. The following example shows how to name a community string comaccess and number an access list 10:
Router(config)# snmp-server community comaccess ro 10 Router(config)# snmp-server host 10.0.0.0 comaccess Router(config)# access-list 10 deny any
Note | The “at” sign (@) is used as a delimiter between the community string and the context in which it is used. For example, specific VLAN information in BRIDGE-MIB may be polled using community @VLAN-ID (for example, public@100), where 100 is the VLAN number. |
The following example shows how to send RFC 1157 SNMP traps to a specified host named myhost.cisco.com. Other traps are enabled, but only SNMP traps are sent because only snmp is specified in the snmp-server host command. The community string is defined as comaccess.
Router(config)# snmp-server enable traps Router(config)# snmp-server host myhost.cisco.com comaccess snmp
The following example shows how to send the SNMP and Cisco environmental monitor enterprise-specific traps to address 10.0.0.0 using the community string public:
Router(config)# snmp-server enable traps snmp Router(config)# snmp-server enable traps envmon Router(config)# snmp-server host 10.0.0.0 public snmp envmon
The following example shows how to enable the router to send all traps to the host myhost.cisco.com using the community string public:
Router(config)# snmp-server enable traps Router(config)# snmp-server host myhost.cisco.com public
The following example will not send traps to any host. The BGP traps are enabled for all hosts, but only the ISDN traps are enabled to be sent to a host. The community string is defined as public.
Router(config)# snmp-server enable traps bgp Router(config)# snmp-server host myhost.cisco.com public isdn
The following example shows how to enable the router to send all inform requests to the host myhost.cisco.com using the community string public:
Router(config)# snmp-server enable traps Router(config)# snmp-server host myhost.cisco.com informs version 2c public
The following example shows how to send HSRP MIB informs to the host specified by the name myhost.cisco.com. The community string is defined as public.
Router(config)# snmp-server enable traps hsrp Router(config)# snmp-server host myhost.cisco.com informs version 2c public hsrp
The following example shows how to send all SNMP notifications to example.com over the VRF named trap-vrf using the community string public:
Router(config)# snmp-server host example.com vrf trap-vrf public
The following example shows how to configure an IPv6 SNMP notification server with the IPv6 address 2001:0DB8:0000:ABCD:1 using the community string public:
Router(config)# snmp-server host 2001:0DB8:0000:ABCD:1 version 2c public udp-port 2012
The following example shows how to specify VRRP as the protocol using the community string public:
Router(config)# snmp-server enable traps vrrp Router(config)# snmp-server host myhost.cisco.com traps version 2c public vrrp
The following example shows how to send all Cisco Express Forwarding informs to the notification receiver with the IP address 10.0.1.1 using the community string public:
Router(config)# snmp-server enable traps cef Router(config)# snmp-server host 10.0.1.1 informs version 2c public cef
The following example shows how to enable all NHRP traps, and how to send all NHRP traps to the notification receiver with the IP address 10.0.0.0 using the community string public:
Router(config)# snmp-server enable traps nhrp Router(config)# snmp-server host 10.0.0.0 traps version 2c public nhrp
The following example shows how to enable all P2MP MPLS-TE SNMP traps, and send them to the notification receiver with the IP address 172.20.2.160 using the community string "comp2mppublic":
Router(config)# snmp-server enable traps mpls p2mp-traffic-eng Router(config)# snmp-server host 172.20.2.160 comp2mppublic udp-port 162 p2mp-traffic-eng
Related Commands
Command |
Description |
---|---|
show snmp host |
Displays recipient details configured for SNMP notifications. |
snmp-server enable peer-trap poor qov |
Enables poor quality of voice notifications for applicable calls associated with a specific voice dial peer. |
snmp-server enable traps |
Enables SNMP notifications (traps and informs). |
snmp-server enable traps nhrp |
Enables SNMP notifications (traps) for NHRP. |
snmp-server informs |
Specifies inform request options. |
snmp-server link trap |
Enables linkUp/linkDown SNMP traps that are compliant with RFC 2233. |
snmp-server trap-source |
Specifies the interface from which an SNMP trap should originate. |
snmp-server trap-timeout |
Defines how often to try resending trap messages on the retransmission queue. |
test snmp trap storm-control event-rev1 |
Tests SNMP storm-control traps. |
switchover pxf restart
To configure the number of parallel express forwarding (PXF) restarts that are allowed before a switchover to a redundant Performance Routing Engine (PRE) module, use the switchover pxf restartcommand in redundancy configuration (main-cpu) mode. To disable switchovers due to PXF restarts, use the no form of this command.
switchover pxf restart number-of-restarts time-period
no switchover pxf restart
Syntax Description
number-of-restarts |
The number of PXF restarts that are allowed within the specified time period. If the PXF processors restart this many times within the given time period, the router switches over to the redundant PRE module. The valid range is 1 to 25. The default is 2 PXF restarts within 5 hours. |
||
time-period |
Time period, in hours, that PXF restart counts are monitored. The valid range is 0 to 120 hours.
|
Command Default
If this command is not configured, the default is 2 PXF restarts within 5 hours.
Command Modes
Redundancy configuration, main-cpu mode (config-r-mc)
Command History
Release |
Modification |
---|---|
12.2(15)BC2 |
This command was introduced on the Cisco uBR10012 router. |
12.3(7) |
This command was introduced on the Cisco 10000 series router and integrated into Cisco IOS Release 12.3(7). |
12.2SB |
This command was integrated into Cisco IOS Release 12.2SB. |
Usage Guidelines
The startup and running configurations of the standby PRE are synchronized with the active PRE, ensuring the fastest possible cut-over time if the active PRE fails. A second switchover is prevented for 2 hours if a PXF restart occurs on the new active PRE.
A PXF restart following a PXF fault may restore service more quickly when the features in use are not configured for nonstop forwarding with stateful switchover (NSF/SSO), or when SSO mode is not configured on the router. Conversely, a PRE switchover in response to a PXF restart may restore service more quickly when NSF/SSO is configured on the router and all configured features support NSF/SSO.
When a switchover occurs because of repeated PXF restarts, the router displays the following system message:
C10KEVENTMGR-3-PXF_FAIL_SWITCHOVER: Multiple PXF failures, switchover to redundant PRE initiated.
Examples
The following example shows how to configure the router so that if five PXF restarts occur within a one-hour period, the router initiates a switchover to the redundant PRE module.
Router(config)# redundancy Router(config-red)# main-cpu Router(config-r-mc)# switchover pxf restart 5 1
Related Commands
Command |
Description |
---|---|
main-cpu |
Enters main-cpu redundancy configuration mode to configure the synchronization of the active and standby PRE modules. |
redundancy |
Configures the synchronization of system files between the active and standby PRE modules. |
redundancy force-failover main-cpu |
Forces a manual switchover between the active and standby PRE modules. |
show redundancy |
Displays the current redundancy status. |
test cef table consistency
To test the Cisco Express Forwarding Forwarding Information Base (FIB) for prefix consistency, use the test cef table consistency command in privilege EXEC mode.
test cef table consistency [detail]
Syntax Description
detail |
(Optional) Displays detailed information about the consistency of prefixes in the Cisco Express Forwarding FIB table. |
Command Modes
Privileged EXEC (#)
Command History
Release |
Modification |
---|---|
12.2(25)S |
This command was introduced. This command replaces the show ip cef inconsistency command. |
12.2(28)SB |
This command was integrated into Cisco IOS Release 12.2(28)SB. |
12.2(33)SRA |
This command was integrated into Cisco IOS Release 12.2(33)SRA. |
12.2(33)SXH |
This command was integrated into Cisco IOS Release 12.2(33)SXH. |
12.4(20)T |
This command was integrated into Cisco IOS Release 12.4(20)T. |
Usage Guidelines
This command displays recorded Cisco Express Forwarding consistency records found by the lc-detect, scan-rib-ios, scan-ios-rib, scan-lc-rp, and scan-rp-lc detection mechanisms. The scan-lc-rp and scan-rp-lc detection mechanisms are available only on routers with line cards.
You can configure the Cisco Express Forwarding prefix consistency-detection mechanisms using the cef table consistency-check command.
Examples
The following is sample output from the test cef table consistency command:
Router# test cef table consistency full-scan-rib-ios: Checking IPv4 RIB to FIB consistency full-scan-ios-rib: Checking IPv4 FIB to RIB consistency No IPv4 inconsistencies found, check took 00:00:00.000
The following is sample output from the test cef table consistency detailcommand:
Router# test cef table consistency detail full-scan-rib-ios: Checking IPv4 RIB to FIB consistency full-scan-rib-ios: FIB checked 12 prefixes, and found 0 missing. full-scan-ios-rib: Checking IPv4 FIB to RIB consistency full-scan-ios-rib: Checked 12 FIB prefixes in 1 pass, and found 0 extra. full-scan-rp-lc: Sent 26 IPv4 prefixes to linecards in 1 pass full-scan-rp-lc: Initiated IPv4 FIB check on linecards..4..1..0.. full-scan-rp-lc: FIB IPv4 check completed on linecards..1..0..4.. full-scan-rp-lc: Linecard 4 checked 26 IPv4 prefixes (ignored 0). 0 inconsistent. full-scan-rp-lc: Linecard 1 checked 26 IPv4 prefixes (ignored 0). 0 inconsistent. full-scan-rp-lc: Linecard 0 checked 26 IPv4 prefixes (ignored 0). 0 inconsistent. full-scan-rib-ios: Checking IPv6 RIB to FIB consistency full-scan-rib-ios: FIB checked 16 prefixes, and found 5 missing. full-scan-ios-rib: Checking IPv6 FIB to RIB consistency full-scan-ios-rib: Checked 11 FIB prefixes in 1 pass, and found 0 extra. full-scan-rp-lc: Sent 11 IPv6 prefixes to linecards in 1 pass full-scan-rp-lc: Initiated IPv6 FIB check on linecards..4..1..0.. full-scan-rp-lc: FIB IPv6 check completed on linecards..1..4..0.. full-scan-rp-lc: Linecard 4 checked 11 IPv6 prefixes (ignored 0). 0 inconsistent. full-scan-rp-lc: Linecard 1 checked 11 IPv6 prefixes (ignored 0). 0 inconsistent. full-scan-rp-lc: Linecard 0 checked 11 IPv6 prefixes (ignored 0). 0 inconsistent. No IPv4 inconsistencies found, check took 00:00:01.444 Warning: 5 IPv6 inconsistencies found, check took 00:00:01.240
The table below describes the significant fields shown in the display.
Field |
Description |
---|---|
FIB checked 12 prefixes, and found 0 missing |
The scan-rib-ios consistency checker checked 12 prefixes in the FIB against the FIB and found 0 missing. |
Checked 12 FIB prefixes in 1 pass, and found 0 extra. |
The scan-ios-rib consistency checker checked 12 prefixes in the RIB and found no extra prefixes in one pass. |
Linecard 4 checked 26 IPv4 prefixes (ignored 0). 0 inconsistent. |
The scan-rp-lc consistency checker found no inconsistencies on line card 4 after checking 26 IPv4 prefixes. |
Related Commands
Command |
Description |
---|---|
cef table consistency check |
Enables Cisco Express Forwarding table consistency checker types and parameters. |