To show Parallel eXpress Forwarding (PXF) switching statistics for individual interfaces, use the
showpxfaccounting command in user EXEC or privileged EXEC mode.
show pxf accountinginterface
[ 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
showpxfaccounting command:
Table 1 show pxf accounting Interface Types
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
showpxfaccounting?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
showpxfaccountingethernet 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 theshowpxfaccountingnull 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
showpxfaccountingpos 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 theshowpxfaccountingserial 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
showpxfaccountingsummary command:
Displays the PXF routing feature tables for enabled PXF features.
showpxfinterface
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
showpxfcpuaccess-lists command in privileged EXEC mode.
(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.
tcamacl-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
Cisco10000SeriesRouter(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.
Cisco10000Seriesrouter(PRE3)
The PRE3 implements only TCAM ACLs. Turbo-ACLs and Mini-ACLs are not supported.
Examples
The sample output from the
showpxfcpuaccess-listssecurity 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.
ACLConfiguration
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
SampleOutput
The following sample output describes the information displayed in the first section of the command output from the
showpxfcpuaccess-listssecurity command:
The table below describes the significant fields shown in the display.
Table 2 show pxf cpu access-lists security Field Descriptions
Field
Description
ACL
Identifies the ACL by name or number.
State
Displays the current state of the ACL:
Copying--ACL is in the process of being created or compiled.
Operational--ACL is active and filtering packets.
Out of acl private mem--ACL has run out of the private memory that was allocated exclusively to it.
Out of shared mem--ACL has run out of the memory that it shares with other ACLs.
Unknown Failure--ACL has failed because of an uncategorized reason.
Unneeded--ACL was allocated but is not currently in use.
Tables
An indicator of whether the ACL has been split into more than one PXF pass. The first three ACLs in the output are MiniACLs, and have the ACL_index duplicated in the Tables column.
Entries
The count of ACL rules as seen by the Turbo compiler. This is the sum of the Config, Fragment, and Redundant columns plus 1.
Config
The count of rules for this ACL.
Fragment
The count of extra rules added to handle fragment handling, where Layer 4 information is needed but not available in a packet fragment.
Redundant
The count of rules that are not needed because they are covered by earlier rules.
Memory
The amount of PXF XCM in use for the ACL.
ACL_index
The index of the ACL in XCM.
The following sample output describes the information displayed in the next section of the command output from the
showpxfcpuaccess-listssecurity 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.
Table 3 show pxf cpu access-lists security Field Descriptions
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
showpxfcpuaccess-listssecurity command. There are 16 banks of XCM in each PXF column. This output section shows the usage level of each bank.
The table below describes the significant fields shown in the display.
Table 4 show pxf cpu access-lists security Field Descriptions
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
showpxfcpuaccess-listssecurity command:
Available MiniACL count = 8191
Usable ranges(inclusive):
1->8191
The table below describes the significant fields shown in the display.
Table 5 show pxf cpu access-lists security Field Descriptions
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.
For the PRE3, the following sample output displays for the
showpxfcpuaccess-listssecurity 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.
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 showpxfcpuatomcommand in privileged EXEC mode.
showpxfcpuatom
[ 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
showmplsl2transportvc
Displays information about AToM VCs that are enabled to route Layer 2 packets on a router.
showpxfcpumpls
Displays PXF MPLS FIB entry information.
showpxfcpusubblocks
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 showpxfcpubbacommand in privileged EXEC mode.
showpxfcpubba
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-grouppppoe
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
showpxfcpubuffers command in privileged EXEC mode.
showpxfcpubuffers
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.
Table 6 show pxf cpu buffers Field Descriptions
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
clearpxf
Clears PXF counters and statistics.
showpxfstatistics
Displays chassis-wide, summary PXF statistics.
show pxf cpu cef
The showpxfcpucefcommand is replaced by the showipcefplatform command on the Cisco 10000 series router. See the showipcefplatformcommand for more information.
show pxf cpu context
To display the current and historical loads on the Parallel eXpress Forwarding (PXF), use the
showpxfcpucontext command in privileged EXEC mode.
showpxfcpucontext
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
showpxfcpucontextcommand 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.
The table below describes the significant fields shown in the display.
Table 7 show pxf cpu context Field Descriptions
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
clearpxf
Clears PXF counters and statistics.
showpxfstatistics
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 showpxfcpufeedback command in privileged EXEC mode.
showpxfcpufeedback
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:
(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
showpxfcpuipv6table 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
showpxfcpuipv6table command replaces the
showpxfcpuipv6 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
showpxfcpustatistics
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
showpxfcpumplscommand in privileged EXEC mode.
showpxfcpumpls [ labelslabel-value | vrf
]
Syntax Description
labelslabel-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
pingmpls
Checks MPLS LSP connectivity.
showmplsinterfaces
Displays information about the interfaces configured for label switching.
showpxfcpustatistics
Displays PXF CPU statistics.
tracempls
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
showpxfcpumroutecommand in privileged EXEC mode.
showpxfcpumroute [ipaddress1] [ipaddress2]
Syntax Description
ipaddress1ipaddress2
(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:
The table below describes the fields shown in the display.
Table 8 show pxf cpu mroute Field Descriptions
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.
showpxfstatistics
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 showpxfcpupbraction command in privileged EXEC mode.
(Optional) Displays PBR action information and redirects the command output to the route map you specify.
tcammap-name
(Optional) Displays VMR (value, plus a mask and result) information stored in ternary content addressable memory (TCAM) and redirects the command output to the route map you specify.
Note
This option is only available on the PRE3 for the Cisco 10000 series router.
flex-sum
(Optional) Displays summary information describing the amount of memory allocated in the PXF engine for use by the flexible key construction microcode. This information is useful for design teams.
Note
This option is only available on the PRE3 for the Cisco 10000 series router.
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 setipnext-hopip-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 showpxfcpupbr 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 showpxfcpupbrtcam command shows the type of detailed VMR (value, plus a mask and result) information that displays:
To display all active policer policies in the Parallel eXpress Forwarding (PXF), including active interface and policing parameters, use the showpxfcpupolice command in privileged EXEC mode.
showpxfcpupolice [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
showpxfcpuvcci
Displays VCCI to interface mapping information.
showpxfstatistics
Displays chassis-wide, summary PXF statistics.
show pxf cpu policy-data
To display Parallel eXpress Forwarding (PXF) policy data index usage statistics, use the showpxfcpupolicy-data command in privileged EXEC mode.
showpxfcpupolicy-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
showpxfcpupbraction
Displays PBR actions configured in the PXF for all PBR route maps.
showpxfcpuvcci
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 theshowpxfcpuqos command in privileged EXEC mode.
(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.
Note
This option is only available on the Cisco 10000 series router for the PRE3.
policy-mappolicy-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:
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
showpxfcpuqueuecommand in privileged EXEC mode.
showpxfcpuqueue
[ interface | QID | summary ]
Cisco uBR10012 Universal Broadband Router
showpxfcpuqueue
[ 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:
Number of queues and recycled queues.
Number of available queue IDs (QIDs).
Number of packet buffers, recycled packet buffers, and free packet buffers.
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
showpxfcpuqueue 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
showpxfcpuqueuecommand. 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
showpxfcpuqueueinterfacesummary 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.
Table 9 show pxf cpu queue Interface Option Field Descriptions
Field
Description
<0-131071>
QID (queue identifier)
ATM
Asynchronous transfer mode interface
Note
The ATM interface output is not available for the Cicso uBR10012 universal broadband router.
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.
Enables DBS on a specific modular cable or wideband cable interface.
showpxfcablecontroller
Displays information about the RF channel VTMS links and link queues.
showpxfcpustatisticsqueue
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 showpxfcpureasm_index command in privileged EXEC mode.
showpxfcpureasm_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
ipvirtual-reassembly
Enables VFR information on an interface.
showipvirtual-reassembly
Displays VFR configuration and statistical information.
show pxf cpu statistics
To display Parallel eXpress Forwarding (PXF) CPU statistics, use the
showpxfcpustatisticscommand in privileged EXEC mode.
(Optional) Displays packets that the PXF diverted to the Route Processor (RP). Available on the Cisco 10000 series router only.
pxfinterfaceinterface
(Optional) Displays per-interface PXF statistical information for the divert cause policer on a particular interface. Available on the Cisco 10000 series router only.
pxfinterfacevcci
(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.
topnumber
(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,andwan-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
showpxfcpustatisticsdiversioncommand displays statistical information about diverted packets. Divert causes with the string "ipv6..." display as "v6..." in the output of all
showpxfcpustatisticsdiversioncommands
The output from the
showpxfcpustatisticsdiversionpxfcommand was enhanced in Cisco IOS Release 12.2(33)SB to display the provisioned burst size for any divert causes.
The
showpxfcpustatisticsdiversionpxfinterfaceinterfacecommand 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
showpxfcpustatisticsdiversionpxfinterfacevccicommand 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
showpxfcpustatisticsdiversiontopnumbercommand 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.
The table below describes the significant fields shown in the display.
Table 10 show pxf cpu statistics queue Field Descriptions
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
platformc10kdivert-policer
Configures the rate and burst size of the divert-policer.
showpxfstatistics
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
showpxfcpusubblocks command in privileged EXEC mode.
showpxfcpusubblocksinterface-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:
The table below describes the fields shown in the display.
Table 11 show pxf cpu subblocks Field Descriptions
Field
Description
Interface
Identifies the interface or subinterface.
Status
Displays the status of the interface:
Administ--The interface has been shut down and is in the administrative down state.
Deleted--The subinterface has been removed from the router's configuration.
Down--The interface is down because of a cable or other connectivity problem.
Initiali--The interface is in the process of initializing.
Reset--The interface is currently being reset.
Up--The interface is up and passing traffic.
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
clearpxf
Clears PXF counters and statistics.
debugpxf
Displays PXF debugging output.
showipmroute
Displays the contents of the IP multicast routing table.
showpxfcputbridge
Displays PXF CPU statistics for transparent bridging.
showpxfmicrocode
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 showpxfcpuvcci command in privileged EXEC mode.
showpxfcpuvcci [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
showpxfcpupolicy-data
Displays QoS policy data index usage statistics.
show pxf crash
To display Parallel eXpress Forwarding (PXF) crash information, use theshowpxfcrash command in privileged EXEC mode.
showpxfcrash
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.
Table 12 show pxf crash Field Descriptions
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
showpxfstatistics
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
showpxfdmacommand in privileged EXEC mode.
(Optional) Displays PXF DMA information, including the initialization state of each block in the PXF API and any errors that occurred.
Note
This option is available on the PRE3 only.
config
(Optional) Displays a configuration summary of the registers in each of the PXF DMA blocks.
Note
This option is available on the PRE3 only.
errors
(Optional) Displays the errors that occurred in each of the PXF DMA blocks.
Note
This option is available on the PRE3 only.
status
(Optional) Displays the initialization state of each PXF DMA block. In normal operation, all blocks display the enabled state.
Note
This option is available on the PRE3 only.
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.
Table 13 show pxf dma Field Descriptions
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
clearpxf
Clears PXF counters and statistics.
showpxfcpu
Displays PXF CPU statistics.
showpxfmicrocode
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 showpxffeaturecef command in user EXEC or privileged EXEC mode.
showpxffeaturecefentry
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 showpxffeaturecef command. The fields shown in the display are self-explanatory.
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
showpxffeaturecefvrfcommand in privileged EXEC mode.
showpxffeaturecefvrfvpn-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
showpxffeaturecefvrfcommand when it is used to display information about VRF vpn1:
The table below describes the significant fields shown in the display.
Table 14 show pxf feature cef vrf Field Descriptions
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
showpxffeaturecef
Displays PXF routing feature tables for CEF.
showpxffeaturenat
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 showpxffeaturenat command in user EXEC or privileged EXEC mode.
showpxffeaturenat
[ 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 showpxffeaturenatcommand. The fields shown in the display are self-explanatory.
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
showpxfinterface command in privileged EXEC mode.
showpxfinterfaceinterface-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
clearpxf
Clears PXF counters and statistics.
showpxfstatistics
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 theshowpxfmicrocodecommand in privileged EXEC mode.
showpxfmicrocode
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.
Table 15 show pxf microcode Field Descriptions
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
clearpxf
Clears PXF counters and statistics.
showpxfcpustatistics
Displays PXF CPU statistics.
showpxfdma
Displays PXF DMA information.
show pxf netflow
To display the NetFlow Parallel eXpress Forwarding (PXF) counters, use the
showpxfnetflow command in privileged EXEC mode.
showpxfnetflow
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.
To display the configuration and operating status details of the PXF stall monitor (PSM), use the showpxfstall-monitoring command in privileged EXEC mode. The showpxfstall-monitoring command also displays the number of stalls on the PSM after it was last enabled.
To display Parallel eXpress Forwarding (PXF) External Column Memory (XCM) information, use the
showpxfxcm command in privileged EXEC mode.
showpxfxcm
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.
Table 16 show pxf xcm Field Descriptions
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.
showpxfmicrocode
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
showroute-mapipccommand in privileged EXEC mode.
showroute-mapipc
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
showroute-mapipc 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
showroute-mapipc 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.
Table 17 show route-map ipc Field Descriptions
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
setipnext-hopverify-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 showxdr command in user EXEC or privileged EXEC mode.
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.
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:
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
showcefbroker
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 snmpmibcefthrottling-intervalcommand in global configuration mode. To remove the throttling interval, use the no form of this command.
snmpmibcefthrottling-intervalseconds
nosnmpmibcefthrottling-intervalseconds
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 thesnmp-serverenabletrapscefinconsistency 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:
Enables CEF-MIB notifications that correspond to Cisco Express Forwarding events.
snmp-serverhost
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-serverenabletrapscef command in global configuration mode. To disable Cisco Express Forwarding support of SNMP notifications, use the no form of this command.
(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 thesnmp-serverhost command with the cef keyword.
You can enable all CEF-MIB SNMP notifications if you enter thesnmp-serverenabletrapscefcommand 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-servercommunity
Configures a community access string to permit SNMP access to the local router by the remote SNMP software client.
snmp-serverhost
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-serverhost command in global configuration mode. To
remove the specified host from the configuration, use the
no form of this
command.
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.
In
Cisco IOS Release 12.2(54)SE, the
vrf keyword
is required.
vrf-name
(Optional) VPN VRF instance used to send SNMP notifications.
In
Cisco IOS Release 12.2(54)SE, the
vrf-name
argument is required.
informs
(Optional) Specifies that notifications should be sent as informs.
In
Cisco IOS Release 12.2(54)SE, the
informs
keyword is required.
traps
(Optional) Specifies that notifications should be sent as traps. This is the
default.
In
Cisco IOS Release 12.2(54)SE, the
traps keyword
is required.
version
(Optional) Specifies the version of the SNMP that is used to send the traps or
informs. The default is 1.
In
Cisco IOS Release 12.2(54)SE, the
version
keyword is required and the
priv keyword
is not supported.
If you
use the
version
keyword, one of the following keywords must be specified:
1--SNMPv1.
2c--SNMPv2C.
3--SNMPv3. The most secure model because it allows
packet encryption with the
priv keyword.
The default is
noauth.
One of
the following three optional security level keywords can follow the
3 keyword:
noauth--Specifies that the noAuthNoPriv security
level applies to this host. This is the default security level for SNMPv3.
priv--Enables Data Encryption Standard (DES) packet
encryption (also called “privacy”).
community-string
Password-like community string sent with the notification operation.
Note
You
can set this string using the
snmp-serverhost command by itself, but Cisco recommends that
you define the string using the
snmp-servercommunity command prior to using the
snmp-serverhost command.
Note
The
“at” sign (@) is used for delimiting the context information.
udp-port
(Optional) Specifies that SNMP traps or informs are to be sent to an network
management system (NMS) host.
In
Cisco IOS Release 12.2(54)SE, the
udp-port
keyword is not supported.
port
(Optional) User Datagram Protocol (UDP) port number of the NMS host. The
default is 162.
In
Cisco IOS Release 12.2(54)SE, the
port argument
is not supported.
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.
The
version3 [auth |
noauth |
priv] syntax
was added as part of the SNMPv3 Support feature.
The
hsrp
notification-type keyword was added.
The
voice
notification-type keyword was added.
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.
The
vrfvrf-name
keyword-argument pair was added.
The
ipmobile
notification-type keyword was added.
Support for the
vsimaster
notification-type keyword was added for the Cisco 7200 and Cisco 7500 series
routers.
12.2(4)T
This
command was modified.
The
pim
notification-type keyword was added.
The
ipsec
notification-type keyword was added.
12.2(8)T
This
command was modified.
The
mpls-traffic-eng notification-type keyword was
added.
The
director
notification-type keyword was added.
12.2(13)T
This
command was modified.
The
srp
notification-type keyword was added.
The
mpls-ldp
notification-type keyword was added.
12.3(2)T
This
command was modified.
The
flash
notification-type keyword was added.
The
l2tun-session
notification-type keyword was added.
12.3(4)T
This
command was modified.
The
cpu
notification-type keyword was added.
The
memory
notification-type keyword was added.
The
ospf
notification-type keyword was added.
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.
Support for SNMP over IPv6 transport was integrated into Cisco IOS Release
12.3(14)T. Either an IP or IPv6 Internet address can be specified as the
hostname
argument.
The
eigrp
notification-type keyword was added.
12.4(20)T
This
command was modified. The
license
notification-type keyword was added.
15.0(1)M
This
command was modified.
The
nhrp
notification-type keyword was added.
The
automatic insertion of the
snmp-servercommunity command into the configuration, along
with the community string specified in the
snmp-serverhost command, was changed. The
snmp-servercommunity command must be manually configured.
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.
All
features in Cisco IOS Release 12.0ST were integrated into Cisco IOS Release
12.0(22)S.
The
mpls-vpn
notification-type keyword was added.
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.
Support for SNMP over IPv6 transport was added. Either an IP or IPv6 Internet
address can be specified as the
hostname
argument.
The
vrfvrf-name
keyword and argument combination was added to support multiple Lightweight
Directory Protocol (LDP) contexts for VPNs.
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.
The
cpu
notification-type keyword was added.
The
memory
notification-type keyword was added.
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.
The
dhcp-snooping
notification-type keyword was added.
The
errdisable
notification-type keyword was added.
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
publicstorm-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
nosnmp-serverhost command with no keywords disables traps, but
not informs, to the host. To disable informs, use the
nosnmp-serverhostinforms command.
Note
If a community
string is not defined using the
snmp-servercommunity command prior to using this command, the
default form of thesnmp-servercommunity command will automatically be inserted
into the configuration. The password (community string) used for this automatic
configuration of the
snmp-servercommunity command will be the same as that
specified in the
snmp-serverhost 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-serverhost command, no notifications are sent. To
configure the router to send SNMP notifications, you must enter at least one
snmp-serverhost 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-serverhost command for each host. You can specify
multiple notification types in the command for each host.
When multiple
snmp-serverhost 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-serverhost command will be in effect. For example, if
you enter an
snmp-serverhostinform command for a host and then enter another
snmp-serverhostinform command for the same host, the second
command will replace the first.
The
snmp-serverhost command is used in conjunction with the
snmp-serverenable command. Use the
snmp-serverenable command to specify which SNMP notifications
are sent globally. For a host to receive most notifications, at least one
snmp-serverenable command and the
snmp-serverhost command for that host must be enabled.
Some notification
types cannot be controlled with the
snmp-serverenable command. Some notification types are always
enabled, and others are enabled by a different command. For example, the
linkUpDown
notifications are controlled by the
snmptraplink-status command. These notification types do
not require an
snmp-serverenable 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-serverhost 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.
aaaserver--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.
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-serverhost command do not always match the keywords used
in the corresponding
snmp-serverenabletraps 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-serverenabletraps command is specified as
mplstraffic-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-serverhost command as a unified, single-word construct,
which preserves the capability of the
snmp-serverhost command to accept multiple
notification-type keywords in the command line. The
snmp-serverenabletraps 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-serverenabletraps commands to the keywords used in the
snmp-serverhost command.
Table 18 snmp-server enable traps
Commands and Corresponding Notification Keywords
1 See the
Cisco
IOS Multiprotocol Label Switching Command Reference for documentation of
this command.
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-serverhost command. The community string is defined as
comaccess.
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:
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.
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":
Displays recipient details configured for SNMP notifications.
snmp-serverenablepeer-trappoorqov
Enables
poor quality of voice notifications for applicable calls associated with a
specific voice dial peer.
snmp-serverenabletraps
Enables
SNMP notifications (traps and informs).
snmp-serverenabletrapsnhrp
Enables
SNMP notifications (traps) for NHRP.
snmp-serverinforms
Specifies inform request options.
snmp-serverlinktrap
Enables
linkUp/linkDown SNMP traps that are compliant with RFC 2233.
snmp-servertrap-source
Specifies the interface from which an SNMP trap should originate.
snmp-servertrap-timeout
Defines
how often to try resending trap messages on the retransmission queue.
testsnmptrapstorm-controlevent-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 switchoverpxfrestartcommand in redundancy configuration (main-cpu) mode. To disable switchovers due to PXF restarts, use the no form of this command.
switchoverpxfrestartnumber-of-restartstime-period
noswitchoverpxfrestart
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.
Note
A value of 0 specifies that a switchover occurs on the configured number-of-restarts regardless of the time period.
Command Default
If this command is not configured, the default is 2 PXF restarts within 5 hours.
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.
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.
redundancyforce-failovermain-cpu
Forces a manual switchover between the active and standby PRE modules.
showredundancy
Displays the current redundancy status.
test cef table consistency
To test the Cisco Express Forwarding Forwarding Information Base (FIB) for prefix consistency, use the
testceftableconsistency command in privilege EXEC mode.
testceftableconsistency [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 theshowipcefinconsistencycommand.
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
ceftableconsistency-check command.
Examples
The following is sample output from the
testceftableconsistency 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
testceftableconsistencydetailcommand:
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.
Table 19 test cef consistency detail Field Descriptions
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.