Cisco

Release 3.
2 Beta DraftCisco Highly Conf idential Information
Cisco IOS XR Interface and Hardware Component Command Reference

Cisco IOS XR Software Release 3.2
Corporate Headquarters Cisco Systems, Inc. 170 West Tasman Drive San Jose, CA 95134-1706 USA http://www.cisco.com Tel: 408 526-4000 800 553-NETS (6387) Fax: 408 526-4100
Text Part Number: OL-5563-03
THE SPECIFICATIONS AND INFORMATION REGARDING THE PRODUCTS IN THIS MANUAL ARE SUBJECT TO CHANGE WITHOUT NOTICE. ALL STATEMENTS, INFORMATION, AND RECOMMENDATIONS IN THIS MANUAL ARE BELIEVED TO BE ACCURATE BUT ARE PRESENTED WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED. USERS MUST TAKE FULL RESPONSIBILITY FOR THEIR APPLICATION OF ANY PRODUCTS. THE SOFTWARE LICENSE AND LIMITED WARRANTY FOR THE ACCOMPANYING PRODUCT ARE SET FORTH IN THE INFORMATION PACKET THAT SHIPPED WITH THE PRODUCT AND ARE INCORPORATED HEREIN BY THIS REFERENCE. IF YOU ARE UNABLE TO LOCATE THE SOFTWARE LICENSE OR LIMITED WARRANTY, CONTACT YOUR CISCO REPRESENTATIVE FOR A COPY. The Cisco implementation of TCP header compression is an adaptation of a program developed by the University of California, Berkeley (UCB) as part of UCBs public domain version of the UNIX operating system. All rights reserved. Copyright 1981, Regents of the University of California. NOTWITHSTANDING ANY OTHER WARRANTY HEREIN, ALL DOCUMENT FILES AND SOFTWARE OF THESE SUPPLIERS ARE PROVIDED AS IS WITH ALL FAULTS. CISCO AND THE ABOVE-NAMED SUPPLIERS DISCLAIM ALL WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION, THOSE OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OR ARISING FROM A COURSE OF DEALING, USAGE, OR TRADE PRACTICE. IN NO EVENT SHALL CISCO OR ITS SUPPLIERS BE LIABLE FOR ANY INDIRECT, SPECIAL, CONSEQUENTIAL, OR INCIDENTAL DAMAGES, INCLUDING, WITHOUT LIMITATION, LOST PROFITS OR LOSS OR DAMAGE TO DATA ARISING OUT OF THE USE OR INABILITY TO USE THIS MANUAL, EVEN IF CISCO OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
CCSP, CCVP, the Cisco Square Bridge logo, Follow Me Browsing, and StackWise are trademarks of Cisco Systems, Inc.; Changing the Way We Work, Live, Play, and Learn, and iQuick Study are service marks of Cisco Systems, Inc.; and Access Registrar, Aironet, ASIST, BPX, Catalyst, CCDA, CCDP, CCIE, CCIP, CCNA, CCNP, Cisco, the Cisco Certified Internetwork Expert logo, Cisco IOS, Cisco Press, Cisco Systems, Cisco Systems Capital, the Cisco Systems logo, Cisco Unity, Empowering the Internet Generation, Enterprise/Solver, EtherChannel, EtherFast, EtherSwitch, Fast Step, FormShare, GigaDrive, GigaStack, HomeLink, Internet Quotient, IOS, IP/TV, iQ Expertise, the iQ logo, iQ Net Readiness Scorecard, LightStream, Linksys, MeetingPlace, MGX, the Networkers logo, Networking Academy, Network Registrar, Packet, PIX, Post-Routing, Pre-Routing, ProConnect, RateMUX, ScriptShare, SlideCast, SMARTnet, StrataView Plus, TeleRouter, The Fastest Way to Increase Your Internet Quotient, and TransPath are registered trademarks of Cisco Systems, Inc. and/or its affiliates in the United States and certain other countries. All other trademarks mentioned in this document or Website are the property of their respective owners. The use of the word partner does not imply a partnership relationship between Cisco and any other company. (0502R)
Cisco IOS XR Interface and Hardware Component Command Reference Copyright 2005 Cisco Systems, Inc. All rights reserved.
Release 3.2 Beta DraftCisco Highly Conf idential Information
802.1Q VLAN Commands on Cisco IOS XR Software

This module contains commands for configuring and monitoring 802.1Q VLAN commands on Cisco IOS XR software.
HR-3
802.1Q VLAN Commands on Cisco IOS XR Software dot1q native vlan
dot1q native vlan

To assign the native VLAN ID of a physical interface trunking 802.1Q VLAN traffic, use the dot1q native vlan command in interface configuration mode. To remove the VLAN ID assignment, use the no form of this command. dot1q native vlan vlan-id no dot1q native vlan vlan-id
Syntax Description
vlan-id
Trunk interface ID. Range is from 1 to 4094 inclusive (0 and 4095 are reserved).
Command Modes
Interface configuration
Command History
Release Release 3.0 Release 3.1
Modification This command was introduced on the Cisco CRS-1. No modification.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. The dot1q native vlan command defines the default, or native VLAN, associated with a 802.1Q trunk interface. The native VLAN of a trunk interface is the VLAN to which all untagged VLAN packets are logically assigned.
Note
The native VLAN cannot be configured on a subinterface of the trunk interface. The native VLAN must be configured with the same value at both ends of the link, or traffic can be lost or sent to the wrong VLAN.
Examples
The following example shows how to configure the native VLAN of a TenGigE0/2/0/4 trunk interface as 1. Packets received on this interface that are untagged, or that have an 802.1Q tag with VLAN ID 1, are received on the main interface. Packets sent from the main interface are transmitted without an 802.1Q tag.
RP/0/RP0/CPU0:router(config)# interface TenGigE 0/2/0/4 RP/0/RP0/CPU0:router(config-if)# dot1q native vlan 1 RP/0/RP0/CPU0:router# commit RP/0/RP0/CPU0Jul 29 05:26:14.178 : config[65546]: %LIBTARCFG-6-COMMIT : Configuration committed by user 'lab'. Use 'show commit changes 1000002331' to view the changes.
HR-4
802.1Q VLAN Commands on Cisco IOS XR Software dot1q native vlan
Related Commands
Command dot1q vlan
Description Assigns a VLAN ID to a subinterface, or changes the VLAN ID assigned to a subinterface.
HR-5
802.1Q VLAN Commands on Cisco IOS XR Software dot1q vlan
dot1q vlan
To assign a VLAN ID to a subinterface (or to change the VLAN ID assigned to a subinterface) use the dot1q vlan command in subinterface configuration mode. To remove the VLAN ID assigned to a subinterface, use the no form of this command. dot1q vlan vlan-id no dot1q vlan vlan-id
Syntax Description
vlan-id
ID of the subinterface. Range is from 1 to 4094 inclusive (0 and 4095 are reserved).
Command Modes
Subinterface configuration
Command History
Modification This command was introduced on the Cisco CRS-1. This command was first supported on the Cisco 12000 Series router.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. The VLAN ID specifies where 802.1Q tagged packets are sent and received on a specified subinterface. An 802.1Q VLAN subinterface must have a configured VLAN ID to send and receive traffic; without a VLAN ID, the subinterface remains in the down state. All VLAN IDs must be unique among all subinterfaces configured on the same physical interface. To change a VLAN ID, the new VLAN must not already be in use on the same physical interface. To exchange VLAN IDs, you must remove the configuration information and reconfigure the ID for each device.
Note
The subinterface does not pass traffic without an assigned VLAN ID.
Examples
The following example shows how to configure the VLAN ID and IP address on a subinterface:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# interface TenGigE 0/2/0/4.1 RP/0/RP0/CPU0:router(config-subif)# dot1q vlan 10 RP/0/RP0/CPU0:router(config-subif)# ip addr 10.0.0.1/24 RP/0/RP0/CPU0:router(config-subif)# commit RP/0/RP0/CPU0Jul 29 05:14:25.536 : config[65546]: %LIBTARCFG-6-COMMIT : Configuration committed by user 'lab'. Use 'show commit changes 1000002330' to view the changes.
HR-6
802.1Q VLAN Commands on Cisco IOS XR Software dot1q vlan
Related Commands
Command dot1q native vlan
Description Defines the native VLAN ID associated with a VLAN trunk.
HR-7
802.1Q VLAN Commands on Cisco IOS XR Software interface (VLAN)
interface (VLAN)
To create a VLAN subinterface, use the interface command in global configuration mode. To delete a subinterface, use the no form of this command. interface type instance subinterface no interface type instance subinterface
Syntax Description
type instance
Interface type. For more information, use the question mark (?) online help function. For VLANs, this is one of the Gigabit Ethernet interfaces. Either a physical interface instance or a virtual interface instance:
Physical interface instance. Naming notation is rack/slot/module/port and a slash mark between values is required as part of the notation.
rackChassis number of the rack. slotPhysical slot number of the card. moduleModule number. A physical layer interface module
(PLIM) is always 0.
portPhysical port number of the interface. Note
In references to a Management Ethernet interface located on a route processor card, the physical slot number is alphanumeric (RP0 or RP1) and the module is CPU0. Example: interface MgmtEth0/RP1/CPU0/0. Virtual interface instance. Range of numbers varies depending on interface type.
For more information about the syntax for the router, use the question mark (?) online help function. subinterface Subinterface value. Range is from 0 to 4095.
Command Modes
Global configuration
Command History
HR-8
802.1Q VLAN Commands on Cisco IOS XR Software interface (VLAN)
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. To configure a large number of subinterfaces, it is advisable to enter all configuration data before you commit the interface command.
Note
A subinterface does not pass traffic without an assigned VLAN ID.
Examples
The following example shows how to configure a VLAN subinterface on a 10-Gigabit Ethernet interface:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# interface TenGigE 0/0/0/1.2 RP/0/RP0/CPU0:router(config-subif)# dot1q vlan 1 RP/0/RP0/CPU0:router(config-subif)# ipv4 address 50.0.0.1/24
Related Commands
Command dot1q native vlan dot1q vlan
Description Defines the native VLAN ID associated with a VLAN trunk. Assigns a VLAN ID to a subinterface, or changes the VLAN ID assigned to a subinterface.
HR-9
802.1Q VLAN Commands on Cisco IOS XR Software show vlan interface
show vlan interface

To display summary information about VLAN subinterfaces, use the show vlan interface command in EXEC mode. show vlan interface [type instance] [location node-id]
Syntax Description
interface type instance location node-id
(Optional) Displays the interface or subinterface specified by type and instance. If the interface is not a VLAN, no information is displayed. (Optional) Displays VLAN interfaces and subinterfaces on the slot. The node-id argument is entered in the rack/slot/module notation.
Command Modes
EXEC
Command History
Modification This command was introduced Cisco CRS-1. This command was first supported on the Cisco 12000 Series router.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. Use the show vlan interface command to show brief VLAN-specific information about a VLAN subinterface.
Examples
The following is sample output from the show vlan interface command, which shows a router with three configured subinterfaces (one on Te0/2/0/4 and two on Te0/2/0/5):
RP/0/RP0/CPU0:router# show vlan interface interface Te0/2/0/4.1 Te0/2/0/5.10 Te0/2/0/5.20 encapsulation 802.1Q 802.1Q 802.1Q vlan-id 10 10 20 intf-state up admin-down admin-down
RP/0/RP0/CPU0:router# show vlan interface TenGigE 0/2/0/5.10 interface Te0/2/0/5.10 encapsulation 802.1Q vlan-id 10 intf-state admin-down
RP/0/RP0/CPU0:router# show vlan interface location 0/2/CPU0 interface Te0/2/0/4.1 Te0/2/0/5.10 Te0/2/0/5.20 encapsulation 802.1Q 802.1Q 802.1Q vlan-id 10 10 20 intf-state up admin-down admin-down
HR-10
802.1Q VLAN Commands on Cisco IOS XR Software show vlan interface
Table 1 describes the significant fields shown in the display

Table 1 show vlan interface Field Descriptions
Field interface encapsulation vlan-id intf-state
Description VLAN subinterface. Encapsulation of the VLAN subinterface. Currently, this is always 802.1Q. VLAN ID currently assigned to the subinterface. Range is from 1 to 4094 (or blank if no VLAN ID has been assigned). Displays the state of the VLAN interface. Possible states: up, down, admin-down.
Related Commands
Command show interface show interfaces all accounting show vlan trunks
Description Displays statistics for all interfaces configured on the router. These statistics include VLAN L2 interface statistics. Displays Layer 3 protocol statistics for all interfaces and subinterfaces. Displays summary information about VLAN trunk interfaces.
HR-11
802.1Q VLAN Commands on Cisco IOS XR Software show vlan trunks
show vlan trunks

To display summary information about VLAN trunk interfaces, use the show vlan trunks command in EXEC mode. show vlan trunks [brief | summary] [location node-id] [interface type instance]
Syntax Description
brief summary location node-id
(Optional) Displays a short summary output. (Optional) Displays a summary output. (Optional) Displays VLAN trunk interfaces and subinterfaces on the slot specified by node-id. The node-id argument is entered in the rack/slot/module notation. (Optional) Displays the trunk interface or subinterface specified by type and instance. If the trunk interface is not VLAN, no information is displayed. Use an asterisk (*) in place of the type and instance pair to show all trunk interfaces and subinterfaces.
interface type instance
Command Modes
EXEC
Command History
Modification This command was introducedCisco CRS-1. This command was first supported on the Cisco 12000 Series router.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. The show vlan trunks command provides summary information about VLAN trunk interfaces. It is used to determine the number of configured subinterfaces and verify the state of the subinterfaces.
Examples
The following is sample output from the show vlan trunks command, which displays information about all VLAN trunk interfaces on the router:
RP/0/RP0/CPU0:router# show vlan trunks TenGigE0/2/0/4 is up Encapsulations: 802.1Q (Native) Sub-interfaces: 1, 1 are up. 802.1Q VLANs: 1, 1 have VLAN Ids, Native VLAN Id is 1. TenGigE0/2/0/5 is administratively down Encapsulations: 802.1Q (Ether) Sub-interfaces: 3, 0 are up, 3 are admin-down.
HR-12
802.1Q VLANs: 3, 2 have VLAN Ids, No native VLAN.
Table 2 describes the significant fields shown in the display.

Table 2 show vlan trunks Field Descriptions
Field Encapsulations
Description Displays the encapsulation configured on this trunk interface. Possible values are 802.1Q (Ether) or 802.1Q (Native), which indicates whether a native VLAN has been configured on the trunk. Displays the number of subinterfaces that are configured on the trunk interface and how many of those interfaces are in up, down, or admin-down states. Displays the number of subinterfaces that are configured as 802.1Q VLANs, with VLAN IDs, or native VLANs.
Sub-interfaces
802.1Q VLANs
The following is sample output from the show vlan trunks brief command, which displays a short summary of information about all VLAN trunk interfaces on the router:
RP/0/RP0/CPU0:router# show vlan trunks brief interface Te0/2/0/4 Te0/2/0/5 encapsulations 802.1Q (Native) 802.1Q (Ether) intf-state up admin-down

Table 3 show vlan trunks brief Field Descriptions
Field interface encapsulations
Description The VLAN subinterface. Displays the encapsulation configured on this trunk interface. Possible values are 802.1Q (Ether) or 802.1Q (Native), which indicates whether a native VLAN has been configured on the trunk. Defines the interface state of the trunk interface. The values are up, down, and admin-down.
intf-state
The following is sample output from the show vlan trunks summary command, which displays summarized information about all VLAN trunk interfaces on the router:
RP/0/RP0/CPU0:router# show vlan trunks summary VLAN trunks: 2, 1 are 802.1Q (Native), 1 are 802.1Q (Ether). Sub-interfaces: 4, 1 are up, 3 are admin-down. 802.1Q VLANs: 4, 3 have VLAN Ids.
HR-13
Table 4
show vlan trunks summary Field Descriptions
Field VLAN trunks Sub-interfaces
Description Number of VLAN trunks configured on the device (or at the specified location) and number of encapsulations. Number of subinterface configured on the device (or at the specified location), and how many of those subinterfaces are in each state (up, down, admin-down). Number of 802.1Q VLAN subinterfaces configured on the device and number with configured VLAN IDs.
802.1Q VLANs
Related Commands
Command interface (VLAN)
Description Displays summary information about each of the VLAN interfaces and subinterfaces.
HR-14
cHDLC Commands on Cisco IOS XR Software

This module describes the Cisco High-Level Data Link Control (cHDLC) and Serial Line Address Resolution Protocol (SLARP) commands on Cisco IOS XR software. cHDLC is a Cisco version of standard HDLC encapsulation, a bit-oriented synchronous data link layer protocol. HDLC specifies a data encapsulation method on synchronous serial links using frame characters and checksums. cHDLC also provides a simple control protocol called SLARP, which is used to maintain serial link keepalives.
HR-15
cHDLC Commands on Cisco IOS XR Software keepalive
keepalive
To set the keepalive timer for a specific interface, use the keepalive command in interface configuration mode. To turn off the keepalive timer, use the no form of this command or use the disable keyword. keepalive {seconds | disable} no keepalive
Syntax Description
seconds disable
Number of seconds that define the keepalive interval. Default is 10 seconds. Turns off the keepalive timer.
Defaults
seconds: 10 seconds
Command Modes
Command History
Release Release 2.0 Release 3.0 Release 3.1
Modification This command was introduced on the Cisco CRS-1. No modification. This command was first supported on the Cisco 12000 Series router.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. cHDLC keepalives require that the keepalive command is configured the same way on both routers. The two connected routers have no way of negotiating the keepalive value because there is no way for the routers to tell each other what their configured values are. The keepalive value configured on each router (local and partner) sets the rate at which the Cisco IOS XR software sends packets. It also sets the rate at which the local end expects to receive incoming packets To set the keepalive value to the default value, use the keepalive command without specifying a value for the seconds argument. If three keepalives are sent to the peer and no response is received from peer, then the link makes the transition to the down state.
Examples
The following example shows how to configure keepalives for 3 seconds on PoS interface 0/7/0/1:
RP/0/RP0/CPU0:router(config)# interface POS 0/7/0/1 RP/0/RP0/CPU0:router(config-if)# keepalive 3 RP/0/RP0/CPU0:router(config-if)# end
HR-16
cHDLC Commands on Cisco IOS XR Software encapsulation hdlc
encapsulation hdlc
To set the Layer 2 media of an interface, use the encapsulation hdlc command in interface configuration mode. To restore the system to the default HDLC encapsulation, use the no form of this command. encapsulation hdlc no encapsulation
Syntax Description
This command has no arguments or keywords.
Defaults
For Packet-over-SONET (PoS) interfaces, the default encapsulation is HDLC.
Command Modes
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. Use the encapsulation hdlc command to configure HDLC encapsulation on an interface. Some interfaces do not support any encapsulation other than the default encapsulation, in which case this command is not available.
Examples
In the following example, HDLC serial encapsulation is set on PoS interface 0/3/0/1:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# interface POS 0/3/0/1 RP/0/RP0/CPU0:router(config-if)# encapsulation hdlc
Related Commands
Command show interface
Description Displays statistics for all interfaces configured on the router.
HR-17
cHDLC Commands on Cisco IOS XR Software encapsulation hdlc
HR-18
Platform and Driver Commands on Cisco IOS XR Software

This module describes the hardware platform commands used to configure and monitor the router using the Cisco CRS-1 Carrier Routing System and the Cisco 12000 Series router.
HR-19
Platform and Driver Commands on Cisco IOS XR Software clear card-message
clear card-message
To remove the user-specified message that is displayed on the LED on the front panel of one or more line cards, and revert to the normal status message for the line card, use the clear card-message command in Admin EXEC mode. clear card-message {all | slot node-id}
Syntax Description
all slot node-id
Clears the user-specified LED message on all line cards. Identifies the location of the node whose LED message you want to clear. The node-id is expressed in the rack/slot/module notation.
Note
Enter the show platform command to see the location of all nodes installed in the router.
Defaults
No default behavior or values
Command Modes
Admin EXEC
Command History
Release Release 3.1
Modification This command was introduced on the Cisco 12000 Series router.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Examples
The following example shows how to clear the LED card message on all line cards installed in a router:
RP/0/0/CPU0:routername(admin)# clear card-message all RP/0/0/CPU0:routername(admin)#
Related Commands
Command set card-message
Description Specifies the message that is displayed on the LED on the front panel of one or more line cards.
HR-20
Platform and Driver Commands on Cisco IOS XR Software clear controller egressq queue
clear controller egressq queue

To clear a specific controller egress queue, use the clear controller egressq queue command in EXEC mode. clear controller egressq queue queue-id1 [queue-id2] location node-id
Syntax Description
queue-id1 queue-id2 location node-id
Queue you want to clear. Replace queue-id1 with a queue number. Range is from 1 through 8191. (Optional) Last queue in a range of queues to clear. Replace queue-id1 with a queue number. Range is from 1 through 8191. Identifies the location of the node whose egress queue you want to clear. The node-id is expressed in the rack/slot/module notation.
Note
Command Modes
EXEC
Command History
Modification This command was introduced on the Cisco CRS-1. No modification. No modification.
Usage Guidelines
Note
If you enter the optional [queue-id2] argument after you enter the queue-id1 argument, then the queue-id1 argument specifies the first queue in a range of queues to be cleared. If you enter the queue-id1 argument without specifying the queue-id2 argument, then only the queue specified for queue-id1 is cleared.
Examples
The following example shows how to clear a specific controller egress queue:
RP/0/0/CPU0:router# clear controller egress queue 1 location 0/1/CPU0 RP/0/0/CPU0:router#
Related Commands
Command clear controller egressq queue all
Description Clears all controller egress queues in the specified location.
HR-21
Platform and Driver Commands on Cisco IOS XR Software clear controller egressq queue all
clear controller egressq queue all

To clear all controller egress queues on a specific node, use the clear controller egressq queue all command in EXEC mode. clear controller egressq queue all location node-id
Syntax Description
all location node-id
Clears all egress queues in the specified location. Identifies the location of the egressq queue you want to clear. The node-id is expressed in the rack/slot/module notation.
Note
Command Modes
EXEC
Command History
Usage Guidelines
Examples
The following example shows how to clear all controller egress queues on a specific node:
RP/0/0/CPU0:router# clear controller egress queue all location 0/1/CPU0 RP/0/0/CPU0:router#
Related Commands
Command clear controller egressq queue
Description Clears a specific controller egress queue.
HR-22
Platform and Driver Commands on Cisco IOS XR Software clear controller egressq statistics
clear controller egressq statistics

To clear the egress queue statistics in a specific location, use the clear controller egressq statistics command in EXEC mode. clear controller egressq statistics location node-id
Syntax Description
location node-id
Identifies the location of the egressq queue you want to clear. The node-id is expressed in the rack/slot/module notation.
Note
Command Modes
EXEC
Command History
Usage Guidelines
Examples
The following example shows how to clear all controller egress queue statistics on a specific node:
RP/0/0/CPU0:router# clear controller egressq statistics location 0/1/CPU0 RP/0/0/CPU0:router#
HR-23
Platform and Driver Commands on Cisco IOS XR Software clear controller pse statistics
clear controller pse statistics

To clear statistics maintained by the packet switching engine (PSE) on a specific PSE device instance, or on a specific node, use the clear controller pse statistics command in EXEC mode. clear controller pse statistics [instance {0 | 1}] [location node-id]
Syntax Description
instance {0 | 1}
(Optional) Identifies the PSE device whose statistics you want to clear. Enter 0 to specify the ingress PSE device, or enter 1 to specify the egress PSE device.
Note
Follow the instance {0 | 1} argument with the location node-id argument to restrict the command to specific node containing the specified device instance.
location node-id
(Optional) Identifies the location of the node whose PSE device statistics you want to clear. The node-id is expressed in the rack/slot/module notation.
Note
Enter the show platform command to see the location of all nodes installed in the router. Include the instance {0 | 1} argument before the location node-id argument to restrict the command to a specific device instance on the specified node.
Note
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. The instance keyword directs the clear controller pse statistics command to a specific PSE device, and the location keyword directs the clear controller pse statistics command to that device or devices on the specified modular services card. You can specify the instance and location keywords together in the same command. If the instance and location arguments are not specified, the command takes effect on both device instances on all modular services cards.
HR-24
Platform and Driver Commands on Cisco IOS XR Software clear controller pse statistics
Examples
The following example shows how to clear PSE statistics on a specific instance of the controller (instance 1):
RP/0/0/CPU0:router# clear controller pse statistics instance 1 RP/0/0/CPU0:router#
The following example shows how to clear all PSE statistics on a specific node (0/1/CPU0):
RP/0/0/CPU0:router# clear controller pse statistics location 0/1/CPU0 RP/0/0/CPU0:router#
Related Commands
Command show controllers pse eio links show controllers pse ipc show controllers pse mp show controllers pse statistics show controllers pse summary
Description Displays PSE information for EIO (Elastic I/O) links, or for a specific controller. Displays PSE information for IPC connections, or for a specific IPC controller. Displays PSE information for the maintenance processor on a specific controller or node. Displays PSE statistics for a specific controller instance, or for a specific node. Displays a summary of PSE information for a specific controller or node.
HR-25
Platform and Driver Commands on Cisco IOS XR Software full-duplex
full-duplex
To configure full-duplex operation on a Management Ethernet interface, use the full-duplex command in interface configuration mode. To return the system to autonegotiate duplex operation, use the no form of the full-duplex command. full-duplex no full-duplex
Syntax Description
Defaults
Autonegotiates duplex operation
Command Modes
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. The full-duplex command automatically replaces the half-duplex command if half duplex was previously configured on your router.
Note
The full-duplex command and the half-duplex command cannot be configured simultaneously.
Examples
The following example shows how to set the Management Ethernet interface at full duplex:
RP/0/RP0/CPU0:router(config)# interface mgmteth 0/RP0/CPU0/0 RP/0/RP0/CPU0:router(config-if)# full-duplex
HR-26
Platform and Driver Commands on Cisco IOS XR Software full-duplex
Related Commands
Command half-duplex show controllers mgmteth show interfaces speed
Description Configures half-duplex operation on a Management Ethernet interface. Displays the register values of the Management Ethernet controller. Displays statistics for all interfaces configured on the router. Configures the speed for a Management Ethernet interface.
HR-27
Platform and Driver Commands on Cisco IOS XR Software half-duplex
half-duplex
To configure half-duplex operation on a Management Ethernet interface, use the half-duplex command in interface configuration mode. To return the system to autonegotiate duplex operation, use the no form of the half-duplex command. half-duplex no half-duplex
Syntax Description
Defaults
Autonegotiates duplex operation
Command Modes
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. The half-duplex command automatically replaces the full-duplex command if full duplex was previously configured on your router.
Note
The half-duplex command and the full-duplex command cannot be configured simultaneously.
Examples
The following examples shows how to set the Management Ethernet interface at half duplex:
RP/0/RP0/CPU0:router(config)# interface mgmteth 0/RP0/CPU0/0 RP/0/RP0/CPU0:router(config-if)# half-duplex
HR-28
Platform and Driver Commands on Cisco IOS XR Software half-duplex
Related Commands
Command full-duplex show controllers mgmteth show interfaces speed
Description Configures full-duplex operation on a Management Ethernet interface. Displays the register values of the Management Ethernet controller. Displays statistics for all interfaces configured on the router. Configures the speed for a Management Ethernet interface.
HR-29
Platform and Driver Commands on Cisco IOS XR Software hw-module location
hw-module location
To configure various hardware attributes for a specific node, or for all nodes installed in the router, use the hw-module location command. The syntax and tasks performed by the hw-module location command differ, depending on the command mode you are running when you enter the hw-module location command. To reset a specific node, use the hw-module location command in Admin EXEC or EXEC mode as follows: hw-module location {node-id | all} reload path To disable the power, monitor, or shutdown states of the hardware on a specific node, or on all nodes installed in the router, use the hw-module location command in admin configuration mode as follows: hw-module location {node-id {power disable | reset auto disable | shutdown} | all reset auto disable}
Syntax Description
node-id
Identifies the node you want to configure. The node-id is expressed in the rack/slot/module notation.
Note
all reload path
(Optional) Resets the hardware for all nodes on the router. Resets power-cycle, reload hardware, or both on a specific node. Specifies a specific image you want to download onto the specific node or nodes. Replace path with the TFTP or disk path to the image you want to download. Disables the power state on the specified node. Disables the auto monitor state on the specified node. Disables the shutdown state on the specified node. Disables the auto monitor state on on all nodes installed in the router.
power disable reset auto disable shutdown all reset auto disable
Defaults
Command Modes
EXEC admin EXEC admin configuration
Command History
Release Release 3.1
HR-30
Platform and Driver Commands on Cisco IOS XR Software hw-module location
Usage Guidelines
Note
By default, the node remains powered until you specify that you want it powered down with the hw-module location node-id power disable command.
Examples
The following example shows how to reset the hardware on all nodes in the router:
RP/0/0/CPU0:routername(admin)# hw-module location all reload RP/0/0/CPU0:routername(admin)#
The following example shows how to reset the hardware on a specific node:
RP/0/0/CPU0:routername(admin)# hw-module location 0/3/CPU0 reload RP/0/0/CPU0:routername(admin)#
HR-31
Platform and Driver Commands on Cisco IOS XR Software hw-module subslot
hw-module subslot
To shut down the subslot hardware (spa or bay) or power-cycle on a specific node, use the hw-module subslot command. The syntax and tasks performed by the hw-module subslot command differ, depending on the command mode you are running when you enter the hw-module subslot command. To reset the subslot (SPA or bay) power-cycle or hardware for a specific node, use the hw-module subslot command in EXEC mode as follows: hw-module subslot node-id {power-cycle | reload} To shut down the subslot (SPA or bay) hardware for a specific node, use the hw-module subslot command in global configuration mode as follows: hw-module subslot node-id shutdown {powered | unpowered}
Syntax Description
node-id
Identifies the subslot (SPA/bay) whose hardware module power cycle or reload hardware you want to reset. Enter the subslot keyword, and replace the node-id argument with the location of the node you want to reset. The node-id argument is expressed in the rack/slot/module notation, as showed in the following example:
subslot 0/3/CPU0
To reset the nodes power cycle, follow the subslot node-id argument with the power-cycle argument. To reset the nodes hardware, follow the subslot word argument with the reload argument. power-cycle reload shutdown Resets the subslot (SPA or bay) power cycle. Resets the subslot (SPA or bay) hardware. Shuts down the subslot (SPA/bay) for the specified hardware module. If you enter the shutdown keyword without specifying the powered or unpowered keywords, the node itself remains powered while the subslot hardware is powered down. Keeps the node powered while the subslot is shut down.
Note
powered
By default, the node remains powered until you specify that you want in powered down with the unpowered keyword.
unpowered
Powers down the entire node, as well as the subslot.
Defaults
Command Modes
EXEC Global configuration
Command History
Release Release 3.1
HR-32
Platform and Driver Commands on Cisco IOS XR Software hw-module subslot
Usage Guidelines
Examples
The following example shows how to reset the hardware on all nodes in the router:
RP/0/0/CPU0:routername(config)# hw-module subslot 0/0/CPU0 shutdown powered WORD RP/0/0/CPU0:routername(config)#
HR-33
Platform and Driver Commands on Cisco IOS XR Software mac-address
mac-address
To set the MAC layer address of the Management Ethernet interface, use the mac-address command in interface configuration mode. To return the device to its default MAC address, use the no form of the mac-address command. mac-address value1.value2.value3 no mac-address
Syntax Description
value1. value2. value3
High 2 bytes of the MAC address in hexadecimal. Range is from 0 to ffff. Middle 2 bytes of the MAC address in hexadecimal. Range is from 0 to ffff. Low 2 bytes of the MAC address in hexadecimal. Range is from 0 to ffff.
Defaults
The default MAC address is read from the hardware burned-in address (BIA).
Command Modes
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. The MAC address must be in the form of three 4-digit values (12 digits in dotted decimal notation).
Examples
The following example shows how to set the MAC address of the Management Ethernet interface located at 0/RP0/CPU0/0:
RP/0/RP0/CPU0:router(config)# interface mgmteth 0/RP0/CPU0/0 RP/0/RP0/CPU0:router(config-if)# mac-address 0001.2468.ABCD
HR-34
Platform and Driver Commands on Cisco IOS XR Software set card-message
set card-message
To create a new LED maintenance message that will be displayed by sysldr, use the set card-message command in EXEC mode. set card-message {all | slot node-id} [blink interval] [expire expire] string1 string2
Syntax Description
all slot node-id string1
Sets the card message so that it appears for all nodes in the router. Sets the card message so that it appears for a specific node only. The node-id argument is expressed in the rack/slot/module notation. Creates an LED message that blinks on and off at a set interval. The string1 argument can be no more that four characters.
Note
You can set the interval at which the message blinks on and off by entering the set card-message blink interval argument.
string2
Creates an LED message that blinks on and off at a set interval. The string2 argument can be no more that four characters.
Note
You can set the interval at which the message blinks on and off by entering the set card-message blink interval argument.
blink interval
(Optional) Sets the interval, in seconds, at which the card message blinks on and off. The message blinks for the number of seconds set with the expire seconds argument. The range is from 1 through 10.
Note
If you want to set the blink time, you must include the string1 string2 arguments in the command string, as shown in the following example: set card-message blink interval string1 string2
expire seconds
(Optional) Sets the number of seconds after which the card message stops blinking. The range is from 0 through 31536000.
Note
If you want to set the expire time, you must include the string1 string2 arguments in the command string, as shown in the following example: set card-message expire seconds string1 string2
Command Modes
EXEC
Command History
Release Release 3.1
Usage Guidelines
HR-35
Platform and Driver Commands on Cisco IOS XR Software set card-message
Use the set card-message command to overwrite an LED message for string1 and string 2. The set card-message command results in a user specified LED string, which is displayed for specified interval. When the specified interval expires, the original LED message values (for string 1 and string 2) are restored.
Examples
The following example show how to create an LED message on all nodes in the router. In this example, the message is represented by the words msg1 and msg2.
RP/0/0/CPU0:routername# set card-message all msg1 msg2 RP/0/0/CPU0:routername#
The following example shows how to create an LED message that blinks once every second for twenty seconds. In this example, the message is represented by the words msg1 and msg2.
RP/0/0/CPU0:routername# set card-message all blink 1 expire 20 msg1 msg2 RP/0/0/CPU0:routername#
Related Commands
Command clear card-message
Description Removes the user-specified message that is displayed on the LED on the front panel of one or more line cards, and reverts to the normal status message for the line card.
HR-36
Platform and Driver Commands on Cisco IOS XR Software show controllers
show controllers
To display information about a specific interface, enter the show controllers command with the interface option in EXEC mode. show controllers interface {all | framer {internal | register | statistics} | internal}
Syntax Description
interface
Identifies the interface or subinterface you want to display, in the <type>rack/slot/module/port format.
Note
Enter the show interfaces command in EXEC mode to see a list of all interfaces the router,
all framer internal framer register framer statistics internal
Displays all available information about the specified controller. Displays information about internal PoS framers only. Displays information about PoS framer registers. Display information about PoS framer statistics. Displays internal PoS information for the specified controller.
Command Modes
EXEC
Command History
Modification This command was introduced on the Cisco CRS-1. No modification This command was first supported on the Cisco 12000 Series router.
Usage Guidelines
HR-37
Examples
The following example shows how to display information about a specific interface (POS0/0/0) on the Cisco CRS-1:
RP/0/0/CPU0:router# Port Number Interface Ifhandle CRC MTU Port Bandwidth Kbps Admin state Driver Link state show controllers POS0/0/0/0 : 0 : POS0_0_0_0 : 0x1080060 : 32 : 4474 : 2488320 : Down : Down
Bundle member : No Bundle MTU : 4474 Bundle Adminstate : Up RP/0/0/CPU0:router#

Table 5 show controllers Field Descriptions (Cisco CRS-1)
Field Port Number Interface
Description Number of the port that is associated with the interface whose controller information is displayed. Interface whose controller information is displayed. The interface is represented in the <type instance>rack/slot/module/port format. The example provides controller information for a PoS (or SONET) interface associated with port 0 on node 0, which is installed in slot 0, rack 0. Number that identifies the caps node that hosts the node whose controller information is displayed. cyclic redundancy check (CRC) size for HDLC encapsulation on an SDCC interface. Can be one of the following settings:

Ifhandle CRC
16CRC is set to 16 bits. 32CRC is set to 32 bits.
MTU Port Bandwidth Kbps Admin state
Maximum transmission unit (MTU) size for the interface. Port bandwidth in Kbps. Current administrative state for the line. Can be one of the following settings:

UpLine is active. DownLine is deactivated.
Driver Link state
Current state of the link driver. Can be one of the following settings:

UpDriver is active. DownDriver is deactivated.
Bundle member Bundle MTU Bundle Adminstate
Indicates whether the specified interface is part of a bundle. Number that identifies the MTU bundle to which this link belongs. Indicates whether the bundle is up (active) or down (inactive).
HR-38
The following example shows how to display the framer statistics for a specific interface (POS0/2/0/0) on the Cisco 12000 Series router:
RP/0/0/CPU0:routername# show controllers POS0/2/0/0 framer statistics POS Driver Internal Cooked Stats Values for port 0 =================================================== Rx Statistics Tx Statistics ------------------------Total Bytes: 0 Total Bytes: 0 Good Bytes: 0 Good Bytes: 0 Good Packets: 0 Good Packets: 0 Aborts: 0 Aborts: 0 FCS Errors: 0 Min-len errors: 0 Runts: 0 Max-len errors: 0 FIFO Overflows: 0 FIFO Underruns: 0 Giants: 0 Drops: 0 RP/0/0/CPU0:routername#

Table 6 show controllers Field Descriptions (Cisco 12000 Series router)
Field Total Bytes Good Bytes Aborts FCS Errors Min-len errors Runts Max-len errors: FIFO Overflows
Description Number of bytes received. Number of bytes received without errors. Number of receive bytes that have been aborted. Number of frame check sequence (FCS) errors that have been received. Number of minimum queue length violations. Number of received packets that are discarded, because they are smaller than the minimum packet size of the medium. Number of maximum queue length violations. Number of received packets that exceeded the FIFO stack limit.
Note
FIFO is buffering scheme where the first byte of data entering the buffer is the first byte retrieved by the CPU.
FIFO Underruns
Number of first-in, first-out FIFO underruns. FIFO underruns reports the number of times that the transmitter has been running faster than the router can handle.
Note
FIFO is buffering scheme where the first byte of data entering the buffer is the first byte retrieved by the CPU.
Giants Drops
Number of received packets that are discarded, because they exceed the maximum packet size of the medium. Number of received packets that have been dropped from the system.
HR-39
Related Commands
Command show controllers null interface show controllers xgxs show interfaces
Description Displays null interface counters. Displays internal driver information about XGXS sublayer interfaces. Displays statistics for all interfaces configured on the router.
HR-40
Platform and Driver Commands on Cisco IOS XR Software show controllers cpuctrl cdma
show controllers cpuctrl cdma

To display information about the CPU controller Code Division Multiplex Access (CDMA) engine, use the show controllers cpuctrl cdma command in EXEC mode. show controllers cpuctrl cdma {all | cdma0 {queue | all} | cdma1 {queue | all} {active | detail} [location node-id]
Syntax Description
all cdma0 queue
Displays CDMA information for channel 0 and channel 1. Displays CDMA information for a specific Division Multiplex Access (DMA) queue on channel 0. Replace queue with a number. Range is from 1 through 7. Displays CDMA engine information for all DMA queues on channel 0. Displays CDMA information for a specific Division Multiplex Access (DMA) queue on channel 1. Replace queue with a number. Range is from 1 through 7. Displays CDMA engine information for all DMA queues on channel 1. Displays descriptions for active DMA queues only. Displays descriptions for any DMA queues, regardless of whether they are active. (Optional) Identifies the location of the node whose CPU controller CDMA information you want to display. The node-id is expressed in the rack/slot/module notation.
cdma0 all cdma1 queue
cdma1 all active detail location node-id
Command Modes
EXEC
Command History
Usage Guidelines
HR-41
Examples
The following example shows how to display CPU controller CDMA information from the active DMA queues on channel 1:
RP/0/RP0/CPU0:router# show controllers cpuctrl cdma cdma0 1 active --------------------------------------------------------------DMA queue: Channel: 0 queue: 1 client handle: 1 queue state: Active IOS-XR Interrupt Level:108 Cpuctrl Interrupt Level:12 IOS-XR Run Priority:45 Queue Created 1 times Pakmode = 0x2 CDMA out_of_desc failures = 0 CDMA transactions = 3, Bytes DMA'd = 67584 DMA IWA = 0 ISR pointer is at 0x78043224 Descriptor List at 0xec032300 Pakman/Bufman Instance: /dev/bufman/misc client callback function pointer 0x48203424 client cleanup function pointer 0x48203424 Queue descriptor list info: list_size=32 current_index=3 active descriptors number:0
tx_index=3
--------------------------------------------------------------DMA queue: Channel: 0 queue: 1 client handle: 1 queue state: Active IOS-XR Interrupt Level:108 Cpuctrl Interrupt Level:12 IOS-XR Run Priority:45 Queue Created 1 times Pakmode = 0x2 CDMA out_of_desc failures = 0 CDMA transactions = 3, Bytes DMA'd = 67584 DMA IWA = 0 ISR pointer is at 0x7804316c Descriptor List at 0xec032300 Pakman/Bufman Instance: /dev/bufman/misc client callback function pointer 0x48203424 client cleanup function pointer 0x48203424 Queue descriptor list info: list_size=32 current_index=3 --Moreactive descriptors number:0
tx_index=3
--------------------------------------------------------------DMA queue: Channel: 0 queue: 1 client handle: 1 queue state: Inactive --------------------------------------------------------------DMA queue: Channel: 0 queue: 1 client handle: 1 queue state: Inactive

Table 7 show controller cpuctrl cdma Field Descriptions
Field DMA queue Channel
Description Identifies the DMA queue. Identifies the channel whose DMA queue is displayed. 0 is the ingress channel, and 1 is the egress channel
HR-42
Table 7
show controller cpuctrl cdma Field Descriptions (continued)
Field queue client handle queue state IOS XR Interrupt Level Cpuctrl Interrupt Level IOS XR Run Priority Queue Created 1 times Pakmode CDMA out_of_desc failures CDMA transactions Bytes DMA'd DMA IWA ISR pointer is at Descriptor List at Pakman/Bufman Instance client callback function pointer client cleanup function pointer Queue descriptor list info
Description Identifies the queue. Internal identifier for the Cisco client. Describes the current state of the queue. Displays the current interrupt level for the queue. Displays the current interrupt level for the CPU controller. Describes the run priority level for this queue. Describes the number of times this queue was regenerated. Displays information about internal data structures and parameters. Displays the number of Code Division Multiple Access (CDMA) failures in the queue. Displays the number of Code Division Multiple Access (CDMA) transactions in the queue. Number of bytes that have been processed by the Division Multiplex Access engine. Number of IWA bytes that have been processed by the Division Multiplex Access engine. Displays internal information about the location of the ISR pointer. Displays internal information about the location of the descriptor list. Displays internal information about the location of the Pakman and Bufman Instance. Displays internal information about the client callback function pointer. Displays internal information about the client cleanup function pointer. Displays internal information about the queue descriptor list.
HR-43
Platform and Driver Commands on Cisco IOS XR Software show controllers cpuctrl clear
show controllers cpuctrl clear

To clear CPU controller queue counters and error logs on all nodes in the router, or on a specific node, use the show controllers cpuctrl clear command in EXEC mode. show controllers cpuctrl clear {counters | errors} [location node-id]
Syntax Description
counters
Clears all CPU controller queue counters on all nodes, or on a specific node. To clear queue counters on all nodes in the router, enter the show controllers cpuctrl clear counters command without specifying the location node-id argument. To clear queue counters on a specific node, include the location node-id argument with the command string, as shown in the following example:
show controllers cpuctrl clear counters location node-id
errors
Clears all CPU controller error logs on all nodes, or on a specific node. To clear error logs on all nodes in the router, enter the show controllers cpuctrl clear errors command without specifying the location node-id argument. To clear error logs on a specific node, include the location node-id argument with the command string, as shown in the following example:
show controllers cpuctrl clear errors location node-id
location node-id
(Optional) Identifies the location of the node whose CPU controller queue counters or error logs information you want to display. The node-id is expressed in the rack/slot/module notation.
Command Modes
EXEC
Command History
Usage Guidelines
HR-44
Platform and Driver Commands on Cisco IOS XR Software show controllers cpuctrl clear
Examples
The following example shows how to clear the CPU controller counters on all nodes in the router:
RP/0/0/CPU0:router# show controllers cpuctrl clear counters show show show show controller controller controller controller cpuctrl cpuctrl cpuctrl cpuctrl cleared cleared cleared cleared queue queue queue queue counters counters counters counters
Related Commands
Command show controllers cpuctrl summary
Description Displays summarized information about all CPU controller ASICs on the router or on a specific node.
HR-45
Platform and Driver Commands on Cisco IOS XR Software show controllers cpuctrl clients
show controllers cpuctrl clients

To display information about all CPU controller clients on the router, or for specific CPU controller clients, use the show controllers cpuctrl clients command in EXEC mode. show controllers cpuctrl clients {all | cdma {plim asic | dcc | egressq | fabricq | fia | ingressq | jacketcard | mipc | plim | plimasic | pse | reindeer} | pdma {diag | fia | frr | gsp| mipc | mstats | netflow | netio}} {active | detail} [location node-id]
Syntax Description
all cdma dcc egressq fabricq fia ingressq jacketcard mipc plim plimasic pse reindeer pdma diag fia frr gsp mipc mstats netflow netio active detail location node-id
Displays a summary information for all clients on the router. Displays information about Code Division Multiplex Access (CDMA) clients only. Displays information for the dcc client. Displays information for the egressq client. Displays information for the Fabricq ASIC client. Displays information for the Fabric Interface ASIC (FIA) client. Displays information for the ingressq ASIC client. Displays information for the jacketcard client. Displays information for the Marvel interprocess communication (MIPC) client. Displays information for the plim client. Displays information for the plim ASIC client. Displays information for the pse client. Displays information for the reindeer client. Displays information for PDMA clients only. Displays information for the PDMA client called DIAG packet. Displays information for the Fabric Interface ASIC packet PDMA client. Displays information for the Fast Reroute (FRR) packet PDMA client. Displays information for the Global Support Partner (GSP) packet PDMA client. Displays information for the MIPC packet PDMA client. Displays information for the MSTATS packet PDMA client. Displays information for the NETFLOW packet PDMA client. Displays information for the NETIO packet PDMA client. Displays descriptions for active queues only. Displays descriptions for any queues, regardless of whether they are active. (Optional) Identifies the location of the node whose CPU controller information you want to display. The node-id is expressed in the rack/slot/module notation.
Command Modes
EXEC
HR-46
Command History
Usage Guidelines
Examples
The following example shows how to display information about the active queues on the CPU controller client called plimasic:
RP/0/0/CPU0:router# show controllers cpuctrl clients plimasic active ------------------------------------------------------------client_name: plimasic client_handle: 10 isr_count: 0 queue_count: 0 client_pid: 0 ------------------------------------------------------------client_name: plimasic client_handle: 10 isr_count: 0 queue_count: 0 client_pid: 0 ------------------------------------------------------------client_name: plim asic client_handle: 10 isr_count: 0 queue_count: 0 client_pid: 0 ------------------------------------------------------------client_name: plim asic client_handle: 10 isr_count: 0 queue_count: 0 client_pid: 0 RP/0/0/CPU0:router#
RP/0/0/CPU0:router# show controllers cpuctrl clients all -----------------------------------------------------------DMA client: client_name: MIPC client_handle:0 isr_count: 0 queue_count: 2 client_pid: 24616 -----------------------------------------------------------DMA client: client_name: Pse client_handle:1 isr_count: 0 queue_count: 2 client_pid: 24616 -----------------------------------------------------------DMA client: client_name: DCC client_handle:2 isr_count: 0 queue_count: 0 client_pid: 0 -----------------------------------------------------------DMA client: client_name: PlimAsic client_handle:3 isr_count: 0 queue_count: 1 client_pid: 28732 -----------------------------------------------------------DMA client: client_name: Egressq client_handle:4 isr_count: 0 queue_count: 1 client_pid: 28737
HR-47
-----------------------------------------------------------DMA client: client_name: Ingressq client_handle:5 isr_count: 0 queue_count: 1 client_pid: 20526 -----------------------------------------------------------DMA client: client_name: Fabricq client_handle:6 isr_count: 0 queue_count: 1 client_pid: 20524 -----------------------------------------------------------DMA client: client_name: PLIM client_handle:7 isr_count: 0 queue_count: 0 client_pid: 45147 -----------------------------------------------------------DMA client: client_name: FIA client_handle:8 isr_count: 0 queue_count: 0 client_pid: 20525 -----------------------------------------------------------DMA client: client_name: Reindeer client_handle:9 isr_count: 0 queue_count: 0 client_pid: 0 ------------------------------------------------------------

Table 8 show controllers cpuctrl clients Field Descriptions
Field client client_name client_handle isr_count queue_count client_pid
Description Client type that whose information is displayed. Can be DMA or PKT. Identifies the client whose information is displayed. Internal client identifier. Integrated SONET/SDH (ISR) counters. Queue counters. Client packet identification (PID).
Related Commands
Description Displays summarized information about all CPU controller ASICs on the router or on a specific node
HR-48
Platform and Driver Commands on Cisco IOS XR Software show controllers cpuctrl devices
show controllers cpuctrl devices

To display information about the CPU controller devices on the router, use the show controllers cpuctrl devices command in EXEC mode. show controllers cpuctrl devices {egressq | epse | fabricq0| fabricq1 | fabricq2 | fabricq3 | fia0 | fia1 | ingressq | ipse| jacketcard0 | jacketcard1 | jacketcard2 | plimasic0 | plimasic1 | plimasic2 | plimasic3 | plimfpga} {pdma queue {all | tx | rx} {active | detail} | pio} [location node-id]
Syntax Description
egressq epse fabricq0 fabricq1 fabricq2 fabricq3 fia0 fia1 ingressq ipse jacketcard0 jacketcard1 jacketcard2 plimasic0 plimasic1 plimasic2 plimasic3 plimfpga pdma queue all
Displays information about the egressq ASIC instance 0. Displays information about the egress packet switching engine (PSE) ASIC. Displays information about the fabricq ASIC instance 0. Displays information about the fabricq ASIC instance 1. Displays information about the fabricq ASIC instance 2. Displays information about the fabricq ASIC instance 3. Displays information about the Fabric Interface ASIC (FIA) instance 0. Displays information about the FIA instance 1. Displays information about the ingressq ASIC. Displays information about the ingress packet switching engine (PSE) ASIC. Displays information about the jacketcard0 ASIC. Displays information about the jacketcard1 ASIC. Displays information about the jacketcard2 ASIC. Displays information about the PLIM ASIC instance 0. Displays information about the PLIM ASIC instance 1. Displays information about the PLIM ASIC instance 2 Displays information about the PLIM ASIC instance 3. Displays information about the field-programmable gate array (FPGA) PLIM. Displays transmit and receive PDMA information for the specified queue. Replace queue with a queue number. The range is from 1 through 7. Displays transmit PDMA information only for the specified queue. Replace queue with a queue number. The range is from 1 through 7. Displays receive PDMA information only for the specified queue. Replace queue with a queue number. The range is from 1 through 7. Displays transmit and receive PDMA information for all queues. Displays descriptions for active queues only. Displays detailed descriptions for any queues, regardless of whether they are active.
pdma queue tx pdma queue rx pdma all active detail
HR-49
pio location node-id
Displays transmit and receive PIO information for the specified queue. (Optional) Identifies the location of the node whose CPU controller information you want to display. The node-id is expressed in the rack/slot/module notation.
Command Modes
EXEC
Command History
Usage Guidelines
Examples
The following example shows how to display transmit and receive PDMA information for all active queues on the egressq ASIC instance 0:
RP/0/0/CPU0:router# show controllers cpuctrl devices egressq pdma all active --------------------------------------------------------------TX PKT queue: cpuctrl net Port: 7 queue: 0 client handle: 6 queue state: Active IOS-XR Interrupt Level:127 Cpuctrl Interrupt Level:31 IOS-XR Run Priority:20 Queue Created 1 times Pakmode = 0x1 Tx out_of_desc failures = 0 Packets transmitted = 0, Byte transmitted = 0 Tx IWA = 0 ISR pointer is at 0x7804372c Descriptor List at 0xec27b060 Pakman/Bufman Instance: /dev/pakman/server client callback function pointer 0x00000000 client cleanup function pointer 0x00000000 Queue descriptor list info: list_size=1024 current_index=0 active descriptors number:0
tx_index=0
--------------------------------------------------------------TX PKT queue: cpuctrl net Port: 0 queue: 1 client handle: 6 queue state: Inactive --------------------------------------------------------------TX PKT queue: cpuctrl net Port: 0 queue: 2 client handle: 6 queue state: Inactive --------------------------------------------------------------TX PKT queue: cpuctrl net Port: 0 queue: 3 client handle: 6 queue state: Inactive
HR-50
--------------------------------------------------------------TX PKT queue: cpuctrl net Port: 0 queue: 4 client handle: 6 queue state: Inactive --------------------------------------------------------------TX PKT queue: cpuctrl net Port: 0 queue: 5 client handle: 6 queue state: Inactive --------------------------------------------------------------TX PKT queue: cpuctrl net Port: 0 queue: 6 client handle: 6 queue state: Inactive --------------------------------------------------------------TX PKT queue: cpuctrl net Port: 0 queue: 7 client handle: 6 queue state: Inactive --------------------------------------------------------------RX PKT queue: cpuctrl net Port: 7 queue: 0 client handle: 3 queue state: Active --More--

Table 9 show controllers cpuctrl devices Field Descriptions
Field PKT queue: cpuctrl net Port queue client handle queue state
Description Displays whether the packet queue is transmit (TX) or receive (RX). Identifies the CPU controller port. Identifies the queue whose CPU controller device information is displayed. Internal Cisco client identifier. Current state of the queue. The queue can be Active or Inactive.
Related Commands
HR-51
Platform and Driver Commands on Cisco IOS XR Software show controllers cpuctrl internal
show controllers cpuctrl internal

To display information about the internal CPU controller, use the show controllers cpuctrl internal command in EXEC mode. show controllers cpuctrl internal location node-id
Syntax Description
location node-id
Identifies the location of the node whose internal CPU controller information you want to display. The node-id is expressed in the rack/slot/module notation.
Command Modes
EXEC
Command History
Usage Guidelines
Examples
The following example shows how to display information about the internal CPU controller:
RP/0/0/CPU0:router# show controllers cpuctrl internal
Cpuctrl Internal Info for node 0/0/CPU0: Error Interrupts = 0 Spurious Error Interrupts = 0 PCI Error Overflows = 0 PCI PM Error Overflows = 0 PCIX Error Overflows = 0 Internal Access PCI Overflows = 0 Port Error Overflows = 0 Error Log Overflows = 0 cpuctrl Config Reg = 0x8357ffff cpuctrl Physical Offset = 0x80000000 cpuctrl Window Size = 0x40000000 cpuctrl Port Window Size = 0x04000000 cpuctrl SHMem Size = 0x00800000 cpuctrl SHMem Used = 0x00223ee8 cpuctrl version info: Squid FPGA v2.07 Fri Jan 23 16:21:01 2004 ykoren
Cpuctrl Internal Info for node 0/3/CPU0: Error Interrupts = 0 Spurious Error Interrupts = 0 PCI Error Overflows = 0 PCI PM Error Overflows = 0 PCIX Error Overflows = 0 Internal Access PCI Overflows = 0 Port Error Overflows = 0 Error Log Overflows = 0 cpuctrl Config Reg = 0x8357ffff cpuctrl Physical Offset = 0x80000000 cpuctrl Window Size = 0x40000000 cpuctrl Port Window Size = 0x04000000 cpuctrl SHMem Size = 0x00800000 cpuctrl SHMem Used = 0x00223ee8 cpuctrl version info: Squid FPGA v2.07 Fri Jan 23 16:21:01 2004 ykoren
HR-52
Cpuctrl Internal Info for node 0/RP0/CPU0: Error Interrupts = 0 Spurious Error Interrupts = 0 PCI Error Overflows = 0 PCI PM Error Overflows = 0 PCIX Error Overflows = 0 Internal Access PCI Overflows = 0 Port Error Overflows = 0 Error Log Overflows = 0 cpuctrl Config Reg = 0x803f007f cpuctrl Physical Offset = 0x80000000 cpuctrl Window Size = 0x40000000 cpuctrl Port Window Size = 0x04000000 cpuctrl SHMem Size = 0x00800000 cpuctrl SHMem Used = 0x00223ee8 cpuctrl version info: Squid FPGA v2.07 Fri Feb 6 17:49:22 2004 ykoren Cpuctrl Internal Info for node 0/RP1/CPU0: Error Interrupts = 0 Spurious Error Interrupts = 0 PCI Error Overflows = 0 PCI PM Error Overflows = 0 PCIX Error Overflows = 0 Internal Access PCI Overflows = 0 Port Error Overflows = 0 Error Log Overflows = 0 cpuctrl Config Reg = 0x003f007f cpuctrl Physical Offset = 0x80000000 cpuctrl Window Size = 0x40000000 cpuctrl Port Window Size = 0x04000000 cpuctrl SHMem Size = 0x00800000 cpuctrl SHMem Used = 0x00223ee8 cpuctrl version info: Squid FPGA v2.05 Wed Sep 3 17:37:47 2003 ykoren RP/0/0/CPU0:router#

Table 10 show controllers cpuctrl internal Field Descriptions
Field Error Interrupts Spurious Error Interrupts PCI Error Overflows
Description Total of error interrupts that have occurred on this node. Current number interrupts that have occurred on this node due to spurious errors. Number of times the Peripheral Component Interconnect (PCI) error buffer overflowed on the node.
Note
When an overflow occurs, packets may be dropped.
PCI PM Error Overflows
Number of times PCI port manager (PM) errors buffer overflowed on this node.
Note
When an overflow occurs, packets may be dropped. When an overflow occurs, packets may be dropped.
PCIX Error Overflows Internal Access PCI Overflows
Number of times the PCI IX error buffer overflowed on this node.

Note
Number of times the Internal Access PCI buffer overflowed on this node.
Note
When an overflow occurs, packets may be dropped. When an overflow occurs, packets may be dropped. When an overflow occurs, packets may be dropped.
Port Error Overflows Error Log Overflows cpuctrl Config Reg cpuctrl Physical Offset cpuctrl Window Size
Number of times the port error buffer overflowed on this node.

Note
Number of times the error log buffer overflowed on this node.

Note
CPU controller configuration register, expressed in hexadecimal format. CPU controller physical offset, expressed in hexadecimal format. CPU controller window size, expressed in hexadecimal format. CPU controller performance improves as window size increases.
HR-53
Table 10
show controllers cpuctrl internal Field Descriptions (continued)
Field cpuctrl Port Window Size
Description CPU controller port window size, expressed in hexadecimal format. CPU controller port performance improves as window size increases. CPU controller SH memory size, expressed in hexadecimal format. CPU controller SH memory that has been used already, expressed in hexadecimal format. Provides version information for the CPU controller. The information displayed is:

cpuctrl SHMem Size cpuctrl SHMem Used cpuctrl version info
Squid version Date of the last version install or upgrade ID of the user who performed the install or upgrade.
Related Commands
HR-54
Platform and Driver Commands on Cisco IOS XR Software show controllers cpuctrl ports
show controllers cpuctrl ports

To display port information for the specified CPU controller ASIC, use the show controllers cpuctrl ports command in EXEC mode. show controllers cpuctrl ports {cpuctrl | egressq| epse | fabricq0 | fabricq1 | fabricq2 | fabricq3 | fia0| fia1 | ingressq | ipse | jacketcard0 | jacketcard1 | jacketcard2| plimasic0 | plimasic1 | plimasic2 | plimasic3 | reindeer} {pdma queue-id {all | rx | tx} {active | detail} | pio} [location node-id]
Syntax Description
cpuctrl egressq epse fabricq0 fabricq1 fabricq2 fabricq3 fia0 fia1 ingressq ipse jacketcard0 jacketcard1 jacketcard2 plimasic0 plimasic1 plimasic2 plimasic3 reindeer pdma queue-id all pdma queue-id tx
Displays port information for the CPU controller ASIC instance 0. Displays port information for the egressq ASIC instance 0. Displays port information for the egress packet switching engine (EPSE) ASIC. Displays port information for the fabricq ASIC instance 0 Displays port information for the fabricq ASIC instance 1 Displays port information for the fabricq ASIC instance 2 Displays port information for the fabricq ASIC instance 3 Displays port information for the fabric Interface ASIC (FIA) instance 0. Displays port information for the fabric Interface ASIC (FIA) instance 1. Displays port information for the ingressq ASIC. Displays port information for the ingress packet switching engine (PSE) ASIC. Displays port information for the jacketcard0 ASIC. Displays port information for the jacketcard1 ASIC. Displays port information for the jacketcard2 ASIC. Displays port information for instance 0 of the plim ASIC. Displays port information for instance 1 of the plim ASIC. Displays port information for instance 2 of the plim ASIC. Displays port information for instance 3 of the plim ASIC. Displays port information for the reindeer ASIC. Displays transmit and receive PDMA information for the specified queue. Displays transmit PDMA information only for the specified queue. The information displayed pertains to the ASIC indicated in the show controllers cpuctrl ports command. Displays receive PDMA information only for the specified queue. The information displayed pertains to the ASIC indicated in the show controllers cpuctrl ports command. Displays transmit and receive PDMA information for all queues. The information displayed pertains to the ASIC indicated in the show controllers cpuctrl ports command. Displays descriptions for active queues only.
pdma queue-id rx
pdma all
active
HR-55
detail pio location node-id
Displays descriptions for any queues, regardless of whether they are active. Displays transmit and receive PIO information for the specified queue. (Optional) Identifies the location of the node whose CPU controller port information you want to display. The node-id is expressed in the rack/slot/module notation.
Command Modes
EXEC
Command History
Usage Guidelines
Examples
The following example shows how to display port information for the transmit and receive PIO queues on the EPSE ASIC:
RP/0/0/CPU0:router# show controllers cpuctrl ports epse pio client name: PSE device instance: 1 cpuctrl net port: 6 pci base: 0x98000000 map reg: 0x6076a12c IOS-XR interrupt level: 102 Cpuctrl interrupt level: 6 IOS-XR Run priority: 6 config reg: 0x00000000 channels reg: 0x00000000 int_cause_asic_mask: 0x00000010 int_cause_error_mask: 0x00000020 int_cause_link_error_mask: 0x00000040 crc_errors: 0 sync_errors: 0 reframe_events: 0
client name: PSE device instance: 1 cpuctrl net port: 6 pci base: 0x98000000 map reg: 0x6076a12c IOS-XR interrupt level: 102 Cpuctrl interrupt level: 6 IOS-XR Run prority: 6 config reg: 0x00000000 channels reg: 0x00000000 int_cause_asic_mask: 0x00000010 int_cause_error_mask: 0x00000020 int_cause_link_error_mask: 0x00000040 crc_errors: 0 sync_errors: 0 reframe_events: 0
device PSE instance 1 is not detected on node 201/ RP/0/0/CPU0:router#
HR-56
Table 11
show controllers cpuctrl ports Field Descriptions
Field client name device instance cpuctrl net port pci base map reg IOS XR interrupt level
Description Identifies the client whose port CPU controller information is displayed. The clients device instance for which the port CPU controller information is displayed. Identifies the CPU controller net port. Peripheral Component Interconnect (PCI) base. Client map register. Level of IOS XR interrupt configured for the port. Interrupts are triggered by arrival of a packet that causes the CPU to postpone other tasks and handle the packet. Level of CPU controller interrupt configured for the port. IOS XR priority. Configuration register, expressed in hexadecimal format. Channel register, expressed in hexadecimal format. Internal ASIC masking information. Internal error masking information. Internal link error masking information. Number of cyclic redundancy check (CRC) errors that have occurred on this port. Number of synchronization errors that have occurred on this port. Number of reframe events that have occurred on this port.
Cpuctrl interrupt level IOS XR Run priority config reg channels reg int_cause_asic_mask int_cause_error_mask int_cause_link_error_mask crc_errors sync_errors reframe_events
Related Commands
HR-57
Platform and Driver Commands on Cisco IOS XR Software show controllers cpuctrl summary
show controllers cpuctrl summary

To display summarized information about all CPU controller ASICs on the router or on a specific node, use the show controllers cpuctrl summary command in EXEC mode. show controllers cpuctrl summary [location node-id]
Syntax Description
location node-id
(Optional) Identifies the location of the node whose CPU controller ASIC information you want to display. The node-id is expressed in the rack/slot/module notation.
Command Modes
EXEC
Command History
Usage Guidelines
Examples
The following example shows how to display summarized information about all CPU controller ASICs on a specific node:
RP/0/0/CPU0:router# show controllers cpuctrl summary location 0/0/CPU0 Cpuctrl discovered 11 device on node 0/0/CPU0: Cpuctrl HW version string for this node is: Squid FPGA v2.07 Fri Jan 23 16:21:01 2004 ykoren ----------------------------------------------------------device_name: Fabricq device instance: 0 Cpuctrl net port: 3 pci_base: 0x8c000000 ----------------------------------------------------------device_name: Fabricq device instance: 1 Cpuctrl net port: 4 pci_base: 0x90000000 ----------------------------------------------------------device_name: Ingressq device instance: 0 Cpuctrl net port: 8 pci_base: 0xa0000000 ----------------------------------------------------------device_name: Egressq device instance: 0 Cpuctrl net port: 7 pci_base: 0x9c000000
HR-58
Platform and Driver Commands on Cisco IOS XR Software show controllers cpuctrl summary
----------------------------------------------------------device_name: FIA device instance: 0 Cpuctrl net port: 1 pci_base: 0x84000000 ----------------------------------------------------------device_name: FIA device instance: 1 Cpuctrl net port: 2 pci_base: 0x88000000 ----------------------------------------------------------device_name: Cpuctrl device instance: 0 Cpuctrl net port: 0 pci_base: 0x80000000 ----------------------------------------------------------device_name: PSE device instance: 1 Cpuctrl net port: 6 pci_base: 0x98000000 --More--

Table 12 show controllers cpuctrl summary Field Descriptions
Field device_name device instance Cpuctrl net port pci_base
Description Identifies the device whose CPU controller information is displayed. Identifies the CPU device whose information is displayed. Can be 0 or 1. Identifies the CPU controller network port. Peripheral Component Interconnect (PCI) base, in hexadecimal format.
Related Commands
Command show controllers cpuctrl cdma show controllers cpuctrl clear show controllers cpuctrl clients show controllers cpuctrl devices show controllers cpuctrl internal show controllers cpuctrl ports
Description Displays information about the CPU controller CDMA engine. Clears CPU controller queue counters and error logs on all nodes in the router, or on a specific node. Displays information about all CPU controller clients on the router, or for specific CPU controller clients. Displays information about the CPU controller devices on the router. Displays information about the internal CPU controller. Displays port information for the specified CPU controller ASIC.
HR-59
Platform and Driver Commands on Cisco IOS XR Software show controllers egressq eio links
show controllers egressq eio links

To display Elastic I/O (EIO) information for the egress queueing ASIC, enter the show controllers egressq ) command in EXEC mode. show controllers egressq eio links {link-id | all} location node-id
Syntax DescriptionI
link-id
Identifies the EIO link whose egress queueing ASIC information you want to display. Replace link-id with a link identifier. Range is from 0 through 4294967295. Indicates that you want to display egress queueing ASIC information for all links on the specified node. Identifies the location of the egress queue manager whose EIO link information you want to display. The node-id is expressed in the rack/slot/module notation.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
Release Release 3.2
Modification This command was introduced on the Cisco CRS-1.
Usage Guidelines
Examples
The following example shows how to display information for all EIO links on a nodes egress queueing ASIC:
RP/0/0/CPU0:router#show controllers egressq eio links all location 0/2/CPU0 Node: 0/2/CPU0: ---------------------------------------EIO links: ------------------------------------------------------------------ASIC Id Peer Id Type Link-Id Attempts Accept Failed State ------------------------------------------------------------------EGRESSQ_0 PSE_1 RX 11 1 1 0 EIO_LINK_TRAINED EGRESSQ_0 PSE_1 TX 64 0 0 0 EIO_LINK_TRAINED EGRESSQ_0 PLIM-ASIC_0 TX 60 0 0 0 EIO_LINK_TRAINED EGRESSQ_0 PLIM-ASIC_1 TX 61 0 0 0 EIO_ADD_LINK EGRESSQ_0 PLIM-ASIC_2 TX 62 0 0 0 EIO_ADD_LINK EGRESSQ_0 PLIM-ASIC_3 TX 63 0 0 0 EIO_ADD_LINK RP/0/0/CPU0:router#
HR-60
Platform and Driver Commands on Cisco IOS XR Software show controllers egressq eio links
Related Commands
Command show controllers egressq group show controllers egressq interface show controllers egressq port show controllers egressq queue show controllers egressq statistics show controllers ingressq statistics
Description Displays information for about egress queue groups. Displays information about interfaces associated with an egress queue. Displays egress queue information for a port, or for several ports. Displays information about a specific egress queue, or a range of egress queues. Displays egress queue manager statistics. Displays ingress queue manager statistics.
HR-61
Platform and Driver Commands on Cisco IOS XR Software show controllers egressq group
show controllers egressq group

To display information about egress queue groups, enter the show controllers egressq group command in EXEC mode. show controllers egressq group {group1 [geoup2]| all | limits {max | min}} location location
Syntax Description
group1 group1 all limits
Identifies the first group whose information you want to display. (Optional) Identifies the last group whose information you want to display. Indicates that you want to display information about all egress queue groups on a specific node. Indicates that you want to display the limits table. Follow the keyword with max to display the maximum limits table, or min to display the minimum limits table. Display the maximum limits table. Display the minimum limits table. Identifies the location of the egress queue whose group information you want to display.
max min location location
Defaults
Command Modes
EXEC
Command History
Release Release 3.2
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. If you do not specify a group number for the group2 argument, information is displayed only for the egress queue you specified for the group1 argument. If you specify group1 and group2, information is displayed for all groups within the range from group1 through group2.
Examples
The following example shows how to display information for a specific range of egress queue groups on the CPU node in slot 2.
RP/0/0/CPU0:router#show controllers egressq egressq group 1 3 location 0/2/CPU0 ---------------------------------Group 1 ---------------------------------Port : 0 Priority : Low
HR-62
Platform and Driver Commands on Cisco IOS XR Software show controllers egressq group
Max LB Tokens : 7812 Max LB Limit Index : 38 Min LB Tokens : 0 Min LB Limit Index : 0 Quantum : 27 Default Queue : 1 High Priority Queue : N/A Low Priority Queue : 1 ------------------------------------------------------------------Group 2 ---------------------------------Port : 1 Priority : Low Max LB Tokens : 7812 Max LB Limit Index : 38 Min LB Tokens : 0 Min LB Limit Index : 0 Quantum : 27 Default Queue : 2 High Priority Queue : N/A Low Priority Queue : 2 ------------------------------------------------------------------Group 3 ---------------------------------Port : 256 Priority : Low Max LB Tokens : 7812 Max LB Limit Index : 38 Min LB Tokens : 0 Min LB Limit Index : 0 Quantum : 27 Default Queue : 3 High Priority Queue : N/A Low Priority Queue : 3 ---------------------------------RP/0/0/CPU0:router#
Related Commands
Command show controllers egressq eio links show controllers egressq interface show controllers egressq port show controllers egressq queue show controllers egressq statistics show controllers ingressq statistics
Description Displays EIO information for the egress queueing ASIC. Displays information about interfaces associated with an egress queue. Displays egress queue information for a port, or for several ports. Displays information about a specific egress queue, or a range of egress queues. Displays egress queue manager statistics. Displays ingress queue manager statistics.
HR-63
Platform and Driver Commands on Cisco IOS XR Software show controllers egressq interface
show controllers egressq interface

To display information about interfaces associated with an egress queue, enter the show controllers egressq interface command in EXEC mode. show controllers egressq interface [Bundle-Ether bundle-id | Bundle-POS bundle-id | GigabitEthernet interface_instance| Loopback interface| MgmtEth interface_instance | Null 0 | POS interface_instance| all] location location
Syntax Description
Bundle-Ether bundle-id
Identifies the Aggregated Ethernet interface(s) whose egress queue information you want to display. Replace bundle-id with the bundle identifier. Range is from 1 through 65535.
Bundle-POS bundle-id Identifies the Aggregated PoS interface(s) whose egress queue information you want to display. Replace bundle-id with the bundle identifier. Range is from 1 through 65535. GigabitEthernet interface_instance Loopback interface Identifies the GigabitEthernet or IEEE 802.3 interface(s) whose egress queue information you want to display. Identifies the loopback interface(s) whose egress queue information you want to display. Replace interface with the loopback interface identifier. Range is from 1 through 65535. Identifies the Ethernet or IEEE 802.3 interface(s) whose egress queue information you want to display. Identifies the Null interface. Identifies the PoS interface(s) whose egress queue information you want to display. Indicates that you want to display egress queue information for all interfaces in the specified location. Identifies the location of the interface whose egress queue information you want to display.
MgmtEth interface_instance Null 0 POS interface_instance all location location
Defaults
Command Modes
EXEC
Command History
Release Release 3.2
Usage Guidelines
HR-64
Examples
The following example shows how to display egress queue information for all configured interfaces on the router:
RP/0/0/CPU0:router# show controllers egressq interface all /CPU0 ---------------------------------Interface POS0/0/0/15 ---------------------------------Port 776 ---------------------------------Max LB Tokens : 18720 Max LB Limit Index : 41 Quantum : 27 Default Group : 24 High Priority Group : N/A Low Priority Group : 24 ------------------------------------------------------------------Interface POS0/0/0/14 ---------------------------------Port 780 ---------------------------------Max LB Tokens : 18720 Max LB Limit Index : 41 Quantum : 27 Default Group : 23 High Priority Group : N/A Low Priority Group : 23 ------------------------------------------------------------------Interface POS0/0/0/13 ---------------------------------Port 778 ---------------------------------Max LB Tokens : 18720 Max LB Limit Index : 41 Quantum : 27 Default Group : 22 High Priority Group : N/A Low Priority Group : 22 ------------------------------------------------------------------Interface POS0/0/0/12 ---------------------------------Port 782 ---------------------------------Max LB Tokens : 18720 Max LB Limit Index : 41 Quantum : 27 Default Group : 21 High Priority Group : N/A Low Priority Group : 21 ------------------------------------------------------------------Interface POS0/0/0/11 ---------------------------------Port 520 ---------------------------------Max LB Tokens : 18720 Max LB Limit Index : 41 Quantum : 27 Default Group : 20
HR-65
High Priority Group : N/A Low Priority Group : 20 ------------------------------------------------------------------Interface POS0/0/0/10 ---------------------------------Port 524 ---------------------------------Max LB Tokens : 18720 Max LB Limit Index : 41 Quantum : 27 Default Group : 19 High Priority Group : N/A Low Priority Group : 19 ------------------------------------------------------------------Interface POS0/0/0/9 ---------------------------------Port 522 ---------------------------------Max LB Tokens : 18720 Max LB Limit Index : 41 Quantum : 27 Default Group : 18 High Priority Group : N/A Low Priority Group : 18 ------------------------------------------------------------------Interface POS0/0/0/8 ---------------------------------Port 526 ---------------------------------Max LB Tokens : 18720 Max LB Limit Index : 41 Quantum : 27 Default Group : 17 High Priority Group : N/A Low Priority Group : 17 ------------------------------------------------------------------RP/0/0/CPU0:router#
Related Commands
Command show controllers egressq eio links show controllers egressq group show controllers egressq port show controllers egressq queue show controllers egressq statistics show controllers ingressq statistics
Description Displays EIO information for the egress queueing ASIC. Displays information for about egress queue groups. Displays egress queue information for a port, or for several ports. Displays information about a specific egress queue, or a range of egress queues. Displays egress queue manager statistics. Displays ingress queue manager statistics.
HR-66
Platform and Driver Commands on Cisco IOS XR Software show controllers egressq port
show controllers egressq port

To display egress queue information for a port, or for several ports, enter the show controllers egressq port command in EXEC mode. show controllers egressq port {port1 [port2]| all | limits max] location node-id
Syntax Description
port1 port2 all limits max location node-id
Identifies the port whose egress queue information you want to display. Replace port1 with a port identifier. Range is from 1 through 1023. Identifies the last port whose egress queue information you want to display. Replace port2 with a port identifier. Range is from 1 through 1023. Indicates that you want to display egress queue information for all ports on the node in the specified location. Indicates that you want to display the maximum limits table. Identifies the location of the egress queue whose group information you want to display. The node-id is expressed in the rack/slot/module notation.
Defaults
Command Modes
EXEC
Command History
Release Release 3.2
Usage Guidelines
Examples
The following example shows how to display egress queue information for ports 1, 2, and 3 on the CPU node in slot 2:
RP/0/0/CPU0:router#show controllers egressq port 1 3 location 0/2/CPU0 ---------------------------------Port 1 ---------------------------------Max LB Tokens : 7812 Max LB Limit Index : 38 Quantum : 27 Default Group : 2 High Priority Group : N/A Low Priority Group : 2 ------------------------------------------------------------------Port 2
HR-67
Platform and Driver Commands on Cisco IOS XR Software show controllers egressq port
---------------------------------Port is not allocated ---------------------------------Port 3 ---------------------------------Port is not allocated RP/0/0/CPU0:router#
Related Commands
Command show controllers egressq eio links show controllers egressq group show controllers egressq interface show controllers egressq queue show controllers egressq statistics show controllers ingressq statistics
Description Displays EIO information for the egress queueing ASIC. Displays information for about egress queue groups. Displays information about interfaces associated with an egress queue. Displays information about a specific egress queue, or a range of egress queues. Displays egress queue manager statistics. Displays ingress queue manager statistics.
HR-68
Platform and Driver Commands on Cisco IOS XR Software show controllers egressq queue
show controllers egressq queue

To display information about a specific egress queue, or a range of egress queues, enter the show controllers egressq queue command in EXEC mode. show controllers egressq queue {queue1 [queue2 | context [max_elements] | all | limits] location nodie-id
Syntax Description
queue1 queue2
Identifies the first port whose egress queue information you want to display. Replace queue1 with a queue identifier. Range is from 1 through 8191. (Optional) Identifies the last port whose egress queue information you want to display. Replace queue2 with a queue identifier. Range is from 1 through 8191. Specifies the context in which to display the information. (Optional) Maximum number of queue elements to show. Replace max_elements with a maximum number of elements. Range is from 1 through 4096000. Indicates that you want to display egress queue information for all ports on the node in the specified location. Indicates that you want to display the limits table. Follow the keyword with max to display the maximum limits table, or min to display the minimum limits table. Display the maximum limits table. Display the minimum limits table. Identifies the location of the egress queue whose egress queue information you want to display. The node-id is expressed in the rack/slot/module notation.
context max_elements
all limits
max min location node-id
Defaults
Command Modes
EXEC
Command History
Release Release 3.2
Usage Guidelines
Examples
The following example shows how to display information about egress queues 1 and 2 on the CPU node in slot 2:
HR-69
Platform and Driver Commands on Cisco IOS XR Software show controllers egressq queue
RP/0/0/CPU0:router#show controllers egressq queue 1 2 location 0/2/CPU0 ---------------------------------Queue 1 ---------------------------------Group : 1 Priority : Low Max LB Tokens : 7812 Max LB Limit Index : 38 Min LB Tokens : 0 Min LB Limit Index : 0 Quantum : 27 Instantaneous length : 0 Length high watermark : 0 ------------------------------------------------------------------Queue 2 ---------------------------------Group : 2 Priority : Low Max LB Tokens : 7812 Max LB Limit Index : 38 Min LB Tokens : 0 Min LB Limit Index : 0 Quantum : 27 Instantaneous length : 0 Length high watermark : 0 ---------------------------------RP/0/0/CPU0:router#
Related Commands
Command show controllers egressq eio links show controllers egressq group show controllers egressq interface show controllers egressq port show controllers egressq statistics show controllers ingressq statistics
Description Displays EIO information for the egress queueing ASIC. Displays information for about egress queue groups. Displays information about interfaces associated with an egress queue. Displays egress queue information for a port, or for several ports. Displays egress queue manager statistics. Displays ingress queue manager statistics.
HR-70
Platform and Driver Commands on Cisco IOS XR Software show controllers egressq statistics
show controllers egressq statistics

To display egress queue manager statistics, enter the show controllers egressq statistics command in EXEC mode. show controllers egressq statistics location node-id
Syntax Description
location node-id
Identifies the location of the egress queue whose statistics you want to display. The node-id is expressed in the rack/slot/module notation.
Defaults
Command Modes
EXEC
Command History
Release Release 3.2
Usage Guidelines
Examples
The following example shows how to display egress queue manager statistics:
RP/0/0/CPU0:router#show controllers egressq statistics location 0/2/CPU0 -------------------------------------------------Egressq Statistics -------------------------------------------------egressq ASIC version: 1 egressq ASIC state: Normal plimasic link0 output packets: 0 plimasic link0 output bytes: 0 plimasic link1 output packets: 0 plimasic link1 output bytes: 0 plimasic link2 output packets: 0 plimasic link2 output bytes: 0 plimasic link3 output packets: 0 plimasic link3 output bytes: 0 cpuctrl input packets: 0 cpuctrl output bytes: 1433250 pse input packets: 29250 pse dropped packets: 0 cpuctrl dropped packets: 0 -------------------------------------------------RP/0/0/CPU0:router#
HR-71
Platform and Driver Commands on Cisco IOS XR Software show controllers egressq statistics
Related Commands
Command show controllers egressq eio links show controllers egressq group show controllers egressq interface show controllers egressq port show controllers egressq queue show controllers ingressq statistics
Description Displays EIO information for the egress queueing ASIC. Displays information for about egress queue groups. Displays information about interfaces associated with an egress queue. Displays egress queue information for a port, or for several ports. Displays information about a specific egress queue, or a range of egress queues. Displays ingress queue manager statistics.
HR-72
Platform and Driver Commands on Cisco IOS XR Software show controllers fia eio link
show controllers fia eio link

To display Fabric Interface ASIC (FIA) information for a specific Elastic I/O (EIO) link, for all EIO links on the router, or for all EIO links on a specific node, use the show controllers fia eio link command in EXEC mode. show controllers fia eio link {link | all} [location node-id]
Syntax Description
link all location node-id
EIO link whose FIA information you want to display. Range is from 0 through 4294967295. Displays FIA information about all links on the router, or on a specific node. (Optional) Identifies the location of the node whose FIA information you want to display. The node-id is expressed in the rack/slot/module notation.
Note
Command Modes
EXEC
Command History
Usage Guidelines
Examples
The following example shows how to display FIA information for all EIO links on the router:
RP/0/RP0/CPU0:router# show controllers fia eio link all Node: 0/0/CPU0: ---------------------------------------EIO links: ------------------------------------------------------------------ASIC Id Peer Id Type Link-Id Attempts Accept Failed State ------------------------------------------------------------------FIA_0 INGRESSQ_0 RX 20 1 1 0 EIO_LINK_TRAINED FIA_0 INGRESSQ_0 RX 21 1 1 0 EIO_LINK_TRAINED FIA_0 FABRICQ_0 TX 30 0 0 0 EIO_LINK_TRAINED FIA_0 FABRICQ_1 TX 31 0 0 0 EIO_LINK_TRAINED FIA_0 FABRICQ_0 TX 32 0 0 0 EIO_LINK_TRAINED FIA_0 FABRICQ_1 TX 33 0 0 0 EIO_LINK_TRAINED
HR-73
FIA_0 FIA_0 FIA_0 FIA_0 FIA_1 FIA_1 FIA_1 FIA_1 FIA_1 FIA_1 FIA_1 FIA_1 FIA_1 FIA_1
FABRICQ_0 FABRICQ_1 FABRICQ_0 FABRICQ_1 INGRESSQ_0 INGRESSQ_0 FABRICQ_0 FABRICQ_1 FABRICQ_0 FABRICQ_1 FABRICQ_0 FABRICQ_1 FABRICQ_0 FABRICQ_1
TX TX TX TX RX RX TX TX TX TX TX TX TX TX
34 35 36 37 22 23 40 41 42 43 44 45 46 47
0 0 0 0 1 1 0 0 0 0 0 0 0 0
0 0 0 0 1 1 0 0 0 0 0 0 0 0
0 0 0 0 0 0 0 0 0 0 0 0 0 0
EIO_LINK_TRAINED EIO_LINK_TRAINED EIO_LINK_TRAINED EIO_LINK_TRAINED EIO_LINK_TRAINED EIO_LINK_TRAINED EIO_LINK_TRAINED EIO_LINK_TRAINED EIO_LINK_TRAINED EIO_LINK_TRAINED EIO_LINK_TRAINED EIO_LINK_TRAINED EIO_LINK_TRAINED EIO_LINK_TRAINED
Node: 0/3/CPU0: ---------------------------------------EIO links: ------------------------------------------------------------------ASIC Id Peer Id Type Link-Id Attempts Accept Failed State ------------------------------------------------------------------FIA_0 INGRESSQ_0 RX 20 1 1 0 EIO_LINK_TRAINED FIA_0 INGRESSQ_0 RX 21 1 1 0 EIO_LINK_TRAINED FIA_0 FABRICQ_0 TX 30 0 0 0 EIO_LINK_TRAINED FIA_0 FABRICQ_1 TX 31 0 0 0 EIO_LINK_TRAINED FIA_0 FABRICQ_0 TX 32 0 0 0 EIO_LINK_TRAINED FIA_0 FABRICQ_1 TX 33 0 0 0 EIO_LINK_TRAINED FIA_0 FABRICQ_0 TX 34 0 0 0 EIO_LINK_TRAINED FIA_0 FABRICQ_1 TX 35 0 0 0 EIO_LINK_TRAINED FIA_0 FABRICQ_0 TX 36 0 0 0 EIO_LINK_TRAINED FIA_0 FABRICQ_1 TX 37 0 0 0 EIO_LINK_TRAINED FIA_1 INGRESSQ_0 RX 22 1 1 0 EIO_LINK_TRAINED FIA_1 INGRESSQ_0 RX 23 1 1 0 EIO_LINK_TRAINED FIA_1 FABRICQ_0 TX 40 0 0 0 EIO_LINK_TRAINED FIA_1 FABRICQ_1 TX 41 0 0 0 EIO_LINK_TRAINED FIA_1 FABRICQ_0 TX 42 0 0 0 EIO_LINK_TRAINED FIA_1 FABRICQ_1 TX 43 0 0 0 EIO_LINK_TRAINED FIA_1 FABRICQ_0 TX 44 0 0 0 EIO_LINK_TRAINED FIA_1 FABRICQ_1 TX 45 0 0 0 EIO_LINK_TRAINED FIA_1 FABRICQ_0 TX 46 0 0 0 EIO_LINK_TRAINED FIA_1 FABRICQ_1 TX 47 0 0 0 EIO_LINK_TRAINED Node: 0/RP0/CPU0: ---------------------------------------EIO links: ------------------------------------------------------------------ASIC Id Peer Id Type Link-Id Attempts Accept Failed State ------------------------------------------------------------------FIA_0 INGRESSQ_0 RX 20 1 1 0 EIO_LINK_TRAINED FIA_0 INGRESSQ_0 RX 21 1 1 0 EIO_LINK_TRAINED FIA_0 FABRICQ_0 TX 30 0 0 0 EIO_LINK_TRAINED FIA_0 FABRICQ_1 TX 31 0 0 0 EIO_ADD_LINK FIA_0 FABRICQ_0 TX 32 0 0 0 EIO_LINK_TRAINED FIA_0 FABRICQ_1 TX 33 0 0 0 EIO_ADD_LINK FIA_0 FABRICQ_0 TX 34 0 0 0 EIO_LINK_TRAINED FIA_0 FABRICQ_1 TX 35 0 0 0 EIO_ADD_LINK FIA_0 FABRICQ_0 TX 36 0 0 0 EIO_LINK_TRAINED FIA_0 FABRICQ_1 TX 37 0 0 0 EIO_ADD_LINK FIA_1 INGRESSQ_0 RX 22 1 1 0 EIO_LINK_TRAINED FIA_1 INGRESSQ_0 RX 23 1 1 0 EIO_LINK_TRAINED FIA_1 FABRICQ_0 TX 40 0 0 0 EIO_LINK_TRAINED FIA_1 FABRICQ_1 TX 41 0 0 0 EIO_ADD_LINK
HR-74
FIA_1 FABRICQ_0 FIA_1 FABRICQ_1 FIA_1 FABRICQ_0 FIA_1 FABRICQ_1 FIA_1 FABRICQ_0 FIA_1 FABRICQ_1 RP/0/RP0/CPU0:router#
TX TX TX TX TX TX
42 43 44 45 46 47
0 0 0 0 0 0
0 0 0 0 0 0
0 0 0 0 0 0
EIO_LINK_TRAINED EIO_ADD_LINK EIO_LINK_TRAINED EIO_ADD_LINK EIO_LINK_TRAINED EIO_ADD_LINK

Table 13 show controllers fia eio link Field Descriptions
Field ASIC Id Peer Id Type Link-Id Attempts Accept Failed State
Description Identifies the ASIC associated with the EIO link. Local peer IP address for the EIO link. Indicate whether this link is transmitting (TX) or receiving (RX) FIA information. Number that identifies the EIO link. Number of consecutive attempts to reach the local peer group. Number of successful calls to the local peer group. Number of failed attempts to reach the local peer group. Current state of the EIO link.
Related Commands
Command show controllers fia location show controllers fia register location
Description Displays FIA error information for a specific node. Displays FIA register information for a specific node.
HR-75
Platform and Driver Commands on Cisco IOS XR Software show controllers fia location
show controllers fia location

To display Fabric Interface ASIC (FIA) error information for a specific node, use the show controllers fia location command in EXEC mode. show controllers fia location node-id
Syntax Description
location node-id
Identifies the location of the node whose FIA information you want to display. The node-id is expressed in the rack/slot/module notation.
Note
Command Modes
EXEC
Command History
Release Release 3.1
Usage Guidelines
Examples
The following example shows how to display FIA error information for a specific node:
RP/0/0/CPU0:routername# show controllers fia location 0/2/CPU0 To-Fabric FIA Errors -------------------sca not pres grant parity cntrl parity multi fifo cell parity
0 0 0 0 0
req error multi req uni req empty dst req
0 uni fifo overflow 0 uni fifo underflow 0 0 handshake error
0 0 0
From-Fabric FIA Errors ---------------------cell drops 0 cell parity 0 Switch cards monitored 0x001f Slots 16 17 18 19 20 Slot: 18 19 20 21 22 Name: sfc0 sfc1 sfc2 sfc3 sfc4 -----------------------------------los 0 0 0 0 0 state Off Off Off Off Off crc16 0 0 0 0 0 RP/0/0/CPU0:routername#
HR-76
Table 14
show controllers fia location Field Descriptions
Field To-Fabric FIA Errors sca not pres
Description Errors that occur on packets going out a line card and through the switch fabric to another card. Number of errors that occur when the master SCA (Scheduler Control ASIC) is lost. The following errors are detected:
req errorThe SCA detected a parity error on the req lines uni fifo overflowNumber of unicast FIFO overflow
errors caused by a problem between the Buffer Management ASIC (BMA)/Cisco Cell Segmentation and Reassembly (CSAR) and the FIA. grant parity Number of grant parity errors that occurred on the FIA. Grant parity errors do not cause an interrupt. The FIA is polled once every second and errors are counted. The following errors are detected:
multi req Number of errored single destination cells in a
multicast request. The FIA sends these cell to their destination, and there is no drop.
uni fifo underflowNumber of unicast FIFO underflow
errors caused by the SCA granting without actually getting a request from the FIA cntrl parity Number of control parity errors on the FIA. The following errors are detected:
uni reqNumber of errored multidestination cells in a
unicast requests. The FIA drops these cells.

multi fifoNumber of multicast FIFO errors.
empty dst req
Number of empty destination requests received by the FIA. The FIA drops these cells. The following errors are detected:
handshake errorNumber of errors that accompany cell
parity errors that point out the reason of the problem.

cell parityNumber of errors that occurred in cells during
the SLI processing that removes 8B/10B encoding. From-Fabric FIA Errors cell drops cell parity Errors that occur on packets coming from the switch fabric toward a line card or a GRP. Number of cell drops on the FIA. Number of errors that occurred in cells during the SLI processing that removes 8B/10B encoding.
HR-77
Table 14
show controllers fia location Field Descriptions (continued)
Field Switch cards monitored
Description Bit mask of which fabric cards are currently present (powered up) and monitored (being used). The bits are broken down like this:

7 = unused 6 = unused 5 = unused 4 = SFC2 3 = SFC1 2 = SFC0 1 = CSC1 0 = CSC0
For example, 0x1F is 00011111, meaning all the cards are there. 0x1D would be 00011101, meaning that the bit for CSC1 is off. Slot name los state crc16 Identifies the slot that contains the card being monitored. Identifies the card that is being monitored. Number of times clock synchronization with the fabric card was lost. Synchronization status. On means that you are currently out of synchronization; off means that you are synchronized. Number of fabric cyclic redundancy check (CRC) errors that have occurred while talking to this particular fabric card. A high number is usually a sign of bad or poorly seated hardware. It is important to check whether the number of errors increases. If it does, you need to check whether the number of errors is increasing on all of the fabric cards, or on just one of them.
Related Commands
Command show controllers fia eio link show controllers fia register location
Description Displays FIA information for a specific EIO link, for all EIO links on the router, or for all EIO links on a specific node. Displays FIA register information for a specific node.
HR-78
Platform and Driver Commands on Cisco IOS XR Software show controllers fia register location
show controllers fia register location

To display Fabric Interface ASIC (FIA) register information for a specific node, use the show controllers fia register location command in EXEC mode. show controllers fia register location node-id
Syntax Description
location node-id
Identifies the location of the node whose FIA registers you want to display. The node-id is expressed in the rack/slot/module notation.
Note
Command Modes
EXEC
Command History
Release Release 3.1
Usage Guidelines
Examples
The following example shows how to display FIA register information for a specific node:
RP/0/0/CPU0:routername# show controllers fia register location 0/2/CPU0 To-Fabric FIA Registers ----------------------fia_config 0x5f masked_interrupts los_link_error asic_id halt fia_cntrl resync_delay fab_error bma_parity_error fifo_overflow fifo_underflow other_fifo_error cc_fifo_parity_error tofab_bma_handshakeerr soft_req_error los_err0..los_err4 cell_drop_cntrl crc16_err0..crc16_err4 diag_cntrl, loop_mode force crc, parity
0x10 0x00 0x21a5 0x00 0x02 resync-en 0xff 0x00 0x00 0x0000 0x0000 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00
sca1-sel sc0-pres sc1-pres sc2-pres sc3-pres sc4-pres serial-link
0x00 0x00
HR-79
From-Fabric FIA Registers ------------------------fia_config 0x5f masked_interrupts los_link_error asic_id halt fia_cntrl resync_delay los_error los_status crc_error other_fifo_error cc_fifo_parity_error los_err0..los_err4 cell_drop_cntrl crc16_err0..crc16_err4 diag_cntrl, loop_mode force crc, parity RP/0/0/CPU0:routername# 0x3c
sca1-sel sc0-pres sc1-pres sc2-pres sc3-pres sc4-pres handshake-err serial-link fab-error bma-perror
0x00 0x21a5 0x00 0x02 resync-en 0xff 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00
0x00 0x00

Table 15 show controllers fia register location Field Descriptions
Field To-Fabric FIA Registers fia_config masked_interrupts los_link_error asic_id halt fia_cntrl resync_delay los_error los_status crc_error other_fifo_error cc_fifo_parity_error los_err0..los_err4 cell_drop_cntrl
Description Displays register information for cells going out a line card and through the switch fabric to another card. Displays FIA configuration register values (register map byte addresses). Displays masked interrupts register values (register map byte addresses). Displays los link error register values (register map byte addresses). Displays ASIC ID register values (register map byte addresses). Displays halt register values (register map byte addresses). Displays FIA controller register values (register map byte addresses). Displays resync delay register values (register map byte addresses). Displays LOS error register values (register map byte addresses). Displays LOS status register values (register map byte addresses). Displays CRC error register values (register map byte addresses). Displays FIFO register values (register map byte addresses). Displays CC FIFO register values (register map byte addresses). Displays los err0 and err4 register values (register map byte addresses). Displays cell drop controller register values (register map byte addresses).
HR-80
Table 15
show controllers fia register location Field Descriptions (continued)
Field crc16_err0..crc16_err4 diag_cntrl, loop_mode force crc, parity From-Fabric FIA Registers
Description Displays CRC16 err0 and err4 register values (register map byte addresses). Displays diagnostics controller and loop mode register values (register map byte addresses). Displays force CRC and parity register values (register map byte addresses). Displays register information for packets coming from the switch fabric toward a line card or a GRP.
Related Commands
Command show controllers fia eio link show controllers fia location
Description Displays FIA information for a specific EIO link, for all EIO links on the router, or for all EIO links on a specific node. Displays FIA error information for a specific node.
HR-81
Platform and Driver Commands on Cisco IOS XR Software show controllers fia rxslice
show controllers fia rxslice

To display Fabric Interface ASIC (FIA) information for a specific receive slice on the router, or for all receive slices on a specific node, use the show controllers fia rxslice command in EXEC mode. show controllers fia rxslice {receive_slice | all} [location node-id]
Syntax Description
receive_slice all location node-id
Identifies the receive slice whose FIA information you want to display. Displays FIA information for all receive slices on the router, or on a specific node. (Optional) Identifies the location of the node whose FIA information you want to display. The node-id is expressed in the rack/slot/module notation.
Note
Command Modes
EXEC
Command History
Usage Guidelines
Examples
The following example shows how to display FIA information for the receive slice identified by the number 1:
RP/0/RP0/CPU0:router# show controllers fia rxslice 1 Node: 0/0/CPU0: ---------------------------------------FIA 0, Receive Slice 1 Info: -----------------------------cell check register base : 0x608e8c00 slice PLL lock ? slice clock status ? : 1 slice clock channel FIA 1, Receive Slice 1 Info: -----------------------------cell check register base : 0x648e8c00 slice PLL lock ? slice clock status ? : 1 slice clock channel Node: 0/3/CPU0:
: 1 : 0
: 1 : 0
HR-82
Platform and Driver Commands on Cisco IOS XR Software show controllers fia rxslice
---------------------------------------FIA 0, Receive Slice 1 Info: -----------------------------cell check register base : 0x608e8c00 slice PLL lock ? slice clock status ? : 1 slice clock channel FIA 1, Receive Slice 1 Info: -----------------------------cell check register base : 0x648e8c00 slice PLL lock ? slice clock status ? : 1 slice clock channel Node: 0/RP0/CPU0: ---------------------------------------FIA 0, Receive Slice 1 Info: -----------------------------cell check register base : 0x608e8c00 slice PLL lock ? slice clock status ? : 1 slice clock channel FIA 1, Receive Slice 1 Info: -----------------------------cell check register base : 0x648e8c00 slice PLL lock ? slice clock status ? : 1 slice clock channel RP/0/RP0/CPU0:router#
: 1 : 0
: 1 : 0
: 1 : 0
: 1 : 0

Table 16 show controllers fia rxslice Field Descriptions
Field cell check register base slice PLL lock ? slice clock status ? slice clock channel
Description Address in hex of the cell check register base. Per Rx Slice PLL lock status bit vector. Displays the current status of the receive slice clock. Displays the receive slice channel ID.
Related Commands
Command show controllers fia txslice
Description Displays FIA information for a specific transmit slice on the router, or for all receive slices on a specific node.
HR-83
Platform and Driver Commands on Cisco IOS XR Software show controllers fia summary
show controllers fia summary

T o display summarized Fabric Interface ASIC (FIA) information for a specific controller instance or node, use the show controllers fia summary command in EXEC mode. show controllers fia summary [instance {0 | 1}] [location node-id]
Syntax Description
instance {0 | 1}
(Optional) Identifies the device whose FIA information you want to display. Enter 0 to specify the ingress device, and 1 to specify the egress device. (Optional) Identifies the location of the node whose FIA information you want to display. The node-id is expressed in the rack/slot/module notation.
Note
location node-id
Command Modes
EXEC
Command History
Usage Guidelines
Examples
The following example shows how to display summarized information for the controller instance identified by the number 1:
RP/0/RP0/CPU0:router# show controllers fia summary instance 0 Node: 0/0/CPU0: ---------------------------------------FIA 0, Summary Info: ---------------------Device Name Cpuctrl Net Port Chip ID Asic Id Rack Type Card Type Default Unilink Constants IOS-XR Interrupt Level
: : : : : : :
FIA Cpuctrl Net Device Instance: 0 1 Cpuctrl Device Id : 6 0x10269000 Device Id : 0 8 MiniQ Chassis LC No
: 100
HR-84
Cpuctrl Interrupt Level
: 4 0x84000000 0x60448118 0x60848000 0x02000000 0x02000000
IOS-XR Run priority
: 4
Cpuctrl Net PCI Base : CpuctrlNet Mapping register: Base register address : PCI indirect window base : PCI indirect window size : Reset Mask Interrupt Mask Slice PLL Lock status Loopback Configuration : : : :
Cpuctrl Net PCI size : 0x04000000 Driver register base : 0x60848000 Cpuctrl register base addr : 0x60868000 PCI fixed window size : 0x02000000 PCI current map base : 0x00000000
0x00000000 0x0001fffe Interrupt Status 0x0000003f Slice Clock Status 0x00000000
: 0x00000000 : 0x00000000
Node: 0/3/CPU0: ---------------------------------------FIA 0, Summary Info: ---------------------Device Name Cpuctrl Net Port Chip ID Asic Id Rack Type Card Type Default Unilink Constants IOS-XR Interrupt Level Cpuctrl Interrupt Level
: : : : : : :
FIA Cpuctrl Net Device Instance: 0 1 Cpuctrl Device Id : 6 0x10269000 Device Id : 0 8 MiniQ Chassis LC No
: 100 : 4 0x84000000 0x60448118 0x60848000 0x02000000 0x02000000
IOS-XR Run priority
: 4
Cpuctrl Net PCI Base : CpuctrlNet Mapping register: Base register address : PCI indirect window base : PCI indirect window size : Reset Mask Interrupt Mask Slice PLL Lock status Loopback Configuration : : : :
0x00000000 0x0001fffe Interrupt Status 0x0000003f Slice Clock Status 0x00000000
: 0x00000000 : 0x00000000
Node: 0/RP0/CPU0: ---------------------------------------FIA 0, Summary Info: ---------------------Device Name Cpuctrl Net Port Chip ID Asic Id Rack Type Card Type Default Unilink Constants IOS-XR Interrupt Level Cpuctrl Interrupt Level
: : : : : : :
FIA Cpuctrl Net Device Instance: 0 1 Cpuctrl Device Id : 6 0x10269000 Device Id : 0 8 MiniQ Chassis RP No
: 100 : 4 0x84000000 0x60448118 0x60848000 0x02000000 0x02000000
IOS-XR Run priority
: 4
Cpuctrl Net PCI Base : CpuctrlNet Mapping register: Base register address : PCI indirect window base : PCI indirect window size : Reset Mask Interrupt Mask
: 0x00000000 : 0x0001fffe Interrupt Status
: 0x00000000
HR-85
Slice PLL Lock status Loopback Configuration RP/0/RP0/CPU0:router#
: 0x0000003f Slice Clock Status : 0x00000000
: 0x00000000

Table 17 show controllers fia summary Field Descriptions
Field Device Name Cpuctrl Net Device Instance Cpuctrl Net Port Cpuctrl Device Id Chip ID Device Id Asic Id Rack Type Card Type Default Unilink Constants IOS XR Interrupt Level
Description Device on display. For the show controllers fia summary command, the device is always FIA. Instance on display. The device instance is either 0 or 1. CPU controller network port. CPU controller device. Internal FIA chip. FIA device. FIA identifier. Describes the chassis. Type of card whose CPU controller FIA information is displayed. For example, RP (route processor). Displays whether a UNI link constant is associated with the FIA. Level at which the arrival of a packet on the router triggers an interrupt, which causes the CPU to postpone other tasks and handle the packet. Level at which the arrival of a packet on the CPU controller triggers an interrupt, which causes the CPU to postpone other tasks and handle the packet. IOS XR run priority queue. Internal CPU controller network PCI base register. Internal CPU controller network PCI size register. Internal CPU controller networking mapping register. Internal CPU driver register Internal base register address. Internal CPU controller register base address. PCI indirect window base register. PCI fixed window size register. PCI indirect window size register. PCI current map base register. Reset mask register. Interrupt mask register. Interrupt status register. Slice PLL lock status register.
Cpuctrl Interrupt Level
IOS XR Run priority Cpuctrl Net PCI Base Cpuctrl Net PCI size CpuctrlNet Mapping register Driver register base Base register address Cpuctrl register base addr PCI indirect window base PCI fixed window size PCI indirect window size PCI current map base Reset Mask Interrupt Mask Interrupt Status Slice PLL Lock status
HR-86
Table 17
show controllers fia summary Field Descriptions (continued)
Field Slice Clock Status Loopback Configuration
Description Slice clock status register. Loopback configuration register.
HR-87
Platform and Driver Commands on Cisco IOS XR Software show controllers fia txslice
show controllers fia txslice

To display Fabric Interface ASIC (FIA) information for a specific transmit slice on the router, or for all transmit slices on a specific node, enter the show controllers fia txslice command in EXEC mode. show controllers fia txslice {slice_number | all} [location node-id]
Syntax Description
slice_number
Identifies the receive slice whose FIA information you want to display. Replace slice_number with the number of a receive slice. Range is from 0 through 4294967295. Displays FIA information for all receive slices on the router, or on a specific node. (Optional) Identifies the location of the node whose FIA information you want to display. The node-id is expressed in the rack/slot/module notation.
Note
Command Modes
EXEC
Command History
Usage Guidelines
Examples
The following example shows how to display FIA information for the transmit slice identified by the number 1:
RP/0/RP0/CPU0:router# show controllers fia txslice 1 Node: 0/0/CPU0: ---------------------------------------FIA 0, Transmit Slice 1 Info: ------------------------------cell gen register base : 0x608a8c00 cell generation enable ? slice PLL lock ? : 1 FIA 1, Transmit Slice 1 Info: ------------------------------cell gen register base : 0x648a8c00 cell generation enable ? slice PLL lock ? : 1
: 0
: 0
HR-88
Platform and Driver Commands on Cisco IOS XR Software show controllers fia txslice
Node: 0/3/CPU0: ---------------------------------------FIA 0, Transmit Slice 1 Info: ------------------------------cell gen register base : 0x608a8c00 cell generation enable ? slice PLL lock ? : 1 FIA 1, Transmit Slice 1 Info: ------------------------------cell gen register base : 0x648a8c00 cell generation enable ? slice PLL lock ? : 1 Node: 0/RP0/CPU0: ---------------------------------------FIA 0, Transmit Slice 1 Info: ------------------------------cell gen register base : 0x608a8c00 cell generation enable ? slice PLL lock ? : 1 FIA 1, Transmit Slice 1 Info: ------------------------------cell gen register base : 0x648a8c00 cell generation enable ? slice PLL lock ? : 1 RP/0/RP0/CPU0:router#
: 0
: 0
: 0
: 0

Table 18 show controllers fia txslice Field Descriptions
Field cell gen register base cell generation enable ? slice PLL lock ?
Description Internal information about the cell generation register base. Internal information about the cell generation register base. Internal information about the phase lock loop (PLL) slice.
Related Commands
Command show controllers fia rxslice
Description Displays FIA information for a specific receive slice on the router, or for all receive slices on a specific node.
HR-89
Platform and Driver Commands on Cisco IOS XR Software show controllers ingressq statistics
show controllers ingressq statistics

To display ingress queue manager statistics, enter the show controller ingressq statistics command in EXEC mode. show controller ingressq statistics location location
Syntax Description
location location
Identifies the location of the ingress queue whose statistics you want to display.
Defaults
Command Modes
EXEC
Command History
Release Release 3.2
Usage Guidelines
Examples
The following example shows how to display ingress queue manager statistics:
RP/0/0/CPU0:router#show controller ingressq statistics location 0/2/CPU0 Ingressq Rx Statistics. -----------------------------------------------------------------------rx pkts : 131827 ( 33509182 bytes) rx pkts from cpu : 102509 ( 16422606 bytes) rx control pkts from cpu : 102509 ( 16422606 bytes) rx data pkts from cpu : 0 ( 0 bytes) Ingressq Tx Statistics. -----------------------------------------------------------------------tx pkts : 131826 ( 35086366 bytes) tx pkts to cpu : 29318 ( 17086576 bytes) tx control pkts to cpu : 29318 ( 17086576 bytes) tx data pkts to cpu : 0 ( 0 bytes) tx pkts shaped : 102508 ( 17999790 bytes) tx cells to fabric : 223190 Ingressq Drops. -----------------------------------------------------------------------length error drops - PSE : 0 length error drops - Cpuctrl : 0 crc error drops - PSE : 0 crc error drops - Cpuctrl : 0 OOR error drops - PSE : 0 OOR error drops - Cpuctrl : 0
HR-90
Platform and Driver Commands on Cisco IOS XR Software show controllers ingressq statistics
discard drops tail drops tail drops - no QE cell drops RP/0/0/CPU0:router#
: : : :
0 0 0 0
Related Commands
Command show controllers egressq eio links show controllers egressq group show controllers egressq interface show controllers egressq port show controllers egressq queue show controllers egressq statistics
Description Displays EIO information for the egress queueing ASIC. Displays information for about egress queue groups. Displays information about interfaces associated with an egress queue. Displays egress queue information for a port, or for several ports. Displays information about a specific egress queue, or a range of egress queues. Displays egress queue manager statistics.
HR-91
Platform and Driver Commands on Cisco IOS XR Software show controllers mgmteth
show controllers mgmteth

To display the register values of the Management Ethernet controller, enter the show controllers mgmteth command in EXEC mode. On a Cisco CRS-1, enter the show controllers mgmteth command as follows: show controllers mgmteth interface-instance {all | internal | mac | phy | stats} On a Cisco 12000 Series router, enter the show controllers mgmteth command as follows: show controllers mgmteth {0/0/CPU0/0 | 0/0/CPU0/1} {all | internal | mac | phy | stats | xgxs}
Syntax Description
interface-instance
Management Ethernet interface instance. Replace interface-instance with a Management Ethernet interface located on a route processor card. The physical slot number is alphanumeric (RP0 or RP1) and the module is CPU0. Example: 0/RP1/CPU0/0. Displays all information. Displays internal variable software values. Displays the register value of the Management Ethernet controller. Displays the register value of the physical device. Displays the hardware Management Information Base (MIB) counters. Displays information for MgmtEth Interface Instance 0. Displays information for MgmtEth Interface Instance 1. Displays Gigabit Ethernet XGMII Extender Sublayer (XGXS) information.
all internal mac phy stats 0/0/CPU0/0 0/0/CPU0/1 xgxs
Defaults
When no options are specified, all information is displayed.
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. The show controllers mgmteth command is used to display hardware and software information about the Management Ethernet interface.
HR-92
Examples
The following is sample output from the show controllers mgmteth command on the Cisco CRS-1 that displays all register values for the Management Ethernet interface located at 0/RP0/CPU0/0:
RP/0/RP0/CPU0:router# show controllers mgmteth 0/RP0/CPU0/0 MV64360 10/100/1000 Mb/s Ethernet controller port = 1 - base addr = 0xf1000000, intr level = 45 Controller registers: - Common regs: PhyAddr = 0x00000820 - SMI = 0x00011340 - EUDAR = 0x00000000 EUDIDR = 0x000000e0 - EUICR = 0x00000000 - EUIMR = 0x00000000 EUEAR = 0x00000000 - EUIAER = 0x00000000 - BA0 = 0x00002e00 SR0 = 0x1fff0000 - BA1 = 0x20002d00 - SR1 = 0x1fff0000 BA2 = 0x40002b00 - SR2 = 0x1fff0000 - BA3 = 0x60002700 SR3 = 0x1fff0000 - BA4 = 0x00000000 - SR4 = 0x00000000 BA5 = 0x00000000 - SR5 = 0x00000000 - HRBR = 0x00000000 HRCR = 0x00000000 - HARR0 = 0x00000000 - HARR1 = 0x00000000 HARR2 = 0x00000000 - HARR3 = 0x00000000 - BARER = 0x00000030 EPAPR0 = 0x00000fff - EPAPR1 = 0x00000fff - EPAPR2 = 0x00000fff - Port regs: PxCR = 0x00001000 - PxCXR = 0x00000000 - MII = 0x00218823 GMII = 0x00000006 - EVLANE = 0x00008100 - MACL = 0x0000ce50 MACH = 0x00059a3d - SDCR = 0x00800005 - DSCP0 = 0x00000000 DSCP1 = 0x00000000 - DSCP2 = 0x00000000 - DSCP3 = 0x00000000 DSCP4 = 0x00000000 - DSCP5 = 0x00000000 - DSCP6 = 0x00000000 PSCR = 0x00440e18 - VPT2P = 0x00000000 - PSR = 0x0000042a TQCR = 0x0000ff00 - TQFPC = 0x000000ff - PTTBRC = 0x000003ff MTU = 0x00000024 - PMTBS = 0x0000ffff - ICR = 0x00000000 ICER = 0x00000000 - PIMR = 0x00000807 - PEIMR = 0x001d0101 PxRFUTR = 0x00000000 - PxTFUTR = 0x00000000 - PxMFSR = 0x00000040 PxDFC = 0x00000000 - PxOFC = 0x00000000 - EUIAER = 0x00000000 - Rx current desc. ptr regs: CRDP_Q0 = 0x78cc5000 - CRDP_Q0 = 0x00000000 - CRDP_Q2 = 0x00000000 CRDP_Q1 = 0x00000000 - CRDP_Q4 = 0x00000000 - CRDP_Q3 = 0x00000000 CRDP_Q6 = 0x00000000 - CRDP_Q5 = 0x00000000 - Tx current desc. ptr regs: TCQDP_Q0 = 0x78cc2000 - TCQDP_Q1 = 0x00000000 - TCQDP_Q2 = 0x00000000 TCQDP_Q3 = 0x00000000 - TCQDP_Q4 = 0x00000000 - TCQDP_Q5 = 0x00000000 TCQDP_Q6 = 0x00000000 - TCQDP_Q7 = 0x00000000 - Tx queue regs: TQ0TBCn = 0x03ffffff - TQ0TBCf = 0x03ffffff - TQ0AC = 0x00000082 TQ1TBCn = 0x03ffffff - TQ1TBCf = 0x03ffffff - TQ1AC = 0x000000d6 TQ2TBCn = 0x03ffffff - TQ2TBCf = 0x03ffffff - TQ2AC = 0x000000c4 TQ3TBCn = 0x03ffffff - TQ3TBCf = 0x03ffffff - TQ3AC = 0x0000004c TQ4TBCn = 0x03ffffff - TQ4TBCf = 0x03ffffff - TQ4AC = 0x0000006d TQ5TBCn = 0x03ffffff - TQ5TBCf = 0x03ffffff - TQ5AC = 0x00000060 TQ6TBCn = 0x03ffffff - TQ6TBCf = 0x03ffffff - TQ6AC = 0x00000029 TQ7TBCn = 0x03ffffff - TQ7TBCf = 0x03ffffff - TQ7AC = 0x0000005b - Rx queue command regs: RQCR = 0x0000ff00 - Tx token bucket counter regs: PTTBC = 0x3fffeff7 PHY registers (My Company 88E1000): - Generic registers Ctrl(0) = 0x1140, Status(1) = 0x796d PHY Id #1(2) = 0x0141, PHY Id #2(3) = 0x0c54 Int Mask(18) = 0x0000, Int Cause(19) = 0x5e40 - Auto-Negotiation registers Advertisment(4) = 0x01e1, Expansion(6) = 0x0007 Link Partner Ability(5) = 0x40a1, Link Partner Next Page(8) = 0x0000 Next Page Transmit(7) = 0x2801 - 1000BaseT registers Ctrl(9) = 0x0a00, Status(10) = 0x0000, Ext. Status(15) = 0x3000
HR-93
- Specific registers Ctrl(16) = 0x0068, Status(17) = 0x5d80, Ext. Status(20) = 0x0060 LED ctrl(24) = 0x4100, Rx error cnt(21) = 0x0001 MIB counters: - Frames Sent (0 Bytes) Total = 0, Broadcast = 0, Multicast = 0 - Frames Received (0 Bytes) Total = 0, Good = 0 (0 Bytes), Broadcast = 0, Multicast = 0 Error CRC = 0, Oversizes = 0, Fragments = 0, Jabber = 0 Collision = 0, Late collision = 0, Undersize = 0, Others = 0 - Frames by size 64 bytes = 0, 65-127 bytes = 0, 128-255 bytes = 0 256-511 bytes = 0, 512-1023 bytes = 0, > 1023 bytes = 0

Table 19 show controllers mgmteth Field Descriptions
Field Ethernet controller Controller registers
Description Name, port number, base address, and interrupt level of the Management Ethernet interface. Displays register values (register map byte addresses) for the Management Ethernet interface. Register values are displayed for:

Common registersRegisters common to all Ethernet interfaces Port registersEthernet port registers Rx current desc. ptr regsReceived current descriptor pointer registers Tx current desc. ptr regsTransmitted current descriptor pointer registers Tx queue regsTransmit queue registers Rx queue command regsReceived queue command registers Tx token bucket counter regsTransmit token buckets counter registers Generic registersGeneric Ethernet registers Auto-negotiation registersAuto-negotiation registers 1000BASE-T registers1000BASE-T port registers Specific registersController-specific registers
Total (Frames Sent) Broadcast (Frames Sent) Multicast (Frames Sent)
MIB counter that displays the total number of frames sent (in bytes). MIB counter that displays the total number of broadcast frames sent (in bytes). MIB counter that displays the total number of multicast frames sent (in bytes).
HR-94
Table 19
show controllers mgmteth Field Descriptions (continued)
Field Total (Frames Received) Good (Frames Received) Broadcast (Frames Received) Multicast (Frames Received) CRC Oversizes Fragments Jabber
Description MIB counter that displays the total number of frames received (in bytes). MIB counter that displays the number of unerrored (good) frames received (in bytes). MIB counter that displays the number of broadcast frames received (in bytes). MIB counter that displays the number of multicast frames received (in bytes). MIB counter that displays the number of cyclic redundancy check (CRC) errors. MIB counter that displays the number of oversize errors experienced by the interface. MIB counter that displays the number of fragment errors experienced by the interface. MIB counter that displays the number of errors due to jabber, an error condition in which a device continually transmits random, meaningless data onto the network. MIB counter that displays the number of collision errors experienced by the interface. MIB counter that displays the number of late collision errors experienced by the interface. MIB counter that displays the number of undersize errors experienced by the interface. MIB counter that displays the number of other errors experienced by the interface (errors that are not related to CRC, oversizes, fragments, jabber, collision, or undersizes). MIB counter that displays the number of received 64-byte frames. MIB counter that displays the number of received frames that were between 65 and 127 bytes. MIB counter that displays the number of received frames that were between 128 and 255 bytes. MIB counter that displays the number of received frames that were between 256 and 511 bytes. MIB counter that displays the number of received frames that were between 512 and 1023 bytes. MIB counter that displays the number of received frames that were greater than 1023 bytes.
Collision Late collision Undersize Others
64 bytes 65-127 bytes = 0, 128-255 bytes 256-511 bytes 512-1023 bytes > 1023 bytes
HR-95
Platform and Driver Commands on Cisco IOS XR Software show controllers null interface
show controllers null interface

To display null interface counters, enter the show controllers null interface command in EXEC mode. show controllers null interface
Syntax Description
Command Modes
EXEC
Command History
Usage Guidelines
Examples
The following example shows how to display null interface counters:

RP/0/RP0/CPU0:router# show controllers null interface Null interface: name : Null0 handle : 0x00180010 rx_count : 0 tx_count : 0 drops : 0 RP/0/RP0/CPU0:router#

Table 20 show controllers null interface Field Descriptions
Field name handle rx_count tx_count drops
Description Null interface identifier. Internal interface identifier. Total number of packets currently received by the interface. Total number of packets currently transmitted by the interface. Total number of packets dropped by the interface.
HR-96
Platform and Driver Commands on Cisco IOS XR Software show controllers null interface
Related Commands
Command show controllers show interfaces
Description Displays information about a specific interface. Displays statistics for all interfaces configured on the router.
HR-97
Platform and Driver Commands on Cisco IOS XR Software show controllers plim asic
show controllers plim asic

To display physical layer interface module (PLIM) ASIC information for a specific node or interface, enter the show controllers plim asic command in EXEC mode. Use the following syntax on a Cisco CRS-1: show controllers plim asic {statistics {interface {POS interface_instance | TenGigE interface_instance}| summary} | summary} [location node-id] Use the following syntax on a Cisco 12000 Series router: show controllers plim asic {rx-channel bay {0 | 1} channel channel | spa {0 | 1} | tx-channel bay {0 | 1} channel channel_number} [location node-id]
Syntax Description
statistics interface POS interface_instance
Displays PLIM ASIC statistics for a specific interface, or summarized statistics information for all PLIM ASICS on a specific node. Displays statistical information for PoS interfaces only. The interface argument is expressed in the rack/slot/module/port notation.
Note
Enter the show interfaces command in EXEC mode to see a list of all interfaces the router.
interface TenGigE interface_instance
Displays statistical information for TenGigE interfaces only. The interface argument is expressed in the rack/slot/module/port notation.
Note
Enter the show interfaces command in EXEC mode to see a list of all interfaces the router.
summary location node-id
Displays a summarized information for PLIM ASICs on a specified node, or for all interfaces on the router. Identifies the location of the node whose PLIM ASIC information you want to display. The node-id is expressed in the rack/slot/module notation.
Note
rx-channel bay {0 | 1}
Displays statistical information for the SPI4.2 receive channel that is specified with the channel channel_number argument. Use 0 to indicate the bottom bay, or 1 to indicate the top bay. Displays statistical information for the SPA that is specified with the channel channel argument. Use 0 to indicate the bottom bay, or 1 to indicate the top bay. Displays statistical information for the SPI4.2 transmit channel. Use 0 to indicate the bottom bay, or 1 to indicate the top bay. Identifies the channel whose statistics you want to display. Replace channel_number with the number of the channel whose statistics you want to display. The channel range is from 1 through 255.
spa {0 | 1}
tx-channel bay {0 | 1} channel channel_number
Command Modes
EXEC
HR-98
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. To display statistics for a specific PLIM ASIC on a Cisco CRS-1, include the interface interface option in the command, as shown in the following example:
show controllers plim asic statistics interface interface
To display summarized statistics information for all PLIM ASICs on a specific node in a Cisco CRS-1, include the summary option in the command, as shown in the following example:
show controllers plim asic statistics summary
To display summarized PLIM ASIC port information on a Cisco CRS-1, enter the show controllers plim asic summary location node-id command. To display a summary of PLIM ASIC statistics on a Cisco CRS-1, enter the show controllers plim asic statistics summary location node-id command.
Examples
The following example shows how to display PLIM ASIC statistics information for a PoS interface on a Cisco CRS-1:
RP/0/RP0/CPU0:ios# show controllers plim asic statistics interface POS 0/2/0/0 Node: 0/2/CPU0 ------------------------------------------------------------------------------POS0/2/0/0 Tx Statistics ------------------------------------------------------------------------------TotalOctets : 78904040 TotalPkts : 1622308 Unicastpkts : 1622308 MulticastPkts : 0 BroadcastPkts : 0 <64Octets : 1610433 64Octets : 0 65to127Octets : 11875 128to255Octets : 0 256to511Octets : 0 512to1023Octets : 0 1024to1518Octets : 0 1519to1548Octets : 0 1549to9216Octets : 0 >9216Octet : 0 BadCRCPkts : 0 802.1QPkts : 0 Underrun : 0 Runt : 0 Giant : 0 PausePkts : 0 Jabbers : 0 DeferralAbort : 0 LateCollision : 0 CollisionAbort : 0 OneCollision : 0 MultiCollision : 0 TotalCollisions : 0 TotalDefer : 0 LateCollisionAbort: 0 LengthAbort : 0 TxBP count : 0 POS0/2/0/0 Rx Statistics --------------------------------------------------------------------------------More-- failed to get stats TotalOctets : 91010808 TotalPkts : 1815571 UnicastPkts : 1815571
HR-99
MulticastPkts 64Octets 128to255Octets 512to1023Octets 1519to1548Octets >9216Octets BadCodedPkts ShortPkts Drop ControlPkts BadPreamble
: : : : : : : : : : :
0 63846 7 0 0 0 0 1739874 0 0 0
BroadcastPkts 65to127Octets 256to511Octets 1024to1518Octets 1549to9216Octets BadCRCPkts Runt 802.1QPkts PausePkts Jabbers
: : : : : : : : : :
0 11844 0 0 0 0 0 0 0 0
POS0/2/0/0 Drop ------------------------------------------------------------------------------RxFiFO Drop : 0 PAR Tail Drop : 0 TxFIFO Drop : 0
RP/0/RP0/CPU0:ios#

Table 21 show controllers plim asic Field Descriptions
Field TotalOctets TotalPkts Unicastpkts MulticastPkts BroadcastPkts 64Octets
Description Number of octets received or transmitted on the interface. Number of Total packets received or transmitted on the interface. Number of unicast packets received or transmitted on the interface. Number of multicast packets received or transmitted on the interface. Received packets were directed to the multicast address. Number of of good broadcast packets received or transmitted. Received packets were directed to the broadcast address. Number of packets (including bad packets) received or transmitted that were less than 64 octets in length (excluding framing bits but including FCS octets). Number of packets (including bad packets) received or transmitted that were 64 octets in length (excluding framing bits but including FCS octets). Number of packets (including bad packets) received or transmitted that were between 65 and 127 octets in length inclusive (excluding framing bits but including FCS octets). Number of packets (including bad packets) received or transmitted that were between 128 and 255 octets in length inclusive (excluding framing bits but including FCS octets). Number of packets (including bad packets) received or transmitted that were between 256 and 511 octets in length inclusive (excluding framing bits but including FCS octets). Number of packets (including bad packets) received or transmitted that were between 512 and 1023 octets in length inclusive (excluding framing bits but including FCS octets).
64Octets
65to127Octets
128to255Octets
256to511Octets
512to1023Octets
HR-100
Table 21
show controllers plim asic Field Descriptions (continued)
Field 1024to1518Octets
Description Number of packets (including bad packets) received or transmitted that were between 1024 and 1518 octets in length inclusive (excluding framing bits but including FCS octets). Number of packets (including bad packets) received or transmitted that were between 1519 and 1548 octets in length inclusive (excluding framing bits but including FCS octets). Number of packets (including bad packets) received or transmitted that were between 1549 and 9216 octets in length inclusive (excluding framing bits but including FCS octets). Number of packets (including bad packets) received or transmitted that were greater than 9216 octets in length (excluding framing bits but including FCS octets). Number of packets received or transmitted that had a length (excluding framing bits, but including FCS octets) of between 64 and 1518 octets, inclusive, but had either a bad Frame Check Sequence (FCS) with an integral number of octets (FCS error) or a bad FCS with a nonintegral number of octets (alignment error). Number of 802.1QPkts received or transmitted on the interface. Number of packets that were not retrieved quickly enough from shared memory to be transmitted/received. Number of packets received or transmitted that were less than 64 octets long (excluding framing bits, but including FCS octets) and were otherwise well formed. Number of packets received or transmitted that were longer than 1518 octets (excluding framing bits, but including FCS octets) and were otherwise well formed. Number of pause packets transmitted/received on the interface. Pause packets that tell remote devices to delay sending more packets for a specified period of time. Number of packets received or transmitted that were longer than 1518 octets (excluding framing bits but including FCS octets) and had either a bad Frame Check Sequence (FCS) with an integral number of octets (FCS error) or a bad FCS with a nonintegral number of octets (assigned error). Number of deferral aborts that occurred on this segment. Number of late collisions on this segment Number of collisions that were aborted. Number of single collisions that occurred on this segment. Number multiple collisions that occurred on this segment. Number of collisions on this segment. Number of deferrals on this segment. Number of late collison aborts that occurred on this segment.
1519to1548Octets
1549to9216Octets
>9216Octet
BadCRCPkts
802.1QPkts Underrun Runt
Giant
PausePkts
Jabbers
DeferralAbort LateCollision CollisionAbort OneCollision MultiCollision TotalCollisions TotalDefer LateCollisionAbort
HR-101
Table 21
show controllers plim asic Field Descriptions (continued)
Field LengthAbort TxBP count Rx Statistics TX statistics RxFiFO Drop PAR Tail Drop TxFIFO Drop
Description Number of length aborts that occurred on this segment. Number of transmit BP on this segment. Indicates the statistics that follow were received by the interface. Indicates the statistics that follow were transmitted by the interface. Displays the receive FIFO drop information. Displays PAR tail drop information. Displays transmitted FIFO drop information.
Related Commands
Command show controllers plim asic pla show controllers plim asic pla768 eio show controllers plim asic pla768 ports
Description Displays PLIM ASIC information for a specific node. Displays Oc768 PLIM ASIC information for all EIO links on a specific node, for all EIO links on the router, or for a specific EIO link. Displays Oc768 PLIM ASIC port mapping information for a specific node.
HR-102
Platform and Driver Commands on Cisco IOS XR Software show controllers plim asic pla
show controllers plim asic pla

To display physical layer interface module (PLIM) ASIC platform information for a specific node, enter the show controllers plim asic pla command in EXEC mode. show controllers plim asic pla {clients | eio links {link | all} | error | packet mbp instance link entries | sbp | pointers} [location node-id]
Syntax Description
clients eio links link eio links all packet mbp instance
Displays PLA clients. Displays PLA information for a specific Elastic I/O (EIO) link. Replace the link argument with a number. Range is from 0 through 107151. Displays PLA information for all EIO links on the router, or on a specified node. Displays dump packet information for the Management Bus Protocol (MBP) buffer. Enter the packet mbp keywords, followed by the number of the PLA instance whose MBP buffer information you want to display. Range is from 1 through 3. Starting number of the MBP entry whose PLA information you want to display. Replace the link argument with a number. Range is from 0 through 10751. Number of MBP entries you wish to display, starting with the entry number you entered for the eio links link argument. Replace the entries argument with a number. Range is from 1 through 2500. For example, if you entered show controllers plim asic plapacket mbp 1 3 250, then the output shows dump packet information for the MBP buffer PLA instance1, starting with MBP entry 3, and ending with entry 253.
link
entries
error sbp pointers location node-id
Displays PLA errors. Displays Sharq back pressure table. Displays PLA pointers. (Optional) Identifies the location of the node whose PLIM ASIC information you want to display. The node-id is expressed in the rack/slot/module notation.
Note
Command Modes
EXEC
Command History
HR-103
Platform and Driver Commands on Cisco IOS XR Software show controllers plim asic pla
Usage Guidelines
Examples
The following example shows how to display PLIM ASIC information for all EIO links on the router.
RP/0/0/CPU0:router# show controllers plim asic pla eio links 1 Node: 0/1/CPU0: ---------------------------------------EIO link: 1 ------------------------------------------------------------------ASIC Id Peer Id Type Link-Id Attempts Accept Failed State ------------------------------------------------------------------PLIM-ASIC_0 PSE_0 TX 1 0 0 0 EIO_LINK_TRAINED ------------------------------------------------------------------RP/0/0/CPU0:router#

Table 22 show controllers plim asic pla Field Descriptions
Field ASIC Id Peer Id Type Link-Id Attempts Accept Failed State
Description ASIC associated with the specified EIO link. Local peer group associated with the specified EIO link. Whether the link endpoint is a transmitting or receiving packet. EIO link identifier. Number of consecutive attempts to reach the local peer group. Number of successful calls to the local peer group. Number of failed attempts to reach the local peer group. Current state of the EIO link.
HR-104
Platform and Driver Commands on Cisco IOS XR Software show controllers plim asic pla768 eio
show controllers plim asic pla768 eio

To display Oc768 physical layer interface module (PLIM) ASIC information for all Elastic I/O (EIO) links on a specific node, for all EIO links on the router, or for a specific EIO link, enter the show controllers plim asic pla768 eio command in EXEC mode. show controllers plim asic pla768 eio {links {number | all} [location {node-id | all}]
Syntax Description
links number
Identifies the EIO link whose Oc768 PLIM ASIC information you want to display. Replace number with the link ID. The range is from 0 through 4294967295.
Note
Enter the show controllers plim asic pla768 eio links all command to obtain the link ID associated with the specific EIO link whose Oc768 PLIM ASIC information you want to display.
links all location node-id
Displays Oc768 PLIM ASIC information for all EIO links on the router. (Optional) Identifies the location of the node whose PLIM ASIC information you want to display. The node-id is expressed in the rack/slot/module notation. Note Enter the show platform command to see the location of all nodes installed in a router. (Optional) Displays Oc768 PLIM ASIC information for all nodes installed in the router.
location all
Command Modes
EXEC
Command History
Usage Guidelines
HR-105
Platform and Driver Commands on Cisco IOS XR Software show controllers plim asic pla768 eio
Examples
The following example shows how to display Oc768 PLIM ASIC information for all EIO links on a specific node, for all EIO links on the router, or for a specific EIO link:
RP/0/RP0/CPU0:foster-city# show controllers plim asic pla768 eio links all Node:0/0/CPU0: ---------------------------------------EIO links: ------------------------------------------------------------------ASIC Id Peer Id Type Link-Id Attempts Accept Failed State ------------------------------------------------------------------REINDEER_0 EGRESSQ_0 RX 60 1 1 0 EIO_LINK_TRAINED REINDEER_0 PSE_0 TX 70 1 1 0 EIO_LINK_TRAINED RP/0/RP0/CPU0:foster-city#

Table 23 show controllers plim asic pla768 eio Field Descriptions
Field Node: EIO links
Description Identifies the node whose Oc768 PLIM ASIC information information is displayed. Describes the following information EIO link or links:

ASIC IdIdentifies the ASIC associated with the specified EIO link. Peer IdIdentifies the local peer group associated with the specified EIO link. TypeIndicates whether the link endpoint is a transmitting or receiving packet. Link-IdIdentifies the EIO link. Attempts Number of consecutive attempts to reach the local peer group. AcceptNumber of successful calls to the local peer group. Failed Number of failed attempts to reach the local peer group. StateCurrent state of the EIO link.
Related Commands
Command show controllers plim asic pla show controllers plim asic pla768 ports
Description Displays PLIM ASIC information for a specific node. Displays Oc768 PLIM ASIC port mapping information for a specific node.
HR-106
Platform and Driver Commands on Cisco IOS XR Software show controllers plim asic pla768 ports
show controllers plim asic pla768 ports

To display Oc768 physical layer interface module (PLIM) ASIC port mapping information for specific node, enter the show controllers plim asic pla768 command in EXEC mode. show controllers plim asic pla768 ports location node-id
Syntax Description
ports location node-id
Displays port mapping information for a specific node. Identifies the location of the node whose PLIM ASIC port mapping information you want to display. The node-id argument is expressed in the rack/slot/module notation.
Note
Enter the show platform command to see the location of all nodes installed in a router.
Command Modes
EXEC
Command History
Usage Guidelines
Examples
The following example shows how to display Oc768 PLIM ASIC port mapping information for a specific node:
RP/0/RP0/CPU0:foster-city# show controllers plim asic pla768 ports location 0/0/cpu0 Node:0/0/CPU0 ------------------------------------------------------------------------------Oc768 Plim Asic, Port Info: -------------------------Interface Name :POS0/0/0/0 Interface Handle Rx Logical Port :0x00000041 Tx Logical Port RP/0/RP0/CPU0:foster-city#
:0x01080060 :0x00000002
HR-107
Platform and Driver Commands on Cisco IOS XR Software show controllers plim asic pla768 ports
Table 24
show controllers plim asic pla768 ports Field Descriptions
Field Node Oc768 Plim Asic, Port Info:
Description Identifies the node whose Oc768 PLIM ASIC port information information is displayed. Describes the following Oc768 PLIM ASIC port mapping information: Interface NameIdentifies the interface, in the format Interface HandleHexadecimal number that identifies the interface whose Oc768 PLIM ASIC port mapping information you want to display. Rx Logical PortHexadecimal number that identifies the receive logical port. Tx Logical Port Hexadecimal number that identifies the transmit logical port.
Related Commands
Command show controllers plim asic pla show controllers plim asic pla768 eio
Description Displays PLIM ASIC information for a specific node. Displays Oc768 PLIM ASIC port mapping information for a specific node.
HR-108
Platform and Driver Commands on Cisco IOS XR Software show controllers pse egress gather
show controllers pse egress gather

To display transmitted packet switching engine (PSE) packet gather stage programming information for a specific job, enter the show controllers pse egress gather command in EXEC mode. show controllers pse egress gather {id number | job name} location node-id
Syntax Description
id number
Identifies the job whose egress gather stage programming information you want to display. Replace number with the number of the job you want to displa. Range is from 0 through 4294967295. Identifies the job whose egress gather stage programming information you want to display. Replace name with the name of the job you want to display. Identifies the location of the node whose PSE information you want to display. The node-id is expressed in the rack/slot/module notation.
Note
job name
location node-id
Command Modes
EXEC
Command History
Release Release 3.1
Examples
The following command shows how display PSE packet gather stage programming information for a specific job:
RP/0/0/CPU0:routername show controllers pse egress gather id 1 location 0/3/CPU0 RX_IPV4_U_FBHDR -> (Not enough memory) RP/0/0/CPU0:routername
Related Commands
show controllers pse egress precam show controllers pse ingress gather show controllers pse ingress precam show controllers pse mem show controllers pse trace pmugger
Displays transmitted PSE precam information for a specific controller, node, or interface. Displays received PSE gather stage programming information for a specific job. Displays received PSE precam information for a specific controller, node, or interface. Displays PSE information about the memory banks on a specific controller or node. Displays received PSE trace information for a specific controller or node.
HR-109
Platform and Driver Commands on Cisco IOS XR Software show controllers pse egress precam
show controllers pse egress precam

To display transmitted packet switching engine (PSE) information for a specific controller, node, or interface, enter the show controllers pse egress precam command in EXEC mode. show controllers pse egress precam {hardware {1 | 0}{index bitmap | lufifo register | lureg register} | ifhandle ifhandle {interface {GigabitEthernet instance | Loopback interface | MgmtEth instance | Null 0| POS {1 | 0} | tunnel-ipsec instance} | subtype interface} | subtype interface} [location node-id]
Syntax Description
hardware {1 | 0}
Displays precam instance data extracted from the hardware. Replace precam_instance with the number that identifies the precam instance whose receive data you want to display. Enter 1 for the first instance, or 2 for the second instance. Identifies a bitmap whose PSE receive information you want to display. Replace bitmap with the number of the bitmap whose information you want to display. Range is from 0 through 255. Identifies a lookup FIFO whose information you want to display. Replace register with the number of the FIFO whose information you want to display. Range is from 0 through 32. Identifies a lookup register whose information you want to display. Replace register with the number of the register whose information you want to display. Range is from 0 through 32. Identifies an interface whose precam information you want to display. Replace ifhandle with the number that identifies the interface you want to display. Range is from 0-4294967295.
Note
index bitmap
lufifo register
lureg register
ifhandle ifhandle
The ifhandle is an internal alternative to the interface option.
interface
Displays precam information for a specific interface. Enter the interface keyword, followed by one of the following interface options:

GigabitEthernet instance Loopback instance MgmtEth instance Null 0 POS instance
GigabitEthernet instance
Identifies a Gigabit Ethernet interface. Replace instance with the number that identifies the Gigabit Ethernet interface whose precam egress information you want to display.
Note
Enter the show controllers pse egress precam interface GigabitEthernet ? command to see a list of available Gigabit Ethernet interfaces.
HR-110
Loopback interface
Identifies a loopback interface. Replace interface with the number that identifies the loopback interface whose precam egress information you want to display. Range is from 0 through 65535. Identifies a Management Ethernet interface. Replace instance with the number that identifies the Ethernet interface whose precam egress information you want to display.
Note
MgmtEth instance
Enter the show controllers pse egress precam interface MgmtEth ? command to see a list of available management ethernet interfaces.
Null 0 POS instance
Identifies the Null interface. Identifies a SONET interface. Replace instance with the number that identifies the SONET interface whose precam egress information you want to display.
Note
Enter the show controllers pse egress precam interface POS ? command to see a list of available SONET Ethernet interfaces.
tunnel-ipsec instance
Identifies an IPSec tunnel interface. Replace instance with a number that identifies the IPSec interface you want to display. Range is from 0 through 4294967295. Identifies an interface subtype. Replace interface with a number the indicates an interface subtype. Range is from 0 through 4294967295. (Optional) Identifies the location of the node whose PSE information you want to display. The node-id is expressed in the rack/slot/module notation.
Note
subtype interface
location node-id
Command Modes
EXEC
Command History
Release Release 3.1
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. To display precam instance data for a specific bitmap, include the index bitmap parameter in the show controllers pse egress precam command string. To display precam instance data for a specific lookup FIFO, include the lufifo register parameter in the show controllers pse egress precam command string. To display precam instance data for a specific lookup register, include the lureg register parameter in the show controllers pse egress precam command string.
HR-111
To display subtype information for a specific interface, include the interface or ifhandle handle options in the command string, as shown in the following examples:
show controllers pse rx precam subtype 0-4294967295 interface instance show controllers pse rx precam subtype 0-4294967295 ifhandle 0-4294967295
Examples
The following example shows how to display received PSE gather information for a specific PoS interface:
P/0/0/CPU0:routername show controllers pse egress precam interface POS 0/3/0/0 location 0/3/CPU0 OS0_3_0_0 (JList: 3 locked: 1 times). UH: 0x0001000004000300 Running: 0x0200000000000000 Priority: 0x0300000000000000 Indexes: [-1][1]. Found 1 jobs 3: ACCT_IPV4_PJOB P/0/0/CPU0:routername

Table 25 show controllers pse egress precam Field Descriptions
Field JList UH Running Priority Indexes
Description Provides information about the Jlist. The Jlist is a component that allows the user to select one or more objects from a list. Address in hex of the UH flag. Address in hex of the Running flag. Address in hex of the Priority flag. Provides detailed index information about the PoS interface.
HR-112
Related Commands
show controllers pse egress gather show controllers pse ingress gather show controllers pse ingress precam show controllers pse mem show controllers pse trace pmugger
Displays transmitted PSE packet gather stage programming information for a specific job. Displays received PSE gather stage programming information for a specific job. Displays received PSE precam information for a specific controller, node, or interface Displays PSE information about the memory banks on a specific controller or node. Displays received PSE trace information for a specific controller or node.
HR-113
Platform and Driver Commands on Cisco IOS XR Software show controllers pse eio links
show controllers pse eio links

To display packet switching engine (PSE) information for Elastic I/O (EIO) links, enter the show controllers pse eio links command in EXEC mode. show controllers pse eio links {link_number | all} [location node-id]
Syntax Description
links link_number
Displays PSE information for the specified link. Replace link_number with a link number in the range from 1 through 4294967295.
Note
Enter the show controllers pse eio links all location node-id command to display all available EIO link IDs on a node.
links all location node-id
Displays PSE information for all links on the specified node. (Optional) Displays all EIO links on a specific node only. The node-id is expressed in the rack/slot/module notation.
Note
Command Modes
EXEC
Command History
Usage Guidelines
HR-114
Examples
The following example shows how to display PSE information for a specific EIO link:
RP/0/RP0/CPU0:router# show controllers pse eio links 50 location 0/0/CPU0 Node: 0/0/CPU0: ---------------------------------------EIO link: 50 ------------------------------------------------------------------ASIC Id Peer Id Type Link-Id Attempts Accept Failed State ------------------------------------------------------------------PSE_1 FABRICQ_0 RX 50 1 1 0 EIO_LINK_TRAINED ------------------------------------------------------------------Macro-id Windage Diag status ------------------------------------------------------------------0 4 0x0000 1 4 0x0000 2 4 0x0000 3 4 0x0000 ------------------------------------------------------------------RP/0/RP0/CPU0:router#

Table 26 show controllers pse eio Field Descriptions
Field Node EIO link ASIC Id Peer Id Type Link-Id Attempts
Description Node whose PSE information is displayed. EIO link whose information is displayed. ASIC associated with this EIO link. ASIC of the remote peer of this EIO link. Indicates whether this link is receiving or transmitting (re)training requests. Unique ID assigned by the system to the EIO link. Number of consecutive EIO training requests for the link made by the PSE driver to the peer.
Note
Typically, the PSE driver at the receive end of a link initiates the training of that EIO link. Therefore, the EIO links whose PSE driver is at the transmit end show a value of 0 for the Attempts field, even though those links are in the EIO_LINK_TRAINED state.
Accept
Number of PSE driver requests for training that were accepted by the peer. When a PSE driver request is accepted, training is started.
Note
Typically, the PSE driver at the receive end of a link initiates the training of that EIO link. Therefore, the EIO links whose PSE driver is at the transmit end show a value of 0 for the Accept field, even though those links are in the EIO_LINK_TRAINED state.
Failed
Number of times the training for this link failed for any reason.
HR-115
Table 26
show controllers pse eio Field Descriptions (continued)
Field State Macro-id Windage Diag status
Description Current state of the EIO link. Windage value used for the training, and the final status of the training for that windage.
Note
The Macro-id Windage Diag status field is displayed only when you ask EIO info for specific link.
Related Commands
show controllers pse ipc show controllers pse mp show controllers pse statistics show controllers pse summary
Displays PSE device information for IPCconnections, or for a specific IPC controller. Displays PSE information for the maintenance processor on a specific controller or node. Displays PSE statistics for a specific controller instance, or for a specific node. Displays a summary of PSE information for a specific controller or node.
HR-116
Platform and Driver Commands on Cisco IOS XR Software show controllers pse ingress gather
show controllers pse ingress gather

To display received packet switching engine (PSE) gather information for a specific job, enter the show controllers pse ingress gather command in EXEC mode. show controllers pse ingress gather {id number | job name} [location node-id]
Syntax Description
id number
Identifies the job whose egress gather stage programming information you want to display.Replace number with the number of the job you want to display. Range is from 0 through 4294967295. Identifies the job whose egress gather stage programming information you want to display. Replace name with the name of the job you want to display. (Optional) Identifies the location of the node whose PSE information you want to display. The node-id is expressed in the rack/slot/module notation.
Note
job name
location node-id
Command Modes
EXEC
Command History
Release Release 3.1
Usage Guidelines
Examples
The following example shows how to display received PSE gather information for a specific job:
RP/0/RP0/CPU0:router# show controllers pse ingress gather job RX_IPV4_U _FBHDR location 0/3/CPU0 RX_IPV4_U_FBHDR -> [2]:(2) [0x12000] :{@PHB.FS_Control_length+0n, 36n} [0x1130] :{@PHB.ADJ_alphabits_so__gather_taglen+0n, 2n} [0x15026] :{@PHB.BHDR_output_mask__reserved__ideal_freeq+6n, 42n} [0x1408058] :{IP @PHB.IP_version_ihl_tos_tl+0n, 16n} [0x1001110] :{@PHB.FS_TTL+0n, 2n} [0x85706a] :{LAST @PHB.IP_ttl_prot_checksum+2n, 174n} RP/0/RP0/CPU0:router#
HR-117
Platform and Driver Commands on Cisco IOS XR Software show controllers pse ingress gather
Related Commands
show controllers pse egress gather show controllers pse egress precam show controllers pse ingress precam show controllers pse mem show controllers pse trace pmugger
Displays transmitted PSE packet gather stage programming information for a specific job. Displays transmitted PSE precam information for a specific controller, node, or interface. Displays received PSE precam information for a specific controller, node, or interface Displays PSE information about the memory banks on a specific controller or node. Displays received PSE trace information for a specific controller or node.
HR-118
Platform and Driver Commands on Cisco IOS XR Software show controllers pse ingress precam
show controllers pse ingress precam

To display received packet switching engine (PSE) precam information for a specific controller, node, or interface, enter the show controllers pse ingress precam command in EXEC mode. show controllers pse ingress precam [hardware {1 | 2}{index bitmap | lufifo register | lureg register} | ifhandle ifhandle {interface {GigabitEthernet instance| Loopback instance | MgmtEth instance | Null 0| POS instance} | subtype interface} [location node-id]
Syntax Description
hardware {1 | 2}
Displays precam instance data extracted from the hardware. Enter 1 or 2 to specify the precam instance you want to display. Indicates a bitmap whose PSE receive information you want to display. Enter the index keyword followed by the number of the bitmap whose information you want to display. Range is from 0 through 255. Indicates a lookup FIFO whose information you want to display. Replace register with the number of the FIFO whose information you want to display. Range is from 0 through 32. Indicates a lookup register whose information you want to display. Replace register with the number of the register whose information you want to display. Range is from 0 through 32. Identifies an interface whose precam information you want to display. Replace register with the number that identifies the interface you want to display. Range is from 0-4294967295.
Note
index bitmap
lufifo register
lureg register
ifhandle ifhandle
You can use the ifhandle as an alternative to the interface option.
interface
Displays precam information for a specific interface. Enter the interface keyword, followed by one of the following interface options:

GigabitEthernet instance Loopback instance MgmtEth instance Null 0 POS instance
GigabitEthernet instance
Identifies a Gigabit Ethernet interface. Replace instance with the number that identifies the Gigabit Ethernet interface whose precam egress information you want to display.
Note
Enter the show controllers pse egress precam interface GigabitEthernet ? command to see a list of available Gigabit Ethernet interfaces.
Loopback instance
Identifies a loopback interface. Replace instance with the number that identifies the loopback interface whose precam egress information you want to display. Range is from 0 through 65535.
HR-119
MgmtEth instance
Identifies a Management Ethernet interface. Replace instance with the number that identifies the Ethernet interface whose precam egress information you want to display.
Note
Enter the show controllers pse egress precam interface MgmtEth ? command to see a list of available management ethernet interfaces.
Null 0 POS instance
Identifies the Null interface. Identifies a SONET interface. Replace instance with the number that identifies the SONET interface whose precam egress information you want to display.
Note
Enter the show controllers pse egress precam interface POS ? command to see a list of available SONET Ethernet interfaces.
subtype interface
Indicates an interface subtype. Replace interface with a number the indicates an interface subtype. Range is from 0 through 4294967295. (Optional) Identifies the location of the node whose PSE information you want to display. The node-id is expressed in the rack/slot/module notation.
Note
location node-id
Command Modes
EXEC
Command History
Release Release 3.1
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. To display precam instance data for a specific bitmap, include the index bitmap parameter in the command string. To display precam instance data for a specific lookup FIFO, include the lufifo register parameter in the command string. To display precam instance data for a specific lookup register, include the lureg register parameter in the command string. To display subtype information for a specific interface, include the interface or ifhandle handle options in the command string, as shown in the following examples:
show controllers pse rx precam subtype 0-4294967295 interface instance show controllers pse rx precam subtype 0-4294967295 ifhandle 0-4294967295
HR-120
Examples
The following example shows how to display received PSE precam information for a specific PoS interface:
RP/0/RP0/CPU0:router# show controllers pse ingress precam interface POS 0/3/0/0 location 0/3/CPU0 OS0_3_0_0 (JList: 3 locked: 1 times). UH: 0x0001000004000300 Running: 0x0200000000000000 Priority: 0x0300000000000000 Indexes: [-1][1]. Found 1 jobs 3: ACCT_IPV4_PJOB RP/0/RP0/CPU0:router#

Table 27 show controllers pse ingress precam Field Descriptions
Field JList UH Running Priority Indexes
Description Provides information about the Jlist. The Jlist is a component that allows the user to select one or more objects from a list. Address in hex of the UH flag. Address in hex of the Running flag. Address in hex of the Priority flag. Provides detailed index information about the PoS interface.
Related Commands
show controllers pse egress gather show controllers pse egress precam show controllers pse ingress gather show controllers pse mem show controllers pse trace pmugger
Displays transmitted PSE packet gather stage programming information for a specific job. Displays transmitted PSE precam information for a specific controller, node, or interface. Displays received PSE gather stage programming information for a specific job. Displays PSE information about the memory banks on a specific controller or node. Displays received PSE trace information for a specific controller or node.
HR-121
Platform and Driver Commands on Cisco IOS XR Software show controllers pse ipc
show controllers pse ipc

To display packet switching engine (PSE) device information for interprocess communication (IPC) connections, or for a specific IPC controller, enter the show controllers pse ipc command in EXEC mode. show controllers pse ipc {client-connection {connID | all} | cpuctrlif} [instance {0 | 1}] [location node-id]
Syntax Description
client-connection connID
Displays IPC information about the specified client connection. Replace connID with the client connection ID. Range is from 1 through 255. Displays IPC information about the all client connection. Displays IPC information about the specified PSE IPC CPU controller instance. (Optional) Identifies the PSE device whose information you want to display. Enter 0 to specify the ingress PSE device, or 1 to specify the egress PSE device.
Note
client-connection all cpuctrlif instance {0 | 1}
Follow the instance {0 | 1} argument with the location node-id argument to restrict the command to a specific node containing the specified device instance.
location node-id
(Optional) Identifies the location of the node whose PSE device information you want to display. The node-id is expressed in the rack/slot/module notation.
Note
Note
To display client connection IPC information for a specific device instance, include the instance {0 | 1} argument with the command, as shown in the following example:
show controllers pse ipc client-connection connId instance instance
To display client connection IPC information for a specific node location, include the location node-id argument with the command, as shown in the following example:
show controllers pse ipc client-connection connId location node-id
Command Modes
EXEC
HR-122
Command History
Usage Guidelines
Examples
The following command shows how to display PSE information for a specific IPC client-connection:
RP/0/RP0/CPU0:router# show controllers pse ipc client-connection 13 Node: 0/0/CPU0: ---------------------------------------PSE IPC Conn Info: ------------------------------------------------ConnId: 13 (hfr_pm) ConnOptions: 0 Clinfos: 0x482bf9f8 (Notif) 0 (Reply) ConnStateFlags: 0 ConnNotifFlags: 0 SendReqs: 0 (iHP) 4 (iNP) 0 (eHP) 0 (eNP) SendFiltered: 0 (iHP) 0 (iNP) 0 (eHP) 0 (eNP) SendFailed: 0 (iHP) 0 (iNP) 0 (eHP) 0 (eNP) RecvReqs: 0 RecvReqTouts: 0 RecvDatTouts: 0 RecvQState: 0/16
Node: 0/3/CPU0: ---------------------------------------PSE IPC Conn Info: ------------------------------------------------ConnId: 13 (hfr_pm) ConnOptions: 0 Clinfos: 0x482bf9f8 (Notif) 0 (Reply) ConnStateFlags: 0 ConnNotifFlags: 0 SendReqs: 0 (iHP) 4 (iNP) 0 (eHP) 0 (eNP) SendFiltered: 0 (iHP) 0 (iNP) 0 (eHP) 0 (eNP) SendFailed: 0 (iHP) 0 (iNP) 0 (eHP) 0 (eNP) RecvReqs: 0 RecvReqTouts: 0 RecvDatTouts: 0 RecvQState: 0/16 RP/0/RP0/CPU0:router#
HR-123
Table 28
show controllers pse ipc client-connection Field Descriptions
Field ConnId ConnOptions Clinfos
Description Connection identifier. Connection bind time options requested by the client creating this connection. Client information (clinfo) index number. The memory database is organized as a table of clinfos, which are indexed by the region id and maintained in shared memory. Bitmask containing the current state of the connection. Bitmask of the types of notifications that the client creating this connection has registered for. Number of PSE IPC send requests that client has made on this connection. Number of send requests that were filtered out (dropped) from the PSE driver due to any internal filter policy. Number of send requests that could not be handled by the PSE driver due to error conditions such as hardware I/O failures, lack of buffering space, and so forth. Number of data receive requests that the client has made on this connection. Number of data receive requests from the client that timed out because no data was received from PSE device. Number of times data was received from PSE device, but timed out because there was no receive request from client to pick up that data from the connection. Current state of the internal data receive FIFO queue. The internal data receive FIFO queue buffers data arriving from the PSE device for the connection, until the client sends a receive request for that data. The RecvQState is expressed in the X/Y notation, where X is current depth of the queue, and Y is the maximum depth allowed for the queue.
ConnStateFlags ConnNotifFlags SendReqs SendFiltered SendFailed
RecvReqs RecvReqTouts RecvDatTouts
RecvQState
The following command shows how to display PSE information for a specific IPC controller connection:
RP/0/RP0/CPU0:router# show controllers pse ipc cpuctrlif Node: 0/0/CPU0: ---------------------------------------Pse IPC cpuctrl if Information ------------------------------------------------Cpuctrl interface is up Normal Priority Tx I/F: BufBase 0x112190 BufSize 32768 PadBufp 0xec0af118 Seqnum 854 RORegNum 10 RORegVal 0x49f0 WORegNum 2 WORegVal 0x49f0 CDMACh 0 CDMAQ 3 HoldQ 0/512 CDMAPendQ 0/128 UnackQ 0/256 NumEnqs 854 NumRejs 0 NumDmaReqFails 0 NumDmaPendFails 0 NumMbxSpcFails 0 NumHldqOvflows 0 Normal Priority Rx I/F: NumPDMAEntries 64 NumEnqs 15 NumRejs 0
HR-124
Pse IPC cpuctrl if Information ------------------------------------------------Cpuctrl interface is up Normal Priority Tx I/F: BufBase 0x112190 BufSize 32768 PadBufp 0xec0af14c Seqnum 424 RORegNum 10 RORegVal 0x1c60 WORegNum 2 WORegVal 0x1c60 CDMACh 1 CDMAQ 3 HoldQ 0/512 CDMAPendQ 0/128 UnackQ 0/256 NumEnqs 424 NumRejs 0 NumDmaReqFails 0 NumDmaPendFails 0 NumMbxSpcFails 0 NumHldqOvflows 0 Normal Priority Rx I/F: NumPDMAEntries 64 NumEnqs 2 NumRejs 0 Node: 0/3/CPU0: ---------------------------------------Pse IPC cpuctrl if Information ------------------------------------------------Cpuctrl interface is up Normal Priority Tx I/F: BufBase 0x112190 BufSize 32768 PadBufp 0xec0af118 Seqnum 833 RORegNum 10 RORegVal 0xdb8 WORegNum 2 WORegVal 0xdb8 CDMACh 0 CDMAQ 3 HoldQ 0/512 CDMAPendQ 0/128 UnackQ 0/256 NumEnqs 833 NumRejs 0 NumDmaReqFails 0 NumDmaPendFails 0 NumMbxSpcFails 0 NumHldqOvflows 0 Normal Priority Rx I/F: NumPDMAEntries 64 NumEnqs 9 NumRejs 0 Pse IPC cpuctrl if Information ------------------------------------------------Cpuctrl interface is up Normal Priority Tx I/F: BufBase 0x112190 BufSize 32768 PadBufp 0xec0af14c Seqnum 409 RORegNum 10 RORegVal 0x5f70 WORegNum 2 WORegVal 0x5f70 CDMACh 1 CDMAQ 3 HoldQ 0/512 CDMAPendQ 0/128 UnackQ 0/256 NumEnqs 409 NumRejs 0 NumDmaReqFails 0 NumDmaPendFails 0 NumMbxSpcFails 0 NumHldqOvflows 0 Normal Priority Rx I/F: NumPDMAEntries 64 NumEnqs 2 NumRejs 0 RP/0/RP0/CPU0:router#
HR-125
Table 29
show controllers pse ipc cpuctrlif Field Descriptions
Field Cpuctrl interface is up Cpuctrl interface is down Normal Priority Tx I/F
Description Whether the connection is currently up or down. Displays the following transmit buffer information for the connection:

BufBase BufSize PadBufp Seqnum RORegNum RORegVal WORegNum WORegVal CDMACh CDMAQ HoldQ CDMAPendQ UnackQ NumEnqs NumRejs NumDmaReqFails NumDmaPendFails NumMbxSpcFails NumHldqOvflows NumPDMAEntries NumEnqs NumRejs
Normal Priority Rx I/F:
Displays the following receive buffer information for the connection:

Related Commands
show controllers pse eio links show controllers pse mp show controllers pse statistics show controllers pse summary
Displays PSE information for EIO (Elastic I/O) links, or for a specific controller. Displays PSE information for the maintenance processor on a specific controller or node. Displays PSE statistics for a specific controller instance, or for a specific node. Displays a summary of PSE information for a specific controller or node.
HR-126
Platform and Driver Commands on Cisco IOS XR Software show controllers pse mem
show controllers pse mem

To display packet switching engine (PSE) information from the memory banks on a specific controller or node, enter the show controllers pse mem command in EXEC mode. show controllers pse mem {plu bankId | sram bankId | tlu bankId} {detail | egress | ingress | location node-id}
Syntax Description
plu bankId
Identifies a pointer lookup (PLU) memory bank. If you include the bankId option with the show controllers pse plu command string, the output shows information for the specified bank only. Replace bankId with a bank identifier. Range is from 0 through 3. Identifies an SRAM memory bank. If you include the bankId option with the show controllers pse sram command string, the output shows information for the specified bank only. Replace bankId with a bank identifier. Range is from 0 through 3. Identifies a TLU memory bank. If you include the bankId option with the show controllers pse tlu command string, the output shows information for the specified bank only. Replace bankId with a bank identifier. Range is from 0 through 3. Displays detailed information about the memory bank. Displays transmit information only for the memory bank. Displays receive information only for the memory bank. Identifies the location of the node whose PSE memory information you want to display. The node-id is expressed in the rack/slot/module notation.
Note
sram bankId
tlu bankId
detail egress ingress location node-id
Command Modes
EXEC
Command History
Release Release 3.1
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. Keep the following guidelines in mind when entering the show controllers pse mem command:
To display detailed information about a specific memory bank, include the detail keyword after the bankId argument.
HR-127
To display memory bank egress information only, include the egress keyword after the bankId argument. To display memory bank ingress information only, include the ingress keyword after the bankId parameter. To display information about a memory bank on a specific node, include the location node-id keyword argument after the bankId argument. To display details about a memory bank on a specific node, include the location node-id keyword argument after the detail argument. To display detailed egress or ingress information for a memory bank, include the detail keyword after the egress or ingress keyword. To display egress or ingress information for a memory bank on a specific node, include the location node-id keyword argument after the egress or ingress keyword.
Examples
The following command shows how to display a detailed PSE PLU memory bank information for a specific node:
RP/0/0/CPU0:routername# show controllers pse mem plu detail location 0/8/CPU0 Mem name: HFA_RX_MEM_PLU0 Pool size: 67108864 bytes, Total Pages: 512, Page Size: 131072 Reserved Pages: 6 Free Pages: 506 98% Free Applications -----------Client GSR_IPV6_FWD: ---------------Pages owned: 0 Pages cached: 0 Total memory owned:0 Available:0 plu mtrie node ---------------Block size:4096 Blocks allocated:0 Total allocated:0 Available:0 plu leaf ---------------Block size:16 Blocks allocated:0 Total allocated:0 Available:0 Client GSR_IPV4_FWD: ---------------Pages owned: 0 Pages cached: 0 Total memory owned:0 Available:0 plu mtrie node ---------------Block size:4096 Blocks allocated:0 Total allocated:0 Available:0 plu leaf ---------------Block size:16 Blocks allocated:0 Total allocated:0 Available:0 RP/0/0/CPU0:routername#
HR-128
Table 30
show controllers pse mem Field Descriptions
Field Mem name Pool size Total Pages Page size Reserved Pages Free Pages Free Pages owned Pages cached Total memory owned Available plu mtrie node plu leaf
Description Identifies the memory bank whose information is displayed. Memory pool size, in bytes. Total number of pages that make up the memory pool. Size of the pages in the memory pool. Total number of reserved pages in the memory pool. Total number of free pages in the memory pool. Percent of total pages that are free. Total number of owned pages in the memory pool. Total number of cache pages in the memory pool. Total owned memory. Available memory in the pool. Displays internal information about the clients PLU mtrie node entry. Node entries point to other nodes and to leaves. Indicates that the following information is related to the clients leaf entry. The leaf entry is a terminal element in the mtrie lookup engine.
Note
PLU is an mtrie lookup engine that can fetch a leaf entry from an mtrie. The leaf entry has information which could result in more processing. The lookup is controlled by PLU registers and by the lookup target value.
Related Commands
show controllers pse egress gather show controllers pse egress precam show controllers pse ingress gather show controllers pse ingress precam show controllers pse trace pmugger
Displays transmitted PSE packet gather stage programming information for a specific job. Displays transmitted PSE precam information for a specific controller, node, or interface. Displays received PSE gather stage programming information for a specific job. Displays received PSE precam information for a specific controller, node, or interface Displays received PSE trace information for a specific controller or node.
HR-129
Platform and Driver Commands on Cisco IOS XR Software show controllers pse mp
show controllers pse mp

To display packet switching engine (PSE) information for the maintenance processor on a specific controller or node, enter the show controllers pse mp command in EXEC mode. show controllers pse mp [instance {0 | 1}] [location node-id]
Syntax Description
instance {0 | 1}
(Optional) Identifies the PSE device whose information you want to display. Enter 0 to specify the ingress PSE device, or 1 to specify the egress PSE device.
Note
location node-id
Note
Note
Command Modes
EXEC
Command History
Modification This command was introduced on the Cisco CRS-1 router. No modification. No modification.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. The instance and location optional keywords are not mutually exclusive. The instance keyword directs the command to a specific PSE device, and the location keyword directs the command to that device or devices on the specified modular services card. You can specify the instance and location options together in the same command. If you do not specify the instance {0 | 1} and location node-id arguments, the show controllers pse mp command takes effect on both device instances on all modular services cards.
HR-130
Examples
The following command shows how to display PSE maintenance processor information for a specific controller instance:
RP/0/RP0/CPU0:router# show controllers pse mp instance 1 Node: 0/0/CPU0: ---------------------------------------PSE 1, MP Info: ------------------------------------------------MIPC Subtask Context Information High Priority MIPC Mbox Info NumProc 0 NumUnsupp 0 NxtSeqNum 0 NumOOSeq 0 Norm Priority MIPC Mbox Info NumProc 429 NumUnsupp 0 NxtSeqNum 425 NumOOSeq 0 NumMsgsGtred 93 NumDMAErrDrops 5 NumGtrDisDrops MSTAT Subtask Context Information NumSegs 9 CntrsPerBrst 93 MinCycleMsecs 4000 --------- Seg[0] config ----------------SegId 0 SegBeg 0 SegEnd 3071 ExpBeg 0 ExpEnd 0 ExpRate 0 CycBefExp 0 --------- Seg[1] config ----------------SegId 1 SegBeg 3072 SegEnd 74239 ExpBeg 3072 ExpEnd 3072 ExpRate 0 CycBefExp 0 --------- Seg[2] config ----------------SegId 2 SegBeg 74240 SegEnd 107007 ExpBeg 74240 ExpEnd 74240 ExpRate 0 CycBefExp 0 --------- Seg[3] config ----------------SegId 3 SegBeg 107008 SegEnd 262143 ExpBeg 107008 ExpEnd 107008 ExpRate 0 CycBefExp --------- Seg[4] config ----------------SegId 4 SegBeg 262144 SegEnd 265215 ExpBeg 262144 ExpEnd 262144 ExpRate 0 CycBefExp --------- Seg[5] config ----------------SegId 5 SegBeg 265216 SegEnd 336383 ExpBeg 265216 ExpEnd 265216 ExpRate 0 CycBefExp --------- Seg[6] config ----------------SegId 6 SegBeg 336384 SegEnd 442367 ExpBeg 336384 ExpEnd 336385 ExpRate 1 CycBefExp --------- Seg[7] config ----------------SegId 7 SegBeg 442368 SegEnd 458751 ExpBeg 442368 ExpEnd 442368 ExpRate 0 CycBefExp --------- Seg[8] config ----------------SegId 8 SegBeg 458752 SegEnd 491519 ExpBeg 458752 ExpEnd 458752 ExpRate 0 CycBefExp CurrTokens 9 MaxTokens 44 MinTokens 11 CurrSeg 5 CurrCntr 289954 CntrsExp 66532 PktsExp 33266 DMAErrDrops 0 REDDrops 0 REDDelays 0 GtrDisDelays 0 CfgUpdsApp 1 SegUpdsApp 10 UpdsRej 0 Node: 0/3/CPU0: ---------------------------------------PSE 1, MP Info: ------------------------------------------------MIPC Subtask Context Information High Priority MIPC Mbox Info NumProc 0 NumUnsupp 0 NxtSeqNum 0 NumOOSeq 0 Norm Priority MIPC Mbox Info
HR-131
NumProc 416 NumUnsupp 0 NxtSeqNum 412 NumOOSeq 0 NumMsgsGtred 71 NumDMAErrDrops 4 NumGtrDisDrops MSTAT Subtask Context Information NumSegs 9 CntrsPerBrst 93 MinCycleMsecs 4000 --------- Seg[0] config ----------------SegId 0 SegBeg 0 SegEnd 3071 ExpBeg 0 ExpEnd 0 ExpRate 0 CycBefExp 0 --------- Seg[1] config ----------------SegId 1 SegBeg 3072 SegEnd 74239 ExpBeg 3072 ExpEnd 3072 ExpRate 0 CycBefExp 0 --------- Seg[2] config ----------------SegId 2 SegBeg 74240 SegEnd 107007 ExpBeg 74240 ExpEnd 74240 ExpRate 0 CycBefExp 0 --------- Seg[3] config ----------------SegId 3 SegBeg 107008 SegEnd 262143 ExpBeg 107008 ExpEnd 107008 ExpRate 0 CycBefExp --------- Seg[4] config ----------------SegId 4 SegBeg 262144 SegEnd 265215 ExpBeg 262144 ExpEnd 262144 ExpRate 0 CycBefExp --------- Seg[5] config ----------------SegId 5 SegBeg 265216 SegEnd 336383 ExpBeg 265216 ExpEnd 265216 ExpRate 0 CycBefExp --------- Seg[6] config ----------------SegId 6 SegBeg 336384 SegEnd 442367 ExpBeg 336384 ExpEnd 336415 ExpRate 1 CycBefExp --------- Seg[7] config ----------------SegId 7 SegBeg 442368 SegEnd 458751 ExpBeg 442368 ExpEnd 442368 ExpRate 0 CycBefExp --------- Seg[8] config ----------------SegId 8 SegBeg 458752 SegEnd 491519 ExpBeg 458752 ExpEnd 458752 ExpRate 0 CycBefExp CurrTokens 5 MaxTokens 44 MinTokens 11 CurrSeg 6 CurrCntr 398633 CntrsExp 1064256 PktsExp 33258 DMAErrDrops 0 REDDrops 0 REDDelays 0 GtrDisDelays 0 CfgUpdsApp 1 SegUpdsApp 10 UpdsRej 0 RP/0/RP0/CPU0:router#
HR-132
Table 31
show controllers pse mp Field Descriptions
Field MIPC Subtask Context Information
Description MIPC subtask information from the following mailboxes (queues):

Note
High Priority MIPC Mbox Norm Priority MIPC Mbox The MIPC MBox is a chunk of the MP DMEM that receives MIPC messages. The Norm Priority mailbox has buffer of 32 KB, while the High Priority Mbox has an 8 KB buffer.
High Priority MIPC Mbox Info
Mailbox (or queue) that receives high-priority MIPC messages. The following information is displayed for the High Priority MIPC Mbox:

NumProcNumber of MIPC messages that have been processed. NumUnsuppNumber of unsupported MIPC messages. NxtSeqNumSequence number of the message with respect to other messages sent on the same MIPC channel. NumOOSeqNumber of MIPC messages that were received out of sequence.
Norm Priority MIPC Mbox info Mailbox (or queue) that receives normal-priority MIPC messages. The following information is displayed for the High Priority MIPC Mbox:

NumProcNumber of MIPC messages that have been processed. NumUnsuppNumber of unsupported MIPC messages. NxtSeqNumIdentifies the sequence number of the message with respect to other messages sent on the same MIPC channel. NumOOSeqNumber of MIPC messages that were received out of sequence.
NumMsgsGtred NumDMAErrDrops NumGtrDisDrops MSTAT Subtask Context Information
Number of MIPC gather messages that have been processed. Number of MIPC gather messages that were dropped due to DMA errors. Number of MIPC gather messages that were dropped due to distribution errors. MSTAT subtask information from the following queues:

High Priority MIPC Mbox Norm Priority MIPC Mbox
The MIPC MBox is a chunk of the MP DMEM that receives MIPC messages. The Norm Priority mailbox has buffer of 32 KB, while the High Priority Mbox has an 8 KB buffer.
HR-133
Related Commands
show controllers pse eio links show controllers pse ipc show controllers pse statistics show controllers pse summary
Displays PSE information for EIO links, or for a specific controller. Displays PSE device information for IPC connections, or for a specific IPC controller. Displays PSE statistics for a specific controller instance, or for a specific node. PSE displays a summary of PSE information for a specific controller or node.
HR-134
Platform and Driver Commands on Cisco IOS XR Software show controllers pse statistics
show controllers pse statistics

To display packet switching engine (PSE) statistics for a specific controller instance, or for a specific node, enter the show controllers pse statistics command in EXEC mode. show controllers pse statistics [instance {0 | 1}] [location node-id]
Syntax Description
instance {0 | 1}
(Optional) Identifies the PSE device whose statistics you want to display. Enter 0 to specify the ingress PSE device, or 1 to specify the egress PSE device.
Note
location node-id
Note
Note
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. The instance and location optional keywords are not mutually exclusive. The instance keyword directs the command to specific PSE device, and the location keyword directs the command to that device or devices on the specified modular services card. You can specify the instance and location options together in the same command. If you do not specify the instance {0 | 1} and location node-id arguments, the show controllers pse statistics command takes effect on both device instances on all modular services cards.
HR-135
Examples
The following command shows how to display PSE statistics for a specific controller instance:
RP/0/RP0/CPU0:router# show controllers pse statistics instance 0 Node: 0/0/CPU0: ---------------------------------------PSE 0, Statistics Info: ------------------------------------------------NULL_STATS_PTR : 0 MPLS_FWD_STATS_MEM_OOR : 0 LAYER2_LOW_PRIORITY : 0 CDP : 0 CONTROL : 0 ARP : 0 RARP : 0 CGMP : 0 LOOP : 0 IPV4_OPTIONS : 0 DROP_IPV4_LENGTH_ERROR : 0 DROP_IPV4_CHECKSUM_ERROR : 0 IPV4_TTL_ERROR : 0 DROP_TCP_FLAG : 0 DROP_ACL_NO_MATCH : 0 UNKNOWN_PKT_TYPE : 0 DROP_ERROR_DISTR : 0 DROP_UNKNOWN_DISTR : 0 PLU_EXCEPTION : 0 IPV4_UNKNOWN_PLU_TYPE : 0 IPV4_PLU_PUNT : 0 IPV4_PLU_DROP_PKT : 0 UNKNOWN_LAYER2 : 0 IPV4_DF_SET_FRAG_NEEDED_PUNT : 0 IPV4_FRAG : 0 INCOMPLETE_ADJ_PUNT : 0 UNKNOWN_IFIB : 0 IPV4_MCAST_EMPTY_OLIST_COUNTER : 0 IPV4_MCAST_MAX_COPIES_EXCEEDED_COUNTER : 0 IPV4_MCAST_LAST_PACKET_TIME_WASTED_COUNTER : 0 BAD_SKIP_GATHER : 0 RP_PUNT : 0 UNKNOWN_PUNT_REASON : 0 DROP_BAD_RESOURCE_ERROR : 0 IPV4_LOAD_INFO_DROP : 0 DROP_IPV4_LINE_STATUS : 0 DROP_PUNT_EXCEED_Q_THRESH : 0 DROP_IPV6_LINE_STATUS : 0 PLU_LEAF_UNTERMINATED : 0 PLU_LEAF_UNUSED : 0 PLU_LEAF_ECC : 0 PLU_LEAF_NO_MATCH : 0 PLU_LEAF_BAD_CHANNEL : 0 PLU_LEAF_INVALID : 0 QUEUE_THRESHOLD_DROP : 0 DROP_IPV6_SANITY : 0 DROP_IPV6_PLU : 0 DROP_IPV6_UNKNOWN_PLU_TYPE : 0 DROP_IPV6_LENGTH_ERROR : 0 PUNT_IPV6_MISS_SRC_COMP : 0 IPV6_LINK_LOCAL : 0 IPV6_HOP_BY_HOP : 0 IPV6_TTL_ERROR : 0 IPV6_PLU_PUNT : 0 IFIB_DROP : 0
HR-136
IPV4_MCAST_DROP_DF_PACKET : 0 IPV6_TOO_BIG : 0 IPV4_MCAST_DO_ALL_BUT_FWD : 0 IPV4_NO_MATCH : 0 GRE_NON_IPV4 : 0 GRE_BAD_FLAGS : 0 IPV4_TUNNEL_NOT_CONFIGD : 0 MPLS_LOADINFO_DROP : 0 IPV4_DOUBLE_TUNNEL : 0 GLOBAL_IFHANDLE_TCAM_MISS : 0 L2TP_COOKIE_MISMATCH : 0 L2TP_TUNNEL_DOWN : 0 RECIRCULATE_UIDB_INDEX : 0 DUMMY_COUNTER : 2622348240762 MPLS_LINE_STATUS_DN_DROP : 0 MPLS_TTL_ERROR : 0 MPLS_PLU_DROP_PKT : 0 MPLS_INVALID_EXPNULL : 0 MPLS_NOT_ENABLED_DROP : 0 MPLS_UNSUPP_PLU_LABEL_TYPE : 0 IPV6_MED_PRI : 0 IPV4_TUNNEL_UNEXP_PHYSINTF_ADJ : 0 IPV4_TUNNEL_UNEXP_TUNINTF_ADJ : 0 IPV4_MCAST_DO_ALL : 0 DROP_IPV4_L4HDR_LENGTH_ERROR : 0 UNKNOWN_OSI : 0 MPLS_PLU_ERROR : 0 MPLS_PLU_NO_MATCH : 0 MPLS_TTL_EXP_GEN_ICMP : 0 MPLS_PLU_PUNT : 0 MPLS_NON_IP_PKT_GT_MTU : 0 MPLS_IPV4_DF : 0 DROP_L2TP_TOO_SHORT_ERROR : 0 DROP_L2TP_TOO_LONG_ERROR : 0 DROP_GRE_LENGTH_ERROR : 0 DROP_IPIP_LENGTH_ERROR : 0 DROP_PUNT_POL_EXCEED : 0 IPV4_TUNNEL_FORUS : 0 IPV4_PLU_RCV : 0 IPV4_FRAG_TUNNEL_PUNT : 0 IPV4MC_NO_MATCH : 0 MPLS_IPV4_FRAGMENTED : 0 MPLS_IPV4_PKT_WITH_OPT_NEEDS_FRAG : 0 IPV4_CANNOT_FRAG : 0 IPV4_NULL_RTE_DROP_PKT : 0 IPV6_NULL_RTE_DROP_PKT : 0 IPV4_OPTIONS_RSVP : 0 IPV4_IGMP : 0 IPV4_OPTIONS_PIM : 0 PLIM_ASIC_HDR_ERROR : 0 IPV6_PLU_RCV : 0 IPV4_LOAD_INFO_PUNT : 0 IPV6_LOAD_INFO_PUNT : 0 IPV6_LOAD_INFO_DROP : 0 RP_DEST_DROP : 0 DROP_IPV6_ENABLE : 0 PUNT_ACL_ICMP : 0 PUNT_ACL_LOG : 0 SAP_PUNT : 0 MPLS_INCOMPLETE_ADJ : 0 PKT_LARGE_PADDING_PUNT : 0 Node: 0/3/CPU0: ----------------------------------------
HR-137
PSE 0, Statistics Info: ------------------------------------------------NULL_STATS_PTR : 0 MPLS_FWD_STATS_MEM_OOR : 0 LAYER2_LOW_PRIORITY : 0 CDP : 0 CONTROL : 0 ARP : 0 RARP : 0 CGMP : 0 LOOP : 0 IPV4_OPTIONS : 0 DROP_IPV4_LENGTH_ERROR : 0 DROP_IPV4_CHECKSUM_ERROR : 0 IPV4_TTL_ERROR : 0 DROP_TCP_FLAG : 0 DROP_ACL_NO_MATCH : 0 UNKNOWN_PKT_TYPE : 0 DROP_ERROR_DISTR : 0 DROP_UNKNOWN_DISTR : 0 PLU_EXCEPTION : 0 IPV4_UNKNOWN_PLU_TYPE : 0 IPV4_PLU_PUNT : 0 IPV4_PLU_DROP_PKT : 0 UNKNOWN_LAYER2 : 0 IPV4_DF_SET_FRAG_NEEDED_PUNT : 0 IPV4_FRAG : 0 INCOMPLETE_ADJ_PUNT : 0 UNKNOWN_IFIB : 0 IPV4_MCAST_EMPTY_OLIST_COUNTER : 0 IPV4_MCAST_MAX_COPIES_EXCEEDED_COUNTER : 0 IPV4_MCAST_LAST_PACKET_TIME_WASTED_COUNTER : 0 BAD_SKIP_GATHER : 0 RP_PUNT : 0 UNKNOWN_PUNT_REASON : 0 DROP_BAD_RESOURCE_ERROR : 0 IPV4_LOAD_INFO_DROP : 0 DROP_IPV4_LINE_STATUS : 0 DROP_PUNT_EXCEED_Q_THRESH : 0 DROP_IPV6_LINE_STATUS : 0 PLU_LEAF_UNTERMINATED : 0 PLU_LEAF_UNUSED : 0 PLU_LEAF_ECC : 0 PLU_LEAF_NO_MATCH : 0 PLU_LEAF_BAD_CHANNEL : 0 PLU_LEAF_INVALID : 0 QUEUE_THRESHOLD_DROP : 0 DROP_IPV6_SANITY : 0 DROP_IPV6_PLU : 0 DROP_IPV6_UNKNOWN_PLU_TYPE : 0 DROP_IPV6_LENGTH_ERROR : 0 PUNT_IPV6_MISS_SRC_COMP : 0 IPV6_LINK_LOCAL : 0 IPV6_HOP_BY_HOP : 0 IPV6_TTL_ERROR : 0 IPV6_PLU_PUNT : 0 IFIB_DROP : 0 IPV4_MCAST_DROP_DF_PACKET : 0 IPV6_TOO_BIG : 0 IPV4_MCAST_DO_ALL_BUT_FWD : 0 IPV4_NO_MATCH : 0 GRE_NON_IPV4 : 0 GRE_BAD_FLAGS : 0
HR-138
IPV4_TUNNEL_NOT_CONFIGD : 0 MPLS_LOADINFO_DROP : 0 IPV4_DOUBLE_TUNNEL : 0 GLOBAL_IFHANDLE_TCAM_MISS : 0 L2TP_COOKIE_MISMATCH : 0 L2TP_TUNNEL_DOWN : 0 RECIRCULATE_UIDB_INDEX : 0 DUMMY_COUNTER : 2668152738279 MPLS_LINE_STATUS_DN_DROP : 0 MPLS_TTL_ERROR : 0 MPLS_PLU_DROP_PKT : 0 MPLS_INVALID_EXPNULL : 0 MPLS_NOT_ENABLED_DROP : 0 MPLS_UNSUPP_PLU_LABEL_TYPE : 0 IPV6_MED_PRI : 0 IPV4_TUNNEL_UNEXP_PHYSINTF_ADJ : 0 IPV4_TUNNEL_UNEXP_TUNINTF_ADJ : 0 IPV4_MCAST_DO_ALL : 0 DROP_IPV4_L4HDR_LENGTH_ERROR : 0 UNKNOWN_OSI : 0 MPLS_PLU_ERROR : 0 MPLS_PLU_NO_MATCH : 0 MPLS_TTL_EXP_GEN_ICMP : 0 MPLS_PLU_PUNT : 0 MPLS_NON_IP_PKT_GT_MTU : 0 MPLS_IPV4_DF : 0 DROP_L2TP_TOO_SHORT_ERROR : 0 DROP_L2TP_TOO_LONG_ERROR : 0 DROP_GRE_LENGTH_ERROR : 0 DROP_IPIP_LENGTH_ERROR : 0 DROP_PUNT_POL_EXCEED : 0 IPV4_TUNNEL_FORUS : 0 IPV4_PLU_RCV : 0 IPV4_FRAG_TUNNEL_PUNT : 0 IPV4MC_NO_MATCH : 0 MPLS_IPV4_FRAGMENTED : 0 MPLS_IPV4_PKT_WITH_OPT_NEEDS_FRAG : 0 IPV4_CANNOT_FRAG : 0 IPV4_NULL_RTE_DROP_PKT : 0 IPV6_NULL_RTE_DROP_PKT : 0 IPV4_OPTIONS_RSVP : 0 IPV4_IGMP : 0 IPV4_OPTIONS_PIM : 0 PLIM_ASIC_HDR_ERROR : 0 IPV6_PLU_RCV : 0 IPV4_LOAD_INFO_PUNT : 0 IPV6_LOAD_INFO_PUNT : 0 IPV6_LOAD_INFO_DROP : 0 RP_DEST_DROP : 0 DROP_IPV6_ENABLE : 0 PUNT_ACL_ICMP : 0 PUNT_ACL_LOG : 0 SAP_PUNT : 0 MPLS_INCOMPLETE_ADJ : 0 PKT_LARGE_PADDING_PUNT : 0 RP/0/RP0/CPU0:router#
HR-139
Table 32
show controllers pse statistics Field Descriptions
Field Node
Description Identifies the node whose PSE statistics are displayed. The node ID is expressed in the rack/slot/module notation. Displays all statistics maintained by the PSE. Displays PSE information for EIO links, or for a specific controller. Displays PSE device information for IPC connections, or for a specific IPC controller. Displays PSE information for the maintenance processor on a specific controller or node. Displays a summary of PSE information for a specific controller or node.
PSE 0, Statistics Info show controllers pse eio links show controllers pse ipc show controllers pse mp show controllers pse summary
Related Commands
HR-140
Platform and Driver Commands on Cisco IOS XR Software show controllers pse summary
show controllers pse summary

To display a summary of packet switching engine (PSE) information for a specific controller or node, enter the show controllers pse summary command in EXEC mode. show controllers pse summary [instance {0 | 1}] [location node-id]
Syntax Description
instance {0 | 1}
(Optional) Identifies the PSE device whose information you want to display. Enter 0 to specify the ingress PSE device, or 1 to specify the egress PSE device.
Note
location node-id
Note
Note
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. The instance and location optional keywords are not mutually exclusive. The instance keyword directs the command to specific PSE device, and the location keyword directs the command to that device or devices on the specified modular services card. You can specify the instance and location options together in the same command. If you do not specify the instance {0 | 1} and location node-id arguments, the show controllers pse summary command takes effect on both device instances on all modular services cards.
HR-141
Examples
The following command shows how to display a summary of PSE information for a specific controller instance:
RP/0/RP0/CPU0:router# show controllers pse summary instance 1 Node: 0/0/CPU0: ---------------------------------------PSE 1, Summary Info: ------------------------------------------------IBM P/N : 47P0595 LotNum : D2300123 SerialNum : 0x00001c BadPPECls : 0000 Version : 1 CpuctrlPort : 6 DeviceState : 0 (UP) StartupOpts : 00000000 MmappedBase : 0x60669000 ClsDisMask : 0000 NFusedPPEs : 0 (0 hwf, 0 swf) MPUcodeName : /pkg/gsr/ucode/egress_mp_v1.mucode PPEUcodeName: /pkg/gsr/ucode/egress_turbo_pos_v1.mucode INTR-Status : 00000000 INTR-Enable : 0x7ffffe NColdResets : 1 NWarmResets : 0 NPPEUcDlds : 1 NResetRetry : 0 NIntrtps : 1 NIntrptThrot: 0 Node: 0/3/CPU0: ---------------------------------------PSE 1, Summary Info: ------------------------------------------------IBM P/N : LotNum : SerialNum : 0xffffff BadPPECls : 0000 Version : 3 CpuctrlPort : 6 DeviceState : 0 (UP) StartupOpts : 00000000 MmappedBase : 0x60669000 ClsDisMask : 0000 NFusedPPEs : 4 (0 hwf, 4 swf) MPUcodeName : /pkg/gsr/ucode/egress_mp_v3.mucode PPEUcodeName: /pkg/gsr/ucode/egress_turbo_pos_v3.mucode INTR-Status : 00000000 INTR-Enable : 0x7ffffe NColdResets : 1 NWarmResets : 0 NPPEUcDlds : 1 NResetRetry : 0 NIntrtps : 1 NIntrptThrot: 0 RP/0/RP0/CPU0:router#

Table 33 show controllers pse summary Field Descriptions
Field Node IBM P/N SerialNum BadPPECls Version CpuctrlPort DeviceState StartupOpts MmappedBase
Description Node whose PSE information is displayed. IBM part number. Serial number of the node. Number of bad PPECIs on the PSE. PSE version. Cpuctrl port associated with the PSE instance. Whether the node is up (active) or down (inactive). Internal information about the PSE startup options. Internal mapping information.
HR-142
Table 33
show controllers pse summary Field Descriptions (continued)
Field ClsDisMask NFusedPPEs MPUcodeName PPEUcodeName INTR-Status INTR-Enable NColdResets NWarmResets NPPEUcDlds NResetRetry NIntrtps NIntrptThrot show controllers pse eio links show controllers pse ipc show controllers pse mp show controllers pse statistics
Description Internal masking information, Internal PPE information. Information about the MPU code. Information about the PPEU code. Internal status information. Internal enable information. Number of cold resets experienced by the router. Number of warm resets experienced by the router. Internal information about the PSE. Number of times the router attempted to reset itself. Internal information about interrupts on the PSE. Internal throttling information for the PSE. Displays PSE information for EIO links, or for a specific controller. Displays PSE device information for IPC connections, or for a specific IPC controller. Displays PSE information for the maintenance processor on a specific controller or node. Displays PSE statistics for a specific controller instance, or for a specific node.
Related Commands
HR-143
Platform and Driver Commands on Cisco IOS XR Software show controllers pse trace pmugger
show controllers pse trace pmugger

To display received packet switching engine (PSE) trace information for a specific controller or node, enter the show controllers pse trace pmugger command in EXEC mode. show controllers pse trace pmugger [file name original location node-id [file name original location {node-id | all}]] [hexdump] [last entries] [location {node-id | all}] reverse}[stats] [tailf] [unique] [verbose] [wrapping]
Syntax Description
file name original location node-id {node-id | all}
(Optional) Displays trace information for a specific file. Replace name with the name of the file. Replace node-id with the original location of the file you want to display, or enter all to display trace information for the specified file on all nodes. . The node-id is expressed in the rack/slot/module notation.
Note
You can display trace information for more than one file by entering the file name original location {node-id | all} argument again. Replace namewith the name of the next file whose trace information you want to display, and replace node-id with the original location of that file.
hexdump last entries
(Optional) Displays the dump packets in hexidecimal format. (Optional) Replace entries with the number of entries you want to display. For example, if you enter 5, the display will show the last 5 entries in the pmugger trace data. (Optional) Identifies the location of the node whose PSE information you want to display. The node-id is expressed in the rack/slot/module notation.
Note
location node-id
reverse stats tailf unique verbose wrapping
(Optional) Reverses the order of the traces that are displayed, so that the latest traces are displayed first. (Optional) Display trace statistics. (Optional) Displays new traces as they are added. (Optional) Displays unique entries with counts. (Optional) Displays verbose detail about internal debugging information. (Optional) Displays wrapping entries.
Command Modes
EXEC
Command History
Release Release 3.1
HR-144
Platform and Driver Commands on Cisco IOS XR Software show controllers pse trace pmugger
Examples
The following example shows how to displace pmugger trace information for all cards on the router:
RP/0/0/CPU0:routername# show controllers pse trace pmugger all-cards Warning: no files successfully opened on node 0/0/CPU0 362 wrapping entries (6144 possible, 0 filtered, 362 total) Nov 16 11:05:30.842 pmugger 0/3/CPU0 t1 S:1,0,0,177777 Nov 16 11:05:30.844 pmugger 0/3/CPU0 t1 S:1,1,0,177777 Nov 16 11:05:30.844 pmugger 0/3/CPU0 t1 S:2,0,0,177777 Nov 16 11:05:30.844 pmugger 0/3/CPU0 t1 S:2,1,0,177777 Nov 16 11:05:30.844 pmugger 0/3/CPU0 t1 S:3,0,0,177777 Nov 16 11:05:30.844 pmugger 0/3/CPU0 t1 S:3,1,0,177777 Nov 16 11:05:30.845 pmugger 0/3/CPU0 t1 S:4,0,0,177777 Nov 16 11:05:30.845 pmugger 0/3/CPU0 t1 S:4,1,0,177777 Nov 16 11:05:30.845 pmugger 0/3/CPU0 t1 S:5,0,0,177777 Nov 16 11:05:30.845 pmugger 0/3/CPU0 t1 S:5,1,0,177777 Nov 16 11:05:30.845 pmugger 0/3/CPU0 t1 S:6,0,0,177777 Nov 16 11:05:30.846 pmugger 0/3/CPU0 t1 S:6,1,0,177777 Nov 16 11:05:30.846 pmugger 0/3/CPU0 t1 S:7,0,0,177777 Nov 16 11:05:30.846 pmugger 0/3/CPU0 t1 S:7,1,0,177777 Nov 16 11:05:30.846 pmugger 0/3/CPU0 t1 S:10,0,0,177777 Nov 16 11:05:30.846 pmugger 0/3/CPU0 t1 S:10,1,0,177777 Nov 16 11:05:30.846 pmugger 0/3/CPU0 t1 S:11,0,0,177777 Nov 16 11:05:30.847 pmugger 0/3/CPU0 t1 S:11,1,0,177777 Nov 16 11:05:30.847 pmugger 0/3/CPU0 t1 S:12,0,0,177777 Nov 16 11:05:30.847 pmugger 0/3/CPU0 t1 S:12,1,0,177777 Nov 16 11:05:30.847 pmugger 0/3/CPU0 t1 S:13,0,0,177777 Nov 16 11:05:30.847 pmugger 0/3/CPU0 t1 S:13,1,0,177777 --More--
Related Commands
show controllers pse egress gather show controllers pse egress precam show controllers pse ingress gather show controllers pse ingress precam show controllers pse mem
Displays transmitted PSE packet gather stage programming information for a specific job. Displays transmitted PSE precam information for a specific controller, node, or interface. Displays received PSE gather stage programming information for a specific job. Displays received PSE precam information for a specific controller, node, or interface Displays PSE information about the memory banks on a specific controller or node.
HR-145
Platform and Driver Commands on Cisco IOS XR Software show controllers xgxs
show controllers xgxs

To display internal driver information about 10 Gigabit Ethernet XGMII Extender Sublayer (XGXS) sub-layer interfaces, enter the show controllers xgxs command in EXEC mode. show controllers interface xgxs
Syntax Description
interface
Identifies the interface or subinterface you want to display. The interface argument is expressed in the <type>rack/slot/module/port format.
Note
Enter the show interfaces TenGigE command in EXEC mode to see a list of all TenGigE interfaces available on the router.
Command Modes
EXEC
Command History
Usage Guidelines
Examples
RP/0/RP0/CPU0:adelanto# show controllers TenGigE0/3/0/1 xgxs DTE XGXS (BCM8011): Control = 0x0000 Status = 0x801f Dev ID 0 = 0x0040 Dev ID 1 = 0x6092 Control 2 = 0x202f Status 2 = 0x8b01

Table 34 show controllers xgxs Field Descriptions
Field Control Status Dev ID 0 Dev ID 1 Control 2 Status 2
Description Internal control information. Internal status information. Internal ID information. Internal ID information. Internal control information. Internal status information.
HR-146
Platform and Driver Commands on Cisco IOS XR Software show controllers xgxs
Related Commands
Command show interfaces
HR-147
Platform and Driver Commands on Cisco IOS XR Software show memory
show memory
To display information about the memory available on the router after the system image decompresses and loads, enter the show memory command in EXEC mode. You can display the memory available for the entire router or for a specific job. show memory [number] [location node-id]
Syntax Description
number
(Optional) Identifies the job whose memory information you want to display. Replace number with a job identifier. Range is from 0-4294967295. (Optional) Specifies the location of the node whose memory usage information you want to display. The node-id is expressed in the rack/slot/module notation.
location node-id
Command Modes
EXEC
Command History
Usage Guidelines
Note
To display detailed memory information for the entire router, enter the show memory command without any parameters.
Examples
The following example shows how to display memory information for the entire router:
RP/0/0/CPU0:routername# show memory Physical Memory: 256M total Application Memory : 140M (15M available) Image: 95M (bootram: 95M) Reserved: 20M, IOMem: 0, flashfsys: 0 Total shared window: 0 kernel: jid 1 Address 80033000 86147000 8614c000 8614f000 86152000
Bytes 100392960 12288 12288 12288 12288
What Physical Mapped Memory Program Stack Program Stack Program Stack Program Stack
HR-148
86155000 12288 86179000 12288 Total Allocated Memory: 0 Total Shared Memory: 0 pkg/bin/pkgfs: jid 71 Address Bytes 07f75000 126976 07f94000 4096 07f96000 126976 07fb5000 4096 07fb7000 126976 07fd6000 4096 07fd8000 126976 07ff7000 4096 07ff9000 114688 08015000 16384 08020000 28672 08027000 12288 0802a000 4096 0802b000 16384 0802f000 16384 08034000 16384 08038000 528384 080b9000 135168 080da000 16384 080de000 16384 080e2000 16384 38107000 1511424 38279000 98304 38297000 8192 3829f000 376832 382fb000 40960 38307000 1511424 38479000 98304 38497000 1511424 38609000 98304 38622000 24576 38628000 49152 7c0ca000 45056 7c0d5000 184320 7c128000 438272 7c193000 28672 7c1c1000 32768 7c1c9000 8192 l 7c1d2000 16384 7e002000 4096 7e003000 4096 7e006000 4096 7e009000 8192 7e00b000 4096 Total Allocated Memory: 761856 Total Shared Memory: 5328896 sbin/dllmgr: jid 56 Address Bytes 07fd8000 126976 07ff7000 4096 07ff9000 122880 08017000 8192 08020000 176128 0804b000 24576 08051000 16384
Program Stack Program Stack
What Program Stack (pages not allocated) Program Stack Program Stack (pages not allocated) Program Stack Program Stack (pages not allocated) Program Stack Program Stack (pages not allocated) Program Stack Program Stack (pages not allocated) Program Stack Physical Mapped Memory Program Text or Data Program Text or Data Allocated Memory Allocated Memory Allocated Memory Allocated Memory Allocated Memory Allocated Memory Allocated Memory Allocated Memory Shared Memory Shared Memory Shared Memory Shared Memory Shared Memory Shared Memory Shared Memory Shared Memory Shared Memory Shared Memory Shared Memory DLL Text (pages not allocated) libsysmgr.dll DLL Text (pages not allocated) libinfra.dll DLL Text (pages not allocated) libc.dll DLL Text (pages not allocated) libltrace.dll DLL Text (pages not allocated) libpkgfs_node.dll DLL Text (pages not allocated) libpkgfs_debug.dl DLL DLL DLL DLL DLL DLL Text Data Data Data Data Data (pages not allocated) libinst_mem.dll lib_pfi_buffhdr.dll libovl.dll libplatform.dll libios.dll (pages not allocated) libc.dll
What Program Stack (pages not allocated) Program Stack Program Stack (pages not allocated) Program Stack Physical Mapped Memory Program Text or Data Allocated Memory
HR-149
08055000 08059000 08062000 08068000 08080000 0809a000
16384 36864 24576 98304 106496 16384
Allocated Allocated Allocated Allocated Allocated Allocated
Memory Memory Memory Memory Memory Memory

Table 35 show memory Field Descriptions
Field Physical Memory Application Memory Image Reserved IOMem flashfsys Total shared window kernel Address Bytes What
Description Available physical memory on the router. Current memory usage of all the processes on the router. Memory that is currently used by the image, and available memory. Total available reserved memory. Available I/O memory. Available flash memory. Total shared window. Process currently in the kernel. This is the process for which memory information is displayed. Hexadecimal address of memory block. Size of the memory block, in bytes. Name of process that owns the memory block.
Related Commands
Command show memory compare show memory heap show memory summary
Description Creates and compares memory snapshots. Displays process heap information. Displays summarized memory information for a specific process (job).
show memory location Displays memory information for a specific node.
HR-150
Platform and Driver Commands on Cisco IOS XR Software show memory compare
show memory compare

To create and compare memory snapshots, enter the show memory compare command in EXEC mode. show memory compare {end | report | start}
Syntax Description
end
Stores an initial memory snapshot.

Note
You need to enter the show memory compare start command to create a report before you enter the show memory compare end command to store the memory snapshot. To compare memory snapshots and display the results, enter the show memory compare report command. You need to enter the show memory compare start and show memory compare end commands to create and store a report before you enter the show memory compare report command to display the results of a memory comparison.
report
Displays a comparison between memory snapshots.

Note
start
Creates an initial memory snapshot.
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. The show memory compare command is useful for detecting patterns of memory usage during events such as restarting processes or configuring interfaces. Use the following steps to create and compare memory snapshots:
Step 1 Step 2 Step 3 Step 4
Enter the show memory compare start command to record brief details about the heap memory usage of all processes on the router at different moments in time. Perform the test you want to analyze. Enter the show memory compare end command to take and store another memory snapshot. Enter the show memory compare report command to compare the results of both memory snapshots. The Memcompare reads the files and prints the difference between the values stored there.
HR-151
Platform and Driver Commands on Cisco IOS XR Software show memory compare
Examples
The following example shows how to use the show memory compare command to discover which processes are leaking memory during Interface Manager restarts. The results show that all clients are leaking the same amount of memory, probably once per ifmgr restart. This indicates a probable bug in the ifmgr client library. The results also show other (possibly related) leaks in GSP and driver-infra-partner.
RP/0/RP0/CPU0:routername# show memory compare start Successfully stored memory snapshot /tmp/memcmp_start.out RP/0/RP0/CPU0:routername# proc restart ifmgr RP/0/RP0/CPU0:routername# proc restart ifmgr RP/0/RP0/CPU0:routername# proc restart ifmgr RP/0/RP0/CPU0:routername# proc restart ifmgr RP/0/RP0/CPU0:routername# proc restart ifmgr RP/0/RP0/CPU0:routername# show memory compare end Successfully stored memory snapshot /tmp/memcmp_end.out RP/0/0/CPU0:routername# show memory compare report JID --74 271 263 61 name ---qnet sysldr sysdb_mc mbus-rp mem before ---------849880 99588 95540 22196 mem after --------849928 99516 95380 21932 difference ---------48 -72 -160 -264 mallocs restart ------- ------2 -2 -1 -3
You are now free to remove snapshot memcmp_start.out and memcmp_end.out under /t mp RP/0/RP0/CPU0:routername#

Table 36 show memory compare Field Descriptions
Field JID name mem before mem after difference mallocs restarted
Description Job identifier. Name of the process whose memory is compared. Heap memory usage at the start of the process comparison, in bytes. Heap memory usage at end of the process comparison, in bytes. Difference in heap memory usage, in bytes. Number of unfreed allocations made during the test period. Indicates if the process was restarted during the test period.
Related Commands
Command show memory show memory heap show memory summary
Description Displays information about memory available on the router after the system image decompresses and loads. Displays process heap information. Displays summarized memory information for a specific process (job).
HR-152
Platform and Driver Commands on Cisco IOS XR Software show memory heap
show memory heap

To display process heap information, enter the show memory heap command in EXEC mode. show memory heap {job-id | allocated {job-id | dllname | free {job-id | dllname job-id}} | dllname job-id | failure {job-id | all} | free job-id | dllname job-id | summary {job-id | all}}
Syntax Description
job-id
Identifies the process (job) whose memory information you want to display. Replace job-id with a job identifier. Range is from 1 through 4294967295. Displays information about allocated memory blocks. Enter the show memoryheap allocated command, followed by one of the following options:

allocated
job-idReplace job-id with a job identifier. Range is from 1 through 4294967295. dllname free
dllname
Displays heap with dynamic link library (DLL) names. Replace job-id with a job identifier. Range is from 1 through 4294967295.
Note
DLL names have a .dll extention on the end of the filename.
failure
Displays heap failure summary. Enter the failure keyword, followed by one of following options:

job-idReplace job-id with a job identifier. Range is from 1 through 4294967295. allDisplays summarized heap failure information for all jobs that are currently running.
all free
Displays memory information for all processes (jobs) that are currently running. Displays free memory blocks. Enter the free keyword, followed by one of following options:

job-idReplace job-id with a job identifier. Range is from 1 through 4294967295. dllnameDisplays information about free memory blocks that have dll names.
summary
Displays summarized heap information. Enter the summary keyword, followed by one of following options:

job-idReplace job-id with a job identifier. Range is from 1 through 4294967295. allDisplays summarized heap information for all jobs that are currently running.
Command Modes
EXEC
HR-153
Command History
Usage Guidelines
Examples
The following example shows how to display summarized heap information for all processes currently running on the router:
RP/0/0/CPU0:routername# show memory heap summary all Process heap-sz allocmem freemem allocs frees -------------------------------- -------- -------- -------- ------- -------pkgfs 745472 694600 40936 27456 27385 dllmgr 0 0 0 0 0 attractor_cache 49152 25932 18140 851 551 mbus-rp 49152 22196 21964 170063384 170063162 devc-pty 114688 97144 7360 397 161 devc-conaux 208896 158936 31016 1233060 1231361 pkgfs 712704 677136 25712 1838 1778 ksh 49152 21252 14632 725 289 pipe 32768 15524 6680 1604 1570 flashfs_hes 32768 20588 6504 831 611 mqueue 32768 5744 17316 90 17 mbus_text 32768 8064 14056 224 155 c12000_bflash_driver 32768 9148 13040 49 25 pcmciad 65536 39964 17976 803 628 cardmgrd 53248 25380 16108 294 140 qsm 303104 256160 11136 3310765 3308530 syslogd_helper 32768 15936 8684 1048 882 syslogd 212992 196448 12992 3640339 3639945 correlatord 65536 47144 14836 1541 1248 shmwin_svr 32768 15300 8476 506 373 qad_server 32768 14484 9288 713 564 --More--

Table 37 show memory heap Field Descriptions
Field Process heap-sz allocmem freemem allocs frees
Description Identifies the process whose memory heap information is displayed. Size of the memory heap. Amount of memory allocated for the specified process. Available memory. Internal allocated memory information. Internal available memory information.
HR-154
Related Commands
Command show memory
Description Displays information about memory available on the router after the system image decompresses and loads. Displays summarized memory information for a specific process (job).
show memory location Displays memory information for a specific node. show memory summary
HR-155
Platform and Driver Commands on Cisco IOS XR Software show memory location
show memory location

To display memory information for a specific node, enter the show memory location command in EXEC mode. show memory location {node-id | all} [job-id | summary [bytes | detail]
Syntax Description
location node-id
Specifies the location of the node whose memory usage information you want to display. The node-id is expressed in the rack/slot/module notation. Indicates that you want to display memory usage information for all nodes installed in the router. (Optional) Identifies the job whose memory information you want to display. Replace job-id with a job identifier. Range is from 1 through 4294967295. (Optional) Displays summarized memory information. Enter the summary option, followed by one of following keywords:

location all job-id
summary
bytes detail
bytes detail
(Optional) Displays numbers in bytes for an exact count. (Optional) Displays numbers as nnn.dddM for more detail.
Command Modes
EXEC
Command History
Usage Guidelines
Examples
The following example shows how to display a detailed summary of memory information for a specific node:
RP/0/0/CPU0:routername# show memory location 0/0/CPU0 summary detail Physical Memory: 256.000M total Application Memory : 140.178M (15.117M available) Image: 95.739M (bootram: 95.739M) Reserved: 20.000M, IOMem: 0, flashfsys: 0 Shared window fibv6: 257.980K Shared window PFI_IFH: 207.925K
HR-156
Platform and Driver Commands on Cisco IOS XR Software show memory location
Shared window aib: 8.972M Shared window infra_statsd: 3.980K Shared window ipv4_fib: 1.300M Shared window atc_cache: 35.937K Shared window qad: 39.621K Total shared window: 10.805M Allocated Memory: 49.953M Program Text: 6.578M Program Data: 636.000K Program Stack: 4.781M RP/0/0/CPU0:routername#

Table 38 show memory location Field Descriptions
Field Physical Memory Application Memory Image Reserved IOMem flashfsys Shared window fibv6 Shared window PFI_IFH Shared window aib Shared window infra_statsd Shared window ipv4_fib Shared window atc_cache Shared window qad Total shared window Allocated Memory Program Text Program Data Program Stack
Description Available physical memory on the router. Current memory usage of all the processes on the router. Memory that is currently used by the image, and available memory. Memory that is currently reserved. Available I/O memory. Internal flash information. Internal shared window information. Internal shared window information. Internal shared window information. Internal shared window information. Internal shared window information. Internal shared window information. Internal shared window information. Internal shared window information. Amount of memory allocated for the specified node. Internal program test information. Internal program data information. Internal program stack information.
Related Commands
Command show memory show memory heap show memory summary
Description Displays information about memory available on the router after the system image decompresses and loads. Displays process heap information. Displays summarized memory information for a specific process (job).
HR-157
Platform and Driver Commands on Cisco IOS XR Software show memory summary
show memory summary

To display summarized memory information for a specific process (job), enter the show memory summary command in EXEC mode. show memory summary [bytes | detail | location node-id]
Syntax Description
bytes
(Optional) Displays numbers in bytes for an exact count.

Note
To display information in bytes for a specific node only, follow the bytes keyword with the optional location node-id argument. To display detailed information for a specific node only, follow the detail keyword with the optional location node-id argument.
detail
(Optional) Displays numbers as nnn.dddM for more detail.

Note
location node-id
(Optional) Specifies the location of the node whose memory usage information you want to display. The node-id is expressed in the rack/slot/module notation.
Command Modes
EXEC
Command History
Usage Guidelines
Examples
The following example shows how to display a detailed summary of memory information for the router:
RP/0/0/CPU0:routername# show memory summary detail Physical Memory: 256.000M total Application Memory : 140.178M (15.003M available) Image: 95.739M (bootram: 95.739M) Reserved: 20.000M, IOMem: 0, flashfsys: 0 Shared window fibv6: 257.980K Shared window PFI_IFH: 207.925K Shared window aib: 8.972M Shared window infra_statsd: 3.980K Shared window ipv4_fib: 1.300M Shared window atc_cache: 35.937K Shared window qad: 39.621K Total shared window: 10.805M Allocated Memory: 49.933M Program Text: 6.578M
HR-158
Platform and Driver Commands on Cisco IOS XR Software show memory summary
Program Data: 636.000K Program Stack: 4.781M RP/0/0/CPU0:routername#

Table 39 show memory summary Field Descriptions
Field Physical Memory Application Memory Image Reserved IOMem flashfsys Shared window fibv6 Shared window PFI_IFH Shared window aib Shared window infra_statsd Shared window ipv4_fib Shared window atc_cache Shared window qad Total shared window Allocated Memory Program Text Program Data Program Stack
Description Available physical memory on the router. Current memory usage of all the processes on the router. Memory that is currently used by the image, and available memory. Total reserved memory. Available I/O memory. Total flash memory. Internal shared window information. Internal shared window information. Internal shared window information. Internal shared window information. Internal shared window information. Internal shared window information. Internal shared window information. Internal shared window information. Amount of memory allocated for the specified node. Internal program test information. Internal program data information. Internal program stack information.
Related Commands
Command show memory show memory heap
Description Displays information about memory available on the router after the system image decompresses and loads. Displays process heap information.
HR-159
Platform and Driver Commands on Cisco IOS XR Software show packet-memory
show packet-memory
To display information for packet memory, enter the show packet-memory command in EXEC mode. show packet-memory [location node-id]
Syntax Description
location node-id
(Optional) Displays detailed packet memory information for the designated node. The node-id argument is entered in the rack/slot/module notation.
Defaults
Displays information about all packet memory.
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. The show packet-memory command can be used to display the total number of packet and particle headers, along with the packet memory that is currently allocated in the system.
Examples
In the following example, the show packet-memory command is used to display information about packet memory:
RP/0/RP0/CPU0:router# show packet-memory Packet memory statistics : ========================== Packet headers total: 32000, free: 32000, size: 448 Particle Pools(8) Pool(0):total: 8000, free: 8000, size: 256 fallback: 0, region: 0 Pool(1):total: 4000, free: 3968, size: 512 fallback: 1, region: 0 Pool(2):total: 16, free: 16, size: 512 fallback: 2, region: 0 Pool(3):total: 8000, free: 7936, size: 768 fallback: 3, region: 0 Pool(4):total: 12800, free: 9172, size: 1648 fallback: 4, region: 0 Pool(5):total: 320, free: 320, size: 2560 fallback: 5, region: 0
HR-160
Platform and Driver Commands on Cisco IOS XR Software show packet-memory
Pool(6):total: 1600, free: 1088, size: 4608 fallback: 6, region: 0 Pool(7):total: 640, free: 640, size: 6240 fallback: 7, region: 0 Particle clone total: 8000, free: 8000, size: 256 Packet Feature Specific Variable (FSV) total: 16000, free: 16000, size: 88 Packet trace total: 16384, free: 16384, size: 40

Table 40 show packet memory Field Descriptions
Field Packet headers
Description Data structure that defines and controls an aggregation of data structures, collectively known as a packet. Includes information about every packet in the system. Data structure that describes a particle and may be chained to other particles in a linked list. Includes information about the actual data of the packet and other particle headers in this packet if present in this packet. Duplicate particle header that points to a previously allocated particle. Differs from a particle header in that a particle clone shares the particle with another particle header. Scratch pad shared among the features in the packet path, listing hangs of the packet header. Data associated with the packet header to help tracing a packet in the system.
Particle Pools
Particle clone
Packet Feature Specific Variable (FSV) Packet trace
HR-161
Platform and Driver Commands on Cisco IOS XR Software speed
speed
To configure the speed for a Management Ethernet interface, enter the speed command in interface configuration mode. To return the system to autonegotiate speed, use the no form of the speed command. speed {10 | 100 | 1000} no speed
Syntax Description
10 100 1000
Configures the interface to transmit at 10 Mbps. Configures the interface to transmit at 100 Mbps. Configures the interface to transmit at 1000 Mbps (1 Gbps).
Defaults
Autonegotiates the speed for a Management Ethernet interface.
Command Modes
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. Table 41 describes the performance of the system for different combinations of the duplex and speed modes. The specified duplex command configured with the specified speed command produces the resulting system action. Table 41 describes the significant fields shown in the display.
Table 41
Relationship Between duplex and speed Commands
duplex Command no duplex no duplex no duplex no duplex full-duplex
speed Command no speed speed 1000 speed 100 speed 10 no speed
Resulting System Action Autonegotiates both speed and duplex modes. Forces 1000 Mbps (1 Gbps) and full duplex. Autonegotiates for duplex mode and forces 100 Mbps. Autonegotiates for duplex mode and forces 10 Mbps. Forces full duplex and autonegotiates for speed.
HR-162
Table 41
Relationship Between duplex and speed Commands (continued)
duplex Command full-duplex full-duplex full-duplex half-duplex half-duplex half-duplex
speed Command speed 1000 speed 100 speed 10 no speed speed 100 speed 10
Resulting System Action Forces 1000 Mbps (1 Gbps) and full duplex. Forces 100 Mbps and full duplex. Forces 10 Mbps and full duplex. Forces half duplex and autonegotiates for speed (10 or 100 Mbps.) Forces 100 Mbps and half duplex. Forces 10 Mbps and half duplex.
Examples
The following example shows how to configure the Management Ethernet interface to transmit at one gigabit:
RP/0/RP0/CPU0:router(config)# interface mgmteth 0/RP0/CPU0/0 RP/0/RP0/CPU0:router(config-if)# speed 1000
HR-163
HR-164
Ethernet Switch and Server Platform Commands on Cisco IOS XR Software

This module describes the commands used to administer and configure the Ethernet server (EthServer), which is used to send and receive packets over the Cisco IOS XR software control network.
HR-165
Ethernet Switch and Server Platform Commands on Cisco IOS XR Software clear controller backplane ethernet location statistics
clear controller backplane ethernet location statistics

To delete the aggregate statistics of traffic sent and received over the control Ethernet, use the clear controller backplane ethernet location statistics command in EXEC mode. clear controller backplane ethernet location node-id statistics
Syntax Description
node-id
Identifies the node whose controller information you want to delete. The node-id argument is entered in the rack/slot/module notation.
Command Modes
EXEC
Command History
Usage Guidelines
Examples
The following example shows how to clear all client statistics on the node at 0/1/1:
RP/0/RP0/CPU0:router# clear controller backplane ethernet location 0/1/1 clients all statistics
Related Commands
Command show controllers backplane ethernet location
Description Displays information about backplane Ethernet interfaces in a particular location.
HR-166
Ethernet Switch and Server Platform Commands on Cisco IOS XR Software clear mac-accounting
clear mac-accounting
To clear Media Access Control (MAC) accounting statistics, use the clear mac-accounting command in EXEC mode. clear mac-accounting type [location node-id]
Syntax Description
type
Type of interface whose MAC accounting statistics you want to clear.

Note
In Release 3.0, the only supported interface is 10-Gigabit Ethernet (TenGigE).
location node-id
(Optional) Clears MAC accounting statistics for the designated node. The node-id argument is entered in the rack/slot/module/port notation.
Command Modes
EXEC
Command History
Usage Guidelines
Examples
The following example shows how to clear all MAC accounting statistics for TenGigE on the node at 1/0/0/1:
RP/0/RP0/CPU0:router# clear mac-accounting TenGigE location 1/0/0/1
Related Commands
Command mac-accounting
Description Generates accounting information for IP traffic based on the source and destination Media Access Control (MAC) addresses on LAN interfaces. Displays MAC accounting statistics for an interface.
show mac-accounting
HR-167
Ethernet Switch and Server Platform Commands on Cisco IOS XR Software flow-control
flow-control
To enable the sending of flow-control pause frames, use the flow-control command in interface configuration mode. To disable flow control, use the no form of this command. flow-control {bidirectional | egress | ingress} no flow-control ingress {bidirectional | egress | ingress}
Syntax Description
bidirectional egress ingress
Sends flow-control pause frames for both ingress and egress traffic. Sends flow-control pause frames for egress traffic. Sends flow-control pause frames for ingress traffic.
Defaults
The sending of flow-control pause frames is disabled by default.
Command Modes
Command History
Usage Guidelines
Examples
The following example shows how to enable the sending of flow-control pause frames for ingress traffic on the TenGigE interface 0/3/0/0:
RP/0/RP0/CPU0:router(config)# interface TenGigE 0/3/0/0 RP/0/RP0/CPU0:router(config-if)# flow-control ingress
Related Commands
HR-168
Ethernet Switch and Server Platform Commands on Cisco IOS XR Software loopback (TenGigE)
loopback (TenGigE)
To configure the 10-Gigabit Ethernet (TenGigE) controller for loopback mode, use the loopback command in interface configuration mode. To disable loopback, use the no form of this command. loopback {internal | line} no loopback
Syntax Description
internal line
All packets will be looped back internally within the router before reaching an external cable. Incoming network packets will be looped back through the external cable.
Defaults
Loopback mode on the 10-Gigabit Ethernet (TenGigE) controller is disabled by default.
Command Modes
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. Two loopback operation modes are supported for diagnostic purposes: internal and line. In the terminal (internal) loopback, the sent signal is looped back to the receiver. In the facility (line) loopback, the signal received from the far end is looped back and sent on the line. The two loopback modes cannot be active at the same time. In normal operation mode, neither of the two loopback modes is enabled.
Examples
In the following example, all packets are looped back to the TenGigE controller:
RP/0/RP0/CPU0:router(config)# interface TenGigE 0/3/0/0 RP/0/RP0/CPU0:router(config-if)# loopback internal
HR-169
Ethernet Switch and Server Platform Commands on Cisco IOS XR Software mac-accounting
mac-accounting
To generate accounting information for IP traffic based on the source and destination Media Access Control (MAC) addresses on LAN interfaces, use the mac-accounting command in interface configuration mode. To disable MAC accounting, use the no form of this command. mac-accounting {egress | ingress}
Syntax Description
egress ingress
Generates accounting information for IP traffic based on the destination MAC addresses (egress direction). Generates accounting information for IP traffic based on the source MAC addresses (ingress direction).
Defaults
MAC accounting is disabled by default.
Command Modes
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. The mac-accounting command calculates the total packet and byte counts for a LAN interface that receives or sends IP packets to or from a unique MAC address.
Note
Some 10-Gigabit Ethernet (TenGigE) modular services cards support only ingress MAC accounting, in which case the egress keyword is unavailable.
Examples
The following example shows how to enable MAC accounting for the source MAC address on the ingress direction:
RP/0/RP0/CPU0:router(config-if)# mac-accounting ingress
Related Commands
Command clear mac-accounting show mac-accounting
Description Clears MAC accounting statistics for a specified interface. Displays MAC accounting statistics for an interface.
HR-170
Ethernet Switch and Server Platform Commands on Cisco IOS XR Software packet-gap non-standard
packet-gap non-standard
To change the packet interval for traffic on an interface for improved interoperability with Cisco Catalyst 6000 series switches, use the packet-gap non-standard command in interface configuration mode. To use the standard packet interval as defined by the IEEE 802.ae specification, use the no form of this command. packet-gap non-standard no packet-gap non-standard
Syntax Description
Defaults
The interface uses the standard packet interval as defined by the IEEE 802.ae specification by default.
Command Modes
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. An interface that is connected to a Cisco Catalyst 6000 series switch may experience packet-loss problems that can be resolved by changing the packet interval of traffic from standard (as defined by the IEEE 802.ae specification) to nonstandard using the packet-gap non-standard command.
Examples
The following example shows how to change the packet interval for traffic on an interface from standard to nonstandard:
RP/0/RP0/CPU0:router(config)# interface TenGigE RP/0/RP0/CPU0:router(config-if)# packet-gap non-standard
HR-171
Ethernet Switch and Server Platform Commands on Cisco IOS XR Software show controllers backplane ethernet local
show controllers backplane ethernet local

To display backplane Ethernet port information for a node, use the show controllers backplane ethernet local command in EXEC mode. show controllers backplane ethernet local {brief | detail | multicast groups}
Syntax Description
brief detail multicast groups
Displays brief information about the interfaces. Displays detailed information about the backplane interfaces. Displays information about backplane interfaces in multicast groups.
Command Modes
EXEC
Command History
Usage Guidelines
Examples
The following is sample output from the show controllers backplane ethernet local command, which displays detailed information for the Ethernet interface that connects the node to the router control Ethernet:
RP/0/RP0/CPU0:router# show controllers backplane ethernet local detail FastEthernet0_33_1 is up Hardware is 10/100 Ethernet, H/W address is 5246.4800.0211 Internet address is 10.0.2.17 MTU 1514 bytes Encapsulation HFRIES (HFR Internal Ethernet Server) Mode : Full Duplex, Rate : 100Mb/s 787486 packets input, 64535218 bytes, 0 total input drops 0 packets discarded (0 bytes) in garbage collection 3 packets discarded (582 bytes) in recv processing Received 8 broadcast packets, 285994 multicast packets Input errors: 0 CRC, 0 overrun, 0 alignment, 0 length, 0 collision 682244 packets output, 157245225 bytes, 0 total output drops Output 42649 broadcast packets, 42649 multicast packets Output errors: 0 underruns, 0 aborts, 0 loss of carrier
HR-172
Ethernet Switch and Server Platform Commands on Cisco IOS XR Software show controllers backplane ethernet local
Table 42
show controllers backplane ethernet local Field Descriptions
Field Hardware Internet address MTU Encapsulation Mode
Description Provides the hardware type, followed by the hardware address. IP address of the interface. Maximum packet size, in bytes, that a particular interface can handle. Encapsulation method assigned to the interface. Indicates the operating mode of the interface, followed by transmission data.
Related Commands
Command show controllers backplane ethernet local clients
HR-173
Ethernet Switch and Server Platform Commands on Cisco IOS XR Software show controllers backplane ethernet local clients
show controllers backplane ethernet local clients

To display information about local client applications, use the show controllers backplane ethernet local clients command in EXEC mode. show controllers backplane ethernet local clients {client-id statistics | all}
Syntax Description
client-id statistics all
Displays a list of client statistics for the specified client ID. Range is from 1 to 22. Displays a list of all client applications and their IDs.
Command Modes
EXEC
Command History
Usage Guidelines
Examples
The following is sample output from the show controllers backplane ethernet local clients command, which displays list of client statistics for client ID 1:
RP/0/RP0/CPU0:router# show controllers backplane ethernet local clients 1 statistics Client QNET, ES Client Id 1, PID 20498 running on FastEthernet0_33_1 490915 packets input, 41918238 bytes 490912 packets delivered,41918120 bytes 0 packets discarded (0 bytes) in garbage collection 0 (0 bytes) unicast packets filtered 0 (0 bytes) multicast packets filtered 0 (0 bytes) buffer mgmt policy discards 555660 packets output, 134265364 bytes, 0 could not be transmitted

Table 43 show controllers backplane ethernet local clients Field Descriptions
Field Client PID
Description Client application name and ID, followed by backplane client application statistics. Process ID.
HR-174
Ethernet Switch and Server Platform Commands on Cisco IOS XR Software show controllers backplane ethernet local clients
Related Commands
Command show controllers backplane ethernet local
Description Displays backplane Ethernet port information for this node.
HR-175
Ethernet Switch and Server Platform Commands on Cisco IOS XR Software show controllers backplane ethernet location
show controllers backplane ethernet location

To display information about backplane Ethernet interfaces in a particular location, use the show controllers backplane ethernet location command in EXEC mode. show controllers backplane ethernet location node-id {brief | detail | multicast groups}
Syntax Description
node-id
Identifies the node whose backplane Ethernet interface information you want to display. The node-id argument is entered in the rack/slot/module notation. Displays brief information about the interfaces. Displays detailed information about the backplane interfaces. Displays information about backplane interfaces in multicast groups.
brief detail multicast groups
Command Modes
EXEC
Command History
Usage Guidelines
Examples
The following is sample output from the show controllers backplane ethernet location command, which displays detailed information about the backplane interfaces.
RP/0/RP0/CPU0:router# show controllers backplane ethernet location 0/1/0 detail FastEthernet0_1_0 is up Hardware is 10/100 Ethernet, H/W address is 5246.4800.0010 Internet address is 10.0.0.16 MTU 1514 bytes Encapsulation HFRIES (HFR Internal Ethernet Server) Mode : Full Duplex, Rate : 100Mb/s 426422 packets input, 0 bytes, 1 total input drops 14170 packets discarded (935122 bytes) in garbage collection 16 packets discarded (5344 bytes) in recv processing Received 0 broadcast packets, 0 multicast packets Input errors: 0 CRC, 0 overrun, 0 alignment, 0 length, 0 collision 440272 packets output, 0 bytes, 0 total output drops Output 0 broadcast packets, 0 multicast packets Output errors: 0 underruns, 0 aborts, 0 loss of carrier
HR-176

Table 44 show controllers backplane ethernet location Field Descriptions
Field Hardware Internet address MTU Encapsulation Mode packets input bytes
Description Provides the hardware type, followed by the hardware address. IP address of the interface. Maximum packet size, in bytes, that a particular interface can handle. Encapsulation method assigned to the interface. Indicates the operating mode of the interface, followed by transmission data. Total number of packets received. Total number of bytes, including data and MAC encapsulation, in the error-free packets received by the system. Total number of packets dropped from the input queue because the queue was full. Number of packets and bytes discarded. Number of packets and bytes discarded.
total input drops packets discarded in garbage collection packets discarded in recv processing
Received broadcast packets and multicast packets Indicates the total number of broadcast and multicast packets received by the interface. Input errors Displays the number of errors received by the interface. Input errors occur when incoming cells are dropped or corrupted. The possible input errors are as follows:
CRCNumber of times that the checksum calculated from the data received did not match the checksum from the transmitted data. overrunNumber of times that the receiver hardware was incapable of handing received data to a hardware buffer because the input rate exceeded the receiver's capability to handle the data. alignmentNumber of nonoctets received. lengthNumber of times the interface prevented the ASIC from overrunning a maximum transmission unit (MTU) size. collisionNumber of messages retransmitted because of an Ethernet collision.
packets output
Total number of messages transmitted by the system.
HR-177
Table 44
show controllers backplane ethernet location Field Descriptions (continued)
Field bytes
Description Total number of bytes, including data and MAC encapsulation, in the error-free packets transmitted by the system. Total number of packets dropped from the output queue because the queue was full. Indicates the total number of broadcast and multicast packets transmitted by the interface. Displays the number of errors transmitted on the interface. Output errors occur when outgoing cells are dropped or corrupted. The possible types output errors are as follows:
total output drops Output Output errors
underrunsNumber of times that the far-end transmitter has been running faster than the near-end receiver can handle. abortsNumber of illegal sequences of one bits on the interface. loss of carrierNumber of times the interface was reset because the carrier detect line of that interface was up, but the line protocol was down.
Related Commands
Command show controllers backplane ethernet location clients
HR-178
Ethernet Switch and Server Platform Commands on Cisco IOS XR Software show controllers backplane ethernet location clients
show controllers backplane ethernet location clients

To display information about local client applications, use the show controllers backplane ethernet location clients command in EXEC mode. show controllers backplane ethernet location node-id clients client-id {statistics | all}
Syntax Description
node-id
Identifies the node whose local client applications information you want to display. The node-id argument is entered in the rack/slot/module notation.
Note
Enter the show platform command to obtain the node-id.
client-id statistics client-id all
Displays a list of client statistics for the specified client ID. Range is from 1 through 22. Displays a list of all client applications and their IDs.
Command Modes
EXEC
Command History
Usage Guidelines
Examples
The following is sample output from the show controllers backplane ethernet location clients command, which displays detailed information about the backplane client application statistics:
RP/0/RP1/CPU0:router# show controllers backplane ethernet location 0/0/CPU0 clients all
Intf Client ethernet Client Description Name server id Process Id -----------------------------------------------------------------------------FE0_0_CPU0 1 12307 QNX network manager 2 28726 Group services 3 0 Reserved for Attach 4 0 Plugin controller 5 0 Designated SC 6 0 HFR H/W diags 7 0 IP packet handler 8 16415 Redundancy controller 9 0 HFR Virtual console 10 12312 HFR Virtual terminal 11 12305 Control ethernet echo 12 0 Control eth echo reply 13 0 Card Configuration Protocol
HR-179
Ethernet Switch and Server Platform Commands on Cisco IOS XR Software show controllers backplane ethernet location clients
14 15 16 17 18 19 20 21 22 RP/0/RP1/CPU0:router#
0 0 0 16414 0 0 0 0 0
Reserved for Attach Chassis controller Forwarding driver MBI hello MBI Boot Server Source HSR ES client Test application 1 Test application 2 Test client out-of-band

Table 45 show controllers backplane ethernet location clients Field Descriptions
Field Intf Name Client ethernet server id Client process id Description
Description Identifies the Ethernet interface. Identifies the Ethernet server for the specified interface. Identifies the client process running on the specified interface. Describes the backplane client application.
Related Commands
Command show controllers backplane ethernet location
HR-180
Ethernet Switch and Server Platform Commands on Cisco IOS XR Software show controllers switch ports
show controllers switch ports

To display status on a switch port, use the show controllers switch ports command in EXEC mode. show controllers switch {0 | 1} ports
Syntax Description
{0 | 1}
Instance of the controller.
Command Modes
EXEC
Command History
Usage Guidelines
Examples
The following is sample output from the show controllers switch ports command, which displays status about switch controller ports on switch 0:
RP/0/RP0/CPU0:router# show controllers switch 0 ports Ports Active FE Port 2 FE Port 9 FE Port 10 GE Port 2 on Switch STP State STP State STP State STP State 0 : : : :
FORWARDING FORWARDING FORWARDING FORWARDING
(Connected to - 0/RP1) (Connected to - 0/SM0) (Connected to - 0/SM1)

Table 46 show controllers switch ports Field Descriptions
Field Ports Active FE Port GE Port STP State Connected to
Description Indicates the active switch ports on the controller. Identifies the FE port. Identifies the GE port. The state of the Spanning-Tree Protocol: FORWARDING or DISABLED. The node that owns the specified port.
Related Commands
HR-181
Ethernet Switch and Server Platform Commands on Cisco IOS XR Software show controllers switch ports
Command show controllers switch stats
Description Displays statistics on all ports on the switch controllers.
HR-182
Ethernet Switch and Server Platform Commands on Cisco IOS XR Software show controllers switch stats
show controllers switch stats

To display statistics on all ports on the switch controllers, use the show controllers switch stats command in EXEC mode. show controllers switch {0 | 1} stats
Syntax Description
{0 | 1}
Instance of the controller.
Defaults
Command Modes
EXEC
Command History
Usage Guidelines
Examples
The following is sample output from the show controllers switch stats command, which displays information about switch controller statistics on all ports:
RP/0/RP0/CPU0:router# show controllers switch 0 stats Port Port Port Port Port Port Port Port Port Port Port Port Port Port Port Port Port Port 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 25 26 : : : : : : : : : : : : : : : : : : Tx Tx Tx Tx Tx Tx Tx Tx Tx Tx Tx Tx Tx Tx Tx Tx Tx Tx Frames Frames Frames Frames Frames Frames Frames Frames Frames Frames Frames Frames Frames Frames Frames Frames Frames Frames 541417 Tx Errors 0 Rx Frames 0 Rx Errors 0 820214 Tx Errors 0 Rx Frames 707494 Rx Errors 1 0 Tx Errors 0 Rx Frames 0 Rx Errors 0 0 Tx Errors 0 Rx Frames 0 Rx Errors 0 0 Tx Errors 0 Rx Frames 0 Rx Errors 0 0 Tx Errors 0 Rx Frames 0 Rx Errors 0 0 Tx Errors 0 Rx Frames 0 Rx Errors 0 0 Tx Errors 0 Rx Frames 0 Rx Errors 0 633546 Tx Errors 0 Rx Frames 158250 Rx Errors 2 0 Tx Errors 0 Rx Frames 0 Rx Errors 0 0 Tx Errors 0 Rx Frames 0 Rx Errors 0 0 Tx Errors 0 Rx Frames 0 Rx Errors 0 0 Tx Errors 0 Rx Frames 0 Rx Errors 0 0 Tx Errors 0 Rx Frames 0 Rx Errors 0 0 Tx Errors 0 Rx Frames 0 Rx Errors 0 0 Tx Errors 0 Rx Frames 0 Rx Errors 0 541417 Tx Errors 0 Rx Frames 0 Rx Errors 0 541330 Tx Errors 0 Rx Frames 587917 Rx Errors 0
HR-183
Ethernet Switch and Server Platform Commands on Cisco IOS XR Software show controllers switch stats

Table 47 show controllers switch stats Field Descriptions
Field Tx Frames 541417 Tx Errors 0 Rx Frames 0 Rx Errors 0
Description Number of packets transmitted from the switch port. Number of transmission errors. Number of packets received on the switch port. Number of receive errors.
Related Commands
Command show controllers switch ports
Description Displays status on a switch port.
HR-184
Ethernet Switch and Server Platform Commands on Cisco IOS XR Software show mac-accounting
show mac-accounting
To display MAC accounting statistics for an interface, use the show mac-accounting command in EXEC mode. show mac-accounting type location node-id
Syntax Description
type location node-id
Type of interface whose MAC accounting statistics you want to display. Displays detailed MAC accounting information for the specified interface on the specified node. The node-id argument is entered in the rack/slot/module/port notation.
Command Modes
EXEC
Command History
Usage Guidelines
Examples
The following is sample output from the show mac-accounting command, which displays MAC accounting statistics on the specified interface:
RP/0/RP0/CPU0:router# show mac-accounting TenGigE location 0/2/0/4 TenGigE0/2/0/4 Input (511 free) 000b.4558.caca: 4 packets, 456 bytes Total: 4 packets, 456 bytes

Table 48 show mac-accounting Field Descriptions
Field Interface Input Total
Description Interface from which the statistics are generated. Heading for the ingress MAC accounting statistics. The number of MAC accounting entries still available is shown in parentheses. Total statistics for the traffic accounted for by MAC accounting. This excludes any traffic for which there is no MAC address entry, such as non-IP traffic from an unknown MAC source address.
HR-185
Ethernet Switch and Server Platform Commands on Cisco IOS XR Software show mac-accounting
Related Commands
Command clear mac-accounting mac-accounting
Description Clears MAC accounting statistics. Generates accounting information for IP traffic based on the source and destination Media Access Control (MAC) addresses on LAN interfaces.
HR-186
Ethernet Switch and Server Platform Commands on Cisco IOS XR Software show controllers tengige
show controllers tengige

To display 10-Gigabit Ethernet (TenGigE) port information, use the show controllers tengige command in EXEC mode. show controllers tengige node-id
Syntax Description
node-id
Node whose detailed TenGigE information you want to display. The node-id argument is entered in the rack/slot/module/port notation.
Command Modes
EXEC
Command History
Usage Guidelines
Examples
The following is sample output from the show controllers tengige command, which displays detailed information about the TenGigE controllers:
RP/0/RP1/CPU0:router# show controllers tengige 0/3/0/0 PHY: XENPAK device registers: ======================== Vendor Name: VENDOR1 Vendor PN: TXN174012013F06 Vendor Rev: A Vendor SN: USC2021W09 Package OUI: 410024f4 Vendor OUI: 00137b01 Vendor Date Code: 2003022700 nvr_control_status = 0x0007 nvr_version = 0x1e nvr_size0 = 0x01 nvr_size1 = 0x00 mem_used0 = 0x01 mem_used1 = 0x00 basic_addr = 0x0b cust_addr = 0x77 vend_addr = 0xa7 ext_vend_addr0= 0x00 ext_vend_addr1= 0xff reserved0 = 0x00 tcvr_type = 0x01
HR-187
connector = 0x00 encoding = 0x01 bitrate0 = 0x27 bitrate1 = 0x10 protocol = 0x01 x_gbe_code_byte_0 = 0x02 x_gbe_code_byte_1 = 0x00 sonet_sdh_code_byte_0 = 0x00 sonet_sdh_code_byte_1 = 0x00 sonet_sdh_code_byte_2 = 0x00 sonet_sdh_code_byte_3 = 0x00 x_gfc_code_byte_0 = 0x00 x_gfc_code_byte_1 = 0x00 x_gfc_code_byte_2 = 0x00 x_gfc_code_byte_3 = 0x00 range0 = 0x03 range1 = 0xe8 fibre_type_byte_0 = 0x20 fibre_type_byte_1 = 0x00 basic_checksum = 0x5a Link Alarm Status Registers: rx_alarm_control = 0x0019 tx_alarm_control = 0x0059 lasi_control = 0x0000 rx_alarm_status = 0x0019 tx_alarm_status = 0x0058 lasi_status = 0x0001 Quake: devid 0x0043a400 10GE PMA/PMD Registers: Control = 0x2040 Status = 0x0002 Dev ID 0 = 0x0043 Dev ID 1 = 0xa400 Speed Ability = 0x0001 Devices 1 = 0x001a Devices 2 = 0x0000 Control 2 = 0x0006 Status 2 = 0xb141 Tx Disable = 0x0000 Rx Signal Detect = 0x0001 OUI 0 = 0x4100 OUI 1 = 0x24f4 Quake (1.c001) = 0x0001 10GE PCS Registers: Control = 0x2040 Status = 0x0002 Dev ID 0 = 0x0043 Dev ID 1 = 0xa400 Speed Ability = 0x0001 Devices 1 = 0x001a Devices 2 = 0x0000 Control 2 = 0x0000 Status 2 = 0x8001 PKG ID 0 = 0x0000 PKG ID 1 = 0x0000 Base X Status = 0x0000 Base X Control = 0x0000 Base R Status 1 = 0x1005 Base R Status 2 = 0x0000 Base R jitter seed a0 = 0x0000 Base R jitter seed a1 = 0x0000 Base R jitter seed a2 = 0x0000 Base R jitter seed a3 = 0x0000 Base R jitter seed b0 = 0x0000 Base R jitter seed b1 = 0x0000 Base R jitter seed b2 = 0x0000 Base R jitter seed b3 = 0x0000 Base R jitter test control = 0x0000 Base R jitter test counter = 0x0000 10GE XS/XS Registers: Control = 0x2040 Status = 0x0002 Dev ID 0 = 0x0043 Dev ID 1 = 0xa400 Speed Ability = 0x0001 Devices 1 = 0x001a Devices 2 = 0x0000 Status 2 = 0x8000 PKG ID 0 = 0x0000 PKG ID 1 = 0x0000 Lane Status = 0x1c0f Test Control = 0x0000 DTE XGXS (BCM8011): Control = 0x0000 Status = 0x801f Dev ID 0 = 0x0040 Dev ID 1 = 0x6092 Control 2 = 0x202f Status 2 = 0x8b01
HR-188
MAC (PLA): Unicast MAC Address entries = 3 Entry 0: 0004.5416.f623 Entry 1: 0000.5e00.0101 Entry 2: 0000.0c07.ac01 MAC (PLA) device is enabled MAC (PLA) device is in promiscuous mode MAC (PLA) device loopback is disabled MAC (PLA) device MTU = 1514
8x10GE PLIM Registers: local_regs_id = 0x96602000 local_regs_inter_stat = 0x00000080 local_regs_inter_stat_alias = 0x00000000 local_regs_inter_enbl_woset = 0x0000ff00 local_regs_inter_enbl_woclr = 0x0000ff00 local_regs_chip_reset = 0x00000000 local_regs_reset = 0xff000000 local_regs_misc_io = 0x00010000 sn_link_framed = 0x00000001 sn_link_crc_errors = 0x00000000 sn_link_force_reframe = 0x00000000 sn_link_error_reframe = 0x00000001 sn_link_force_error = 0x00000000 sn_link_error_cause = 0x00000000 sn_link_error_interrupt_mask = 0x00000003 channel0_control = 0x000000a6 channel1_control = 0x000000a6 channel2_control = 0x000000a6 channel3_control = 0x000000a6 channel4_control = 0x0000008e channel5_control = 0x000000a6 channel6_control = 0x000000a6 channel7_control = 0x000000a6 Field descriptions: PHY - Vendor details and physical register details for the optic. MAC (PLA) - Details of the MAC settings on the interface including unicast MAC addresses set.

Table 49 show controllers tengige Field Descriptions
Field PHY MAC (PLA)
Description Vendor details and physical register details for the optic. Details of the MAC settings on the interface, including unicast MAC addresses set.
HR-189
Ethernet Switch and Server Platform Commands on Cisco IOS XR Software show spantree
show spantree
To display spantree configuration information, enter the show spantree command in EXEC mode. show spantree {mst 1{brief | detail | port port-id}| config}| vlan 1 {brief | detail | port port-id}}
Syntax Description
mst 1 mst config brief detail port port-id
Show Multiple Spanning Tree (MST) information for instance 1. Show Multiple Spanning Tree configuration information. Display a summary of spantree information. Display detailed spantree information. Display spantree information for a specific Spanning Tree Protocol (STP) port. Replace port-id with the number that identifies the port you want to display. Range is 1 through 49. Show Spanning Tree Information for a VLAN.
vlan 1
Defaults
Command Modes
EXEC
Command History
Release Release 3.2
Usage Guidelines
Examples
The following example shows how to display Multiple Spanning Tree configuration information:
RP/0/RP1/CPU0:MiniQ#show spantree mst config Current MST Region Configuration:Name [STP_1] Revision 1 Instance Vlans Mapped --------------------------------------------------------------------IST 2-4094 1 1 ------------------------------------------------------------------------------RP/0/RP1/CPU0:MiniQ#
HR-190
Ethernet Switch and Server Platform Commands on Cisco IOS XR Software show spantree
Table 50
show spantree Field Descriptions
Field Current MST Region Configuration Revision Instance Vlans Mapped
Description Identifies the MST whose information is displayed. Revision of the current MST configuration. MST instance. Lists the Vlans that are mapped to the displayed MST.
Related Commands
Command spantree
Description Configures spantree parameters.
HR-191
Ethernet Switch and Server Platform Commands on Cisco IOS XR Software spantree
spantree
To configure spantree parameters, enter the spantree command in administrative configuration mode. spantree node-id {core {port-id {portcost cost | portpriority priority}| fwddelay time | hellotime time| maxage age| priority priority-num} | mst {region name | revision rev-num}
Syntax Description
node-id core port-id
Node identifier. Enter the name of the node whose spantree parameters you want to configure. Spanning tree instance. Display spantree information for a specific Spanning Tree Protocol (STP) port. Replace port-id with the number that identifies the port you want to display. Range is 1 through 49. Path cost for the port. Replace with a number. Range is 1 through 200000. Priority of the port. Range is 1 through 128. Forward delay timer. Replace time with a number. Range is 4 through 30. Hello time. Replace time with a number. Range is 1 through 10. Bridge maximum age. Replace age with a number. Range is 6 through 40. Bridge priority. Replace priority-num with a priority number. Range is 1 through 65535. Enables configuration of the following options:

portcost cost portpriority priority fwddelay time hellotime time maxage age priority priority-num mst
region wordMST region name revision 1-65535MST revision
region name revision rev-num
MST region name. Replace name with the MST region name. MST revision number. Replace rev-num with the revision number. Range is 1 through 65535
Defaults
Command Modes
Admin configuration
Command History
Release Release 3.2
Usage Guidelines
Examples
The following example shows how to configure the hello time for a spantree:
HR-192
RP/0/RP1/CPU0:MiniQ(admin-config)#spantree node1 core hellotime 5 RP/0/RP1/CPU0:MiniQ(admin-config)#
Related Commands
Command show spantree
Description Displays spantree configuration information.
HR-193
HR-194
Fabric Management Commands on Cisco IOS XR Software

This chapter describes the Cisco IOS XR software commands used to monitor and control application-specific integrated circuit (ASIC) fabric queues for the Cisco 12000 Series router line cards or Cisco CRS-1 modular services cards running Cisco IOS XR software.
HR-195
Fabric Management Commands on Cisco IOS XR Software clear controller fabric statistics
clear controller fabric statistics

To clear fabric plane statistics from the counters information table, use the clear controller fabric statistics command in Admin EXEC mode. clear controller fabric statistics plane [plane-id | all]
Syntax Description
plane plane-id plane all
(Optional) The fabric plane and plane ID. Range is from 0 to 7. (Optional) Specifies fabric statistics for all planes.
Defaults
Information for all planes is cleared.
Command Modes
Admin EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. The clear controller fabric statistics command clears the fabric statistics for the specified fabric plane or all planes.
Examples
The following example shows how the clear controller fabric statistics command is used to clear all fabric plane statistics from the router:
RP/0/RP0/CPU0:router(admin)# clear controller fabric statistics plane all
HR-196
Fabric Management Commands on Cisco IOS XR Software clear controller fabricq counters all
clear controller fabricq counters all

To clear the fabric queue statistics for the application-specific integrated circuit (ASIC), use the clear controller fabricq counters all command in EXEC mode. clear controller fabricq counters all location node-id
Syntax Description
location node-id
ASIC statistics for the designated node. The node-id argument is entered in the rack/slot/module notation.
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. Only locations that contain a fabric queue ASIC can be specified for the location node-id. This command is intended for use while performing special maintenance, test, or debugging procedures. It should not be necessary to use this command when fabric connectivity is performing normally.
Examples
The following example shows how the clear controller fabricq counters all command is used to clear all fabric ASIC statistics in the queue from the location 0/1/CPU0:
RP/0/RP0/CPU0:router# clear controller fabricq counters all location 0/1/CPU0
Related Commands
Command show controllers fabricq packet-stats
Description Displays statistics about packet flow through the fabric queue ASIC.
HR-197
Fabric Management Commands on Cisco IOS XR Software clear controller ingressq
clear controller ingressq

To clear the fabric ingress queue for the application-specific integrated circuit (ASIC), use the clear controller ingressq command in EXEC mode. clear controller ingressq location node-id
Syntax Description
location node-id
ASIC statistics for the designated node. The node-id argument is entered in the rack/slot/module notation.
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. Only locations that contain a fabric queue ASIC can be specified for the location node-id. The clear controller ingressq command is intended for use while performing special maintenance, test, or debugging procedures. It should not be necessary to use this command when fabric connectivity is performing normally.
Examples
The following example shows how the clear controller ingressq command is used to clear all fabric ASIC statistics in the queue from the location 0/1/CPU0:
RP/0/RP0/CPU0:router# clear controller ingressq location 0/1/CPU0
Related Commands
Command show controllers ingressq statistics
Description Displays statistical information for the ingress queue ASIC.
HR-198
Fabric Management Commands on Cisco IOS XR Software clear fabricq counters
clear fabricq counters

To clear to fabric or from fabric counters associated with the fabric queue driver, use the clear fabricq counters command in Admin EXEC mode. clear fabricq counters {frfab | tofab} [all | error | packet] location node-id
Syntax Description
frfab tofab all error packet location node-id
Clears from fabric queue counters. Clears to fabric queue counters. (Optional) Clears all counters. (Optional) Clears error counters. (Optional) Clears packet counters. Clears counters for the designated node. The node-id argument is entered in the rack/slot/module notation.
Defaults
All fabric queue driver counters are cleared.
Command Modes
Admin EXEC
Command History
Release Release 3.1
Usage Guidelines
Examples
The following example shows how the clear fabricq counters command is used to clear all to fabric queue counters for the location 0/1/CPU0:
RP/0/1/CPU0:router(admin)# clear fabricq counters tofab location 0/1/CPU0
Related Commands
Command show controllers fabricq frfab
Description Displays from fabric statistics.
show controllers fabricq tofab Displays to fabric statistics.
HR-199
Fabric Management Commands on Cisco IOS XR Software clear fabricq counters all
clear fabricq counters all

To clear all fabric queue driver counters, use the clear fabricq counters all command in Admin EXEC mode. clear fabricq counters all location node-id
Syntax Description
location node-id
Clears counters for the designated node. The node-id argument is entered in the rack/slot/module notation.
Command Modes
Admin EXEC
Command History
Release Release 3.1
Usage Guidelines
Examples
The following example shows how the clear fabricq counters all command is used to clear all fabricq counters for the location 0/1/CPU0:
RP/0/1/CPU0:router(admin)# clear fabricq counters all location 0/1/CPU0
HR-200
Fabric Management Commands on Cisco IOS XR Software controllers fabric plane shutdown
controllers fabric plane shutdown

To shut down the state of a fabric plane, use the controllers fabric plane shutdown command in admin configuration mode. To disable the state of a fabric plane, use the no form of this command. controllers fabric plane plane-id shutdown no controllers fabric plane plane-id shutdown
Syntax Description
plane-id
The fabric plane number. Range is from 0 to 7.
Defaults
The controller fabric plane is not shut down, and data continues to flow through the plane.
Command Modes
Admin configuration
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. The controllers fabric plane shutdown command is used to perform a graceful shutdown of the fabric plane to ensure that data is no longer flowing through the plane before a fabric reconfiguration or fabric plane migration.
Examples
The following example shows fabric plane 3 being shut down:

RP/0/RP0/CPU0:router(admin-config)# controllers fabric plane 3 shutdown
HR-201
Fabric Management Commands on Cisco IOS XR Software controllers fabric statistics collection
controllers fabric statistics collection

To control the collection of fabric statistics data, use the controllers fabric statistics collection command in admin configuration mode. To return the system to the default interval setting, use the no form of this command. controllers fabric statistics collection {control {disable | enable | refresh} | interval seconds} no controllers fabric statistics collection {control {disable | enable | refresh} | interval seconds}
Syntax Description
control disable enable refresh interval seconds
Controls how fabric statistics are collected. Disables collection of controller fabric statistics data. Enables or restarts collection of controller fabric statistics data. This is the default. Causes the system to collect data immediately. Specifies the interval, in seconds, between collection of data for fabric statistics. Range is from 10 to 180 seconds. Default is 30 seconds.
Defaults
Control of fabric statistics data collection is enabled. Interval setting is 30 seconds.
Command Modes
Admin configuration
Command History
Usage Guidelines
Examples
The following example shows statistic data collection on the fabric being disabled:
RP/0/RP0/CPU0:router(admin-config)# controllers fabric statistics collection control disable
HR-202
Fabric Management Commands on Cisco IOS XR Software show controllers fabric
show controllers fabric

To display fabric card information, use the show controllers fabric command in Admin EXEC mode. show controllers fabric [clock | csc-fpga | fab-clk | fab-control | sca | xbar]
Syntax Description
clock csc-fpga fab-clk fab-control sca xbar
(Optional) Displays which fabric clock each slot is synchronized to and whether the clock is redundant or not. (Optional) Displays registers associated with the csc-fpga on each fabric card (FC). (Optional) Displays registers associated with the fabric clock FPGA on all Route Processors (RPs), line cards (LCs), and FCs. (Optional) Displays the state of all RPs, LCs, and FCs in the chassis from a fabric control software perspective. (Optional) Displays registers associated with Scheduler Control ASIC on the CSC cards. (Optional) Displays registers associated with the Cross Bar (XBAR) ASIC on the clock scheduler card (CSC) and switch fabric card (SFC).
Defaults
All fabric card information is displayed.
Command Modes
Admin EXEC
Command History
Release Release 3.1
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. Use the show controllers fabric command to display various registers associated with the fabric cards and state information associated with the fabric control software.
Examples
The following is sample output from the show controllers fabric clock command:
RP/0/1/CPU0:router(admin)# show controllers fabric clock The Primary Clock for system is CSC_0 System Fabric Clock is Redundant Slot # 3 4 5 Primary Clock CSC_0 CSC_0 CSC_0 Mode Redundant Redundant Redundant
HR-203
Fabric Management Commands on Cisco IOS XR Software show controllers fabric
11 12 15 16 17 18 19 20
CSC_0 CSC_0 CSC_0 CSC_0 CSC_0 CSC_0 CSC_0 CSC_0
Redundant Redundant Redundant Redundant Redundant Redundant Redundant Redundant
HR-204
Fabric Management Commands on Cisco IOS XR Software show controllers fabric connectivity
show controllers fabric connectivity

To display controller fabric connectivity information, use the show controllers fabric connectivity command in Admin EXEC mode. show controllers fabric connectivity {all | location node-id} [brief | detail]
Syntax Description
all location node id brief detail
Specifies all controller fabric ports. Specifies the fabric port associated with the designated node. The node-id argument is entered in the rack/slot/module notation. (Optional) Specifies brief information about controller fabric connectivity. This is the default. (Optional) Specifies detailed information about controller fabric connectivity.
Defaults
Brief information about controller fabric connectivity is displayed.
Command Modes
Admin EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. Theshow controllers fabric connectivity command is used to monitor a modular services card as it sends data to fabric or receives data from fabric.
Examples
The following is sample output from the show controllers fabric connectivity command that displays fabric connectivity information in brief form for all resources:
RP/0/RP0/CPU0:router(admin)# show controllers fabric connectivity all brief Card In Tx Planes Rx Planes Monitored Total Percent R/S/M Use 01234567 01234567 For (s) Uptime (s) Uptime ------------------------------------------------------------------------------0/2/CPU0 1 .1...... .1...... 20913 20913 100.0000 0/RP0/CPU0 1 .1...... .1...... 20913 20913
HR-205
Fabric Management Commands on Cisco IOS XR Software show controllers fabric connectivity
The following is sample output from the show controllers fabric connectivity command that displays detailed fabric connectivity information for all resources:
RP/0/RP0/CPU0:router(admin)# show controllers fabric connectivity all Card In Tx Planes Rx Planes Monitored Total Percent R/S/M Use 01234567 01234567 For (s) Uptime (s) Uptime ------------------------------------------------------------------------------0/1/CPU0 1 .1...... .1...... 8561 8561 100.0000 0/2/CPU0 1 .1...... .1...... 8561 8561 100.0000 0/RP1/CPU0 1 .1...... .1...... 8561 8561 100.0000
The following is sample output from the show controllers fabric connectivity command that displays fabric connectivity information for the modular services card on node 0/0/CPU0:
RP/0/RP0/CPU0:router(admin)# show controller fabric connectivity location 0/0/CPU0 Card In Tx Planes Rx Planes Monitored Total Percent R/S/M Use 01234567 01234567 For (s) Uptime (s) Uptime ------------------------------------------------------------------------------0/0/CPU0 1 .1...... .1...... 8805 8805 100.0000

Table 51 show controllers fabric connectivity Field Descriptions
Field Card R/S/M In Use Tx Planes Rx Planes Monitored For (s) Total Uptime Percent Uptime
Description Identifies the fabric card, in the format rack/slot/module. Indicates the number of fabric ports that are in use on the card. Indicates activity on the transmit fabric plane. Indicates activity on the receive fabric plane. Elapsed time in seconds since monitoring began. Total uptime expressed in seconds. Percentage of time the card has been up since monitoring began.
HR-206
Fabric Management Commands on Cisco IOS XR Software show controllers fabric fgid statistics
show controllers fabric fgid statistics

To display resource statistical information for the fabric group ID (FGID), use the show controllers fabric fgid statistics command in Admin EXEC mode. show controllers fabric fgid statistics {all | logical-router | pool | system} [brief | detail]
Syntax Description
all logical-router pool system brief detail
Specifies all FGID resource statistical information for the logical router and FGID resource pools. Specifies FGID resource statistics about the logical router. Specifies FGID statistical information about the resource pool. Specifies FGID resource statistics for the entire physical router. (Optional) Specifies brief information about FGIDs. This is the default. (Optional) Specifies detailed information about FGIDs.
Defaults
Brief information is displayed.
Command Modes
Admin EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. The show controllers fabric fgid statistics command is used to monitor FGID resource usage based on a system, pool, or client view.
Examples
The following is sample output from the show controllers fabric fgid statistics command that displays resource statistics for the fabric FGID in detailed form with all resources activated:
RP/0/RP0/CPU0:router(admin)# show controllers fabric fgid statistics all detail Fabric FGID Resource Statistics Information: System wide Fabric multicast resource statistics: Total number of FGIDs in the system is 1000000 Current number of Inused FGIDs in the system is 400 High Water Mark of Inused FGIDs in the system is 400
HR-207
Per LR basis Fabric multicast resource statistics:
Logical Router Name is Owner Inused FGIDs is 400 High Water Mark inused FGIDs is 400 Per client basis FGID resource utilization: Appl Appl Pool Current HighWater Mark Name ID ID InUsed FGIDs InUsed FGIDs -------------------------------------------------------------------------------CLI 0 3 0 0 GSP 1 0 400 400 lpts_pa 2 3 0 0 Per Pool basis Fabric multicast resource statistics: Pool Identifier is 0 Pool Name is GSP Pool type is Dedicated Total FGIDs of this pool is 10000 Inused FGIDs of this pool is 400 High Water Mark inused FGIDs of this pool is 400 Pool Identifier is 1 Pool Name is LRD Pool type is Dedicated Total FGIDs of this pool is 100 Inused FGIDs of this pool is 0 High Water Mark inused FGIDs of this pool is 0 Pool Identifier is 2 Pool Name is LPTS Pool type is Dedicated Total FGIDs of this pool is 16000 Inused FGIDs of this pool is 0 High Water Mark inused FGIDs of this pool is 0 Pool Identifier is 3 Pool Name is COMMON Pool type is Shared Total FGIDs of this pool is 972876 Inused FGIDs of this pool is 0 High Water Mark inused FGIDs of this pool is 0

Table 52 show controllers fabric fgid statistics Field Descriptions
Field Total number of FGIDs in the system Current number of Inused FGIDs in the system High Water Mark of Inused FGIDs in the system Logical Router Name Inused FGIDs
Description Total number of fabric FGIDs in the system. Total number of fabric FGIDs in use in the system. Number of in-use fabric FGIDs at the highest point within the system. Name of the logical router. Inused (in-use) fabric FGID.
HR-208
Table 52
show controllers fabric fgid statistics Field Descriptions (continued)
Field High Water Mark inused FGIDs Appl Name Appl ID Pool ID Current InUsed FGIDs Pool Identifier Pool Name Pool type Total FGIDs of this pool Inused FGIDs of this pool High Water Mark inused FGIDs of this pool
Description Number of inused (in-use) FGIDs since monitoring started. Application name. Application ID. Pool ID. Current number of inused (in-use) FGIDs. Group pool identifier number. Group pool name. Group pool type. Number of FGIDs in the pool. Number of FGIDs inused (in-use) in the pool. Number of FGIDs in the pool since the start of monitoring.
The following is sample output from the show controllers fabric fgid statistics command that displays resource statistics for the fabric FGID logical routers in brief form with all resources activated:
RP/0/RP0/CPU0:router(admin)# show controllers fabric fgid statistics logical-router brief Fabric FGID Resource Statistics Information:
Per LR basis Fabric multicast resource statistics: LR Current HighWater Mark Name InUsed FGIDs InUsed FGIDs -------------------------------------------------------------------------------Owner 0 0

Table 53 show controllers fabric fgid statistics logical-router brief Field Descriptions
Field LR Name Current InUsed FGIDs HighWater Mark InUsed FGIDs
Description Logical router name. Current number of inused (in-use) FGIDs. Number of inused (in-use) FGIDs since monitoring started.
HR-209
The following is sample output from the show controllers fabric fgid statistics command that displays resource statistics for FGID logical routers in detail form with all resources activated:
RP/0/RP0/CPU0:router(admin)# show controllers fabric fgid statistics logical-router detail Fabric FGID Resource Statistics Information: Per LR basis Fabric multicast resource statistics: Logical Router Name is Owner Inused FGIDs is 0 High Water Mark inused FGIDs is 0 Per client basis FGID resource utilization: Appl Appl Pool Current HighWater Mark Name ID ID InUsed FGIDs InUsed FGIDs -------------------------------------------------------------------------------CLI 0 2 0 0

Table 54 show controllers fabric fgid statistics logical-router detail Field Descriptions
Field Logical Router Name Inused FGIDs High Water Mark inused FGIDs Appl Name Appl ID Pool ID Current InUsed FGIDs
Description Logical router name. Inused (in-use) fabric FGID. Number of inused FGIDs since monitoring started. Application name. Application ID. Pool ID. Current number of inused (in use) FGIDs.
HR-210
Fabric Management Commands on Cisco IOS XR Software show controllers fabric plane
show controllers fabric plane

To display system fabric plane information, use the show controllers fabric plane command in Admin EXEC mode. show controllers fabric plane {plane-id | all} [brief | detail | statistics {brief | detail}]
Syntax Description
plane-id all brief detail statistics
Plane number. Range is from 0 to 7. Specifies that all information about system fabric planes is displayed. (Optional) Specifies brief information about the system fabric plane. This is the default. (Optional) Specifies detailed information about the system fabric plane. (Optional) Specifies statistical information for cell activity within the plane.
Defaults
Brief information is displayed.
Command Modes
Admin EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. The show controllers fabric plane command is used to monitor the fabric plane status, and the cell traffic and error statistics to or from the fabric plane.
Examples
The following is sample output from the show controllers fabric plane command that displays system fabric plane information from all fabric planes:
RP/0/RP0/CPU0:router(admin)# show controllers fabric plane all Plane Admin Oper Down Total Down Id State State Flags Bundles Bundles -----------------------------------------------------0 UP DOWN p 0 0 1 UP UP 0 0 2 UP DOWN p 0 0 3 UP DOWN p 0 0
HR-211
4 5 6 7
UP UP UP UP
DOWN DOWN DOWN DOWN
p p p p
0 0 0 0
0 0 0 0
The following is sample output from the show controllers fabric plane command that displays system fabric plane statistics from fabric plane 1 in brief form:
RP/0/RP0/CPU0:router(admin)# show controllers fabric plane 1 statistics brief In Out CE UCE PE Plane Cells Cells Cells Cells Cells -------------------------------------------------------------------------------1 0 0 0 0 0
The following is sample output from the show controllers fabric plane command that displays system fabric plane statistics from fabric plane 1 in detailed form:
RP/0/RP0/CPU0:router(admin)# show controllers fabric plane 1 statistics detail The fabric plane number is 1 Total number of providers for the statistics: 0 Total received data cells: 0 Total transmitted data cells: 0 Total received correctable errored cells: 0 Total received uncorrectable errored cells: 0 Total received parity error cells: 0 Total unicast lost cells: 0 Total multicast lost cells: 0 Last clearing of "show controller fabric plane" counters never
The following is sample output from the show controllers fabric plane command that displays system fabric plane statistics from the fabric for all planes in detailed form:
RP/0/RP0/CPU0:router(admin)# show controllers fabric plane all statisitics detail The fabric plane number is 0 Total number of providers for the statistics: 0 Total received data cells: 0 Total transmitted data cells: 0 Total received correctable errored cells: 0 Total received uncorrectable errored cells: 0 Total received parity error cells: 0 Total unicast lost cells: 0 Total multicast lost cells: 0 Last clearing of "show controller fabric plane" counters never The fabric plane number is 1 Total number of providers for the statistics: 0 Total received data cells: 0 Total transmitted data cells: 0 Total received correctable errored cells: 0 Total received uncorrectable errored cells: 0 Total received parity error cells: 0 Total unicast lost cells: 0 Total multicast lost cells: 0 Last clearing of "show controller fabric plane" counters never The fabric plane number is 2 Total number of providers for the statistics: 0 Total received data cells: 0 Total transmitted data cells: 0 Total received correctable errored cells: 0 Total received uncorrectable errored cells: 0
HR-212
Total received parity error cells: 0 Total unicast lost cells: 0 Total multicast lost cells: 0 Last clearing of "show controller fabric plane" counters never The fabric plane number is 3 Total number of providers for the statistics: 0 Total received data cells: 0 Total transmitted data cells: 0 Total received correctable errored cells: 0 Total received uncorrectable errored cells: 0 Total received parity error cells: 0 Total unicast lost cells: 0 Total multicast lost cells: 0 Last clearing of "show controller fabric plane" counters never The fabric plane number is 4 Total number of providers for the statistics: 0 Total received data cells: 0 Total transmitted data cells: 0 Total received correctable errored cells: 0 Total received uncorrectable errored cells: 0 Total received parity error cells: 0 Total unicast lost cells: 0 Total multicast lost cells: 0 Last clearing of "show controller fabric plane" counters never The fabric plane number is 5 Total number of providers for the statistics: 0 Total received data cells: 0 Total transmitted data cells: 0 Total received correctable errored cells: 0 Total received uncorrectable errored cells: 0 Total received parity error cells: 0 Total unicast lost cells: 0 Total multicast lost cells: 0 Last clearing of "show controller fabric plane" counters never

Table 55 show controllers fabric plane Field Descriptions
Field The fabric plane number is 1 Total number of providers for the statistics Total received data cells Total received correctable errored cells Total received uncorrectable errored cells Total received parity error cells Total unicast lost cells Last clearing of show controller fabric plane counters never
Description Fabric plane ID number. Number of providers (sources) from which statistics were extracted. Total of data cells that have been received. Total number of cells with errors that can be corrected. Total number of cells with errors that cannot be corrected. Total number of cells that have parity errors. Number of lost unicast cells. Indicates when the show controller fabric plane counters were cleared.
HR-213
Related Commands
Command show controllers fabric connectivity
Description Displays controller fabric connectivity information.
HR-214
Fabric Management Commands on Cisco IOS XR Software show controllers fabricq drop
show controllers fabricq drop

To display the number of packets dropped to the fabric or from the fabric on a per slot basis in the fabric queue driver, use the show controllers fabricq drop command in Admin EXEC mode. show controllers fabricq drop [detail] [location node-id]
Syntax Description
detail location node-id
(Optional) Displays detailed statistical information. (Optional) Displays statistical information for the designated node. The node-id argument is entered in the rack/slot/module notation.
Defaults
Information about packet drops for all performance route processors (PRPs) on the router is displayed.
Command Modes
Admin EXEC
Command History
Release Release 3.1
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. Use the show controllers fabricq drop command to display statistics about packet drops. Specifying a location displays information only if that location is a PRP. Use the detail keyword to display detailed output. The show controllers fabricq drop command is intended for use while performing debugging procedures.
Examples
The following is detailed sample output from the show controllers fabricq drop command for location 0/1/CPU0:
RP/0/1/CPU0:router(admin)# show controllers fabricq drop detail location 0/1/CPU0 Location 0/1/0: To Fabric dropped packets: -------------------------Slot Tx-OVS Tx-NHB Tx-NPB Low Priority: 0 0 0 0 1 0 0 0 2 0 0 0 3 0 0 0 4 0 0 0 5 0 0 0 6 0 0 0
Tx-QF 0 0 0 0 0 0 0
Tx-LP 0 0 0 0 0 0 0
Tx-DS 0 0 0 0 0 0 0
Tx-MB Tx-DIS Tx-Total 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0
HR-215
7 0 0 0 0 0 0 0 0 0 8 0 0 0 0 0 0 0 0 0 9 0 0 0 0 0 0 0 0 0 10 0 0 0 0 0 0 0 0 0 11 0 0 0 0 0 0 0 0 0 12 0 0 0 0 0 0 0 0 0 13 0 0 0 0 0 0 0 0 0 14 0 0 0 0 0 0 0 0 0 15 0 0 0 0 0 0 0 0 0 mcast 0 0 0 0 0 0 0 0 0 High Priority: 0 0 0 0 0 0 0 0 0 0 1 0 0 0 0 0 0 0 0 0 2 0 0 0 0 0 0 0 0 0 3 0 0 0 0 0 0 0 0 0 4 0 0 0 0 0 0 0 0 0 5 0 0 0 0 0 0 0 0 0 6 0 0 0 0 0 0 0 0 0 7 0 0 0 0 0 0 0 0 0 8 0 0 0 0 0 0 0 0 0 9 0 0 0 0 0 0 0 0 0 10 0 0 0 0 0 0 0 0 0 11 0 0 0 0 0 0 0 0 0 12 0 0 0 0 0 0 0 0 0 13 0 0 0 0 0 0 0 0 0 14 0 0 0 0 0 0 0 0 0 15 0 0 0 0 0 0 0 0 0 mcast 0 0 0 0 0 0 0 0 0 Legend: Tx-OVS: Drops due to oversized packets Tx-NHB: Drops due to missing packet header buffer Tx-NPB: Drops due to missing packet payload buffer Tx-QF: Drops becasue the queue is full Tx-LP: Drops because the packet is low priority Tx-DS: Drops because the destination slot is dead Tx-MB: Drop counter for packets transmitted over MBUS (Not supported) Tx-DIS: Drops because the tofab transmission is disabled From Fabric dropped packets: ---------------------------Slot Rx-REF Rx-PKT Rx-DEC Rx-Total 0 0 0 0 0 1 0 0 0 0 2 0 0 0 0 3 0 0 0 0 4 0 0 0 0 5 0 0 0 0 6 0 0 0 0 7 0 0 0 0 8 0 0 0 0 9 0 0 0 0 10 0 0 0 0 11 0 0 0 0 12 0 0 0 0 13 0 0 0 0 14 0 0 0 0 15 0 0 0 0 Legend: Rx-REF: Drops in the FPGA reassembly Rx-PKT: Drops due to invalid packet Rx-DEC: Drops due to decoding the packet
HR-216
Related Commands
Command show controllers fabricq errors show controllers fabricq frfab show controllers fabricq output show controllers fabricq queue show controllers fabricq tofab
Description Displays information about errors. Displays from fabric statistics. Displays information about to fabric output service. Displays information about packet queues. Displays to fabric statistics.
show controllers fabricq registers Displays information about chopper and assembler registers.
HR-217
Fabric Management Commands on Cisco IOS XR Software show controllers fabricq errors
show controllers fabricq errors

To display the count of hardware errors associated with the fabric queue driver, use the show controllers fabricq errors command in Admin EXEC mode. show controllers fabricq errors [location node-id]
Syntax Description
location node-id
(Optional) Displays statistical information for the designated node. The node-id argument is entered in the rack/slot/module notation.
Defaults
Information about errors for all performance route processors (PRPs) on the router is displayed.
Command Modes
Admin EXEC
Command History
Release Release 3.1
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. Use the show controllers fabricq errors command to display statistics about hardware errors. Specifying a location displays information only if that location is a PRP. The show controllers fabricq errors command is intended for use while performing debugging procedures.
Examples
The following is sample output from the show controllers fabricq errors command for location 0/1/CPU0:
RP/0/1/CPU0:router(admin)# show controllers fabricq errors location 0/1/CPU0 Location 0/1/0: ToFab Errors: Error Type Error Count Max Rate Rate Exceeded Count ----------------------------------------------------------SRAM Parity 0 2 0 DMA Address 0 100 0 DMA Size 0 100 0 Fusilli Parity 0 2 0 PCI TRANS64 0 2 0 PCI Address 0 2 0
HR-218
Fabric Management Commands on Cisco IOS XR Software show controllers fabricq errors

Table 56 show controllers fabricq errors Field Descriptions
Field Error Count Max Rate Rate Exceeded Count
Description Number of errors of each type. Maximum number of errors of that type that can be received per second. Number of times that error has exceeded the Max Rate. When the rate is exceeded, the software may try to restart the fabric queue driver and associated ASICs or FPGAs to correct the problem.
Related Commands
Command show controllers fabricq drop show controllers fabricq frfab show controllers fabricq output show controllers fabricq queue show controllers fabricq tofab
Description Displays information about packet drops. Displays from fabric statistics. Displays information about to fabric output service. Displays information about packet queues. Displays to fabric statistics.
HR-219
Fabric Management Commands on Cisco IOS XR Software show controllers fabricq frfab
show controllers fabricq frfab

To display from fabric statistics associated with the fabric queue driver, use the show controllers fabricq frfab command in Admin EXEC mode. show controllers fabricq frfab [detail] [location node-id]
Syntax Description
Defaults
From fabric statistics are displayed for all performance route processors (PRPs) on the router.
Command Modes
Admin EXEC
Command History
Release Release 3.1
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. Use the show controllers fabricq frfab command to display from fabric statistics. Specifying a location displays information only if that location is a PRP. Use the detail keyword to display detailed output. The show controllers fabricq frfab command is intended for use while performing debugging procedures.
Examples
The following is sample output from the show controllers fabricq frfab command for location 0/1/CPU0:
RP/0/1/CPU0:router(admin)# show controllers fabricq frfab location 0/1/CPU0 Location 0/1/0: From Fabric Stats: ------------------Slot Rx-pkts Rx-TH-pkts 1 0 3928 2 0 37309 3 0 43306 4 0 42681 5 0 35063
Rx-dropped 0 0 0 0 0
From Fabric Packet per Queue Stats: ----------------------------------Packets received in queue 0 - 0
HR-220
Packets received in queue 1 - 3928 Packets received in queue 2 - 150069 Packets received in queue 3 - 8290 From Fabric Error Stats: -----------------------Bigger than MTU pkts - 0 Corrupted pkts - 0 SPD pkt count - 0 No IDB drops - 0 IDB queue tail drops - 0 Chan corrupted pkts - 0 First/Last err pkts - 0 Sequence err pkts - 0 Unknown Rx type - 0 Output queue 0 full drops - 0 Output queue 1 full drops - 0 Output queue 2 full drops - 0 Output queue 3 full drops - 0 Output queue unmatch drops - 0 OQ 0 drops because FQ below threshold OQ 1 drops because FQ below threshold OQ 2 drops because FQ below threshold OQ 3 drops because FQ below threshold From Fabric Error Events: ------------------------Fusilli parity errors- 0 Fusilli interface errors - 0 Free queue drop threshold events Free queue empty events - 0 Bad descriptors events - 0 Output queue 0 almost empty events Output queue 1 almost empty events Output queue 2 almost empty events Output queue 3 almost empty events OQ 0 drops because of ptr - 0 (Not OQ 1 drops because of ptr - 0 (Not OQ 2 drops because of ptr - 0 (Not OQ 3 drops because of ptr - 0 (Not Interrupt throttle events - 0 Spurious interrupt events - 0 Assembler memory statistics: ---------------------------Bufs enqueued to free queue Bufs rxed from OQ Bufs copied to public pool Bufs returned to the pool Bufs returned by driver Bufs from driver to OS
0 0 0 0
- 0 - 0 - 0 - 0 implemented) implemented) implemented) implemented)
163311 162287 0 (Not implemented) 162287 0 (Not implemented) 0 (Not implemented)
HR-221

Table 57 show controllers fabricq frfab Field Descriptions
Field Rx-pkts Rx-TH-pkts Rx-dropped
Description Number of packets received from the fabric. Number of think hard packets received from the fabric. Number of packets received from the fabric that had to be dropped.
Related Commands
Command show controllers fabricq drop show controllers fabricq errors show controllers fabricq output show controllers fabricq queue show controllers fabricq tofab
Description Displays information about packet drops. Displays information about errors. Displays information about to fabric output service. Displays information about packet queues. Displays to fabric statistics.
HR-222
Fabric Management Commands on Cisco IOS XR Software show controllers fabricq output
show controllers fabricq output

To display to fabric output service statistics associated with the fabric queue driver, use the show controllers fabricq output command in Admin EXEC mode. show controllers fabricq output [location node-id]
Syntax Description
location node-id
(Optional) Displays statistical information for the designated node. The node-id argument is entered in the rack/slot/module notation.
Defaults
Information is displayed for all performance route processors (PRPs) on the router.
Command Modes
Admin EXEC
Command History
Release Release 3.1
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. Use the show controllers fabricq output command to display to fabric output service statistics. Specifying a location displays information only if that location is a PRP. The service time is the time from when the PRP CPU has made the packet ready to be sent to the slot to when the chopper FPGA has put the packet on the queue to that particular slot. (The Chopper is the PRP FPGA that handles packets to be sent to the fabric). The show controllers fabricq output command is intended for use while performing debugging procedures.
Examples
The following is sample output from the show controllers fabricq output command for location 0/1/CPU0:
RP/0/1/CPU0:router(admin)# show controllers fabricq output location 0/1/CPU0 Location 0/1/0: To Fabric servicing time statistics: -----------------------------------Slot Minimum Maximum Average Low Priority: 0 0 0 0 1 0 0 0 2 0 10 0 3 0 21 0 4 0 0 0 5 0 0 0
Timeouts 0 0 0 0 0 0
HR-223
Fabric Management Commands on Cisco IOS XR Software show controllers fabricq output
6 7 8 9 10 11 12 13 14 15 mcast High Priority: 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 mcast
0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0
0 0 0 0 0 0 0 0 0 0 0 0 22 96 13 12 14 0 0 0 0 0 0 0 0 0 0 6
0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0
0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0

Table 58 show controllers fabricq output Field Descriptions
Field Slot Minimum Maximum Average Timeouts
Description Slot to which the packets are sent. Lowest service time of all the packets sent to that slot. Highest service time of all the packets sent to that slot. Average service time of all the packets sent to that slot. Number of times a packets service time has exceeded a threshold of 200 milliseconds (the packet is dropped).
Related Commands
Command show controllers fabricq drop show controllers fabricq errors show controllers fabricq frfab show controllers fabricq queue show controllers fabricq tofab
Description Displays information about packet drops. Displays information about errors. Displays from fabric statistics. Displays information about packet queues. Displays to fabric statistics.
HR-224
Fabric Management Commands on Cisco IOS XR Software show controllers fabricq packet-stats
show controllers fabricq packet-stats

To display statistics about packet flow through the fabric queue application-specific integrated circuit (ASIC), use the show controllers fabricq packet-stats command in EXEC mode. show controllers fabricq packet-stats [asic instance] [location node-id]
Syntax Description
asic instance location node-id
(Optional) Specifies instance and number for a single fabric queue ASIC. The instance argument is a number from 0 to 4. (Optional) Specifies statistical packet flow information for the designated node. The node-id argument is entered in the rack/slot/module notation.
Defaults
Information for all fabric queue ASICs for all locations is displayed.
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. The show controllers fabricq packet-stats command is used to track the number of unicast and multicast packets that are sent from the fabric to the specified node.
Examples
The following is sample output from the show controllers fabricq packet-stats command that displays statistics about fabric queue packets that have passed through ASIC 0 on node 0/1/CPU0:
RP/0/RP0/CPU0:router# show controllers fabricq packet-stats asic 0 location 0/1/CPU0 Fabric Queue Manager Packet Statistics ====================================== Location: 0/1/CPU0 Asic Instance: 0 Fabric Destination Address:
32
Input Cell counters: +----------------------------------------------------------+ Data cells : 42356 (+ 22 ) Control cells : 29877224 (+ 36372 ) Idle cells : 219947284936 (+ 267358842 )
HR-225
Fabric Management Commands on Cisco IOS XR Software show controllers fabricq packet-stats
Reassembled packet counters +----------------------------------------------------------+ Ucast pkts : 0 (+ 0 ) Mcast pkts : 0 (+ 0 ) Cpuctrlcast pkts : 21159 (+ 11 ) Dropped packets +----------------------------------------------------------+ Ucast pkts : 0 (+ 0 ) Mcast pkts : 0 (+ 0 ) Cpuctrlcast pkts : 0 (+ 0 ) Vital denied pkts : 0 (+ 0 ) NonVital denied pkts : 0 (+ 0 ) Unicast lost pkts : 0 (+ 0 ) Ucast partial pkts : 0 (+ 0 ) PSM OOR Drops : 0 (+ 0 )

Table 59 show controllers fabricq packet-stats Field Descriptions
Field Input Cell counters Reassembled packet counters Dropped packets
Description Number of cells that have reached the fabric queue ASIC. Number of packets the fabric queue ASIC has reassembled after transmission over the fabric. Number of packets the fabric queue ASIC has had to drop.
HR-226
Fabric Management Commands on Cisco IOS XR Software show controllers fabricq queue
show controllers fabricq queue

To display information about the hardware queues of the performance route processor chopper and assembler FPGAs, use the show controllers fabricq queue command in Admin EXEC mode. show controllers fabricq queue [detail] [location node-id]
Syntax Description
Defaults
Information for all performance route processors on the router is displayed.
Command Modes
Admin EXEC
Command History
Release Release 3.1
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. Use the show controllers fabricq queue command to display information about packet queues. Specifying a location displays information only if that location is a PRP. This command is intended for use while performing debugging procedures.
Examples
The following is detailed sample output from the show controllers fabricq queue command for location 0/1/CPU0:
RP/0/1/CPU0:router(admin)# show controllers fabricq queue detail location 0/1/CPU0 Location 0/1/0: To Fabric Queue Stats: ---------------------Slot EnQueued DeQueued Cur-Entrys Max-Entrys Low Priority: 0 0 0 0 0 1 0 0 0 0 2 300 300 0 2 3 8428 8428 0 12 4 0 0 0 0 5 0 0 0 0 6 0 0 0 0 7 0 0 0 0 8 0 0 0 0
Blocked No No No No No No No No No
BP count 0 0 0 0 0 0 0 0 0
HR-227
9 0 0 10 0 0 11 0 0 12 0 0 13 0 0 14 0 0 15 0 0 mcast 0 0 High Priority: 0 0 0 1 7882 7882 2 62330 62330 3 60752 60752 4 72588 72588 5 60876 60876 6 0 0 7 0 0 8 0 0 9 0 0 10 0 0 11 0 0 12 0 0 13 0 0 14 0 0 15 0 0 mcast 19562 19562 Free packet header buffers 7680 From Fabric Queue Stats: ----------------------Queue Allocated Free 0 0 512 1 0 512 2 0 512 3 0 512 F/Q 87 937
0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0
0 0 0 0 0 0 0 0 0 2 36 100 36 100 0 0 0 0 0 0 0 0 0 0 200
No No No No No No No No No No No No No No No No No No No No No No No No No
0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0

Table 60 show controllers fabricq queue Field Descriptions
Field Slot EnQueued DeQueued Cur-Entrys Max-Entrys Blocked BP count Queue Allocated Free
Description Slot or queue to which the packets are sent. Number of entries enqueued for that queue. Number of entries dequeued for that queue. Number of entries currently for that queue. Highest number of entries for that queue. Yes or No if that queue is blocked. Backpressure count, which is the number of times the queue got full. Priority queues receiving packets; 0 is the highest priority. The F/Q entry is the software free packet queue. Number of packets in that queue. Number of packets available for that queue.
HR-228
Related Commands
Command show controllers fabricq drop show controllers fabricq errors show controllers fabricq frfab show controllers fabricq output show controllers fabricq tofab
Description Displays information about packet drops. Displays information about errors. Displays from fabric statistics. Displays information about to fabric output service. Displays to fabric statistics.
HR-229
Fabric Management Commands on Cisco IOS XR Software show controllers fabricq registers
show controllers fabricq registers

To display the hardware registers of the chopper and assembler FPGAs, use the show controllers fabricq registers command in Admin EXEC mode. show controllers fabricq registers [detail] [location node-id]
Syntax Description
Defaults
Information for all performance route processors (PRPs) on the router is displayed.
Command Modes
Admin EXEC
Command History
Release Release 3.1
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. Use the show controllers fabricq registers command to display the hardware registers of the chopper and assembler FPGAs. Specifying a location displays information only if that location is a PRP. This command is intended for use while performing debugging procedures.
Examples
The following is sample output from the show controllers fabricq registers command for location 0/1/CPU0:
RP/0/1/CPU0:router(admin)# show controllers fabricq registers location 0/1/CPU0 Location 0/1/0: Chopper Registers: -----------------FPGA Version HP Descriptor fetch enable Descriptor array size Interrupt cause Interrupt mask LP Descriptor fetch enable HP Interrupt desc afull LP Interrupt desc afull Discovery low control reg base address Discovery next desc reg base address Chopper PCI base address
00020012 00010000 000003FF 00000000 FC01FFFF 00000008 00000000 00000000 F1000840 F1000830 F0000000
HR-230
HP Descriptor queue empty status HP Descriptor queue almost full Data queue empty status Data queue almost full LP Descriptor queue empty status LP Descriptor queue almost full SRAM Descriptor threshold SRAM Data threshold DMA Control Back pressure status Fusilli Tx Enable Cell count Reset VOQ DMA Busy Status DMA Done Status HP Descriptor start addr for queue HP Descriptor start addr for queue HP Descriptor start addr for queue HP Descriptor start addr for queue HP Descriptor start addr for queue HP Descriptor start addr for queue HP Descriptor start addr for queue HP Descriptor start addr for queue HP Descriptor start addr for queue HP Descriptor start addr for queue HP Descriptor start addr for queue HP Descriptor start addr for queue HP Descriptor start addr for queue HP Descriptor start addr for queue HP Descriptor start addr for queue HP Descriptor start addr for queue HP Descriptor start addr for queue LP Descriptor start addr for queue LP Descriptor start addr for queue LP Descriptor start addr for queue LP Descriptor start addr for queue LP Descriptor start addr for queue LP Descriptor start addr for queue LP Descriptor start addr for queue LP Descriptor start addr for queue LP Descriptor start addr for queue LP Descriptor start addr for queue LP Descriptor start addr for queue LP Descriptor start addr for queue LP Descriptor start addr for queue LP Descriptor start addr for queue LP Descriptor start addr for queue LP Descriptor start addr for queue LP Descriptor start addr for queue Assembler Registers: ------------------Version Chip Config Int Mask Output Queue Threshold Low Pri Req level High Pri Req level Free Queue Size Free Queue Base Free Queue Rd Pointer Free Queue Wr Pointer Output Queue Size Output Queue 0 Base Addr
0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16
0001FFFF 00000000 0001FFFF 00000000 0001FFFF 00000000 000003F0 000007F0 000000DD 00000000 0001FFFF 0030CDA1 00000000 00000000 000000DD 0B448000 0B44A000 0B44C000 0B44E000 0B450000 0B452000 0B454000 0B456000 0B458000 0B45A000 0B45C000 0B45E000 0B460000 0B462000 0B464000 0B466000 0B468000 0B426000 0B428000 0B42A000 0B42C000 0B42E000 0B430000 0B432000 0B434000 0B436000 0B438000 0B43A000 0B43C000 0B43E000 0B440000 0B442000 0B444000 0B446000
0002000D 0000000F 00000000 00000033 00000030 00000060 00001000 0B3A6000 0B3A6380 0B3A61C0 00001000 0B3A8000
HR-231
Output Queue 0 Write Addr Output Queue 0 Read Addr Output Queue 0 Match Output Queue 0 Mask Output Queue 1 Base Addr Output Queue 1 Write Addr Output Queue 1 Read Addr Output Queue 1 Match Output Queue 1 Mask Output Queue 2 Base Addr Output Queue 2 Write Addr Output Queue 2 Read Addr Output Queue 2 Match Output Queue 2 Mask Output Queue 3 Base Addr Output Queue 3 Write Addr Output Queue 3 Read Addr Output Queue 3 Match Output Queue 3 Mask Discard Buffer Addr REFIM config REFIM Max Packet Len
0B3A8000 0B3A8000 C0000200 00003E00 0B3AA000 0B3AAB58 0B3AAB58 C0000C00 00003E00 0B3AC000 0B3AC4D0 0B3AC4D0 C0000400 00003C00 0B3AE000 0B3AE360 0B3AE360 C0000000 00000000 0A1AC700 00000000 000000C1
Related Commands
Command show controllers fabricq drop show controllers fabricq errors show controllers fabricq frfab show controllers fabricq output show controllers fabricq queue show controllers fabricq tofab
Description Displays information about packet drops. Displays information about errors. Displays from fabric statistics. Displays information about to fabric output service. Displays information about packet queues. Displays to fabric statistics.
HR-232
Fabric Management Commands on Cisco IOS XR Software show controllers fabricq tofab
show controllers fabricq tofab

To display to fabric statistics associated with the fabric queue driver, use the show controllers fabricq tofab command in Admin EXEC mode. show controllers fabricq tofab [detail] [location node-id]
Syntax Description
Defaults
Information for all performance route processors (PRPs) on the router is displayed.
Command Modes
Admin EXEC
Command History
Release Release 3.1
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. Use the show controllers fabricq tofab command to display to fabric statistics. Specifying a location displays information only if that location is a PRP. The show controllers fabricq tofab command is intended for use while performing debugging procedures.
Examples
The following is sample output from the show controllers fabricq tofab command for location 0/1/CPU0:
RP/0/1/CPU0:router(admin)# show controllers fabricq tofab location 0/1/CPU0 Location 0/1/0: To Fabric Stats: --------------Slot Tx-pkts Low Priority: 3 0 High Priority: 1 0 2 0 3 0 4 0 5 0 mcast 0
Tx-TH-pkts Tx-dropped Tx-DMA 446 248 13696 14347 15889 14351 2182 0 0 0 0 0 0 0 446 248 13696 14347 15889 14351 2182
HR-233
Fabric Management Commands on Cisco IOS XR Software show controllers fabricq tofab
To Fabric Errors: ---------------Failed sends because of no header bufs - 0 Failed sends because of no payload bufs - 0 SRAM parity errors - 0 DMA errors - 0 Fusilli Parity errors - 0

Table 61 show controllers fabricq tofab Field Descriptions
Field Tx-pkts Tx-TH-pkts Tx-dropped Tx-DMA
Description Number of packets sent to that slot. Number of think hard packets sent to that slot. Number of dropped packets sent to that slot. Number of direct memory accesses (DMA) to send the packet to that slot.
Related Commands
Command show controllers fabricq drop show controllers fabricq errors show controllers fabricq frfab show controllers fabricq output show controllers fabricq queue
Description Displays information about packet drops. Displays information about errors. Displays from fabric statistics. Displays information about to fabric output service. Displays information about packet queues.
HR-234
Fabric Management Commands on Cisco IOS XR Software show controllers ingressq statistics
show controllers ingressq statistics

To display statistical information for the ingress queue application-specific integrated circuit (ASIC), use the show controllers ingressq statistics command in EXEC mode. show controllers ingressq statistics [location node-id]
Syntax Description
location node-id
(Optional) Specifies statistical ingress queue information for the designated node. The node-id argument is entered in the rack/slot/module notation.
Defaults
Information for all locations is displayed.
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. The show controllers ingressq statistics command is used to track the number of unicast and multicast packets that are sent to the fabric from the specified node.
Examples
The following is sample output from the show controllers ingressq statistics command that displays packet and cell flow statistics through an ingress queue on node 0/1/CPU0:
RP/0/RP0/CPU0:router# show controllers ingressq statistics location 0/1/CPU0 Ingressq Rx Statistics. -----------------------------------------------------------------------rx pkts : 278770 ( 44473109 bytes) rx pkts from cpu : 263548 ( 36239661 bytes) rx control pkts from cpu : 263548 ( 36239661 bytes) rx data pkts from cpu : 0 ( 0 bytes) Ingressq Tx Statistics. -----------------------------------------------------------------------tx pkts : 278768 ( 48162158 bytes) tx pkts to cpu : 15222 ( 8233448 bytes) tx control pkts to cpu : 15222 ( 8233448 bytes) tx data pkts to cpu : 0 ( 0 bytes) tx pkts shaped : 263546 ( 39928710 bytes) tx cells to fabric : 529664 Ingressq Drops.
HR-235
Fabric Management Commands on Cisco IOS XR Software show controllers ingressq statistics
-----------------------------------------------------------------------length error drops : 0 crc error drops : 0 OOR error drops : 0 backpressure discard drops : 0 tail drops : 0 cell drops : 2

Table 62 show controllers ingressq statistics Field Descriptions
Field Ingressq Rx Statistics Ingressq Tx Statistics Ingressq Drops
Description Receive side statistics, which include Rx packets from metro and Rx packets from the CPU. Transmit side statistics, which include Tx packets sent out and the number of cells sent to the fabric. Count of various packet and cell drops within the ingress queue.
HR-236
Hardware Redundancy and Node Administration Commands on Cisco IOS XR Software

This module describes the administrative platform commands used to manage hardware redundancy, power, and administrative status of the nodes on a router running Cisco IOS XR software.
HR-237
Hardware Redundancy and Node Administration Commands on Cisco IOS XR Software ce tftp server enable
ce tftp server enable

To enable or disable Trivial File Transfer Protocol (TFTP) on a specific directory, or to enable files to be written to the TFTP server, use the ce tftp enable command in global configuration mode. ce tftp enable {homedir name| write}
Syntax Description
homedir name write
Home directory for TFTP server. Enables files to be written to the TFTP server.
Defaults
Command Modes
Command History
Usage Guidelines
Examples
The following example shows how to enable files to be written to the TFTP server. In this example, the directory is called ios:
RP/0/RP0/CPU0:router(config)# ce tftp server enable write RP/0/RP0/CPU0:router(config)#
The following example shows how to enable TFTP on a specific directory:

RP/0/RP0/CPU0:router(config)# ce tftp server enable homedir ios RP/0/RP0/CPU0:router(config)#
HR-238
Hardware Redundancy and Node Administration Commands on Cisco IOS XR Software clear mbus location
clear mbus location

To clear all MBUS interface counters on a specific node, use the clear mbus command in Admin EXEC mode. clear mbus location node-id
Syntax Description
location node-id
Identifies the location of the node whose MBUS interface counters you want to display.The node-id is expressed in the rack/slot/module notation.
Note
Defaults
Command Modes
Admin EXEC
Command History
Release Release 3.1
Usage Guidelines
Examples
The following example shows how to clear all MBUS interface counters on a specific node:
RP/0/0/CPU0:router(admin)# clear mbus location 0/0/CPU0 RP/0/0/CPU0:router(admin)# exit
HR-239
Hardware Redundancy and Node Administration Commands on Cisco IOS XR Software diag
diag
To run field diagnostics on a node, and to configure various diagnostics testing parameters, use the diag command in EXEC mode. On the Cisco CRS-1: diag [[errorpolicy {coe | hoe | loe | roe}] | [halt] | [testlevel level] | [verbose level] | [wait]] location node-id On the Cisco 12000 Series router : diag slot-number [coe] [device device-id] [dl-timeout-plus seconds] [full] [halt] [messaging [seconds]] [previous] [source {flash | tftp} [source-path]] [update-fpga] [verbose] [wait]
Defaults
Command Modes
EXEC
Command History
Release Release 2.0 Release 3.0 Release 3.1 Release 3.2
Modification This command was introduced on the Cisco CRS-1. No modification. No modification. This command was first supported on the Cisco 12000 Series router. On the Cisco CRS-1, the diag command was updated to include the halt keyword and location node-id argument.
Usage Guidelines
Note
User-initiated diagnostics may run up to 8 hours or longer. Keep the following guidelines in mind when using the diag command on the Cisco CRS-1:
The recommended error policy setting is continue-on-error (coe). This setting continues to run tests despite a test failure. If you specify a coe error policy, Cisco recommends setting the verbose level to 5
and above.
The recommended verbosity level is 3, which provides a progress indicator and a final test result summary. The diagnostic verbose output appears on the route processor (RP) console; consequently, you must have a connection to that port to view the output. To terminate a field diagnostic test, use the diag halt location node-id command. Use the following diag command syntax when running a diagnostics test on an RP:
Keep the following guidelines in mind when using the diag command on the Cisco 12000 Series Router:
HR-240
diag slot-number {[verbose] [wait] [full] [coe] | previous | halt}
Note
The source {tftp | flash}, source-path, dl-timeout-plus 1-2000, device device-id, messaging [seconds], and update-fpga keyword arguments are not applicable on Cisco 12000 Series Router line cards. Use the following diag command syntax when running a diagnostics test on Cisco 12008, Cisco 12012, and Cisco 12016 switch fabric card (SFCs) and clock and scheduler cards (CSCs): diag slot-number [verbose]
Note
The source {tftp | flash}, source-path, wait, full, coe, dl-timeout-plus 1-2000, device device-id, messaging [seconds], previous, halt, and update-fpga keyword arguments are not applicable on Cisco 12008, Cisco 12012, and Cisco 12016 SFCs and CSCs. Before you can use the line card field diagnostics commands, you must place a valid diagnostics image on a separate flash memory card that is installed in the Cisco 12000 Series Internet Router to be tested, or on a TFTP boot server. The diagnostics image is named c12k-fdiagsbflc-mz.120-25.S, where 120-25.S is the version number corresponding to Cisco IOS release 12.0(25)S). The diagnostics image is always available on Cisco.com. RP, SFC, and CSC field diagnostics are imbedded within the IOS XR image, and do not require an external image installation. Perform diagnostics on the CSC only if there is a redundant CSC installed in the router. Diagnostics can be performed on redundant RPs only. Currently, SFC and CSC testing is not available for Cisco 12400 Series Internet Routers. Some nodes include components that are unable to isolate internal node testing traffic from customer premise connections. Before testing such nodes, you can ensure reliable results and minimize traffic disruption by disconnecting any connections to the nodes. The diagnostics software prompts you for confirmation before altering the router configuration. For example, running diagnostics on an SFC or CSC will cause the fabric to go from full bandwidth to one-quarter bandwidth. Bandwidth is not affected by RP, line card, or modular services card diagnostics. If a test fails in normal mode, the title of the failed test is displayed on the console. However, not all tests that are performed are displayed. To view all performed tests, use the verbose keyword. After all diagnostic tests are completed on the line card or modular services card, a PASSED or TEST FAILURE message is displayed. If the line card or modular services card sends a PASSED message, the Cisco IOS XR software image on the card is automatically reloaded unless you specified the wait with the diag command. If the card sends a TEST FAILURE message, the Cisco IOS XR software image is not automatically reloaded on the card. If you want to reload the line card or modular services card after it fails diagnostic testing, use the reload command. If a line card or modular services card fails the diagnostics test, the card is defective and needs to be replaced. TAC engineers may direct you to replace field-replaceable memory modules and retest. This should only be done under the guidance of a TAC engineer. For example, if the DRAM test failed, a customer might only need to replace the DRAM on the card.
The following guidelines apply to both the Cisco CRS-1 and the Cisco 12000 Series router:
HR-241
Cisco recommends using the verbose option with the diag command to ensure you achieve the right level of verbosity in the diagnostics test. Use the show diag command to view field diagnostic test results.
Caution
Performing field diagnostics on a card stops all activity on the card. Before the diag command begins running diagnostics, you are prompted to confirm the request to perform field diagnostics on the card.
Note
When you stop the field diagnostic test with the diag halt command, the card remains down (or in an unbooted state). Generally, you would stop testing in order to remove or replace the card. If you do not want to remove or replace the card, you can use the microcode reload command or power cycle the card to bring it back up (online).
Examples
The following example shows the output when field diagnostics are performed on the line card in slot 7 of a Cisco 12000 Series router:
Router# diag 7 source tftp tftp://192.164.5.4/images/c12k-fdiagsbflc-mz.120-25.S Running DIAG config check Fabric Download for Field Diags chosen: If timeout occurs, try 'mbus' option. Running Diags will halt ALL activity on the requested slot. [confirm] award-rp-slot0# Launching a Field Diagnostic for slot 7 Downloading diagnostic tests to slot 7 via fabric (timeout set to 300 sec.) 5d20h: %GRP-4-RSTSLOT: Resetting the card in the slot: 7,Event: EV_ADMIN_FDIAG Loading images/award/c12k-fdiagsbflc-mz from 192.164.1.1 (via Ethernet0): !!!!! 5d20h: Downloading diags from tftp file tftp://192.164.1.1/images/award/c12k-fdiagsbflc-mz !!!!![OK - 13976524 bytes] FD 7> ***************************************************** FD 7> GSR Field Diagnostics V6.05 FD 7> Compiled by award on Tue Jul 30 13:00:41 PDT 2002 FD 7> view: award-conn_isp.FieldDiagRelease FD 7> ***************************************************** Executing all diagnostic tests in slot 7 (total/indiv. timeout set to 2000/600 sec.) FD 7> BFR_CARD_TYPE_OC12_4P_POS testing... FD 7> Available test types 2 FD 7> 1 FD 7> Completed f_diags_board_discovery() (0x1) FD 7> Test list selection received: Test ID 1, Device 0 FD 7> running in slot 7 (30 tests from test list ID 1) FD 7> Skipping MBUS_FDIAG command from slot 2 FD 7> Just into idle state Field Diagnostic ****PASSED**** for slot 7 Shutting down diags in slot 7 Board will reload 5d20h: %GRP-4-RSTSLOT: Resetting the card in the slot: 7,Event: EV_ADMIN_FDIAG SLOT 7:00:00:09: %SYS-5-RESTART: System restarted -Cisco Internetwork Operating System Software
HR-242
IOS (tm) GS Software (GLC1-LC-M), Experimental Version 12.0(20020509:045149) [award-conn_isp.f_diag_new 337] Copyright (c) 1986-2002 by cisco Systems, Inc. Compiled Tue 25-Jun-02 15:51 by award
The following example shows output for a Cisco 12000 Series router line card test with the verbose option specified.
Router# diag 7 verbose tftp tftp://192.164.1.1/images/award/c12k-fdiagsbflc-mz.120-25.S Running DIAG config check Fabric Download for Field Diags chosen: If timeout occurs, try 'mbus' option. Verbose mode: Test progress and errors will be displayed Runnning Diags will halt ALL activity on the requested slot. [confirm] Router# Launching a Field Diagnostic for slot 7 Downloading diagnostic tests to slot 7 via fabric (timeout set to 300 sec.) 00:07:41: %GRP-4-RSTSLOT: Resetting the card in the slot: 7,Event: EV_ADMIN_FDIAG Loading images/award/c12k-fdiagsbflc-mz from 192.164.1.1 (via Ethernet0): !!!!!! (...) 00:08:24: Downloading diags from tftp file tftp://192.164.1.1/images/award/c12k-fdiagsbflc-mz !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! [OK - 13976524 bytes] FD 7> *****************************************************
Related CommandsF
Command show diag
Description Displays details about the hardware and software on each node on a router.
HR-243
Hardware Redundancy and Node Administration Commands on Cisco IOS XR Software dsc node
dsc node
To configure designated node priority, use the dsc node command in administrative executive mode. dsc node {0/2/CPU0 | 0/2/SP | 0/RP1/CPU0 | 0/SM1/SP | node-id} priority number | set-as-backup | set-as-dsc} |tbeacon timeout} dsc node node-id {priority {priority | set-as-backup | set-as-dsc} | tbeacon timeout}
Syntax Description
0/2/CPU0 0/2/SP 0/RP1/CPU0 0/SM1/SP node-id priority number priority set-as-backup priority set-as-dsc tbeacon timeout
Display diagnostics for the CPU0 node located in rack 0, slot 2. Display diagnostics for the SP node located in rack 0, slot 2. Display diagnostics for the RP1 node. Displays diagnostics for the SM1 node. Identifies the location of a node. The node-id is expressed in the rack/slot/module notation. Configures priority for this router. Replace the number argument with a priority number. Range is from 1 through 255. Configures this router to act as a backup dSC. Configures this rack to be the dSC on re-election Modifies the dSC beacon timeout value.
Note
We recommend that you do not use this option and modify the dSC beacon timeout value.
Related Commands
EXEC
Command History
Usage Guidelines
Examples
The following example shows how to configure designated node priority:

RP/0/RP0/CPU0:router(admin-config)# dsc node 0/0/CPU0 priority 30 RP/0/RP0/CPU0:router(admin-config)#
Related Commands
HR-244
Hardware Redundancy and Node Administration Commands on Cisco IOS XR Software dsc node
Command dsc serial show dsc
Description Defines a serial ID for a rack. Displays the current dial shelf controller (dSC) configuration for the shelf or for the system.
HR-245
Hardware Redundancy and Node Administration Commands on Cisco IOS XR Software dsc serial
dsc serial
To define serial ID for a rack, use the dsc serial command in admin configuration mode. To remove a serial ID entry from the dSC table, use the no form of this command. dsc serial serialId rack rack_num no dsc serial serialId rack rack_num
Syntax Description
serialId rack rack_num
Identifies the dSC serial. Range is from 0 through 16 characters. Identifies the rack whose ID you are configuring to be the serialId.
Command Modes
Admin configuration
Command History
Usage Guidelines
Examples
RP/0/RP0/CPU0:MiniQ(admin-config)# dsc serial 10 rack 1 RP/0/RP0/CPU0:MiniQ(admin-config)#
Related Commands
Command dsc node show dsc
Description Configures dSC priority for a node. Displays the current dial shelf controller (dSC) configuration for the shelf or for the system.
HR-246
Hardware Redundancy and Node Administration Commands on Cisco IOS XR Software env
env
To enable the environment monitoring on the chassis, use the env command in admin configuration mode. To disable environment monitoring, use the no form of this command. env no env
Syntax Description
Defaults
By default, environment monitoring is enabled.
Command Modes
Admin configuration
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. By default, environment monitoring related to temperature and voltage is enabled on a router running Cisco IOS XR software. If environmental monitoring is disabled, you are not alerted if the router overheats.
Examples
The following example shows how to disable environment monitoring with the no env command. The action does not occur until you enter the commit command.
RP/0/RP0/CPU0:router# admin config RP/0/RP0/CPU0:router(admin-config)# no env RP/0/RP0/CPU0:router(admin-config)# commit RP/0/RP0/CPU0:router(admin-config)# exit
Related Commands
Command env power-supply
Description Enables power supply monitoring on the chassis.
HR-247
Hardware Redundancy and Node Administration Commands on Cisco IOS XR Software env power-supply
env power-supply
To enable power supply monitoring on the chassis, use the env power-supply command in admin configuration mode. To disable the power supply, use the no form of this command. env power-supply no env power-supply
Syntax Description
Defaults
By default, power supply monitoring is disabled.
Command Modes
Admin configuration
Command History
Usage Guidelines
Note
Do not enable power supply monitoring unless the system uses B0 (or greater) power supplies.
Examples
The following example shows how to disable power supply monitoring with the no env power-supply command. The action does not occur until you enter the commit command.
RP/0/RP0/CPU0:router# admin config RP/0/RP0/CPU0:router(admin-config)# no env power-supply RP/0/RP0/CPU0:router(admin-config)# commit RP/0/RP0/CPU0:router(admin-config)# exit
Related Commands
Command env
Description Enables environment monitoring on the chassis.
HR-248
Hardware Redundancy and Node Administration Commands on Cisco IOS XR Software facility-alarm contacts
facility-alarm contacts
To set or unset facilities for processing alarms related to temperature and power supply conditions, use the facility-alarm contacts command in Admin EXEC mode. facility-alarm contacts {all | critical | major | minor} {audio | both | visual} {on | off} all critical major minor audio both visual on off Sets facility alarm contacts so that an audio and visual alarm alerts the user to a facility alarm of any severity. Sets facility alarm contacts so that an audio and visual alarm alerts the user to critical facility alarms. Sets facility alarm contacts so that an audio and visual alarm alerts the user to major facility alarms. Sets facility alarm contacts so that an audio and visual alarm alerts the user to minor facility alarms. Configures the alarm contacts to use an audio alarm to alert the user to alarms of the specified severity. Configures the alarm contacts to use audio and visual alarm media to alert the user to alarms of the specified severity. Configures the alarm contacts to use visual alarm media to alert the user to alarms of the specified severity. Enables facility alarm contacts configuration. Disables facility alarm contacts configuration.
Syntax Description
Defaults
Command Modes
Admin EXEC
Command History
Release Release 3.1
Usage Guidelines
Examples
The following example shows how to enable an audio alarm to alert the user when a critical facility-alarm occurs:
RP/0/0/CPU0:router(admin)# facility-alarm contacts critical audio on RP/0/0/CPU0:router(admin)#
HR-249
Hardware Redundancy and Node Administration Commands on Cisco IOS XR Software facility-alarm contacts
Related Commands
Command show facility-alarm contacts
Description Displays audio and visual facility alarm information for the router.
HR-250
Hardware Redundancy and Node Administration Commands on Cisco IOS XR Software hw-module node power
hw-module node power

To power on a specified node, use the hw-module node power command in global configuration mode. To power off a node, use the no form of this command. hw-module node node-id power [disable] no hw-module node node-id power [disable]
Syntax Description
node-id disable
Identifies the node you want to power on. The node-id argument is expressed in the rack/slot/module notation. (Optional) Disables this feature. Use the no form of the command to enable the feature.
Defaults
By default, this feature is enabled and power is on for all nodes.
Command Modes
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. Use the hw-module node power command to administratively turn power on or off for a node. The changes do not take effect until you enter the commit command.
Note
Route processors (RPs) cannot be powered down. Use the show platform command to view a summary of the nodes in the router, including status information.
Examples
In the following example, the no hw-module node power command is used to power off a node. The action does not occur until you enter the commit command.
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# no hw-module node 0/2/cpu0 power RP/0/RP0/CPU0:router(config)# commit RP/0/RP0/CPU0:Feb 13 05:11:27 : config[65709]: %LIBTARCFG-6-COMMIT : Configurati
HR-251
Hardware Redundancy and Node Administration Commands on Cisco IOS XR Software hw-module node power
on committed by user 'user_a'. Use 'show commit changes 1000000690' to view the c hanges. RP/0/RP0/CPU0:router(config)#RP/0/RP0/CPU0:Feb 13 05:11:31 : shelfmgr[276]: %SHE LFMGR-3-POWERDOWN_RESET : Node 0/0/CPU0 is powered off due to admin power off requ est RP/0/RP0/CPU0:router(config)# end RP/0/RP0/CPU0:router#
In the following example, the show platform command is used to display the status of the nodes in the system:
RP/0/RP0/CPU0:router# show platform Node Type PLIM State Config State ----------------------------------------------------------------------------0/2/SP MSC(SP) N/A MBI-RUNNING PWR,NSHUT,MON 0/2/CPU0 MSC N/A UNPOWERED NPWR,SHUT,MON 0/RP1/CPU0 RP(Active) N/A IOS-XR RUN PWR,NSHUT,MON 0/SM0/SP FC/S(SP) N/A IOS-XR RUN PWR,NSHUT,MON
In the following example, the hw-module node power command is used power on a node:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# hw-module node 0/0/cpu0 power RP/0/RP0/CPU0:router(config)# commit RP/0/RP0/CPU0:Feb 13 05:14:31 : config[65709]: %LIBTARCFG-6-COMMIT : Configurat on committed by user 'user_a'. Use 'show commit changes 1000000691' to view the hanges. RP/0/RP0/CPU0:router(config)# end RP/0/RP0/CPU0:router#
Related Commands
Command hw-module node reset hw-module node shutdown show platform
Description Reloads a specified node. Administratively shuts down a specified node. Displays information and status for each node in the system.
HR-252
Hardware Redundancy and Node Administration Commands on Cisco IOS XR Software hw-module node reset
hw-module node reset

To reset a specified node, use the hw-module node reset command in global configuration mode. hw-module node node-id reset auto [disable]
Syntax Description
node-id reset disable
Identifies the node you want to reload. The node-id argument is entered in the rack/slot/module notation. Resets the monitor state. (Optional) Disables the node reset feature on the specified node.
Defaults
By default, this feature is enabled for all nodes.
Command Modes
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. The hw-module node reset command is used to reload Cisco IOS XR software on a specific node. The node reloads with the current running configuration and active software set for that node.
Examples
The following example shows how to reload a node:

RP/0/RP0/CPU0:router# hw-module node 0/2/cpu0 reset RP/0/RP0/CPU0:router#RP/0/RP0/CPU0:Apr 2 22:04:43.659 : shelfmgr[294]: %S HELFMGR-3-USER_RESET : Node 0/2/CPU0 is reset due to user reload request
Related Commands
Command hw-module node power hw-module node shutdown
Description Powers on a specified node. Administratively shuts down a specified node.
HR-253
Hardware Redundancy and Node Administration Commands on Cisco IOS XR Software hw-module node shutdown
hw-module node shutdown

To administratively shut down a specified node, use the hw-module node shutdown command in global configuration mode. To return a node to the up state, use the no form of this command. hw-module node node-id shutdown no hw-module node node-id shutdown
Syntax Description
node-id
Identifies the node you want to shut down. The node-id argument is expressed in the rack/slot/module notation.
Defaults
Nodes are in the up state.
Command Modes
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. Nodes that are shut down still have power, but cannot load or operate Cisco IOS XR software. Use the hw-module node shutdown command to administratively shut down a node.
Note
Route processors (RPs) cannot be administratively shut down.
Examples
In the following example, the node 0/0/CPU0 is administratively shut down, and the change is committed. The action does not occur until you enter the commit command. Enter the show platform command in EXEC mode to display the results of the action.
RP/0/RP0/CPU0:router(config)# hw-module node 0/2/cpu0 shutdown RP/0/RP0/CPU0:router(config)# commit RP/0/RP0/CPU0:Feb 13 05:36:05 : config[65709]: %LIBTARCFG-6-COMMIT : Configurati on committed by user 'user_a'. Use 'show commit changes 1000000694' to view the c hanges. RP/0/RP0/CPU0:router(config)#RP/0/RP0/CPU0:Feb 13 05:36:09 : shelfmgr[276]: %SHE LFMGR-3-SHUTDOWN_RESET : Node 0/2/CPU0 is reset due to admin shut/no shut request RP/0/RP0/CPU0:router(config)# end
HR-254
Hardware Redundancy and Node Administration Commands on Cisco IOS XR Software hw-module node shutdown
RP/0/RP0/CPU0:Feb 13 05:36:37 : config[65709]: %SYS-5-CONFIG_I : Configured from console by lab RP/0/RP0/CPU0:router# show platform Node Type PLIM State Config State ----------------------------------------------------------------------------0/2/SP MSC(SP) N/A IOS-XR RUN PWR,NSHUT,MON 0/2/CPU0 MSC 16OC48-POS/DPT ADMIN DOWN PWR,SHUT,MON 0/RP1/CPU0 RP(Active) N/A IOS-XR RUN PWR,NSHUT,MON 0/RP0/CPU0 RP(Standby) N/A IOS-XR RUN PWR,NSHUT,MON 0/RP1/CPU0 RP(Active) N/A IOS-XR RUN PWR,NSHUT,MON 0/SM0/SP FC/S(SP) N/A IOS-XR RUN PWR,NSHUT,MON
In the following example, the specified node is brought up using the no form of the no hw-module node shutdown command:
RP/0/RP0/CPU0:router(config)# no hw-module node 0/2/cpu0 shutdown 0/2/CPU0 is reset due to admin shut/no shut request RP/0/RP0/CPU0:Feb 13 05:42:08 : config[65709]: %LIBTARCFG-6-COMMIT : Configurati on committed by user 'user_a'. Use 'show commit changes 1000000695' to view the c hanges. RP/0/RP0/CPU0:router(config)# end RP/0/RP0/CPU0:Feb 13 05:42:13 : config[65709]: %SYS-5-CONFIG_I : Configured from console by user_a RP/0/RP0/CPU0:router# show platform Node Type PLIM State Config State ----------------------------------------------------------------------------0/2/SP MSC(SP) N/A IOS-XR RUN PWR,NSHUT,MON 0/2/CPU0 MSC 16OC48-POS/DPT IOS-XR RUN PWR,NSHUT,MON 0/RP1/CPU0 RP(Active) N/A IOS-XR RUN PWR,NSHUT,MON 0/RP0/CPU0 RP(Standby) N/A IOS-XR RUN PWR,NSHUT,MON 0/RP1/CPU0 RP(Active) N/A IOS-XR RUN PWR,NSHUT,MON 0/SM0/SP FC/S(SP) N/A IOS-XR RUN PWR,NSHUT,MON
Related Commands
Command hw-module node power hw-module node reset
Description Powers on a specified node. Reloads a specified node.
HR-255
Hardware Redundancy and Node Administration Commands on Cisco IOS XR Software led mode
led mode
To specify the LED mode parameters, use the led mode command in admin configuration mode. To return the LED mode to the default settings, use the no form of this command. led mode {default | blink | scroll} {lock | unlock} led-display-text location node-id no led mode {default | blink | scroll} {lock | unlock} led-display-text location node-id
Syntax Description
default blink scroll lock unlock led-display-text location node-id
Sets the LED mode to the default fixed display. Sets the LED mode to blink alpha display. Sets the LED mode to scroll alpha display. Locks LED so the display message cannot be changed. Unlocks the LED and allows the display message to be changed. The message shown on the card in the LED display. Specifies the LED mode parameters for the designated node. The node-id argument is expressed in the rack/slot/module notation.
Defaults
LED display message: IOX-RUN (except active and standby Route processors [RPs] which would display ACTV RP and STBY RP respectively).
Command Modes
Admin configuration
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. Use the led mode command to specify the message to be displayed on the LED display on the card. Use the no form of the led mode command to reset the message to the default setting. The default message is IOX-RUN except for the RP, which has ACTV RP for the active RP and STBY RP for the standby RP.
Examples
The following example shows the LED display message being set to SW-RUN:
RP/0/RP0/CPU0:router# admin config RP/0/RP0/CPU0:router(admin-config)# led mode default unlock SW-RUN location 0/0/SP
HR-256
Hardware Redundancy and Node Administration Commands on Cisco IOS XR Software led mode
Related Commands
Command show led location
Description Lists the LED locations on the router.
HR-257
Hardware Redundancy and Node Administration Commands on Cisco IOS XR Software redundancy
redundancy
To enable redundancy failover for hardware cards, use the redundancy enable command in global configuration mode. To disable redundancy failover, use the disable keyword of this command. redundancy {enable | disable}
Syntax Description
enable disable
Enables redundancy failover. Disables redundancy failover.
Defaults
Redundancy is enabled by default
Command Modes
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. Be default, redundancy is enabled in a router running the Cisco IOS XR software. If two route processors (RPs) are installed in the router during system boot, one is automatically configured as the primary (active) RP, and the second is automatically configured as the standby RP.

If a standby RP is installed and in the ready state for failover, you can disable failover using the redundancy disable command. To enable redundancy failover, and return the router to the default state, enter the redundancy enable command.
Note
If redundancy is disabled and a standby card is detected, the standby card is not updated. However, if the active card fails, the standby card always takes over and becomes active.
HR-258
Hardware Redundancy and Node Administration Commands on Cisco IOS XR Software redundancy
Examples
In the following example, the redundancy enable command is used to enable RP redundancy failover on a router. The action does not occur until you enter the commit command.
RP/0/RP0/CPU0:router(config)# redundancy enable RP/0/RP0/CPU0:router(config)# commit RP/0/RP0/CPU0:Mar 28 22:24:05 : redcon[281]: %REDCON-6-FAILOVER_ENABLED : Failov er has been enabled by config RP/0/RP0/CPU0:Mar 28 22:24:05 : config[65739]: %LIBTARCFG-6-COMMIT : Configurati on committed by user 'user_a'. Use 'show commit changes 1000000528' to view the c hanges.
In the following example, the redundancy disable command used to disable redundancy failover on a router:
RP/0/RP0/CPU0:router(config)# redundancy disable RP/0/RP0/CPU0:router(config)# commit RP/0/RP0/CPU0:Mar 28 22:22:58 : redcon[281]: %REDCON-4-FAILOVER_DISABLED : Failo ver has been disabled by config RP/0/RP0/CPU0:Mar 28 22:22:58 : config[65739]: %LIBTARCFG-6-COMMIT : Configurati on committed by user 'user_a'. Use 'show commit changes 1000000527' to view the c hanges.
Related Commands
Command redundancy failover
Description Causes the primary (active) RP to fail over to the redundant standby RP, if the standby RP is available.
HR-259
Hardware Redundancy and Node Administration Commands on Cisco IOS XR Software redundancy failover
redundancy failover
To cause the primary (active) route processor (RP) to fail over to the redundant standby RP, use the redundancy failover command in EXEC mode. To disable the forced failover, use the no form of this command. redundancy failover [force] no redundancy failover [force]
Syntax Description
force
(Optional) Forces a switchover even if the standby is not ready.
Caution
Forcing a redundancy failover overrides the safety mechanisms and force the failover to occur. This action could result in loss of router service.
Defaults
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. Use the redundancy failover command to trigger a failover to the standby RP. When the redundancy failover command is issued, the running (committed) configuration is automatically saved and loaded during failover.
Note
The redundancy failover command can be issued only if the standby RP is in the ready state. Enter the show redundancy command to view the status of the RPs. The standby RP must be available in order for the primary (active) Route processor (RP) to fail over.
HR-260
Examples
You can force a manual failover from the primary RP to the standby RP using the redundancy failover command. If a standby RP is installed and in the ready state for failover, the standby RP becomes the active primary RP. The original primary RP becomes the standby RP.
HR-261
The following example shows partial output for a successful redundancy failover operation:
RP/0/RP0/CPU0:router# show redundancy This node (0/RP0/CPU0) is in ACTIVE role Partner node (0/RP1/CPU0) is in STANDBY role Standby node in 0/RP1/CPU0 is ready .... RP/0/RP0/CPU0:router# redundancy failover Initializing DDR SDRAM...found 2048 MB Initializing ECC on bank 0 ... Turning off data cache, using DDR for first time Initializing NVRAM... Testing a portion of DDR SDRAM ...done Reading ID EEPROMs ... Initializing SQUID ... Initializing PCI ... PCI0 device[1]: Vendor ID 0x10ee Configuring MPPs ... Configuring PCMCIA slots ... --More--
If the Standby RP is not in ready state, the failover operation is not allowed. The following example shows partial output for a failed redundancy failover attempt:
RP/0/RP0/CPU0:router# show redundancy This node (0/RP0/CPU0) is in ACTIVE role Partner node (0/RP1/CPU0) is in UNKNOWN role RP/0/RP0/CPU0:router# redundancy failover Standby card not running; failover disallowed.
Related Commands
Command show redundancy
Description Displays the redundancy status of the route processor (RP) nodes.
HR-262
Hardware Redundancy and Node Administration Commands on Cisco IOS XR Software redundancy reddrv
redundancy reddrv
To enable the route processor (RP) and display system controller (SC) redundancy, use the redundancy reddrv command in global configuration mode redundancy reddrv rackID [disable | prefer-slot {32 | 33}]
Syntax Description
rackID disable prefer-slot {32 | 33}
Identifies the rack on which you want to enable RP or SC redundancy. Enter the rack identifier. Range is from 1 through 127. (Optional) Disables RP or SC redundancy. (Optional) Sets slot number in a rack to be the preferred active RP or SC. Choose slot number 32 or 33.
Defaults
Command Modes
Command History
Usage Guidelines
Examples
The following example shows how to enable redundancy on the rack identified by the number 1:
RP/0/RP0/CPU0:router(config)# redundancy reddrv 1 RP/0/RP0/CPU0:router(config)#
Related Commands
Command show screddrv
Description Displays SC redundancy information.
HR-263
Hardware Redundancy and Node Administration Commands on Cisco IOS XR Software show diag
show diag
To display details about the hardware and software on each node in a router, use the show diag command in EXEC mode. On the Cisco CRS-1: show diag [node-id [details | eeprom-info | power-supply | summary]] | chassis | details | fans [eeprom-info] | power-supply [eeprom-info]| summary] On the Cisco 12000 Series router: show diag [slot] [details] [summary]
Syntax Description
node-id
(Optional) Identifies the node whose information you want to display. The node-id argument is expressed in the rack/slot/module notation. Follow the node-id argument with one of the following optional keywords to specify specific test results:
Note
details eeprom-info power-supply summary The node-id argument is available on the Cisco CRS-1 only. The chassis keyword is available on the Cisco CRS-1 only.
chassis details fans
(Optional) Displays diagnostics information about the current chassis only.

Note
(Optional) Displays detailed diagnostics information for the current node. (Optional) Displays fan tray diagnostics. To display fan-tray related field diagnostics results from EEPROM, follow the fans keyword with the optional eeprom-info keyword.
Note
The fans keyword is available on the Cisco CRS-1 only.
eeprom-info power-supply
(Optional) Displays field diagnostics results from the EEPROM. (Optional) Displays power-supply diagnostics. To display power-supply related field diagnostics results from EEPROM, follow the fans keyword with the optional eeprom-info keyword.
Note
The power-supply keyword is available on the Cisco CRS-1 only.
summary slot
(Optional) Displays summarized diagnostics results for all nodes in the system. Identifies the slot that hosts the node on which you want to run diagnostics. Replace slot-number with a slot number. Range is from 0 through 22.
Note
The slot argument is available on the Cisco CRS-1 only.
Defaults
Diagnostics for all nodes installed in the router are displayed.
Command Modes
EXEC
HR-264
Command History
Release Release 2.0 Release 3.0 Release 3.1 Release 3.2
Modification This command was introduced on the Cisco CRS-1. No modification. This command was first supported on the Cisco 12000 Series router. On the Cisco CRS-1, the show diag command was modified to display the last diagnostic result for a card.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. The show diag command displays detailed information on the hardware components for each node, and on the status of the software running on each node.
Examples
The following example shows sample output from the show diag details command on a Cisco CRS-1:
RP/0/RP1/CPU0:router#show diag details NODE 0/0/SP : MSC(SP) MAIN: board type 500060 0-0-00 rev 00 dev N/A S/N SAD072102RS PCA: 73-7648-04 rev 08 PID: rev 00 VID: V00 CLEI: ECI: 0 Board State : IOS-XR RUN PLD: Motherboard: 0x0025, Processor: 0xda13, Power: N/A MONLIB: QNXFFS Monlib Version 3.0 ROMMON: Version 1.19(20040603:013227) [CRS-1 ROMMON] SPEED: OSC Speed: 100 Mhz, CPU Speed: 800 Mhz BUS Speed: 100 Mhz, MEM Speed: 100 Mhz MEM Size: 2048 Mbytes RMA: Test Hist: ab, RMA#: 00-00-00, RMA Hist: 00 DIAGNOSTICS RESULTS: ENTRY 1: 0 TIMESTAMP: 00/00/0000 00:00:00 VERSION: v0.0 PARAM1: 0 PARAM2: n/a TESTNUM: 0 RESULT: 0 (PASS) ERRCODE: 0 ENTRY 2: 0 TIMESTAMP: 00/00/0000 00:00:00 VERSION: v0.0 PARAM1: 0 PARAM2: n/a TESTNUM: 0 RESULT: 0 (PASS) ERRCODE: 0 ENTRY 3: 0 TIMESTAMP: 00/00/0000 00:00:00 VERSION: v0.0 PARAM1: 0 PARAM2: n/a TESTNUM: 0
HR-265
RESULT: 0 (PASS) ERRCODE: 0 --More--

Table 63 show diag Field Descriptions (Cisco CRS-1)
Field MAIN
Description Provides the following general information about the hardware:

board type revision device identifier S/N
PCA PID VID CLEI ECI Board State PLD
Cisco PCA hardware and revision number. Displays the PID1 revision for the specified node. Displays the VID2 for the specified node. Displays the CLEI3 for the specified node. Displays the EDI4 for the specified node. Displays the current software on the board (in this case, Cisco IOS XR) and whether or not the board is running. Displays the information about the following PLD5 components on the current module:

Processor Power MONLIB
SPEED MEM Size RMA DIAGNOSTICS RESULTS
Displays speed information for the various components of the specified node, in Mhz. Displays the memory size of the specified node, in Mbytes. Displays RMA6 information for the specified node. Provides the following information about the last diagnostics test that was run on the specified node:

ENTRY 1 TIMESTAMPTimestamp for the last diagnostic test that was run on the node. VERSION PARAM1 PARAM2 TESTNUMIdentifies the test that was run on the node. RESULTDisplays whether the last diagnostic test passed or failed. ERRCODE
HR-266
1. process identifier 2. version identifier 3. common language equipment identifier 4. extended call interface 5. programmable logic device 6. Return Material Authorization
The following example shows sample output from the show diag command on a Cisco 12000 Series router. In this example, the show diag command is entered without any of the optional parameters. Diagnostic test results are displayed for all nodes in the router:
RP/0/RP0/CPU0:router# show diag SLOT 0 (RP/LC 0 ): Route Processor MAIN: type 19, 800-2427-01 rev J0 Deviation: 0 HW config: 0xFF SW key: FF-FF-FF PCA: 73-2170-03 rev G0 ver 3 Design Release 1.4 S/N CAB040879NN MBUS: MBUS Agent (1) 73-2146-07 rev B0 dev 0 HW version 1.2 S/N CAB040877IM Test hist: 0xFF RMA#: FF-FF-FF RMA hist: 0xFF DIAG: Test count: 0xFFFFFFFF Test results: 0xFFFFFFFF FRU: Linecard/Module: GRP= Route Memory: MEM-GRP-512= MBUS Agent Software version 1.100 (RAM) (ROM version is 2.9) ROM Monitor version 181 (old numbering scheme) Primary clock is CSC 1 Board State is IOS Running ACTIVE (ACTV RP ) Insertion time: 00:00:04 (5d01h ago) DRAM size: 536870912 bytes

Table 64 show diag Field Descriptions (Cisco 12000 Series Router)
Field SLOT MAIN PCA MBUS DIAG FRU MBUS Agent Software version ROM monitor version Primary clock Board State
Description Physical slot number of the line card. Provides general information about the hardware. Cisco PCA hardware and revision number. Provides version information for the MBUS agent. Displays the results of the last diagnostics test, in hexadecimal format. Displays information about the FRUs1 associated with the nodes that are installed in the router. Displays the Mbus agent software version currently running on the router. Version of monitor library used by ROMMON. Displays the primary clock source configured on the router. Displays the current software on the board (in this case, Cisco IOS XR), and whether or not the board is running.
HR-267
Table 64
show diag Field Descriptions (Cisco 12000 Series Router) (continued)
Field Insertion time DRAM size

1. Field-replaceable units 2. dynamic random-access memory
Description Displays the time at which the last diagnostics test was executed. Displays the DRAM2 size in bytes.
Related Commands
Command diag show platform show version
Description Runs field diagnostics on a node. Displays information and status for each node in the system. Displays details on the hardware and software status of the system.
HR-268
Hardware Redundancy and Node Administration Commands on Cisco IOS XR Software show dsc
show dsc
To display the current dial shelf controller (dSC) configuration for the shelf or for the system, enter the show dsc command in admin EXEC mode. show dsc [all | mine | node {node-id}]
Syntax Description
all mine node node-id
(Optional) Display dSC info from all available nodes in the system. (Optional) Display dSC information about the rack to which this rack is attached. (Optional) Display dSC info for a specific node. The node-id is expressed in the rack/slot/module notation.
Command Modes
Admin EXEC
Command History
Usage Guidelines
Examples
The following is sample output for the show dsc command:

RP/0/RP1/CPU0:MiniQ(admin)#show dsc NODE ROLE PRIORITY TBEACON PRESENT SERIAL ID =========================================================================== 0/RP1/CPU0 DSC 529 5000 YES --------------------------------------------------------------------------RP/0/RP1/CPU0:MiniQ(admin)#
Table 65
show dsc Field Descriptions
Field NODE ROLE PRIORITY TBEACON
Description Identifies the location of the node, in the rack/slot/module notation. Indicates the role this node is performing. Because this command shows DSC node, the ROLE for show dsc will always be dSC. Displays the DSC priority assigned to this node. Displays the current DSC beacon timeout value.
HR-269
Hardware Redundancy and Node Administration Commands on Cisco IOS XR Software show dsc
Table 65
show dsc Field Descriptions
Field PRESENT SERIAL ID
Description Indicates whether the node is present in the slot. Displays the serial ID assigned to this node.
Related Commands
Command dsc node dsc serial
Description Configures dSC priority for a node. Defines a serial ID for a rack.
HR-270
Hardware Redundancy and Node Administration Commands on Cisco IOS XR Software show environment
show environment
To display environmental monitor parameters for the system, use the show environment command in EXEC mode. On the Cisco CRS-1: show environment [all | fans | leds | power-supply | table | temperatures | voltages | | ] On the Cisco 12000 Series router: show environment [node-id | all | last | table | temperatures | voltages | | ]
Syntax Description
node-id all fans leds power-supply table temperatures voltages last
(Optional) Identifies the node whose information you want to display. The node-id argument is expressed in the rack/slot/module notation. (Optional) Displays information for all environmental monitor parameters. (Optional) Displays monitor parameters for system fans. (Optional) Displays monitor parameters for LEDs on all cards in the node. (Optional) Displays power supply voltage and current information. (Optional) Displays environmental parameter ranges. (Optional) Displays system temperature information. (Optional) Displays system voltage information. (Optional) Prior environmental monitor parameters
Defaults
All environmental monitor parameters are displayed.
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. The show environment command displays information on the hardware installed in the system, including fans, LEDs, power supply voltage, and current information and temperatures.
HR-271
Examples
The following is sample output from the show environment command with the temperatures keyword:
RP/0/RP0/CPU0:router# show environment temperatures R/S/I Modules Inlet Temperature (deg C) 31, 27 Exhaust Temperature (deg C) 43, 45 Hotspot Temperature (deg C) 48 31 46 44 34 43 35 42 44 36 42 43 41, 33
0/2/*
host cpu fabricq0 fabricq1 ingressq egressq ingresspse egresspse plimasic 0/RP1/* host cpu ingressq fabricq0 0/SM0/* host
41
30, 31 38
42
29, 29

Table 66 show environment temperatures Field Descriptions
Field R/S/I Modules Inlet Temperature (deg C)
Description Rack number, slot number, and interface for which information is displayed, in the format rack_num/slot_num/*. Module for which temperature information is displayed. Displays the current temperature of the inlet sensor in degrees Celsius.
Note
The inlet temperature corresponds to the room air temperature entering the router.
Exhaust Temperature (deg C)
Displays the current temperature of the exhaust sensor in degrees Celsius.

Note
The exhaust temperature corresponds to the air being exhausted from the router.
Hotspot Temperature (deg C)
Displays the current temperature of the hotspot in degrees Celsius.
The following is sample output from the show environment command the with the leds keyword:
RP/0/RP0/CPU0:router# show environment leds 0/2/*: Module (host) LED status says: OK 0/2/*: Module (plimasic) LED status says: OK 0/SM0/*: Module (host) LED status says: OK
HR-272

Table 67 show environment leds Field Descriptions
Field rack_num/slot_num/*:
Description Rack number and slot number where the node resides.
Module (host) LED status says: Current LED status of the specified node.
Related Commands
Command show platform
Description Displays information about the Cisco IOS XR system.
HR-273
Hardware Redundancy and Node Administration Commands on Cisco IOS XR Software show facility-alarm contacts
show facility-alarm contacts

To display audio and visual facility alarm information for the router, use the show facility-alarm contacts command in EXEC or Admin EXEC mode. show facility-alarm contacts
Syntax Description
Command Modes
EXEC Admin EXEC
Command History
Release Release 3.1
Defaults
Usage Guidelines
Examples
The following is sample output from the show facility-alarm contacts command:
RP/0/0/CPU0:router(admin)# show facility-alarm contacts Alarm Contacts +----------+-------+--------+ | Severity | Audio | Visual | +----------+-------+--------+ | Critical | off | off | | Major | off | off | | Minor | off | off | +----------+-------+--------+ RP/0/0/CPU0:router(admin)#

Table 68 show facility-alarm contacts Field Descriptions
Field Severity
Description Severity level of the alarm. Can be critical, major, or minor.
HR-274
Hardware Redundancy and Node Administration Commands on Cisco IOS XR Software show facility-alarm contacts
Table 68
show facility-alarm contacts Field Descriptions (continued)
Field Audio Visual
Description Describes whether there are audio alarms of the indicated severity on the router. off means there are no alarms. on means there are alarms. Describes whether there are visual alarms of the indicated severity on the router. off means there are no alarms. on means there are alarms.
Related Commands
Command facility-alarm contacts
Description Sets or unsets facilities for processing alarms related to temperature and power supply conditions.
HR-275
Hardware Redundancy and Node Administration Commands on Cisco IOS XR Software show fmgr interface
show fmgr interface

To display ternary content addressable memory (TCAM) entries for QoS, enter the show fmgr interface command in EXEC mode. show fmgr interface [Bundle-Ether bundle-id | Bundle-POS bundle-id | GigabitEthernet interface_instance| Loopback interface_instance| MgmtEth interface_instance | Null 0 | POS interface_instance] feature {policer | qos | qos-all} {in | out} { all [dup-bank] | dup-bank | hw [all | dup-bank | ipv4-mpls | ipv6] | ipv4-mpls [dup-bank] | ipv6 [dup-bank] | sw [all | dup-bank | ipv4-mpls | ipv6] } location node-id}
Syntax Description
Identifies the Aggregated Ethernet interface(s) whose egress queue information you want to display. Replace bundle-id with a port number. Range is from 1 through 65535.
Bundle-POS bundle-id Identifies the Aggregated PoS interface(s) whose egress queue information you want to display. Replace bundle-id with a port number. Range is from 1 through 65535. GigabitEthernet interface_instance Loopback interface_instance MgmtEth interface_instance Null 0 POS interface_instance feature policer qos qos-all in out all dup-bank hw ipv4-mpls ipv6 sw location node-id Identifies the GigabitEthernet or IEEE 802.3 interface(s) whose egress queue information you want to display. Identifies the loopback interface(s) whose egress queue information you want to display. Replace interface_instance with a loopback interface identifier. Range is from 1 through 65535. Identifies the Ethernet or IEEE 802.3 interface(s) whose egress queue information you want to display. Identifies the Null interface. Identifies the PoS interface(s) whose egress queue information you want to display. Displays feature specific information. Displays policer entries.. Displays Quality of Service (QoS) entries. Displays QoS and Policer entries. Specifies the ingress direction. Specifies the egress direction. Displays all TCAM entries. Displays entries from the duplicate bank in turbo mode. Reads from the hardware. Displays ipv4-mpls entries. Displays ipv6 entries. Reads from the software. Identifies the location of the interface whose TCAM information you want to display. The node-id is expressed in the rack/slot/module notation.
Note
HR-276
Command Modes
EXEC
Command History
Release Release 3.2
Usage Guidelines
Examples
The following example shows how to display all ingress QoS and Policer TCAM entries for an ethernet bundle:
RP/0/RP1/CPU0:MiniQ#show fmgr interface bundle-e 1 feature qos-all in QOS ENTRIES =============================================================================== Interface = Bundle-Ether1 Feature = qos Direction = in TCAM Fields: IPv4: ip/mpls bndl drid ip_src proto frag dscp ip_dest qos_grp dc dest_port MPLS: ip/mpls bndl label exp qos_grp dc CSRAM Fields: prio sh_q red_ctr qos_grp dc l2_mark l3_mark l3_mark_val max_th seg_size min_th 1st_seg pol_has_hpq =============================================================================== No QoS configured on this interface QOS ENTRIES =============================================================================== Interface = Bundle-Ether1 Feature = qos Direction = in TCAM Fields: IPv6: ipv6 dest_port ip_dest ip_src ext_dst ext_rtg ext_ah ext_frag bndl_id dest _rng_id dc qos_grp proto dscp/prec CSRAM Fields: prio sh_q red_ctr qos_grp dc l2_mark l3_mark l3_mark_val max_th seg_size min_th 1st_seg pol_has_hpq =============================================================================== No QoS configured on this interface
POLICER ENTRIES =============================================================================== Interface = Bundle-Ether1 Feature = policer Direction = in TCAM Fields: IPv4: ip/mpls bndl drid ip_src l4_proto frag dscp ip_dest qos_grp dc dest_port MPLS: ip/mpls bndl label exp qos_grp dc CSRAM Fields: token1 stats_ptr conform1 exceed1 violate1 token2 conform2 exceed2 violate2 =============================================================================== No QoS configured on this interface
POLICER ENTRIES =============================================================================== Interface = Bundle-Ether1 Feature = policer Direction = in
HR-277
TCAM Fields: IPv6: ipv6 dst_port ip_dest ip_src ext_dst ext_rtg ext_ah ext_frag bndl_id dest_ rng_id dc qos_grp l4_proto dscp/prec CSRAM Fields: token1 stats_ptr conform1 exceed1 violate1 token2 conform2 exceed2 violate2 =============================================================================== No QoS configured on this interface RP/0/RP1/CPU0:MiniQ#

Table 69 show bundle Bundle-Ether Field Descriptions
QOS ENTRIES
Displays the following QoS information:

InterfaceInterface type and identifier. FeatureFeature currently running on the specified interface. DirectionDirection of interface (ingress or egress).
TCAM Fields
Displays the following TCAM information for the specified interface.
What are these fields? Looks like interface info and protocol info... Please help with a definiton.
CSRAM Fields Displays CSRAM information.
What is CSRAM, and what is this showing in the display? Please help with a definiton.
HR-278
Hardware Redundancy and Node Administration Commands on Cisco IOS XR Software show inventory
show inventory
To display inventory information for the entire chassis, or for a specific node, use the show inventory command in EXEC or Admin EXEC mode. show inventory [node-id | all | chassis | raw]
Syntax Description
node-id
(Optional) Identifies the location of a specific node whose inventory information you want to display. The node-id is expressed in the rack/slot/module notation. (Optional) Displays inventory information for all the physical entities in the chassis. (Optional) Displays inventory information for chassis only. (Optional) Displays raw information about the chassis.
all chassis raw
Defaults
All inventory information for the entire chassis is displayed.
Command Modes
EXEC, Admin EXEC
Command History
Release Release 3.1
Usage Guidelines
Examples
The following is sample output from the show inventory command with the chassis keyword:
RP/0/0/CPU0:router(admin)# show inventory chassis NAME: "Chassis", DESCR: "GSR 12410 200 Gbps" PID: GSR10/200-AC , VID: 1.0, SN: TBA07420157 RP/0/0/CPU0:router(admin)#
The following is sample output from the show inventory command with the raw keyword:
RP/0/0/CPU0:router(admin)# show inventory raw NAME: "Chassis", DESCR: "GSR 12410 200 Gbps" PID: GSR10/200-AC , VID: 1.0, SN: TBA07420157 NAME: "slot 0", DESCR: "Line Card/RP slot " PID: , VID: N/A, SN: NAME: "0/0/CPU0", DESCR: "Cisco 12000 Series Performance Route Processor 1"
HR-279
Hardware Redundancy and Node Administration Commands on Cisco IOS XR Software show inventory
PID: PRP-1
, VID: N/A, SN: SAD0742066T
NAME: "voltages 0/0/CPU0", DESCR: "host__PLIM_V4_1.6V" PID: , VID: N/A, SN: NAME: "voltages 0/0/CPU0", DESCR: "host__PLIM_V5_1.8V" PID: , VID: N/A, SN: NAME: "voltages 0/0/CPU0", DESCR: "host__PLIM_V3_2.5V" PID: , VID: N/A, SN: NAME: "voltages 0/0/CPU0", DESCR: "host__3.3V" PID: , VID: N/A, SN: NAME: "voltages 0/0/CPU0", DESCR: "host__5V" PID: , VID: N/A, SN: NAME: "voltages 0/0/CPU0", DESCR: "host__Mbus5V" --More--

Table 70 show inventory Field Descriptions
Field NAME
Description Identifies the hardware for which the inventory information is displayed. If you are displaying the chassis inventory, this field shows, chassis. If you are displaying raw inventory, or all inventory information for all nodes in the chassis, this field shows the node name. For a node, the NAME is expressed in node_type/rack notation. Describes the chassis or the node. Chassis descriptions provide the name of the chassis and its Gbps. Node descriptions provide the type of node and its software version.
DESCR
PID VID SN
Physical model name of the chassis or node. Physical hardware revision of the chassis or node. Physical serial number for the chassis or node.
HR-280
Hardware Redundancy and Node Administration Commands on Cisco IOS XR Software show led
show led
To display a list of the LED locations on the router, or on a specific node, use the show led command in EXEC mode. show led
Syntax Description
Defaults
All LED locations on the router are displayed.
Command Modes
EXEC
Command History
Release Release 3.1
Usage Guidelines
Examples
The following is sample output from the show led command:

RP/0/RP0/CPU0:router# show led NODE 0/0/CPU0 : PRI RP NODE 0/3/CPU0 : IOX RUN NODE 0/4/CPU0 : IOX RUN NODE 0/5/CPU0 : IOX RUN NODE 0/6/CPU0 : IOX RUN NODE 0/7/CPU0 : IOX RUN NODE 0/8/CPU0 : IOX RUN RP/0/RP0/CPU0:router#

Table 71 show led Field Descriptions
Field IOX RP
1. route processor
Description Current platform running on this route (IOS XR). Current state of the RP1.
HR-281
Hardware Redundancy and Node Administration Commands on Cisco IOS XR Software show led location
show led location

To display LED information for the router, or for a specific node, use the show led location command in EXEC mode. show led location [node-id | all]
Syntax Description
node-id
Specific node whose LED information you want to display. The word argument is expressed in the rack/slot/module notation.
Note
all
Indicates that you want to display LED information for the entire router.
Defaults
Command Modes
EXEC
Command History
Usage Guidelines
Examples
The following is sample output from the show led location command with the all keyword::
RP/0/RP0/CPU0:router# show led location all LOCATION MESSAGE MODE STATUS ================================================== 0/0/SP IOS-XR DEFAULT UNLOCKED 0/3/SP IOS-XR DEFAULT UNLOCKED 0/RP0/CPU0 ACTV RP DEFAULT UNLOCKED 0/SM0/SP IOS-XR DEFAULT UNLOCKED RP/0/RP0/CPU0:router#
HR-282
Hardware Redundancy and Node Administration Commands on Cisco IOS XR Software show led location

Table 72 show led location Field Descriptions
Field LOCATION IOS-XR DEFAULT UNLOCKED
Description Identifies the location of the node. The LOCATION is expressed in the rack/slot/module notation Current message displayed by the LED. Current operating mode of the specified node. Current status of the specified node.
Related Commands
Command led mode
Description Specifies the LED mode parameters.

Note
The led mode command is available only on the Cisco CRS-1.
HR-283
Hardware Redundancy and Node Administration Commands on Cisco IOS XR Software show mbus
show mbus
To display Mbus Controller Area Network (CAN) errors and interface counters, use the show mbus command in Admin EXEC mode. show mbus {can-error | counters} location {node-id | all}
Syntax Description
can-error counters location all location node-id
Displays CAN bus error statistics. Displays information about the firmware packets that were dropped. Displays Mbus information for all nodes installed in the router. Identifies the location of the node whose CAN errors and interface counters you want to display. The node-id is expressed in the rack/slot/module notation. Note Enter the show platform command to see the location of all nodes installed in the router.
Defaults
Command Modes
Admin EXEC
Command History
Release Release 3.1
Usage Guidelines
Examples
The following is sample output from the show mbus command with the cann-error and location keywords:
RP/0/0/CPU0:router(admin)# show mbus can-error location 0/0/CPU0 Slot # Stuff Form Ack 0 0 0 0 RP/0/0/CPU0:router(admin)# Bit_1 0 Bit_0 0 CRC 0

Table 73 show mbus can-error Field Descriptions
Field Slot Stuff
Description Identifies the slot that contains the node whose Mbus counters are displayed. Number of stuff errors on the node.
HR-284
Hardware Redundancy and Node Administration Commands on Cisco IOS XR Software show mbus
Table 73
show mbus can-error Field Descriptions (continued)
Field Form Ack Bit_1 Bit-0 CRC

1. cyclic
Description Number of form errors on the node. Number of acknowledgement errors on the node. Number of Bit_1 errors on the node. Number of Bit_0 errors on the node. Number of CRC1 errors. redundancy check
The following is sample output from the show mbus command with the location keyword:
RP/0/0/CPU0:router(admin)# show mbus counters location 0/0/CPU0 Slot # Mbox Mbox Mbus Xmit Rcv Xmit 0 0 0 0 RP/0/0/CPU0:router(admin)# Mbus Rcv 0 Obj Ovr_wr 0
Table 74
show mbus counters Field Descriptions
Field Slot Mbox Xmit
Description Identifies the slot that contains the node whose Mbus counters are displayed. Number of packets dropped due to Mbox transmit errors.
Note
MBox is a chunk of the MP DMEM1 that receives MIPC messages. The Norm Priority mailbox has a buffer of 32 KB, while the High Priority Mbox has a buffer of 8 KB.
Mbox Rcv Mbus Xmit
Number of packets dropped due to Mbox receive errors. Number of packets dropped due to Mbus transmit errors.
Note
The Mbus is a low bandwidth (1 MBps) serial bus that connects cards, switch fabric cards, power supplies, and blower/fan assemblies to the GRP2.
Mbus Rcv Obj Ovr_wr
Number of packets dropped due to Mbus receive errors. Number of packets that were overwritten.
1. Maintenance Processor Data Memory 2. gigabit route processor
Related Commands
Command clear mbus location
Description Clears all MBUS interface counters on a specific node.
HR-285
Hardware Redundancy and Node Administration Commands on Cisco IOS XR Software show platform
show platform
To display information and status on each node in the system, use the show platform command in EXEC mode. On the Cisco CRS-1: show platform [node-id] On the Cisco 12000 Series router: show platform
Syntax Description
node-id
(Optional) Specifies the node about which to display information. The node-id argument is entered in the rack/slot/module notation.
Defaults
On the Cisco CRS-1, status and information is displayed for all nodes in the system. On the Cisco 12000 Series router, there are no default behavior or values.
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. The show platform command provides a summary of the nodes in the system, including node type and status.
Examples
The following is sample output from the show platform command:

RP/0/RP0/CPU0:router# show platform Node Type PLIM State Config State ----------------------------------------------------------------------------0/0/SP MSC(SP) N/A IOS-XR RUN PWR,NSHUT,MON 0/0/CPU0 MSC 16OC48-POS/DPT IOS-XR RUN PWR,NSHUT,MON 0/2/SP MSC(SP) N/A IOS-XR RUN PWR,NSHUT,MON 0/2/CPU0 MSC 16OC48-POS/DPT IOS-XR RUN PWR,NSHUT,MON 0/RP0/CPU0 RP(Standby) N/A IOS-XR RUN PWR,NSHUT,MON 0/RP1/CPU0 RP(Active) N/A IOS-XR RUN PWR,NSHUT,MON 0/SM0/SP FC/S(SP) N/A IOS-XR RUN PWR,NSHUT,MON
HR-286
Hardware Redundancy and Node Administration Commands on Cisco IOS XR Software show platform
The following is sample output for the show platform command with the node-id argument:
RP/0/RP0/CPU0:router# show platform 0/2/cpu0 Node Type PLIM State Config State ----------------------------------------------------------------------------0/2/CPU0 MSC 16OC48-POS/DPT IOS-XR RUN PWR,NSHUT,MON

Table 75 show platform Field Descriptions
Field Node Type PLIM State Config State

1. physical layer interface module
Description Identifies the node, in the format rack/slot/module. Type of node. Type of PLIM1 currently supported on the module. Displays the current state of the specified node. Displays the current status of the specified node.
Related Commands
Command show environment
Description Displays environmental monitor parameters for the system.
HR-287
Hardware Redundancy and Node Administration Commands on Cisco IOS XR Software show redundancy
show redundancy
To display the status of route processor redundancy, use the show redundancy command in EXEC mode. On the Cisco CRS-1: show redundancy [global | trace] On the Cisco 12000 Series router: show redundancy [location {node-id | all} | summary]
Syntax Description
global trace location
(Optional) Displays the status of the local card and of the route processor (RP). (Optional) Displays redundancy trace data. (Optional) Specifies the node for which to display redundancy information. You can display redundancy information for a specific node, or for all nodes installed in the router. Specifies the location of the node whose redundancy information you want to display. The node-id is expressed in the rack/slot/module notation. Displays redundancy information for all nodes installed in the router. (Optional) Displays a summary of all redundant node pairs in the router.
node-id all summary
Defaults
Route processor redundancy information is displayed for all nodes in the system.
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. Use the show redundancy command to display the redundancy status of the route processors. This command also displays the boot and switch-over history for the RPs.
Examples
The following is sample output from the show redundancy command:

RP/0/RP0/CPU0:router# show redundancy This node (0/RP0/CPU0) is in ACTIVE role
HR-288
Hardware Redundancy and Node Administration Commands on Cisco IOS XR Software show redundancy
Partner node (0/RP1/CPU0) is in STANDBY role Standby node in 0/RP1/CPU0 is ready Reload and boot info ---------------------RP reloaded Fri Apr 9 03:44:28 2004: 16 hours, 51 minutes ago This node booted Fri Apr 9 06:19:05 2004: 14 hours, 16 minutes ago Last switch-over Fri Apr 9 06:53:18 2004: 13 hours, 42 minutes ago Standby node boot Fri Apr 9 06:54:25 2004: 13 hours, 41 minutes ago Standby node last not ready Fri Apr 9 20:35:23 2004: 0 minutes ago Standby node last ready Fri Apr 9 20:35:23 2004: 0 minutes ago There have been 2 switch-overs since reload

Table 76 show redundancy Field Descriptions
Field
Description
This node (*/*/*) is in XXX role Describes the current role of the primary route processor, where (*/*/*) is the route processor ID in the format rack/slot/module, and XXX is the role of the route processor (active or standby). In the example, this field shows that the node with the ID 0/RP0/CPU0 is in active role. Partner node (*/*/*) is in XXX role Describes the current role of the secondary (or partner) route processor, where (*/*/*) is the route processor ID in the format rack/slot/module, and XXX is the role of the route processor (active or standby). In the example, this field shows that the node with the ID 0/RP1/CPU0 is in standby role. Standby node in(*/*/*) is ready Describes the current state of the standby node, where (*/*/*) is the standby route processor ID. In the example, the standby node is ready. Reload and boot info Provides a general overview of the active and standby route processors reload and boot history.
Related Commands
Command redundancy failover
Description Causes the primary (active) RP to fail over to the redundant standby RP, if the standby RP is available.
HR-289
Hardware Redundancy and Node Administration Commands on Cisco IOS XR Software show screddrv
show screddrv
To display system controller (SC) redundancy information, use the show screddrv command.
Note
Enter the show screddrv command without any of the optional parameters to display summarized SC redundancy and arbitration information for the router. show screddrv [all | arbitration | standby | trace]
Syntax Description
all arbitration standby trace
(Optional) Displays redundancy details for the entire router. (Optional) Displays detailed redundancy information for the arbitration mechanism. (Optional) Displays detailed redundancy information for the standby node. (Optional) Displays detailed ltrace information for the arbitration mechanism.
Defaults
SC redundancy information is displayed for all nodes in the system.
Command Modes
EXEC
Command History
Usage Guidelines
Examples
The following is sample output from the show screddrv command with the all keyword:
#RP/0/RP0/CPU0:router# show screddrv all Redundancy Driver Info for slot 32: Slot=32 Role=active role State=ACTIVE STATE Prefer_slot=0 Registers: ICreg=[1], MSreg=[33], MPPReg=[c0005cc8] Tx error count=0 Rx error count=22 Comm Statistics=5632
HR-290
Hardware Redundancy and Node Administration Commands on Cisco IOS XR Software show screddrv
SHOW REDDRV ARBITRATION is not supported. RP/0/RP0/CPU0:router#

Table 77 show screddrv Field Descriptions
Field Role State Prefer_slot Registers
Description Current role of the card in the specified slot; for example, it may be active, standby, and so forth. Current state of the card in the specified slot. Displays preferred redundancy slot information. Displays information for the following registers:

ICreg MSreg MPPReg
Tx error count Rx error count Comm Statistics
Number of transmit errors that have occurred on the card in the specified slot. Number of receive errors that have occurred on the card in the specified slot. Displays command statistics.
SHOW REDDRV Describes whether arbitration is supported or not on this slot. If arbitration is ARBITRATION supported, this field provides arbitration information.
Related Commands
Command redundancy reddrv
Description Enables the RP and displays SC redundancy.
HR-291
Hardware Redundancy and Node Administration Commands on Cisco IOS XR Software show version
show version
To display the configuration of the system hardware, the software version, the names and sources of configuration files, and the boot images, use the show version command in EXEC mode. show version
Syntax Description
Defaults
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. The show version command displays a variety of system information, including hardware and software version, router uptime, boot settings (configuration register), and active software.
Examples
The following is sample output from the show version command:

RP/0/RP0/CPU0:router# show version Cisco IOS-XR Software, Version 1.0.0 Copyright (c) 2004 by cisco Systems, Inc. ROM: System Bootstrap, Version 1.15(20040120:002852) , router uptime is 2 days, 1 hour, 59 minutes System image file is "tftp://223.0.0.0/usr/comp-hfr-full.vm-1.0.0 cisco CRS-16/S (7450) processor with 2097152K bytes of memory. 7450 processor at 650Mhz, Implementation , Revision 4 Packet over SONET network interface(s) 4 SONET/SDH Port controller(s) 1 Ethernet/IEEE 802.3 interface(s) 2043k bytes of non-volatile configuration memory. 1000592k bytes of ATA PCMCIA card at disk 0 (Sector size 512 bytes). Configuration register is 0x2
HR-292
Hardware Redundancy and Node Administration Commands on Cisco IOS XR Software show version
Package active on node 0/2/SP: hfr-admin, V 1.0.0, Cisco Systems, at mem:hfr-admin-1.0.0 Built on Fri Mar 5 19:12:26 PST 2004 --More--

Table 78 show version Field Descriptions
Field Cisco IOS XR Software, Version ROM router uptime System image file is Packet over SONET network interface(s)
Description Displays the Cisco IOS XR version number currently running on the router. Displays the system bootstrap version number currently running on the router. Number of uninterrupted days, hours, minutes, and seconds the system has been up and running. Displays the location and name of the system image file currently running on the router. Displays the number of Packet-over-SONET interfaces available on the current router.
SONET/SDH Port controller(s) Displays the number of SONET or SDH1 interfaces available on the current router. Ethernet/IEEE 802.3 interface(s) bytes of non-volatile configuration memory bytes of ATA PCMCIA card at disk 0 Package active on node 0/2/SP Displays the number of Ethernet or IEEE 802.3 interfaces available on the current router. Displays the available volatile configuration memory, in bytes. Displays the ATA PCMCIA2 available on the card in disk 0, in bytes. Provides details about the current software package that is running on the SP node in slot 2.
1.Synchronous Digital Hierarchy 2 AT Attachment Personal Computer Memory Card Industry Association
HR-293
Hardware Redundancy and Node Administration Commands on Cisco IOS XR Software upgrade
upgrade
To upgrade the fabric-downloader, ROMMON, or Mbus images on all nodes or on a specific node, use the upgrade command in Admin EXEC mode. upgrade [all {node-id | all} | fabric-downloader {node-id | all} | mbus location node-id}| rommon {node-id | all}] [force]
Syntax Description
all all all node-id
Upgrade all ROM images on the line card (LC) on all nodes in the router. Upgrade all ROM images on a specific node. The node-id is expressed in the rack/slot/module notation.
Note
fabric-downloader node-id
Upgrade the fabric-downloader on the LC on a specific node. The node-id is expressed in the rack/slot/module notation.
Note
fabric-downloader all mbus location node-id
Upgrade the fabric-downloader on the LC on all nodes in the router. Upgrade the Mbus agent ROM on a specific node. The node-id is expressed in the rack/slot/module notation.
Note
rommon node-id
Upgrade the rommon on a specific line card (LC). The node-id is expressed in the rack/slot/module notation.
Note
rommon all force
Upgrade the rommon on the LCon a specific node. Skip the version check and force an upgrade.
Defaults
Command Modes
Admin EXEC
Command History
Release Release 3.1
Usage Guidelines
HR-294
Examples
The following example shows how to upgrade the Mbus on a specific node:
RP/0/RP0/CPU0:router(admin)# upgrade mbus location 0/0/CPU0 Upgrading the MBUS agent rom on slot 0 RP/0/0/CPU0:Nov 18 16:52:23.296 : upgrade_mbus[65703]: %MBUS-6-API_INFO_DUMP : d ownload status slot 0, DOWNLOAD_SUCCESS RP/0/0/CPU0:Nov 18 16:52:33.422 : upgrade_mbus[65703]: %MBUS-6-API_INFO_DUMP : d ownload status slot 0, PROGRAM_ROM SUCCESS Upgrade complete. Use admin CLI "test mbus soft-reset-agent" or OIR the card to force new MBUS Rom image to execute. RP/0/RP0/CPU0:router(admin)#
Related Commands
Command clear mbus location show mbus
Description Clears all MBUS interface counters on a specific node. Displays Mbus CAN errors and interface counters.
HR-295
HR-296
LPTS Platform Commands on Cisco IOS XR Software

This module describes the commands used to administer and configure the Local Packet Transport Services (LPTS) Internal Forwarding Information Base (IFIB).
HR-297
LPTS Platform Commands on Cisco IOS XR Software show lpts pifib hardware entry
show lpts pifib hardware entry

To display entries in the Local Packet Transport Services (LPTS) pre-IFIB hardware table, use the show lpts pifib hardware entry command in EXEC mode. show lpts pifib hardware entry [type {ipv4 | ipv6 | isis}] [start-index number num-entries number] [brief | statistics] [location node-id]
Syntax Description
type
(Optional) Specifies the hardware entry type. Enter one of the following types:

ipv4Specifies IPv4 entries. ipv6Specifies IPv6 entries. isisSpecifies ISIS entries.
start-index number num-entries number brief statistics location node-id
(Optional) Starting index number. (Optional) Maximum entries permitted. (Optional) Displays summary hardware entry information. (Optional) Displays hardware entry accept/drop statistics for each summary entry. (Optional) Displays pre-Internal Forwarding Information Base (IFIB) information for the designated node. The node-id argument is entered in the rack/slot/module notation.
Defaults
Displays brief hardware entry information.
Command History
Usage Guidelines
Examples
The following is sample output from the show lpts pifib hardware entry command with the location keyword:
RP/0/RP0/CPU0:router# show lpts pifib hardware entry location 0/1/cpu0 V - Vital; M - Fabric Multicast; P - Packet Priority; L - Listener Tag; DestAddr - Destination Fabric Address; Sq - Ingress Shaping Queue; Dq - Destination Queue; Po - Policer; Ct - Stats Counter;
HR-298
na - Not Applicable ---------------------------------------------------L4 Protocol : any Destination IP : any Source IP : any Port/Type : any Source Port : any Is Fragment : 1 Is SYN : any Interface : any V/M/P/L : 0/0/LO/IPv4_REASS DestAddr : Punt Sq/Dq/Po/Ct : 4/na/101/0x9100 Accepted/Dropped : 0/0 ---------------------------------------------------L4 Protocol : ICMP Destination IP : any Source IP : any Port/Type : ICMP:ECHO Source Port : any Is Fragment : 0 Is SYN : any Interface : any V/M/P/L : 0/0/LO/IPv4_STACK DestAddr : Punt Sq/Dq/Po/Ct : 4/na/102/0x9138 Accepted/Dropped : 0/0 ---------------------------------------------------L4 Protocol : ICMP Destination IP : any Source IP : any Port/Type : ICMP:TSTAMP Source Port : any Is Fragment : 0 Is SYN : any Interface : any V/M/P/L : 0/0/LO/IPv4_STACK DestAddr : Punt Sq/Dq/Po/Ct : 4/na/102/0x913a Accepted/Dropped : 0/0

Table 79 show lpts pifib hardware entry Field Descriptions
Field L4 Protocol Destination IP Source IP Port/Type Source Port Is Fragment Is SYN Interface
Description Layer 4 protocol of the entry. Destination IP address for this entry. Source IP address for this entry. Port or ICMP1 type for this entry. Source port for this entry. Indicates if this entry applies to IP fragments. Indicates if this entry applies to TCP SYNs. Interface for this entry.
HR-299
Table 79
show lpts pifib hardware entry Field Descriptions (continued)
Field V/M/P/L DestAddr Sq/Dq/Po/Ct Accepted/Dropped
Description Vital/Fabric Multicast/Packet Priority/Listener Tag. Where to send the packet. Ingress Shaping Queue/Destination Queue/Traffic Policer/Stats Counter address. Number of packets sent to DestAddr/Number of packets dropped due to policing.
1. Internet Control Message Protocol
HR-300
LPTS Platform Commands on Cisco IOS XR Software show lpts pifib hardware usage
show lpts pifib hardware usage

To display hardware table usage, use the show lpts pifib hardware usage command in EXEC mode. show lpts pifib hardware usage [type {ipv4 | ipv6 | isis}] [location node-id]
Syntax Description
type
(Optional) Specifies the hardware entry type. Enter one of the following types:

ipv4Specifies IPv4 entries. ipv6Specifies IPv6 entries. isisSpecifies ISIS entries.
location node-id
(Optional) Displays pre-Internal Forwarding Information Base (IFIB) information for the designated node. The node-id argument is entered in the rack/slot/module notation.
Defaults
Without the optional parameters, the show lpts pifib hardware usage command displays a brief summary of hardware entry information.
Command History
Usage Guidelines
Examples
The following is sample output from the show lpts pifib hardware usage command with the location keyword:
RP/0/RP0/CPU0:router# show lpts pifib hardware usage location 0/1/cpu0 Type ---------ipv4 ipv6 isis Size --------------6000 4000 4000 Used --------------21 15 1 Used(%) ------0.35 0.38 0.03
HR-301
LPTS Platform Commands on Cisco IOS XR Software show lpts pifib hardware usage
Table 80
show lpts pifib hardware usage Field Descriptions
Field Type Size Used Used(%)
Description Type of pre-IFIB entry. Maximum number of entries (72-bits) allowed for the type. Number of entries in use. Percentage of total entries in use.
HR-302
Packet Forwarding Infrastructure Commands on Cisco IOS XR Software

The Cisco IOS XR Packet Forwarding Infrastructure (PFI) provides the following control-plane and data-plane components for processing packet forwarding:
Interface Manager (IM) is a control-plane component that is responsible for management of interfaces, protocols, and capsulations. IM is involved in the creation, deletion, state and maximum transmission unit (MTU) changes, activation, and deactivation of interfaces and the protocols and capsulations running on them. An instance of IM runs on each Route Processor (RP), Distributed Route Processor (DRP), and line card (LC) or modular services card (MSC) and in the system. Each instance manages interfaces local to that card. In the case of bundles and tunnels, which are replicated interfaces, the control plane is considered local to a RP or DRP even though the data plane may be replicated to one or more other cards. Execution Agent (EA) is a platform-specific capsulation chain building component for an interface in hardware and optionally in NetIO. Distributed IM (IMD) is a process that runs on each RP and DRP and collects summary information for all the interfaces known to each IM (where each IM monitors only the interfaces with the control plane on its local card). Management Agent (MA) is an application that uses PFI to create interfaces, add capsulations, and add protocols; it also uses PFI to manage the data path through control messages. Driver Infrastructure (DIv2) is a generic driver infrastructure used by individual drivers to discover and create physical interfaces.
This module describes the basic packet forwarding commands. This command set lets you configure, monitor, and troubleshoot the IM and the IMD.
HR-303
Packet Forwarding Infrastructure Commands on Cisco IOS XR Software clear interface
clear interface
To clear interface statistics or packet counters, use the clear interface command in EXEC mode. clear interface type instance
Syntax Description
type instance
Interface type. For more information, use the question mark (?) online help function. Either a physical interface instance or a virtual interface instance:
Physical interface instance. The naming notation is rack/slot/module/port, with a slash mark between values is required as part of the notation.
rack: Chassis number of the rack. slot: Physical slot number of the line card or modular services card. module: Module number. A physical layer interface module (PLIM)
is always 0.
port: Physical port number of the interface. Note
In references to a Management Ethernet interface located on a Route Processor card, the physical slot number is alphanumeric (RP0 or RP1) and the module is CPU0. Example: interface MgmtEth0/RP1/CPU0/0. Virtual interface instance. Number range will vary depending on interface type.
For more information about the syntax for the router, use the question mark (?) online help function.
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. This command does not have a no form.
Examples
The following example shows how to use the clear interface command to clear POS interface 0/1/0/1:
HR-304
Packet Forwarding Infrastructure Commands on Cisco IOS XR Software clear interface
RP/0/RP0/CPU0:router# clear interface POS 0/1/0/1
Related Commands
Command interface (PFI) show interfaces
Description Configures an interface. Displays information about configured interfaces.
HR-305
Packet Forwarding Infrastructure Commands on Cisco IOS XR Software dampening
dampening
To limit propagation of transient or frequently changing interface states on Interface Manager (IM) clients, turn on event dampening by using the dampening command in interface configuration mode. To turn dampening off, use the no form of this command. dampening [half-life [reuse suppress max-suppress-time]] no dampening [half-life [reuse suppress max-suppress-time]]
Syntax Description
half-life
(Optional) Time (in minutes) after which a penalty is decreased. Once the interface has been assigned a penalty, the penalty is decreased by half after the half-life period. The process of reducing the penalty happens every 5 seconds. The range of the half-life period is 1 to 45 minutes. The default is 1 minute. (Optional) Penalty value below which a stable interface is unsuppressed.
reuse
When dampening is enabled, an interface has a penalty value associated with it. The value starts at 0 and is increased by 1000 whenever the underlying state of the interface changes from UP to DOWN. The penalty value decreases exponentially while the interface state is stable. If the penalty value exceeds a configured suppress threshold, then the state of the interface is suppressed and IM will not notify upper layers of further state transitions. The suppressed state remains until the penalty value decreases past a configured reuse threshold.
The range of the reuse threshold is 1 to 20000. The default value is 750. suppress (Optional) Limit at which an interface is suppressed when its penalty exceeds that limit. The range of the suppress threshold is 1 to 20000, and must be greater than the reuse threshold. The default value is 2000. (Optional) Maximum time (in minutes) that an interface can be suppressed. This value effectively acts as a ceiling that the penalty value cannot exceed. The default value is four times the half-life period.
max-suppress-time
Defaults
Dampening is turned off by default. When you use the dampening command, the following default values are enabled for any optional parameters that you do not enter:

half-life: 1 minute reuse: 750 suppress: 2000 max-suppress-time: Four times the half-life
Command Modes
HR-306
Packet Forwarding Infrastructure Commands on Cisco IOS XR Software dampening
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. Event dampening suppresses a constantly unstable interface until it remains stable for a period of time. Enabling dampening on an interface that already has dampening configured has the effect of resetting the penalty associated with that interface to zero. The reuse threshold must always be less than the suppress threshold. Consider the following guidelines when configuring event dampening:
Configuring dampening on both a subinterface and its parent is usually unnecessary because their states are almost always the same and dampening would be triggered at the same time on each interface. If all subinterfaces require dampening, then apply dampening to the main interface only. Applying configuration to large numbers of subinterfaces requires an abundance of memory and increases the time required to process the configuration during boot and failover.
Examples
The following example shows how to enable dampening with default values on an interface:
RP/0/RP0/CPU0:router(config)# interface POS 0/4/0/0 RP/0/RP0/CPU0:router(config-if))# dampening RP/0/RP0/CPU0:router(config-if)# commit RP/0/RP0/CPU0:Nov 13 10:11:16.547 : config[217254]: %LIBTARCFG-6-COMMIT : Configuration committed by user 'UNKNOWN'. Use 'show commit changes 1000000164' to view the changes. RP/0/RP0/CPU0:router(config-if)#
Related Commands
Command show im dampening
Description Displays the state of all interfaces (or caps nodes) on which dampening has been configured.
HR-307
Packet Forwarding Infrastructure Commands on Cisco IOS XR Software encapsulation (interface)
encapsulation (interface)
To set the Layer 2 media of an interface, use the encapsulation command in interface configuration mode. To remove the encapsulation command from the configuration file and restore the system to its default condition, use the no form of this command. encapsulation {hdlc | ppp} no encapsulation {hdlc | ppp}
Syntax Description
hdlc ppp
Changes the Layer 2 media of the interface to serial High-Level Data Link (HDLC) encapsulation. Changes the Layer 2 media of the interface to PPP protocol encapsulation.
Defaults
When not configured with a specific encapsulation, each interface is configured with its own default encapsulation (for example, the default encapsulation for packet-over-SONET [POS] is HDLC).
Command Modes
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. Use this command to configure a specific encapsulation on a POS interface. Some interfaces do not support any encapsulation other than the default encapsulation, in which case this command will not be available.
Examples
In the following example, HDLC serial encapsulation is set on POS interface 0/3/0/1:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# interface POS 0/3/0/1 RP/0/RP0/CPU0:router(config-if)# encapsulation ppp
HR-308
Packet Forwarding Infrastructure Commands on Cisco IOS XR Software encapsulation (interface)
Related Commands
Description Displays information about configured interfaces.
HR-309
Packet Forwarding Infrastructure Commands on Cisco IOS XR Software interface (PFI)
interface (PFI)
To configure an interface or to create or configure a virtual interface, use the interface command in global configuration mode. To delete the interface configuration, use the no form of this command. interface type instance no interface type instance
Syntax Description
type instance
rack: Chassis number of the rack. slot: Physical slot number of the line card or modular
services card.
module: Module number. A physical layer interface module
(PLIM) is always 0.
Defaults
No interfaces are configured.
Command Modes
Command History
HR-310
Packet Forwarding Infrastructure Commands on Cisco IOS XR Software interface (PFI)
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. The interface command enters interface configuration mode to allow you to configure interfaces. If a virtual interface is configured, then the interface is created if it did not already exist. The no form of this command applies only to virtual interfaces or to subinterfaces (that is, interfaces that have been created in global configuration mode).
Examples
In the following example, the interface command is given for the POS card in location 0/2/0/1, and interface configuration mode is entered for that interface:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# interface POS 0/2/0/1
Related Commands
Command clear interface show interfaces
Description Clears the hardware logic on an interface. Displays information about configured interfaces.
HR-311
Packet Forwarding Infrastructure Commands on Cisco IOS XR Software mtu
mtu
To adjust the maximum packet size or maximum transmission unit (MTU) value for packets on the interface, use the mtu command in interface configuration mode. To return the interface to the default mtu for the interface type, use the no form of this command. mtu bytes no mtu
Syntax Description
bytes
Maximum number of bytes in a package. Valid entries are from 64 to 65535.
Defaults
If the MTU is not configured, then each interface will have a default MTU value that is specific to the interface type.
Command Modes
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. Use the mtu command to set a specific MTU value for an interface, or use the no mtu command to return the interface to the default MTU value for that interface type. The MTU value can be increased or decreased using the mtu command, subject to minimum and maximum MTU limits for the interface type. If the MTU value is not configured, then each interface will have a default MTU value that is specific to the interface type. The default MTU value is generally the largest size possible for the interface type. You can use the show interfaces command to determine if the MTU value has been changed.
Note
This command only configures the MTU of an interface, but there are other commands that can affect the MTU of other nodes in the interface chain.
Note
Changing the MTU on an interface will trigger a change on the protocols and capsulations configured on that interface, although some protocol specific configurations can override the interface MTU. For example, specifically changing the interface MTU configuration will not affect the IP MTU configuration, but may affect the resulting MTU on that node.
HR-312
Packet Forwarding Infrastructure Commands on Cisco IOS XR Software mtu
Examples
In the following example, the MTU size of all interfaces is verified. The MTU size is shown in the next-to-last column.
RP/0/RP0/CPU0:router# show interfaces all brief Intf Intf LineP Encap MTU BW Name State State Type (byte) (Kbps) -------------------------------------------------------------------------------Nu0 up up Null 1500 Unknown PO6/0/0/0 up up HDLC 4474 2488320 PO6/0/0/1 up up HDLC 4474 2488320 PO6/0/0/2 admin-down admin-down HDLC 4474 2488320 PO6/0/0/3 admin-down admin-down HDLC 4474 2488320 Mg0/RP0/CPU0/0 up up ARPA 1514 100000 RP/0/RP0/CPU0:router# configure terminal RP/0/RP0/CPU0:router(config)# interface POS 6/0/0/0 RP/0/RP0/CPU0:router(config-if)# mtu 1000 RP/0/RP0/CPU0:router(config-if)# end
After the mtu command is used to decrease the MTU size for the POS interface on 6/0/0/0 to 1000 bytes, the show interfaces all brief command is used again to verify that the MTU size has been changed.
RP/0/RP0/CPU0:router# show interfaces all brief
Intf Intf LineP Encap MTU BW Name State State Type (byte) (Kbps) -------------------------------------------------------------------------------Nu0 up up Null 1500 Unknown PO6/0/0/0 up up HDLC 1000 2488320 PO6/0/0/1 up up HDLC 4474 2488320 PO6/0/0/2 admin-down admin-down HDLC 4474 2488320 PO6/0/0/3 admin-down admin-down HDLC 4474 2488320 Mg0/RP0/CPU0/0 up up ARPA 1514 100000
Related Commands
Description Displays information about configured interfaces.
HR-313
Packet Forwarding Infrastructure Commands on Cisco IOS XR Software show im dampening
show im dampening
To display the state of all interfaces (or caps nodes) on which dampening has been configured, use the show im dampening command in EXEC mode. show im dampening [interface type | ifhandle handle]
Syntax Description
interface type ifhandle handle
(Optional) Interface type. For more information, use the question mark (?) online help function. (Optional) Display the caps node for which you want Interface Manager (IM) dampening information.
Defaults
If you do not specify an interface, then the system displays brief details about all dampened interfaces.
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. If you do not specify an interface, then the system displays brief details about all dampened interfaces.
Examples
The following example is sample output from the show im dampening command issued with default values:
RP/0/RP0/CPU0:router(config)# interface POS 0/4/0/3 RP/0/RP0/CPU0:router(config-if)# no shutdown RP/0/RP0/CPU0:router(config-if)# dampening RP/0/RP0/CPU0:router# show im dampening Interface Suppressed --------POS0/4/0/3 Proto ----0 Caps ---0 Penalty ---------------0 NO
RP/0/RP0/CPU0:router# show im dampening interface POS 0/4/0/3 POS0/4/0/3 (0x05000d00) Dampening enabled: penalty 0, not suppressed underlying state: Up
HR-314
Packet Forwarding Infrastructure Commands on Cisco IOS XR Software show im dampening
half_life: 1 suppress: 3000
reuse: 750 max-suppress-time: 4
RP/0/RP0/CPU0:router# show interfaces POS 0/4/0/3 POS0/4/0/3 is up, line protocol is down Dampening enabled: penalty 0, not suppressed half_life: 1 reuse: 750 suppress: 3000 max-suppress-time: 4 Hardware is Packet-over-SONET Description: ensoft-gsr5 POS 4\2 Internet address is Unknown MTU 4474 bytes, BW 155520 Kbit reliability 255/255, txload 1/255, rxload 1/255 Encapsulation HDLC, crc 16, controller loopback not set, keepalive set (10 sec) Last clearing of "show interface" counters never 30 second input rate 0 bits/sec, 0 packets/sec 30 second output rate 0 bits/sec, 0 packets/sec 0 packets input, 0 bytes, 0 total input drops 0 drops for unrecognized upper-level protocol Received 0 broadcast packets, 0 multicast packets 0 runts, 0 giants, 0 throttles, 0 parity 0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort 48 packets output, 1504 bytes, 0 total output drops Output 0 broadcast packets, 0 multicast packets 0 output errors, 0 underruns, 0 applique, 0 resets 0 output buffer failures, 0 output buffers swapped out 0 carrier transitions

Table 81 show im dampening Field Descriptions
Field Dampening underlying state half_life reuse suppress max-suppress-time
Description Indicates the dampening state and penalty value: not suppressed, suppressed. Underlying state of the interface: Up, Down, Administratively Down (if an interface has been configured to be shutdown). Time (in minutes) after which a penalty is decreased. Penalty value below which a stable interface is unsuppressed. Limit at which an unstable interface is suppressed when the penalty value exceeds the suppress value. Maximum time (in minutes) that an interface can be suppressed.
Related Commands
Command dampening show interfaces
Description Limits propagation of transient or frequently changing interface states on IM clients. Displays information about configured interfaces.
HR-315
Packet Forwarding Infrastructure Commands on Cisco IOS XR Software show interfaces
show interfaces
To display statistics for all interfaces configured on the router, use the show interfaces command in EXEC mode. show interfaces [type instance | all | local | location node-id] [accounting | brief | detail | summary]
Syntax Description
type
(Optional) Specifies the type of interface for which you want to display statistics. For more information, use the question mark (?) online help function. Specifies the number of the interface whose statistics you want to display. You can display statistics for a physical interface or a virtual interface:
instance
rack: Chassis number of the rack. slot: Physical slot number of the line card or modular services
card.
module: Module number. A physical layer interface module
(PLIM) is always 0.
For more information about the syntax for the router, use the question mark (?) online help function. all local location node-id (Optional) Displays interface information for all interfaces.This is the default. (Optional) Displays interface information for all interfaces in the local card. (Optional) Displays interface information for all interfaces on the specified node. The node-id argument is entered in the rack/slot/module notation. (Optional) Displays the number of packets of each protocol type that have been sent through the interface. (Optional) Displays brief information about each interface (one line per interface).
accounting brief
HR-316
detail summary
(Optional) Displays detailed information about each interface. This is the default. (Optional) Displays a summary of interface information by interface type.
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. The show interfaces command displays statistics for the network interfaces. The resulting display shows the interface processors in slot order. For example, if you type the show interfaces command without an interface type, you will receive information for all the interfaces installed in the networking device. Only by specifying the interface type, slot, and port arguments can you display information for a particular interface. If you enter a show interfaces command for an interface type that has been removed from the networking device, an error message is displayed: Interface not found. The output displayed depends on the network for which an interface has been configured.
Examples
The following is a sample output from the show interfaces command. Output display will depend on the type and number of interface cards in the networking device.
RP/0/RP1/CPU0:router#show interfaces tenGigE 0/0/0/1 TenGigE0/0/0/1 is administratively down, line protocol is administratively down Hardware is TenGigE, address is 0800.4539.d909 (bia 0800.4539.d909) Description: user defined string Internet address is Unknown MTU 1514 bytes, BW 10000000 Kbit reliability 255/255, txload 0/255, rxload 0/255 Encapsulation ARPA, Full-duplex, 10000Mb/s, LR output flow control is off, input flow control is off loopback not set ARP type ARPA, ARP timeout 01:00:00 Last clearing of "show interface" counters never 5 minute input rate 0 bits/sec, 0 packets/sec 5 minute output rate 0 bits/sec, 0 packets/sec 0 packets input, 0 bytes, 0 total input drops 0 drops for unrecognized upper-level protocol Received 0 broadcast packets, 0 multicast packets 0 runts, 0 giants, 0 throttles, 0 parity 0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
HR-317
0 packets output, 0 bytes, 0 total output drops Output 0 broadcast packets, 0 multicast packets 0 output errors, 0 underruns, 0 applique, 0 resets 0 output buffer failures, 0 output buffers swapped out 0 carrier transitions
HR-318
In the following sample output, instance 1 is specified on a packet-over-SONET (POS) card:

RP/0/RP1/CPU0:router#show interfaces POS 0/1/0/1 POS0/1/0/1 is administratively down, line protocol is administratively down Hardware is Packet over SONET Internet address is n.n.n.n/n MTU 4474 bytes, BW 9953280 Kbit reliability 255/255, txload 0/255, rxload 0/255 Encapsulation HDLC, crc 32, controller loopback not set, keepalive not set Last clearing of "show interface" counters never 5 minute input rate 0 bits/sec, 0 packets/sec 5 minute output rate 0 bits/sec, 0 packets/sec 0 packets input, 0 bytes, 0 total input drops 0 drops for unrecognized upper-level protocol Received 0 broadcast packets, 0 multicast packets 0 runts, 0 giants, 0 throttles, 0 parity 0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort 0 packets output, 0 bytes, 0 total output drops Output 0 broadcast packets, 0 multicast packets 0 output errors, 0 underruns, 0 applique, 0 resets 0 output buffer failures, 0 output buffers swapped out 0 carrier transitions

Table 82 show interfaces Field Descriptions
Field Interface name Interface state line protocol state
Description Displays the name of the current interface. In the example, the interface name is POS0/1/0/1. Displays the state of the interface. In the example, the interface is in the administratively down state. Displays the state of the Layer 2 line protocol. This field may be different from the interface state if, for example, a keepalive failure has brought down the Layer 2.
Note
The line protocol state is not the same as the protocol state displayed in the show ip interfaces command, because it is the state of Layer 2 (media) rather than Layer 3 (IP protocol).
Hardware Internet address is n.n.n.n/n
Displays the current hardware type. Displays the Layer 2 address (MAC address for Ethernet interfaces).
Note
Enter the mac-address command to configure the hardware address.
bia
Displays the Burned In Address (BIA) for the interface. The BIA is the default L2 (MAC) address for the interface.
Note
The BIA is not configurable. Enter the description command to configure the description associated with the interface.
description
Displays the user defined string that is associated with the interface.
Note
HR-319
Table 82
show interfaces Field Descriptions (continued)
Field Internet Address
Description Displays the Layer 3 (IP) address for the interface.

Note
Enter the ipv4 address command to configure the internet address for the interface.
MTU
Displays the maximum transmission unit (MTU) for the interface. The MTU is the maximum packet size that can be transmitted over the interface.
Note
The MTU field indicates the interface MTU. Enter the mtu command to configure a lower MTU value at the Layer 3 level.
BW reliability
Displays the bandwidth of the interface in kbps. Displays the proportion of packets that are not dropped and do not have errors.
Note
The reliability is shown as a fraction of 255.
txload
Indicates the traffic flowing out of the interface as a proportion of the bandwidth.
Note
The txload is shown as a fraction of 255.
rxload
Indicates the traffic flowing into the interface as a proportion of the bandwidth.
Note
The rxload is shown as a fraction of 255.
Encapsulation CRC
Layer 2 encapsulation installed on the interface. Indicates the length of the cyclic redundancy check (CRC), in bytes.
Note Note
The CRC is not present for all interface types. Enter the pos crc command to configure the CRC.
loopback or controller loopback Indicates whether the hardware has been configured to be looped back.
Note
Enter the loopback command to configure the loopback or controller loopback. Enter the keepalive command to configure the keepalive value. The keepalive value may not be present if it is not applicable to the interface type. This field is only present for shared media. For some interface types, you can configure the duplexity by entering the full-duplex and half-duplex commands.
keepalive
Displays the configured keepalive value, in seconds.

Note
Note
Duplexity
Displays the duplexity of the link.

Note Note
Speed
The speed and bandwidth of the link in Mbps. This field is present only when other parts of the media info line are also displayed (see duplexity and media type).
HR-320
Table 82
Field Media Type output flow control input flow control ARP type ARP timeout Last clearing of counters 5 minute input rate
Description The media type of the interface. Whether output flow control is enabled on the interface. See output flow control. The Address Resolution Protocol (ARP) type used on the interface. This value is not displayed on interface types that do not use ARP. The ARP timeout in hours:mins:secs. This value is configurable using the arp timeout command. The time since the following counters were last cleared using the clear counters exec command in hours:mins:secs. The average rate at which traffic has been received by the interface in the preceeding time interval, in packets per second and bits per second. The time interval can be configured using the load-interval command. The average rate at which traffic has been transmitted by the interface in the preceeding time interval, in packets per second and bits per second. The time interval can be configured using the load-interval command. The number of packets received on the interface that were successfully delivered to higher layers. The total number of bytes successfully received on the interface The total number of valid packets that were dropped after they were received. This includes packets that were dropped due to configured Quality of Service (QoS) or Access Control List (ACL) policies. This does not include drops due to unknown Layer 3 protocol. Total number of packets that could not be delivered because the necessary protocol was not configured on the interface. Total number of Layer 2 broadcast packets received on the interface. This is a subset of the total input packet count. Total number of Layer 2 multicast packets received on the interface. This is a subset of the total input packet count. The number of received packets that were too small to be handled. This is a subset of the input errors count. The number of received packets that were too large to be handled. This is a subset of the input errors count. The number of packets dropped due to throttling (because the input queue was full). The number of packets dropped because the parity check failed. The total number of received packets that contain errors and hence cannot be delivered. Compare this to total input drops, which counts packets that were not delivered despite containing no errors. The number of packets that failed the CRC check. The number of packets with bad framing bytes.
5 minute output rate
packets input bytes input total input drops
drops for unrecognized upper-level protocol Received broadcast packets Received multicast packets runts giants throttles parity input errors
CRC frame
HR-321
Table 82
Field overrun
Description The number of overrun errors experienced by the interface. Overruns represent the number of times that the receiver hardware is unable to send received data to a hardware buffer because the input rate exceeds the receiver's ability to handle the data. The total number of ignored packet errors. Ignored packets are those that are discarded because the interface hardware does not have enough internal buffers. Broadcast storms and bursts of noise can result in an increased number of ignored packets. The total number of abort errors on the interface. The number of packets received on the interface that were successfully delivered to higher layers. The total number of bytes successfully received on the interface. The number of packets that were dropped before being transmitted. Total number of Layer 2 broadcast packets transmitted on the interface. This is a subset of the total input packet count. Total number of Layer 2 multicast packets transmitted on the interface. This is a subset of the total input packet count. Number of times that the receiver hardware was unable to handle received data to a hardware buffer because the input rate exceeded the receiver's ability to handle the data. The number of underrun errors experienced by the interface. Underruns represent the number of times that the hardware is unable to transmit data to a hardware buffer because the output rate exceeds the transmitters ability to handle the data. The number of applique errors. The number of times that the hardware has been reset. The triggers and effects of this event are hardware-specifc.
Note
ignored
abort packets output bytes output total output drops Received broadcast packets Received multicast packets output errors
underruns
applique resets
Release 3 hardware cannot be reset in this way. This type of reset will be supported in future releases.
output buffer failures output buffers swapped out
Number of times that a packet was not output from the output hold queue because of a shortage of MEMD shared memory. Number of packets stored in main memory when the output queue is full; swapping buffers to main memory prevents packets from being dropped when output is congested. The number is high when traffic is bursty. Number of times the carrier detect (CD) signal of a serial interface has changed state.
carrier transitions
Related Commands
Command show controller (interface)
Description Displays information that is specific to the interface hardware statistics for all interfaces configured on the networking device.
HR-322
Packet Forwarding Infrastructure Commands on Cisco IOS XR Software shutdown (PFI)
shutdown (PFI)
To disable an interface (to force an interface to be administratively down), use the shutdown command in interface configuration mode. To enable an interface that has been shut down, use the no form of this command. shutdown no shutdown
Syntax Description
Defaults
The interface is enabled by default and is disabled only when shutdown is configured.
Note
When you add an interface to the system, or when all the configuration for an interface is lost or deleted, the interface is put in the shutdown state by the system adding the interface.
Command Modes
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. Use the shutdown command to move the state of an interface to administratively down, which stops traffic flowing through the interface. This state does not stop other action from happening on the interface such as changes in configuration, protocols, capsulations, and so forth. The shutdown command also marks the interface as unavailable. To check whether the state of an interface is down, use the show interfaces EXEC command, which displays the current state of the interface. An interface that has been shut down is shown as administratively down in the display from the show interfaces command.
Examples
In the following example, POS interface 0/4/0/2 is turned off:

RP/0/RP0/CPU0:router(config)# interface POS 0/4/0/2 RP/0/RP0/CPU0:router(config-if)# shutdown RP/0/RP0/CPU0:router(config-if)# commit
HR-323
Packet Forwarding Infrastructure Commands on Cisco IOS XR Software shutdown (PFI)
RP/0/RP0/CPU0:router# show interfaces POS 0/4/0/2 POS0/4/0/2 is administratively down, line protocol is administratively down Hardware is Packet-over-SONET Description:ensoft-gsr1 POS 4\2 Internet address is Unknown MTU 4474 bytes, BW 155520 Kbit reliability 255/255, txload 1/255, rxload 1/255 Encapsulation HDLC, crc 16, controller loopback not set, keepalive not set Last clearing of "show interface" counters never 30 second input rate 0 bits/sec, 0 packets/sec 30 second output rate 0 bits/sec, 0 packets/sec 0 packets input, 0 bytes, 0 total input drops 0 drops for unrecognized upper-level protocol Received 0 broadcast packets, 0 multicast packets 0 runts, 0 giants, 0 throttles, 0 parity 0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort 11 packets output, 1768 bytes, 0 total output drops Output 0 broadcast packets, 0 multicast packets 0 output errors, 0 underruns, 0 applique, 0 resets 0 output buffer failures, 0 output buffers swapped out 0 carrier transitions
Related Commands
Command show interfaces show ip interface
Description Displays information about configured interfaces. Displays IPv4 interface status and configuration.
HR-324
Packet-over-SONET User Interface and SONET Layer 1 Commands on Cisco IOS XR Software
This module describes the Cisco IOS XR commands used to configure, monitor, and troubleshoot Packet over SONET (POS). It also describes the Cisco IOS XR software commands used to configure the SONET operation on a router port using Layer 1 SONET transport technology. All SONET-related configurations of a SONET-based physical port are grouped under the SONET controller configuration submode. The SONET path-related configuration commands are grouped under the SONET path submode. POS provides a method for efficiently carrying data packets in SONET or Synchronous Digital Hierarchy (SDH) frames. High-bandwidth capacity and efficient link utilization are characteristics that make POS largely preferred for building the core of data networks. POS uses PPP in High-Level Data Link Control (HDLC)-like framing for data encapsulation at Layer 2 (data link) of the Open System Interconnection (OSI) stack. This method provides efficient packet delineation and error control. In addition to high-bandwidth efficiency, POS offers secure and reliable transmission for data. Reliable data transfer depends on timing integrity. The real-time POS functionality is performed in hardware, according to the hardware configuration setup. Configured hardware events are detected by the framer application-specific integrated circuits (ASICs) and the control is passed to the software. The generic POS driver is responsible for providing a mechanism to configure the hardware on a per-interface basis, to handle interface state transitions, and to collect POS-related statistics.
HR-325
Packet-over-SONET User Interface and SONET Layer 1 Commands on Cisco IOS XR Software ais-shut (SONET)
ais-shut (SONET)
To enable automatic insertion of a line alarm indication signal (LAIS) in the sent SONET signal whenever the SONET port enters the administrative shutdown state, use the ais-shut command in SONET configuration mode. To disable automatic insertion of a LAIS, use the no form of this command. ais-shut no ais-shut
Syntax Description
Defaults
This command is disabled by default; no AIS is sent.
Command Modes
SONET configuration
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. When the line is placed in administrative shutdown state, use the ais-shut command to send a signal to downstream equipment that indicates that there is a problem with the line. The ais-shut command is ignored if automatic protection switching (APS) is running for the corresponding port, because the setting must be enabled for proper APS operation. For SONET ports that do not have hardware support for LAIS insertion, the ais-shut command is disabled.
Examples
In the following example, the alarm indication is forced on the SONET OC-3 controller:
RP/0/RP0/CPU0:router(config)# controller sonet 0/1/0/0 RP/0/RP0/CPU0:router(config-sonet)# ais-shut
HR-326
Packet-over-SONET User Interface and SONET Layer 1 Commands on Cisco IOS XR Software ais-shut (SONET path)
ais-shut (SONET path)

To enable automatic insertion of path alarm indication signal (PAIS) in the sent SONET signal whenever the SONET path enters the administratively down state, use the ais-shut command in SONET path configuration mode. To disable automatic insertion of PAIS in the SONET signal, use the no form of this command. ais-shut no ais-shut
Syntax Description
Defaults
This command is disabled by default; no AIS is sent.
Command Modes
SONET path configuration
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. Use the ais-shut command to enable automatic insertion of PAIS in the appropriate sent SONET path overhead whenever the corresponding SONET path enters the administratively down state.
Examples
The following example shows the alarm indication being enabled on all paths:
RP/0/RP0/CPU0:router(config)# controller sonet 0/2/0/2 RP/0/RP0/CPU0:router(config-sonet)# path RP/0/RP0/CPU0:router(config-sonet-path)# ais-shut
HR-327
Packet-over-SONET User Interface and SONET Layer 1 Commands on Cisco IOS XR Software clear counters sonet
clear counters sonet

To clear SONET counters for a specific SONET controller, use the clear counters sonet command in EXEC mode. clear counters sonet interface-type interface-instance
Syntax Description
interface-type interface-instance
Physical interface instance. For physical interfaces, the interface-instance is expressed in the rack/slot/module/port notation.
rack: Chassis number of the rack. slot: Physical slot number of the modular services card. module: Module number. A physical layer interface module (PLIM) is
always 0.
In references to a Management Ethernet interface located on a route processor card, the physical slot number is alphanumeric (RP0 or RP1) and the module is CPU0. Example: interface MgmtEth0/RP1/CPU0/0. Virtual interface instance. Range varies depending on interface type.
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. Use the clear counters sonet command to clear SONET counters for a specific SONET controller.
HR-328
Packet-over-SONET User Interface and SONET Layer 1 Commands on Cisco IOS XR Software clear counters sonet
Examples
The following example shows the SONET counters being cleared on the SONET interface:
RP/0/RP0/CPU0:router# clear counters ? Loopback Loopback interface(s) MgmtEth Ethernet/IEEE 802.3 interface(s) Null Null interface POS Packet over SONET network interface(s) SONET SONET/SDH Port controller(s) all Clear counters on all interfaces tunnel-te MPLS Traffic Engineering Tunnel interface(s) RP/0/RP0/CPU0:router# clear counters sonet ? 0/1/0/0 0/1/0/1 0/1/0/2 0/1/0/3 0/2/0/0 0/2/0/1 0/2/0/2 0/2/0/3 SONET SONET SONET SONET SONET SONET SONET SONET Interface Interface Interface Interface Interface Interface Interface Interface Instance Instance Instance Instance Instance Instance Instance Instance
RP/0/RP0/CPU0:router# clear counters sonet 0/1/0/0
HR-329
Packet-over-SONET User Interface and SONET Layer 1 Commands on Cisco IOS XR Software clock source (SONET)
clock source (SONET)

To set the clock source of the sent signal on SONET ports, use the clock source command in SONET configuration mode. To cancel a clock source setting, use the no form of this command. clock source {internal | line} no clock source {internal | line}
Syntax Description
internal line
Specifies that the controller will clock its sent data from its internal clock. Specifies that the controller will clock its sent data from a clock recovered from the receive data stream of the line. This is the default value.
Defaults
The default clock source for the controller is the line clock.
Command Modes
SONET configuration
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. Use the clock source command to configure which reference clock is used by the sender.
Examples
In the following example, the SONET controller is configured to clock its sent data from its internal clock:
RP/0/RP0/CPU0:router(config)# controller sonet 0/2/0/2 RP/0/RP0/CPU0:router(config-sonet)# clock source internal
HR-330
Packet-over-SONET User Interface and SONET Layer 1 Commands on Cisco IOS XR Software controller
controller
To configure a SONET controller, use the controller command in global configuration mode. To return to the default state, use the no form of this command. controller {sonet | preconfigure} interface-type interface-instance no controller {sonet | preconfigure} interface-type interface-instance
Syntax Description
sonet preconfigure interface-type
Configures SONET port controllers. Specifies a SONET preconfiguration. This keyword is only used when a modular services card in not physically installed in a slot Interface type. For more information, use the question mark (?) online help function.
interface-instance Either a physical interface instance or a virtual interface instance: Physical interface instance. For physical interfaces, the interface-instance is expressed in the rack/slot/module/port notation.
rack: Chassis number of the rack. slot: Physical slot number of the modular services card. module: Module number. A physical layer interface module (PLIM) is
always 0.
Command Modes
Command History
HR-331
Packet-over-SONET User Interface and SONET Layer 1 Commands on Cisco IOS XR Software controller
Usage Guidelines
Examples
The following example shows how to specify that the configured SONET controller is in slot number 2:
RP/0/RP0/CPU0:router(config)# controller SONET 0/2/0/1 RP/0/RP0/CPU0:router(config-sonet)#
The following example shows how to specify that the SONET controller you want to preconfigure is in slot number 3, which does not have a modular services card installed:
RP/0/RP0/CPU0:router(config)# controller preconfigure SONET 0/3/0/1 RP/0/RP0/CPU0:router(config-sonet)#
HR-332
Packet-over-SONET User Interface and SONET Layer 1 Commands on Cisco IOS XR Software crc
crc
To set the length of the cyclic redundancy check (CRC) on a Packet-over-SONET (POS) interface, use the crc command in POS interface configuration mode. To return the CRC setting on a POS interface to the 16-bit default setting for OC-3 cards, use the no form of this command. crc {16 | 32} no crc {16 | 32}
Syntax Description
16 32
Sets 16-bit CRC mode (default on OC-3 cards). The default is 16 bits. Sets 32-bit CRC mode (default on OC-12 cards and higher). The default is 32 bits.
Defaults
The default is 16 bits for OC-3/Synchronous Transport Module (STM)-1 and 32 bits for OC-12/STM-4 and OC-48/STM-16 POS interfaces.
Command Modes
POS interface configuration
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. The default CRC for interfaces depends on the type of POS interface: OC-3/STM-1 uses a 16-bit CRC; OC-12/STM-4 and OC-48/STM-16 POS interfaces use a 32-bit CRC. All interfaces also support a 32-bit CRC. CRC is an error-checking technique that uses a calculated numeric value to detect errors in transmitted data. The designators 16 and 32 indicate the length (in bits) of the frame check sequence (FCS). A CRC of 32 bits provides more powerful error detection, but adds overhead. Both the sender and receiver must use the same setting. CRC-16, the most widely used error checking method throughout the United States and Europe, is used extensively with WANs. CRC-32 is specified by Electrical and Electronics Engineers (IEEE) 802 and as an option by some point-to-point transmission standards. It is often used on Switched Multimegabit Data Service (SMDS) networks and LANs.
HR-333
Packet-over-SONET User Interface and SONET Layer 1 Commands on Cisco IOS XR Software crc
Examples
In the following example, the 32-bit CRC on POS interface 0/1/0/2 is enabled:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# interface POS 0/1/0/2 RP/0/RP0/CPU0:router(config-if)# POS RP/0/RP0/CPU0:router(config-if-pos)# crc 32
Related Commands
Command pos transmit-delay
Description Specifies a number of flag sequences to be inserted between the packets.
HR-334
Packet-over-SONET User Interface and SONET Layer 1 Commands on Cisco IOS XR Software delay trigger
delay trigger
To configure SONET line delay trigger values, use the delay trigger command in SONET configuration mode. To cancel the line delay trigger value and return to the default, use the no form of this command. delay trigger line value no delay trigger line value
Syntax Description
line value
Sets the SONET line delay trigger value in milliseconds. Range is from 0 to 511. Default is 0 (no delay).
Defaults
value: 0 milliseconds
Command Modes
SONET configuration
Command History
Usage Guidelines
Examples
In the following example, the SONET line delay trigger value is set to 5:
RP/0/RP0/CPU0:router(config)# controller sonet 0/2/0/2 RP/0/RP0/CPU0:router(config-sonet)# delay trigger line 5
HR-335
Packet-over-SONET User Interface and SONET Layer 1 Commands on Cisco IOS XR Software framing (SONET)
framing (SONET)
To specify the framing used on the SONET controller, use the framing command in SONET configuration mode. To disable framing on the SONET controller, use the no form of this command. framing {sdh | sonet} no framing {sdh | sonet}
Syntax Description
sdh sonet
Selects Synchronous Digital Hierarchy (SDH) framing. This framing mode is typically used in Europe. Selects SONET framing. This is the default.
Defaults
SONET framing.
Command Modes
SONET configuration
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. Use the framing command to select either SONET or SDH framing on the selected physical port, if supported. For physical ports that do not support either of these two options, the framing command is disabled. Use the no form of this command to disable SONET or SDH framing on the SONET controller.
Examples
In the following example, the SONET controller is configured for SDH framing:
RP/0/RP0/CPU0:router(config)# controller sonet 0/2/0/2 RP/0/RP0/CPU0:router(config-sonet)# framing sdh
HR-336
Packet-over-SONET User Interface and SONET Layer 1 Commands on Cisco IOS XR Software loopback (SONET)
loopback (SONET)
To configure the SONET controller for loopback mode, use the loopback command in SONET configuration mode. To remove the loopback SONET command from the configuration file, use the no form of this command. loopback {internal | line} no loopback {internal | line}
Syntax Description
internal line
Specifies that all the packets be looped back from the source. Specifies that the incoming network packets be looped back to the SONET network.
Defaults
This command is disabled by default.
Command Modes
SONET configuration
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. The SONET and Synchronous Digital Hierarchy (SDH) transport layers support two loopback operation modes for diagnostic purposes: internal and line. In the terminal (internal) loopback, the sent signal is looped back to the receiver. While in the facility (line) loopback, the signal received from the far end is looped back and sent on the line. The two loopback modes cannot be active at the same time. In normal operation mode, neither of the two loopback modes is enabled.
Examples
In the following example, all packets are looped back to the SONET controller:
RP/0/RP0/CPU0:router(config)# controller sonet 0/2/0/2 RP/0/RP0/CPU0:router(config-sonet)# loopback internal
HR-337
Packet-over-SONET User Interface and SONET Layer 1 Commands on Cisco IOS XR Software overhead (SONET)
overhead (SONET)
To set the SONET overhead bytes in the frame header to a specific standards requirement or to ensure interoperability with equipment from another vendor, use the overhead command in SONET configuration mode. To remove the setting of the SONET overhead bytes from the configuration file and restore the default condition, use the no form of this command. overhead {j0 | s1s0} byte value no overhead {j0 | s1s0} byte value
Syntax Description
j0
Sets the J0/C1 byte value in the SONET section overhead. For interoperability with Synchronous Digital Hierarchy (SDH) equipment in Japan, use the value 0x1. The default j0 value is 0xcc Sets the SS bits value of the H1 byte in the SONET line overhead. Use the following values to tell the SONET transmission equipment the S1and S0 bit:

s1s0
For SONET mode, use 0 (this is the default). For SDH mode, use 2.
Values for the S1 and S0 bits can be from 0 to 3. The default sls0 value is 0. Values 1 and 3 are undefined. byte value Byte value to which the j1 or s1s0 keyword should be set. Range is from 0 to 255.
Defaults
The default j0 value is 0xcc; the default sls0 value is 0.
Command Modes
SONET configuration
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. Use the overhead command to set the SONET overhead bytes in the frame header to a specific standards requirement. Use the no form of this command to remove the setting of the SONET overhead bytes from the configuration file and restore the default condition. For the j0 keyword, the value that you use for the trace byte depends on the type of equipment being used. For the s1s0 keyword, the value that you use depends on whether you are using the SONET or SDH mode. For SONET mode, use the value 0 (the default). For SDH mode, use the value 2.
HR-338
Packet-over-SONET User Interface and SONET Layer 1 Commands on Cisco IOS XR Software overhead (SONET)
Examples
In the following example, the s1s0 keyword value is set to 2 for SDH:
RP/0/RP0/CPU0:router(config)# controller sonet 0/1/0/1 RP/0/RP0/CPU0:router(config-sonet)# overhead sls0 2
HR-339
Packet-over-SONET User Interface and SONET Layer 1 Commands on Cisco IOS XR Software overhead (SONET path)
overhead (SONET path)

To set the SONET path overhead bytes in the frame header to a specific standards requirement or to ensure interoperability with equipment from another vendor, use the overhead command in SONET path configuration mode. To remove the setting of the SONET path overhead bytes from the configuration file and restore the system to its default condition, use the no form of this command. overhead {c2 | j1} byte value no overhead {c2 | j1} byte value
Syntax Description
c2
Specifies Synchronous Transport Signal (STS) synchronous payload envelope (SPE) content (C2) byte. The transmitted c2 value is automatically set to 0xCF for unscrambled payload and 0x16 for scrambled payload. If c2 is configured to a user-specified value, the user-specified value is always applied regardless of scrambling. Configures the SONET path trace (j1) buffer. Default is a 64-byte path trace ASCII message, which includes default information such as router name, (Layer 2POS) interface name, and IP address, if applicable. The byte value to which the c2 keyword should be set. Range is from 0 to 255. For the j1 keyword, ASCII text message can have a maximum of 62 characters. Default value for the j1 keyword is 0.
j1
byte value
Defaults
The default c2 value is 0xCF; the default j1 value is 0.
Command Modes
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. The SONET standards permit or require user access for configuration of some bytes or bits in the SONET path overhead. Use the overhead command to set the SONET path overhead bytes in the frame header to a specific standards requirement. Use the no form of this command to remove the setting of the SONET path overhead bytes from the configuration file and restore the system to its default condition. Use the c2 keyword to configure the desired C2 byte value in the SONET path overhead.
HR-340
Packet-over-SONET User Interface and SONET Layer 1 Commands on Cisco IOS XR Software overhead (SONET path)
Use the j1 keyword to configure a user-defined path trace message in the j1 bytes of the SONET path overhead. For the j1 keyword, use the default message or insert your own message that has a maximum of 62 characters. If no user-defined message is configured, a default message is automatically generated, containing the router name, the controller name, its IP address, and the values of the sent and received K1 and K2 bytes in the SONET line overhead.
Examples
In the following example, the c2 value is set:

RP/0/RP0/CPU0:router(config)# controller sonet 0/2/0/2 RP/0/RP0/CPU0:router(config-sonet)# path RP/0/RP0/CPU0:router(config-sonet-path)# overhead c2 0x13
Related Commands
scrambling (SONET path)
Enables SONET payload scrambling on a SONET path.
HR-341
Packet-over-SONET User Interface and SONET Layer 1 Commands on Cisco IOS XR Software path (SONET)
path (SONET)
To enter the SONET path configuration submode, use the path command in SONET controller configuration mode. path
Syntax Description
Defaults
This command has no defaults.
Command Modes
SONET controller configuration
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. Use the path command to access SONET path configuration submode. The following commands are available in SONET path configuration submode:

ais-shutConfigure sending path alarm indication signal (PAIS) when shut down defaultSet a command to its defaults describeDescribe a command without taking real actions doRun an EXEC command exitExit from this submode noNegate a command or set its defaults overheadConfigure SONET Path OverHead (POH) byte or bit values reportConfigure SONET path alarm reporting scramblingConfigure synchronous payload envelope (SPE) scrambling thresholdConfigure SONET path bit-error rate (BER) threshold values uneq-shutConfigure sending Unequipped (UNEQ) when shut down
HR-342
Packet-over-SONET User Interface and SONET Layer 1 Commands on Cisco IOS XR Software path (SONET)
Examples
In the following example, the SONET path submode is accessed:

RP/0/RP0/CPU0:router(config)# controller sonet 0/1/0/0 RP/0/RP0/CPU0:router(config-sonet)# path
HR-343
Packet-over-SONET User Interface and SONET Layer 1 Commands on Cisco IOS XR Software pos
pos
To access the POS interface configuration submode, use the pos command in interface configuration mode. pos
Syntax Description
Defaults
This command has no default behavior or values.
Command Modes
Command History
Usage Guidelines
Examples
In the following example, POS configuration submode is accessed from POS interface configuration submode:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# interface POS 0/1/0/2 RP/0/RP0/CPU0:router(config-if)# POS RP/0/RP0/CPU0:router(config-if-pos)#
Related Commands
Command crc pos transmit-delay
Description Sets the length of the CRC on a POS interface. Specifies a number of flag sequences to be inserted between the packets.
HR-344
Packet-over-SONET User Interface and SONET Layer 1 Commands on Cisco IOS XR Software pos transmit-delay
pos transmit-delay
To specify a number of flag sequences to be inserted between the packets, use the pos transmit-delay command in interface configuration mode. To restore the default, use the no form of this command. pos transmit-delay microseconds no pos transmit-delay microseconds
Syntax Description
microseconds
Number of microseconds of minimum delay after sending a packet. Range is from 0 to 1023. Default value is 0 (disabled).
Defaults
The default is 0 (disabled).
Command Modes
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. The pos transmit-delay command is especially useful for serial interfaces that can send back-to-back data packets over interfaces faster than some hosts can receive them.
Examples
In the following example, a delay of 2 microseconds is specified on POS interface 0/1/0/2:

RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# interface POS 0/1/0/2 RP/0/RP0/CPU0:router(config-if)# POS transmit-delay 2
In the following example, the transmit delay on POS interface 0/1/0/2 is disabled:
RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# interface POS 0/1/0/2 RP/0/RP0/CPU0:router(config-if)# no POS transmit-delay
HR-345
Packet-over-SONET User Interface and SONET Layer 1 Commands on Cisco IOS XR Software pos transmit-delay
Related Commands
Command transmit-delay
HR-346
Packet-over-SONET User Interface and SONET Layer 1 Commands on Cisco IOS XR Software report (SONET)
report (SONET)
To permit selected SONET alarms to be logged to the console for a SONET controller, use the report command in SONET configuration mode. To disable logging of select SONET alarms, use the no form of this command. report [b1-tca | b2-tca | lais | lrdi | sd-ber | sf-ber | slof | slos] no report [b1-tca | b2-tca | lais | lrdi | sd-ber | sf-ber | slof | slos]
Syntax Description
b1-tca b2-tca lais lrdi sd-ber sf-ber slof slos
(Optional) Reports bit 1 (B1) bit-error rate (BER) threshold crossing alert (TCA) errors. (Optional) Reports bit 2 (B2) BER TCA errors. (Optional) Reports Line Alarm Indication Signal (LAIS) errors. (Optional) Reports line remote defect indication errors. (Optional) Reports signal degradation BER errors. (Optional) Reports signal failure BER errors. (Optional) Reports section loss of frame (SLOF) errors. (Optional) Reports section loss of signal (SLOS) errors.
Defaults
Alarms from the following keywords are reported by default:

b1-tca b2-tca sd-ber sf-ber slof slos
Command Modes
SONET configuration
Command History
Usage Guidelines
HR-347
Packet-over-SONET User Interface and SONET Layer 1 Commands on Cisco IOS XR Software report (SONET)
Reporting an alarm means that the alarm can be logged to the console, but it is no guarantee that it will be logged. SONET alarm hierarchy rules dictate that only the most severe alarm of an alarm group is reported. Whether an alarm is reported or not, you can check the current state of masked alarm, a problem indication that is a candidate for an alarm, by displaying the Masked Alarms line in the show controllers sonet command output. For B1, the bit interleaved parity (BIP) error report is calculated by comparing the BIP-8 code with the BIP-8 code that is extracted from the B1 byte of the following frame. Differences indicate that section level bit errors have occurred. For B2, the BIP error report is calculated by comparing the BIP-8/24 code with the BIP-8 code that is extracted from the B2 byte of the following frame. Differences indicate that line level bit errors have occurred. Path AIS is sent by line terminating equipment to alert the downstream path terminating equipment (PTE) that it has detected a defect on its incoming line signal. Path loss of pointer (LOP) is reported as a result of an invalid pointer (H1, H2) or an excess number of new data flag enabled indications. SLOF is detected when an error framing defect on the incoming SONET signal persists for 3 microseconds. SLOS is detected when an all-zeros pattern on the incoming SONET signal is observed. This defect might also be reported if the received signal level drops below the specified threshold. To determine the alarms that are reported on the controller, use the show controllers sonet command.
Examples
In the following example, the reporting of line AIS alarms is enabled on the path controller:
RP/0/RP0/CPU0:router(config)# controller sonet 0/1/0/1 RP/0/RP0/CPU0:router(config-sonet)# report lais
Related Commands
Command
Description
show controllers sonet Displays information about the operational status of SONET layers.
HR-348
Packet-over-SONET User Interface and SONET Layer 1 Commands on Cisco IOS XR Software report (SONET path)
report (SONET path)

To permit selected SONET alarms to be logged to the console for a SONET path controller, use the report command in SONET path configuration mode. To disable logging of select SONET alarms, use the no form of this command. report [b3-tca | pais | plop | prdi | puneq] no report [b3-tca | pais | plop | prdi | puneq]
Syntax Description
b3-tca pais plop prdi puneq
(Optional) Reports bit 3 (B3) bit-error rate (BER) threshold crossing alert (TCA) errors. (Optional) Reports path alarm indication signal (PAIS) errors. (Optional) Reports path loss of pointer (LOP) errors. (Optional) Reports path remote defect indication (PRDI) errors. (Optional) Reports path unequipped defect indication reporting status.
Defaults
Alarms from the following keywords are reported by default:

b3-tca plop
Command Modes
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. Reporting an alarm means that the alarm can be logged to the console, but it is no guarantee that it will be logged. SONET alarm hierarchy rules dictate that only the most severe alarm of an alarm group is reported. Whether an alarm is reported or not, you can view the current state of an masked alarm, a problem indication that is a candidate for an alarm, by inspecting the Masked Alarms line displayed in the show controllers sonet command output. For B3, the bit interleaved parity (BIP) error report is calculated by comparing the BIP-8 code with the BIP-8 code that is extracted from the B3 byte of the following frame. Differences indicate that path-level bit errors have occurred. Path AIS is sent by line terminating equipment to alert the downstream path-terminating equipment (PTE) that it has detected a defect on its incoming line signal.
HR-349
Packet-over-SONET User Interface and SONET Layer 1 Commands on Cisco IOS XR Software report (SONET path)
Path LOP is reported as a result of an invalid pointer (H1, H2) or an excess number of new data flag enabled indications. To determine the alarms that are reported on the controller, use the show controllers sonet command. All report commands accept the default option. The default reporting values are determined based upon the SONET standards specifications and are clearly identified in the corresponding commands help string.
Examples
In the following example, reporting of path PAIS alarms is enabled:

RP/0/RP0/CPU0:router(config)# controller sonet 0/2/0/2 RP/0/RP0/CPU0:router(config-sonet)# path RP/0/RP0/CPU0:router(config-sonet-path)# report pais
Related Commands
Command show controllers sonet
Description Displays information about the operational status of SONET layers.
HR-350
Packet-over-SONET User Interface and SONET Layer 1 Commands on Cisco IOS XR Software scrambling (SONET path)
scrambling (SONET path)

To enable SONET payload scrambling on a SONET path, use the scrambling command in SONET path configuration mode. To disable payload scrambling, use the no form of this command. scrambling {enable | disable} no scrambling
Syntax Description
enable disable
Enables the functionality of the command. Disables the functionality of the command.
Defaults
The default is enable (SONET payload scrambling is on).
Command Modes
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. Use the scrambling command in SONET path configuration mode to enable SONET payload scrambling on a SONET path. Use the no form of this command to disable payload scrambling. SONET payload scrambling applies a self-synchronous scrambler (x43+1) to the Synchronous payload envelope (SPE) of the controller to ensure sufficient bit transition density. Both ends of the connection must be configured using SONET path scrambling. If the hardware payload scrambling support is not user-configurable, or is not supported, the scrambling command may be disabled or may be rejected.
Examples
In the following example, scrambling is enabled for the path:

RP/0/RP0/CPU0:router(config)# controller sonet 0/2/0/2 RP/0/RP0/CPU0:router(config-sonet)# path RP/0/RP0/CPU0:router(config-sonet-path)# scrambling enable
HR-351
Packet-over-SONET User Interface and SONET Layer 1 Commands on Cisco IOS XR Software show controllers pos
show controllers pos

To display information on the packet-over-SONET (POS) controllers, use the show controllers pos command in EXEC mode. show controllers pos interface-instance [all | framer {internal | register | statistics} | internal] [| {begin line | exclude line | file filename | include line}]
Syntax Description
interface-instance
Either a physical interface instance or a virtual interface instance:
rack: Chassis number of the rack. slot: Physical slot number of the modular services card. module: Module number. A physical layer interface module
(PLIM) is always 0.
For more information about the syntax for the router, use the question mark (?) online help function. all framer internal register statistics begin line exclude line file filename (Optional) Displays information for all POS interface controllers. (Optional) Displays all POS framer information. (Optional) Displays all POS internal information. (Optional) Displays the POS framer registers. (Optional) Displays the POS framer cumulative counters. (Optional) Displays information beginning with the line that includes the regular expression given by line. (Optional) Displays information excluding all lines which contain regular expressions which match line. (Optional) Saves the configuration to the designated file. For more information on which standard filenames are recognized, use the question mark (?) online help function. (Optional) Displays only those lines which contain the regular expression given by line.
include line
Command Modes
EXEC
HR-352
Command History
Releases Release 2.0 Release 3.0 Release 3.1
Modifications This command was introduced on the Cisco CRS-1. No modification. This command was first supported on the Cisco 12000 Series router.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. The information displayed is generally useful for diagnostic tasks performed by technical support personnel only.
Examples
The following is sample output from the show controllers pos command:
RP/0/RP0/CPU0:router# show controllers POS 0/3/0/2 Port Number Interface Ifhandle CRC MTU Port Bandwidth Kbps Admin state Driver Link state : : : : : : : : 2 POS0_3_0_2 0x1380120 32 4474 2488320 Up Up
: No : 4474 : Up
RP/0/RP0/CPU0:router# show controllers POS 0/3/0/2 all Port Number Interface Ifhandle CRC MTU Port Bandwidth Kbps Admin state Driver Link state : : : : : : : : 2 POS0_3_0_2 0x1380120 32 4474 2488320 Up Up
: No : 4474 : Up
POS Driver Internal Cooked Stats Values for port 2 =================================================== Rx Statistics Tx Statistics ------------------------Total Bytes: 1200 Total Bytes: 0 Good Bytes: 1200 Good Bytes: 0 Good Packets: 25 Good Packets: 0 Aborts: 0 Aborts: 0 FCS Errors: 0 Min-len errors: 0
HR-353
Runts: FIFO Overflows: Giants: Drops:
0 0 0 0
Max-len errors: 0 FIFO Underruns: 0
Sky4402 asic #2 registers:
0x000 0x002 0x003 0x004 0x005 0x006 0x007 0x010 0x011 0x012 0x013 0x015 0x017 0x019 0x01b 0x01c 0x01d 0x020 0x021 0x022 0x023 0x024 0x025 0x026 0x027 0x028 0x029 0x02a 0x02b 0x02d 0x041 0x042 0x043 0x0c0 0x0c1 0x0c2 0x0c3 0x0c4 0x0c5 0x0c6 0x0c7 0x0c8 0x142 0x143 0x144 0x145 0x146 0x147 0x148 0x170 0x171 0x172 0x173 0x174
general_cntrl sys_intf_cntrl_1 sys_intf_cntrl_2 JTAG3 JTAG2 JTAG1 JTAG0 active_led gpio_port_mode gpio_port_fault gpio_port_data gpio_port_cntrl gpio_port_transition gpio_port_intr_mask gpio_port_intr master_intr_status master_mask interrupt_4 interrupt_3 interrupt_2 interrupt_1 status_4 status_3 status_2 status_1 mask_4 mask_3 mask_2 mask_1 link_state_cntrl diag stcks short_frame_cntrl ror_ram_c2 ror_ram_g1 ror_ram_f2 ror_ram_h4 ror_ram_z3 ror_ram_z4 ror_ram_z5 ror_ram_db_c2 ror_ram_db_g1 tor_ram_c2 tor_ram_g1 tor_ram_f2 tor_ram_h4 tor_ram_z3 tor_ram_z4 tor_ram_z5 tor_ram_s1 tor_ram_e2 tor_ram_e1 tor_ram_f1 tor_ram_k1
0x00 0x06 0x00 0x10 0x10 0x10 0x2f 0x01 0x01 0x00 0x58 0x3f 0x00 0xff 0x3f 0x00 0x00 0x04 0x00 0x00 0x00 0x04 0x00 0x0c 0x80 0x07 0x03 0x1c 0x8f 0x80 0x00 0x03 0x00 0x16 0x00 0x00 0x00 0x00 0x00 0x00 0x16 0x00 0x16 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00
HR-354
0x175 0x177 0x180 0x181 0x184 0x185 0x186 0x187 0x188 0x189 0x18a 0x18c 0x18d 0x190 0x191 0x194 0x195 0x198 0x199 0x19a 0x19b 0x19c 0x19d 0x1c0 0x1c2 0x1c3 0x1c4 0x1c5 0x1c8 0x1c9 0x1cc 0x1cd 0x1ce 0x1cf 0x1d0 0x1d1 0x200 0x201 0x202 0x203 0x204 0x208 0x209 0x20a 0x244 0x245 0x246 0x247 0x248 0x280 0x2c0 0x2c2 0x2c3 0x2c9
tor_ram_k2 tor_ram_z2 rsp_cntrl_1 rsp_cntrl_2 rtop_f1_ovrhd rtop_k1_ovrhd rtop_k2_ovrhd rtop_s1_ovrhd rtop_e1_ovrhd rtop_e2_ovrhd rtop_deb_s1_ovrhd rtop_b1_mismatch_cnt_u rtop_b1_mismatch_cnt_l rtop_b2_mismatch_cnt_u rtop_b2_mismatch_cnt_l rtop_rei_l_cnt_u rtop_rei_l_cnt_l rtop_ber_thresh_u rtop_ber_thresh_l rtop_ber_leak_u rtop_ber_leak_l rtop_ber_delay_u rtop_ber_delay_l rpop_signal_lbl_c2 rpop_valid_ptr_u rpop_valid_ptr_l rpop_b3_mismatch_cnt_u rpop_b3_mismatch_cnt_l rpop_rei_p_cnt_u rpop_rei_p_cnt_l rpop_ber_thresh_u rpop_ber_thresh_l rpop_ber_leak_u rpop_ber_leak_l rpop_ber_delay_u rpop_ber_delay_l rpp_cntrl_1 rpp_cntrl_2 rpp_cntrl_3 rpp_cntrl_4 rpp_cntrl_5 rpp_max_pkt_len_u rpp_max_pkt_len_l rpp_min_pkt_len tpp_inter_pkt_u tpp_inter_pkt_l tpp_idle_cell_hdr tpp_idle_cell_filldata tpp_cntrl tpog_cntrl ttog_cntrl ttog_ovrhd_src_1 ttog_ovrhd_src_2 ttog_ovrhd_fill
0x00 0x00 0x00 0x02 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x16 0x02 0x0a 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x11 0x03 0x3e 0x00 0x00 0x08 0xbd 0x04 0x00 0x00 0x00 0x00 0x04 0x20 0x00 0x00 0x00 0x00
HR-355
Table 83
show controllers pos Field Descriptions
Field Cisco POS ASIC Register Dump (Receive) asic mode error source error mask error detail 1 error detail 2 rx offset Channel Modes Port 0: Port 1: Port 2: Port 3: Runt Threshold Tx Delay Cisco POS ASIC Register Dump (Transmit) POS Driver Internal Cooked Stats Values for port 0 Rx Statistics Total Bytes Good Bytes Good Packets Aborts FCS Errors Runts FIFO Overflows Giants Drops Tx Statistics Total Bytes
Description Header for display of the contents of the receive application-specific integrated circuit (ASIC) register log. Address in hex of the ASIC mode flag. Address in hex of the error source flag. Address in hex of the error mask flag. Address in hex of the error detail 1 flag. Address in hex of the error detail 2 flag. Address in hex of the receive offset. Location in hex of the channel mode flag. Port 0 (the first port) statistics display. Port 1 (the second port) statistics display. Port 2 (the third port) statistics display. Port 3 (the fourth port) statistics display. Limit in packets set for runts on the specified port. Transmit delay that has been set for the specified port. Header for display of the contents of the transmit ASIC register log. Statistics relating to the specified PoS port (PoS port 0). Receive statistics for the indicated PoS port. Total number of bytes, including data and MAC encapsulation, received by the system. Number of bytes received without errors. Number of packets received without errors. Number of receive bytes that have been aborted Number of frame check sequence (FCS) errors that have been received. Number of received packets that are discarded because they are smaller than the minimum packet size of the medium. Number of received packets that exceeded the first in, first out (FIFO) stack limit. Number of received packets that are discarded because they exceed the maximum packet size of the medium. Number of received packets that have been dropped from the system. Transmit statistics for the indicated PoS port. Total number of bytes, including data and MAC encapsulation, sent by the system.
HR-356
Table 83
show controllers pos Field Descriptions (continued)
Field Good Bytes Good Packets Aborts Min-len errors Max-len errors FIFO Underruns
Description Number of bytes sent without errors. Number of packets sent without errors. Number of sent bytes that have been aborted. Minimum queue length violations. Maximum queue length violations. First-in, first-out, a buffering scheme where the first byte of data entering the buffer is the first byte retrieved by the CPU. FIFO underruns reports the number of times that the transmitter has been running faster than the router can handle.
HR-357
Packet-over-SONET User Interface and SONET Layer 1 Commands on Cisco IOS XR Software show controllers sonet
show controllers sonet

To display information about the operational status of SONET layers, use the show controllers sonet command in EXEC mode. show controllers sonet interface{all | framers | internal-state}
Syntax Description
interface all framers internal-state
Identifies the interface or subinterface you want to display. The interface argument is expressed in the <type>rack/slot/module/port format. Displays all information. Displays framer information. Displays internal SONET state.
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. Use the show controllers sonet command to display information about the operational status of SONET layers on a particular SONET port.
Examples
The following is sample output from the show controllers sonet command:
RP/0/RP0/CPU0:router# show controllers sonet 0/1/2/1
Port SONET0/1/2/1: Status: Up Loopback: None SECTION LOF = 1 LOS LINE AIS = 2 RDI PATH AIS = 1 RDI LOP = 0 NEWPTR PLM = 0 Detected Alarms: None
= 1 = 0 = 0 = 0 FEBE = 0 FEBE = 0 PSE = 0
BIP(B1) = 14892 BIP(B2) = 21 BIP(B3) = 6 NSE = 0
HR-358
Asserted Alarms: None Mask for Detected->Asserted: Detected Alerts: None Reported Alerts: None Mask for Detected->Reported: Alarm reporting enabled for: Alert reporting enabled for:
None
None SLOS SLOF SF_BER PLOP B1-TCA B2-TCA B3-TCA
Framing: SONET SPE Scrambling: Enabled C2 State: Stable C2_rx = 0x16 (22) C2_tx = 0x16 (22) / Scrambling Derived S1S0(tx): 0x0 S1S0(rx): 0x0 / Framing Derived PATH TRACE BUFFER : Remote hostname : Remote interface: Remote IP addr : STABLE brisbane POS0_2_3_1 10.0.0.2
APS No APS Group Configured Rx(K1/K2) : 0x00/0x00 Tx(K1/K2) : 0x00/0x00 Remote Rx(K1/K2): 00/00
Remote Tx(K1/K2): 00/00
BER thresholds: TCA thresholds:
SF = 10e-3 B1 = 10e-6
SD = 10e-6 B2 = 10e-6
B3 = 10e-6
Clock source: line (actual) line (configured) Optical Power Monitoring (accuracy: +/- 1dB) Not Supported RP/0/RP1/CPU0:MiniQ#
The following is sample output from the show controllers sonet framers command:
RP/0/RP0/CPU0:router# show controllers sonet 0/1/2/1 framers Common Regs reg[0] reg[1] reg[3] reg[100] reg[101] reg[102] reg[1000] reg[1001] reg[1002] reg[1004] reg[1005] reg[1006] reg[1007] reg[1008] reg[1010] reg[1011] reg[1012] reg[1013] reg[1014] reg[1015] reg[1016] reg[1017] reg[1018] --More--
Master Reset and Identity 0x01 Master Cfg 0000 Master Clock Monitors 0x37 Master Intr Status 1 0000 Master Intr Status Ch 0-7 0000 Master Intr Status Ch 8-15 0000 Master Clock Source Cfg 0000 Master DCC Interface Cfg 1 0x0f Master DCC Interface Cfg 2 0000 APS Cfg and Status 0000 APS FIFO Cfg and Status 0x0f APS Intr Status 1 0000 APS Intr Status 2 0000 APS Reset Ctrl 0000 TUL3 Interface Cfg 0x80 TUL3 Intr Status/Enable 1 0000 TUL3 Intr Status/Enable 2 0000 TUL3 ATM Level 3 FIFO Cfg 0x03 TUL3 ATM Level 3 Signal Label 0x01 TUL3 POS Level 3 FIFO Low Water Mark 0x15 TUL3 POS Level 3 FIFO High Water Mark 0x17 TUL3 POS Level 3 Signal Label 0000 TUL3 burst 0x0f
HR-359
The following is sample output from the show controllers sonet internal-state command:
RP/0/RP0/CPU0:router# show controllers sonet 0/1/2/1 internal-state Interface(layer) admin_up if_state --------------------- -------- -------SONET0/1/2/1 (SONET Section) (SONET Line) (SONET Path) SonetPath0/1/2/1 POS0/1/2/1 up up up up up up up up up up up up

Table 84 show controllers sonet Field Descriptions
Field Port Status Loopback LOF
Description Slot number of the POS interface. Displays whether the link associated with the specified port is up or down. Loopback identifier, if applicable. Section loss of frame is detected when a severely error-framing (SEF) defect on the incoming SONET signal persists for 3 milliseconds. Section loss of signal is detected when an all-zeros pattern on the incoming SONET signal lasts 19(+-3) microseconds or longer. This defect might also be reported if the received signal level drops below the specified threshold. Bit interleaved parity error reported.
LOS
BIP
For B1, the bit interleaved parity error report is calculated by comparing the BIP-8 code with the BIP-8 code extracted from the B1 byte of the following frame. Differences indicate that section level bit errors have occurred. For B2, the bit interleaved parity error report is calculated by comparing the BIP-8/24 code with the BIP-8 code extracted from the B2 byte of the following frame. Differences indicate that line level bit errors have occurred. For B3, the bit interleaved parity error report is calculated by comparing the BIP-8 code with the BIP-8 code extracted from the B3 byte of the following frame. Differences indicate that path level bit errors have occurred.
HR-360
Table 84
show controllers sonet Field Descriptions (continued)
Field AIS
Description Alarm indication signal.
Line alarm indication signal is sent by the section terminating equipment (STE) to alert the downstream line terminating equipment (LTE) that a LOS or LOF defect has been detected on the incoming SONET section. Path alarm indication signal is sent by the LTE to alert the downstream path terminating equipment (PTE) that it has detected a defect on its incoming line signal. Line remote defect indication is reported by the downstream LTE when it detects LOF, LOS, or AIS. Path remote defect indication is reported by the downstream PTE when it detects a defect on the incoming signal. Line far-end block error (accumulated from the M0 or M1 byte) is reported when the downstream LTE detects BIP(B2) errors. Path far-end block error (accumulated from the G1 byte) is reported when the downstream PTE detects BIP(B3) errors.
RDI
Remote defect indication.

FEBE
Far-end block errors.

LOP
Path loss of pointer is reported as a result of an invalid pointer (H1, H2) or an excess number of new data flag (NDF) enabled indications. Inexact count of the number of times the SONET framer has validated a new SONET pointer value (H1, H2). Inexact count of the number of times the SONET framer has detected a positive stuff event in the received pointer (H1, H2). Inexact count of the number of times the SONET framer has detected a negative stuff event in the received pointer (H1, H2). Any alarms detected by the controller are displayed here. Alarms are as follows:

NEWPTR PSE NSE Detected/Asserted/Reported Alarms
Transmitter is sending remote alarm. Transmitter is sending AIS. Receiver has loss of signal. Receiver is getting AIS. Receiver has loss of frame. Receiver has remote alarm. Receiver has no alarms.
Alarm reporting enabled for Alert reporting enabled for Framing
Types of alarms that generate an alarm message. Types of alarms that generate an alert message. Type of framing enabled on the controller.
HR-361
Table 84
show controllers sonet Field Descriptions (continued)
Field SPE Scrambling C2 State S1S0(tx) PATH TRACE BUFFER
Description Status of synchronous payload envelope (SPE) scrambling: Enabled, Disabled. Value extracted from the SONET path signal label byte (C2). Two S bits received in the last H1 byte. SONET path trace buffer is used to communicate information regarding the remote hostname, interface name/number, and IP address. This is a Cisco-proprietary use of the J1 (path trace) byte. Name of the remote host. Interface of the remote host. IP address of the remote host. List of the bit error rate (BER) thresholds you configured with the threshold (SONET) command. List of threshold crossing alarms (TCA) you configured with the threshold (SONET) command. Actual and configured clock source. Power status of the SONET controller. Header for framer register data.
Remote hostname Remote interface Remote IP addr BER thresholds TCA thresholds Clock source Optical Power Monitoring PM 5355 asic #0 registers
Remote Rx(K1/K2)/Tx(K1/K2) Contents of the received and transmitted K1 and K2 bytes.
HR-362
Packet-over-SONET User Interface and SONET Layer 1 Commands on Cisco IOS XR Software shutdown (SONET)
shutdown (SONET)
To disable SONET controller processing, use the shutdown command in SONET configuration mode. To bring back up a SONET controller and enable SONET controller processing, use the no form of this command. shutdown no shutdown
Syntax Description
Defaults
The SONET controller is up, and SONET controller processing is enabled.
Command Modes
SONET configuration
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. Use the shutdown command to shut down a SONET controller and disable SONET controller processing. Use the no shutdown command to bring back up a SONET controller and enable SONET controller processing. The SONET controller must be brought up for the proper operation of the Layer 2 interface. The Layer 2 interface has a separate shutdown command available, which does not operate on the SONET controllers administrative state.
Examples
In the following example, the SONET controller is brought down and SONET controller processing is disabled:
RP/0/RP0/CPU0:router(config)# controller sonet 0/1/0/2 RP/0/RP0/CPU0:router(config-sonet)# shutdown
HR-363
Packet-over-SONET User Interface and SONET Layer 1 Commands on Cisco IOS XR Software threshold (SONET)
threshold (SONET)
To set the bit-error rate (BER) threshold values of the specified alarms for a SONET controller, use the threshold command in SONET configuration mode. To remove the setting of the threshold from the configuration file and restore the default condition, use the no form of this command. threshold {b1-tca | b2-tca | sd-ber | sf-ber} bit-error-rate no threshold {b1-tca | b2-tca | sd-ber | sf-ber} bit-error-rate
Syntax Description
b1-tca b2-tca sd-ber sf-ber bit-error-rate
Sets the B1 BER threshold crossing alarm (TCA). Default is 10e-6. Sets the B2 BER threshold crossing alarm (TCA). Default is 10e-6. Sets the signal degrade BER threshold. Default is 10e-6. Sets the signal failure BER threshold. Default is 10e-3. BER from 3 to 9 (10 to the minus x).
Defaults
The default bit-error rate is 10e-6 for b1-tca, b2-tca, and sd-ber. The default bit-error rate is 10e-3 for sf-ber.
Command Modes
SONET configuration
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. For B1, the bit interleaved parity (BIP) error report is calculated by comparing the BIP-8 code with the BIP-8 code that is extracted from the B1 byte of the following frame. Differences indicate that section-level bit errors have occurred. For B2, the BIP error report is calculated by comparing the BIP-8/24 code with the BIP-8 code that is extracted from the B2 byte of the following frame. Differences indicate that line-level bit errors have occurred. Signal failure BER and signal degrade BER are sourced from B2 BIP-8 error counts (as is B2-TCA). The b1-tca and b2-tca keywords print only a log message to the console (if reports for them are enabled). To determine the BER thresholds configured on the controller, use the show controllers sonet command.
HR-364
Packet-over-SONET User Interface and SONET Layer 1 Commands on Cisco IOS XR Software threshold (SONET)
Examples
In the following example, thresholds on the SONET controller are configured:

RP/0/RP0/CPU0:router(config)# controller sonet 0/2/0/2 RP/0/RP0/CPU0:router(config-sonet)# threshold sd-ber 8 RP/0/RP0/CPU0:router(config-sonet)# threshold sf-ber 4 RP/0/RP0/CPU0:router(config-sonet)# threshold b1-tca 4
Related Commands
Command report (SONET) show controllers sonet
Description Permits selected SONET alarms to be logged to the console for a SONET controller. Displays information about the operational status of SONET layers.
HR-365
Packet-over-SONET User Interface and SONET Layer 1 Commands on Cisco IOS XR Software threshold (SONET path)
threshold (SONET path)

To set the bit-error rate (BER) threshold values of the specified alarms for a SONET path, use the threshold command in SONET path configuration mode. To remove the setting of the SONET path threshold from the configuration file and restore the default condition, use the no form of this command. threshold b3-tca bit-error-rate no threshold b3-tca bit-error-rate
Syntax Description
b3-tca bit-error-rate
Sets the B3 BER threshold crossing alarm (TCA). The default BER is 6. BER from 3 to 9 (10 to the minus x).
Defaults
The default BER is 6 for b3-tca.
Command Modes
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. For B3, the bit interleaved parity (BIP) error report is calculated by comparing the BIP-8 code with the BIP-8 code that is extracted from the B3 byte of the following frame. Differences indicate that path-level bit errors have occurred. In addition to BIP errors detected at the local end in the receive direction, B3 error counts detected in the G1 byte (P-REI or P-FEBE) by the far-end SONET equipment are returned. The b3-tca keyword prints only a log message to the console (if reports for them are enabled).
Examples
In the following example, the BER is set to 4:

RP/0/RP0/CPU0:router(config)# controller sonet 0/1/0/1 RP/0/RP0/CPU0:router(config-sonet)# path RP/0/RP0/CPU0:router(config-sonet-path)# threshold b3-tca 4
HR-366
Packet-over-SONET User Interface and SONET Layer 1 Commands on Cisco IOS XR Software threshold (SONET path)
Related Commands
Command show controllers sonet report (SONET)
Description Displays information that is specific to SONET controllers. Permits selected SONET alarms to be logged to the console for a SONET controller.
HR-367
Packet-over-SONET User Interface and SONET Layer 1 Commands on Cisco IOS XR Software transmit-delay
transmit-delay
To specify a number of flag sequences to be inserted between the packets, use the transmit-delay command in interface configuration mode. To restore the default, use the no form of this command. transmit-delay microseconds no transmit-delay microseconds
Syntax Description
microseconds
Number of microseconds of minimum delay after sending a packet. Range is from 0 to 1023. Default is 0 (disabled).
Defaults
The default is 0 (disabled).
Command Modes
Command History
Releases Release 3.1
Modifications This command was introduced on the Cisco 12000 Series router.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. The transmit-delay command is especially useful for serial interfaces that can send back-to-back data packets over interfaces faster than some hosts can receive them. The transmit-delay command is identical in function and use to the pos transmit-delay command.
Examples
In the following example, a delay of 2 microseconds is specified on POS interface 0/1/0/2:

RP/0/0/CPU0:router# configure RP/0/0/CPU0:router(config)# interface POS 0/1/0/2 RP/0/0/CPU0:router(config-if)# pos RP/0/0/CPU0:router(config-if-pos)# transmit-delay 2
In the following example, the transmit delay on POS interface 0/1/0/2 is disabled:
RP/0/0/CPU0:router# configure RP/0/0/CPU0:router(config)# interface POS 0/1/0/2 RP/0/0/CPU0:router(config-if)# pos RP/0/0/CPU0:router(config-if-pos)# no transmit-delay
HR-368
Packet-over-SONET User Interface and SONET Layer 1 Commands on Cisco IOS XR Software transmit-delay
Related Commands
Command pos transmit-delay
HR-369
Packet-over-SONET User Interface and SONET Layer 1 Commands on Cisco IOS XR Software uneq-shut (SONET path)
uneq-shut (SONET path)

To enable automatic insertion of P-UNEQ code (0x00) in the sent SONET path overhead C2 byte, use the uneq-shut command in SONET path configuration mode. To disable this feature, use the no form of this command. uneq-shut no uneq-shut
Syntax Description
Defaults
Automatic insertion is enabled by default.
Command Modes
Command History
Modification This command was first introduced No modification. This command was first supported on the Cisco 12000 Router
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. Use the uneq-shut command to disable automatic insertion of P-UNEQ code in the sent SONET path overhead C2 byte whenever the SONET path enters the administratively down state.
Examples
In the following example, automatic insertion of P-UNEQ code is disabled in the sent SONET path overhead C2 byte:
RP/0/RP0/CPU0:router(config)# controller sonet 0/2/0/2 RP/0/RP0/CPU0:router(config-sonet)# path RP/0/RP0/CPU0:router(config-sonet-path)# uneq-shut
HR-370
PPP Commands on Cisco IOS XR Software

This module describes the commands used to configure PPP, an encapsulation scheme that can be used on Packet-over-SONET (POS) interfaces on the Cisco IOS XR software. PPP is a standard protocol used to send data over synchronous serial links. PPP also provides a Link Control Protocol (LCP) for negotiating properties of the link. LCP uses echo requests and responses to monitor the continuing availability of the link. PPP provides the following Network Control Protocols (NCPs) for negotiating properties of data protocols that will run on the link:

Cisco Discovery Protocol Control Protocol (CDPCP) to negotiate CDP properties IP Control Protocol (IPCP) to negotiate IP properties IP Version 6 Control Protocol (IPv6CP) to negotiate IPv6 properties Multiprotocol Label Switching Control Protocol (MPLSCP) to negotiate MPLS properties Open System Interconnection Control Protocol (OSICP) to negotiate OSI properties
HR-371
PPP Commands on Cisco IOS XR Software encapsulation ppp
encapsulation ppp
To enable encapsulation for communication with routers or bridges using the PPP, use the encapsulation ppp command in interface configuration mode. To disable PPP encapsulation, use the no form of this command. encapsulation ppp no encapsulation ppp
Syntax Description
Defaults
PPP encapsulation is disabled.
Command Modes
Command History
Modification This command was first introducedon the Cisco CRS-1. No modification. This command was first supported on the Cisco 12000 Series router.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. Use the encapsulation ppp command to enable PPP encapsulation on an interface.
Examples
The following example sets up PPP encapsulation on interface POS 0/1/0/1:

RP/0/RP0/CPU0:router# configuration RP/0/RP0/CPU0:router(config)# interface POS 0/1/0/1 RP/0/RP0/CPU0:router(config-if)# encapsulation ppp
Related Commands
Command show ppp interfaces
Description Displays PPP state information for an interface.
HR-372
PPP Commands on Cisco IOS XR Software ppp authentication
ppp authentication
To enable Challenge Handshake Authentication Protocol (CHAP), MS-CHAP, or Password Authentication Protocol (PAP), and to specify the order in which CHAP, MS-CHAP, and PAP authentication is selected on the interface, use the ppp authentication command in interface configuration mode. To disable PPP authentication, use the no form of this command. ppp authentication protocol [protocol [protocol]] [list-name | default] no ppp authentication
Syntax Description
protocol list-name
Name of the IP protocol used for PPP authenticate. See Table 85 for the appropriate keyword. You may select one, two, or all three protocols in any order. (Optional) Used with authentication, authorization, and accounting (AAA). Name of a list of methods of authentication to use. If no list name is specified, the system uses the default. The list is created with the aaa authentication ppp command. (Optional) Specifies the name of the method list created with the aaa authentication ppp command.
default
Defaults
PPP authentication is not enabled.
Command Modes
Command History
Modification This command was first introducedon the Cisco CRS-1. No modification. This command was corrected to include the possibility of specifying three protocols simultaneously. This command was first supported on the Cisco 12000 Series router.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. When you enable CHAP or PAP authentication (or both), the local router requires the remote device to prove its identity before allowing data traffic to flow. PAP authentication requires the remote device to send a name and a password, which is checked against a matching entry in the local username database or in the remote security server database. CHAP authentication sends a challenge message to the remote device. The remote device encrypts the challenge value with a shared secret and returns the encrypted value and its name to the local router in a response message. The local router attempts to match the remote devices name with an associated secret stored in the local username or remote security server database; it uses the stored secret to encrypt the original challenge and verify that the encrypted values match.
HR-373
PPP Commands on Cisco IOS XR Software ppp authentication
You can enable CHAP, MS-CHAP, or PAP in any order. If you enable all three methods, the first method specified is requested during link negotiation. If the peer suggests using the second method, or refuses the first method, the second method is tried. Some remote devices support only one method. Base the order in which you specify methods on the remote devices ability to correctly negotiate the appropriate method, and on the level of data line security you require. PAP usernames and passwords are sent as clear text strings, which can be intercepted and reused.
Caution
If you use a list-name value that was not configured with the aaa authentication ppp command, you will disable PPP on this interface. Table 85 lists the protocols used to negotiate PPP authentication.
Table 85 PPP Authentication Protocols for Negotiation
Protocol chap ms-chap pap
Description Enables CHAP on a POS interface. Enables Microsofts version of CHAP (MS-CHAP) on a POS interface. Enables PAP on a POS interface.
Enabling or disabling PPP authentication does not affect the ability of the local router to authenticate itself to the remote device. MS-CHAP is the Microsoft version of CHAP. Like the standard version of CHAP, MS-CHAP is used for PPP authentication. In this case, authentication occurs between a personal computer using Microsoft Windows NT or Microsoft Windows 95 and a Cisco router or access server acting as a network access server. Enabling or disabling PPP authentication does not affect the local router authenticating itself to the remote device.
Examples
In the following example, CHAP is enabled on POS interface 0/4/0/1 and uses the authentication list MIS-access:
RP/0/RP0/CPU0:router# configuration RP/0/RP0/CPU0:router(config)# interface POS 0/4/0/1 RP/0/RP0/CPU0:router(config-if)# encapsulation ppp RP/0/RP0/CPU0:router(config-if)# ppp authentication chap MIS-access
Related Commands
Command aaa authentication ppp encapsulation username
Description Specifies one or more AAA authentication methods for use on serial interfaces running PPP. Sets the encapsulation method used by the interface. Configures a new user with a username, establishes a password, and grants permissions for the user.
HR-374
PPP Commands on Cisco IOS XR Software ppp chap hostname
ppp chap hostname

To create a pool of dialup routers that all appear to be the same host when Challenge Handshake Authentication Protocol (CHAP) or MS-CHAP is used for authentication, use the ppp chap hostname command in interface configuration mode. To disable this function, use the no form of this command. ppp chap hostname hostname no ppp chap hostname hostname
Syntax Description
hostname
Name sent in the CHAP challenge.
Defaults
The router name is sent in any CHAP challenge.
Command Modes
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. The ppp chap hostname command allows you to specify a common alias for all routers in a rotary group to use so that only one username must be configured on the dialing routers. This command is normally used with local CHAP authentication (when the router authenticates to the peer), but it can also be used for remote CHAP authentication.
Examples
The following example shows that CHAP authentication is used on all calls and the username ISPXX will be sent in all CHAP and MS-CHAP challenges and responses:
RP/0/RP0/CPU0:router# configuration RP/0/RP0/CPU0:router(config)# interface POS 0/4/0/1 RP/0/RP0/CPU0:router(config-if)# encapsulation ppp RP/0/RP0/CPU0:router(config-if)# ppp chap hostname ISPXX
HR-375
PPP Commands on Cisco IOS XR Software ppp chap hostname
Related Commands
Command aaa authentication ppp ppp authentication
Description Specifies one or more AAA authentication methods for use on serial interfaces running PPP. Enables CHAP or Password Authentication Protocol (PAP) or both, and specifies the order in which CHAP and PAP authentication is selected on the interface. Enables a router calling a collection of routers that do not support this command (such as routers running older Cisco IOS software images) to configure a common CHAP secret password to use in response to challenges from an unknown peer. Refuses CHAP authentication from peers requesting it. Configures a PPP interface not to reset itself immediately after an authentication failure but instead to allow a specified number of authentication retries.
ppp chap password
ppp chap refuse ppp max-bad-auth
HR-376
PPP Commands on Cisco IOS XR Software ppp chap password
ppp chap password

To enable a router calling a collection of routers to configure a common Challenge Handshake Authentication Protocol (CHAP) or MS-CHAP secret password, use the ppp chap password command in interface configuration mode. To disable the password, use the no form of this command. ppp chap password [0 | 7] password no ppp chap password [0 | 7] password
Syntax Description
0|7 password
(Optional) Encryption parameter for password. Use either 0 (cleartext) or 7 (already encrypted). (Encryption types 1 through 6 are not supported.) Cleartext or already-encrypted password.
Defaults
The password is disabled.
Command Modes
Command History
Modification This command was first introducedon the Cisco CRS-1. No modification. This command was modified to include the password variable with the 0 and 7 keywords. This command was first supported on the Cisco 12000 Series router.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. This command is used for remote CHAP authentication only (when routers authenticate to the peer) and does not affect local CHAP authentication.This command is useful for routers that do not support this command (such as routers running older Cisco IOS software images). The CHAP or MS-CHAP secret password is used by the routers in response to challenges from an unknown peer.
Examples
In the following example, a password (xxxx) is entered as a cleartext password:

RP/0/RP0/CPU0:router(config-if)# ppp chap password xxxx
HR-377
PPP Commands on Cisco IOS XR Software ppp chap password
When the password is displayed (as shown in the following example, using the show running-config command), the password xxxx appears as 7 151419090:
RP/0/RP0/CPU0:router(config)# show running-config interface POS 1/0/1/0 ipv4 address 10.0.0.2 255.255.255.0 encapsulation ppp ppp chap password 7 151419090 shutdown
On subsequent logins, entering any of the three following commands would have the same effect of making xxxx the password for remote CHAP authentication:
RP/0/RP0/CPU0:router# configuration RP/0/RP0/CPU0:router(config)# interface POS 1/0/1/0 RP/0/RP0/CPU0:router(config-if)# ppp chap password xxxx RP/0/RP0/CPU0:router(config-if)# ppp chap password 0 xxxx RP/0/RP0/CPU0:router(config-if)# ppp chap password 7 1514190900
Related Commands
Description Specifies one or more authentication, authorization, and accounting (AAA) methods for use on serial interfaces running PPP. Enables CHAP or Password Authentication Protocol (PAP) or both and specifies the order in which CHAP and PAP authentication is selected on the interface. Enables a router calling a collection of routers that do not support this command (such as routers running older Cisco IOS software images) to configure a common CHAP secret password to use in response to challenges from an unknown peer. Refuses CHAP authentication from peers requesting it. Configures a PPP interface not to reset itself immediately after an authentication failure but instead to allow a specified number of authentication retries. Displays the contents of the currently running configuration file or the configuration for a specific interface, or map class information.
ppp chap hostname
ppp chap refuse ppp max-bad-auth
show running-config
HR-378
PPP Commands on Cisco IOS XR Software ppp chap refuse
ppp chap refuse

To refuse Challenge Handshake Authentication Protocol (CHAP) and MS-CHAP authentication from peers requesting it, use the ppp chap refuse command in interface configuration mode. To allow CHAP and MS-CHAP authentication, use the no form of this command. ppp chap refuse no ppp chap refuse
Syntax Description
Defaults
CHAP and MS-CHAP authentication is disabled.
Command Modes
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. This command specifies that CHAP and MS-CHAP authentication is disabled for all calls, meaning that all attempts by the peer to force the user to authenticate using CHAP or MS-CHAP will be refused. If outbound Password Authentication Protocol (PAP) has been configured (using the ppp authentication command), PAP will be suggested as the authentication method in the refusal packet.
Examples
The following example specifies POS interface 0/3/0/1 and disables CHAP and MS-CHAP authentication from occurring if a peer calls in requesting CHAP or MS-CHAP authentication. The method of encapsulation on the interface is PPP.
RP/0/RP0/CPU0:router# configuration RP/0/RP0/CPU0:router(config)# interface POS 0/3/0/1 RP/0/RP0/CPU0:router(config-if)# encapsulation ppp RP/0/RP0/CPU0:router(config-if)# ppp chap refuse
HR-379
PPP Commands on Cisco IOS XR Software ppp chap refuse
Related Commands
Description Specifies one or more authentication, authorization, and accounting (AAA) methods for use on serial interfaces running PPP. Enables AAA authentication or Password Authentication Protocol (PAP), or both, and specifies the order in which CHAP and PAP authentication is selected on the interface. Enables a router calling a collection of routers that do not support this command (such as routers running older Cisco IOS software images) to configure a common CHAP secret password to use in response to challenges from an unknown peer. Configures a PPP interface not to reset itself immediately after an authentication failure but instead to allow a specified number of authentication retries. Reenables remote PAP support for an interface.
ppp chap hostname
ppp max-bad-auth
ppp pap sent-username
HR-380
PPP Commands on Cisco IOS XR Software ppp max-bad-auth
ppp max-bad-auth
To configure a PPP interface not to reset itself immediately after an authentication failure but instead to allow a specified number of authentication retries, use the ppp max-bad-auth command in interface configuration mode. To reset to the default of immediate reset, use the no form of this command. ppp max-bad-auth retries no ppp max-bad-auth retries
Syntax Description
retries
Number of retries after which the interface is to reset itself. Range is from 0 to 10. Default is 0 retries.
Defaults
retries: 0
Command Modes
Command History
Modification This command was first introduced on the Cisco CRS-1. No modification. This command was first supported on the Cisco 12000 Series router.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. This command applies to any Packet-over-SONET (POS) interface on which PPP encapsulation is enabled.
Examples
In the following example, POS interface 0/3/0/1 is set to allow two additional retries after an initial authentication failure (for a total of three failed authentication attempts):
RP/0/RP0/CPU0:router# configuration RP/0/RP0/CPU0:router(config)# interface POS 0/3/0/1 RP/0/RP0/CPU0:router(config-if)# encapsulation ppp RP/0/RP0/CPU0:router(config-if)# ppp authentication chap RP/0/RP0/CPU0:router(config-if)# ppp max-bad-auth 3
HR-381
PPP Commands on Cisco IOS XR Software ppp max-bad-auth
Related Commands
Command ppp authentication
Description Enables Challenge Handshake Authentication Protocol (CHAP) or Password Authentication Protocol (PAP) or both, and specifies the order in which CHAP and PAP authentication is selected on the interface. Creates a pool of dialup routers that all appear to be the same host when CHAP or MS-CHAP is used to authenticate. Enables a router calling a collection of routers that do not support this command (such as routers running older Cisco IOS software images) to configure a common CHAP secret password to use in response to challenges from an unknown peer. Refuses CHAP authentication from peers requesting it. Refuses PAP authentication from peers requesting it. Reenables remote PAP support for an interface and includes the sent-username and password commands in the PAP authentication request packet to the peer.
ppp chap hostname ppp chap password
ppp chap refuse ppp pap refuse ppp pap sent-username password
HR-382
PPP Commands on Cisco IOS XR Software ppp max-configure
ppp max-configure
To specify the maximum number of configure requests to attempt (without response) before stopping the requests, use the ppp max-configure command in interface configuration mode. To disable the maximum number of configure requests and return to the default, use the no form of this command. ppp max-configure retries no ppp max-configure retries
Syntax Description
retries
Maximum number of retries. The range is 4 to 20. The default is 10.
Defaults
retries: 10
Command Modes
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. Use the ppp max-configure command to specify how many times an attempt is made to establish a link control protocol (LCP) session between two peers for a particular interface. If a configure request message receives a reply before the maximum number of configure requests are sent, further configure requests are abandoned.
Examples
In the following example, a limit of four configure requests is specified:

RP/0/RP0/CPU0:router# configuration terminal RP/0/RP0/CPU0:router(config)# interface POS 0/3/0/1 RP/0/RP0/CPU0:router(config-if)# encapsulation ppp RP/0/RP0/CPU0:router(config-if)# ppp max-configure 4
HR-383
PPP Commands on Cisco IOS XR Software ppp max-configure
Related Commands
Command encapsulation ppp ppp max-failure ppp max-terminate
Description Enables encapsulation for communication with routers or bridges using PPP. Configures the maximum number of CONFNAKs to permit before terminating a negotiation. Configures the maximum number of terminate requests to send without reply before closing down the LCP or Network Control Protocol (NCP).
HR-384
PPP Commands on Cisco IOS XR Software ppp max-failure
ppp max-failure
To configure the maximum number of consecutive Configure Negative Acknowledgments (CONFNAKs) to permit before terminating a negotiation, use the ppp max-failure command in interface configuration mode. To disable the maximum number of CONFNAKs and return to the default, use the no form of this command. ppp max-configure retries no ppp max-configure retries
Syntax Description
retries
Maximum number of retries. Range is from 2 to 10. Default is 5.
Defaults
retries: 5
Command Modes
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. Use the ppp max-failure command to configure the maximum number of CONFNAKs to permit before terminating a negotiation.
Examples
The following ppp max-failure command specifies that no more than three CONFNAKs are permitted before terminating the negotiation:
RP/0/RP0/CPU0:router# configuration terminal RP/0/RP0/CPU0:router(config)# interface POS 0/3/0/1 RP/0/RP0/CPU0:router(config-if)# encapsulation ppp RP/0/RP0/CPU0:router(config-if)# ppp max-failure 3
HR-385
PPP Commands on Cisco IOS XR Software ppp max-failure
Related Commands
Command encapsulation ppp ppp max-configure ppp max-terminate
Description Enables encapsulation for communication with routers or bridges using PPP. Specifies the maximum number of configure requests to attempt (without response) before stopping the requests. Configures the maximum number of terminate requests to send without reply before closing down the Link Control Protocol (LCP) or Network Control Protocol (NCP).
HR-386
PPP Commands on Cisco IOS XR Software ppp max-terminate
ppp max-terminate
To configure the maximum number of terminate requests (TermReqs) to send without reply before closing down the Link Control Protocol (LCP) or Network Control Protocol (NCP), use the ppp max-terminate command in interface configuration mode. To disable the maximum number of TermReqs and return to the default, use the no form of this command. ppp max-terminate number no ppp max-terminate number
Syntax Description
number
Maximum number of TermReqs to send without reply before closing down the LCP or NCP. Range is from 2 to 10. Default is 2.
Defaults
number: 2 retries
Command Modes
Command History
Usage Guidelines
Examples
In the following example, a maximum of five TermReqs are specified to be sent before terminating and closing LCP or NCP:
RP/0/RP0/CPU0:router# configuration terminal RP/0/RP0/CPU0:router(config)# interface POS 0/3/0/1 RP/0/RP0/CPU0:router(config-if)# encapsulation ppp RP/0/RP0/CPU0:router(config-if)# ppp max-terminate 5
HR-387
PPP Commands on Cisco IOS XR Software ppp max-terminate
Related Commands
Command ppp max-configure ppp max-failure
Description Specifies the maximum number of configure requests to attempt (without response) before stopping the requests. Configures the maximum number of CONFNAKs to permit before terminating a negotiation.
HR-388
PPP Commands on Cisco IOS XR Software ppp pap refuse
ppp pap refuse

To refuse Password Authentication Protocol (PAP) authentication from peers requesting it, use the ppp pap refuse command in interface configuration mode. To allow PAP authentication, use the no form of this command. ppp pap refuse no ppp pap refuse
Syntax Description
Defaults
PAP authentication is disabled.
Command Modes
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. This command specifies that PAP authentication is disabled for all calls, meaning that all attempts by the peer to force the user to authenticate using PAP will be refused. If outbound Challenge Handshake Authentication Protocol (CHAP) has been configured (using the ppp authentication command), CHAP will be suggested as the authentication method in the refusal packet.
Examples
The following example specifies POS interface 0/3/0/1 using PPP encapsulation on the interface. This example shows PAP authentication being disabled if a peer calls in requesting PAP authentication.
RP/0/RP0/CPU0:router# configuration RP/0/RP0/CPU0:router(config)# interface POS 0/3/0/1 RP/0/RP0/CPU0:router(config-if)# encapsulation ppp RP/0/RP0/CPU0:router(config-if)# ppp pap refuse
HR-389
PPP Commands on Cisco IOS XR Software ppp pap refuse
Related Commands
Command aaa authentication ppp ppp authentication ppp chap hostname
Description Specifies one or more authentication, authorization, and accounting (AAA) methods for use on serial interfaces running PPP. Enables AAA authentication or PAP, or both, and specifies the order in which CHAP and PAP authentication is selected on the interface. Enables a router calling a collection of routers that do not support this command (such as routers running older Cisco IOS software images) to configure a common CHAP secret password to use in response to challenges from an unknown peer. Configures a PPP interface not to reset itself immediately after an authentication failure but instead to allow a specified number of authentication retries. Enables remote PAP support for an interface.
ppp max-bad-auth
ppp pap sent-username
HR-390
PPP Commands on Cisco IOS XR Software ppp pap sent-username password
ppp pap sent-username password

To reenable remote Password Authentication Protocol (PAP) support for an interface and include the sent-username and password commands in the PAP authentication request packet to the peer, use the ppp pap sent-username password command in interface configuration mode. To disable remote PAP support, use the no form of this command. ppp pap sent-username username password [0 | 7] password no ppp pap sent-username username password [0 | 7] password
Syntax Description
username 0|7 password
Username sent in the PAP authentication request. (Optional) Encryption parameter for password. Use either 0 (cleartext) or 7 (already encrypted). (Encryption types 1 to 6 are not supported.) Cleartext or already-encrypted password.
Defaults
Remote PAP support is disabled.
Command Modes
Command History
Modification This command was first introducedon the Cisco CRS-1. No modification. This command was modified to include the password variable with the 0 and 7 keywords. This command was first supported on the Cisco 12000 Series router.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. Use this command to reenable remote PAP support (for example, to respond to the peers request to authenticate with PAP) and to specify the parameters to be used when sending the PAP authentication request. This command allows you to replace several username and password configuration commands with a single copy of this command on Packet-over-SONET (POS) interfaces. You must configure this command for each interface.
HR-391
PPP Commands on Cisco IOS XR Software ppp pap sent-username password
Examples
In the following example, a password is entered as a cleartext password, xxxx:

RP/0/RP0/CPU0:router(config-if)# ppp pap sent-username xxxx password notified
When the password is displayed (as shown in the following example, using the show running-config command), the password notified appears as 7 1514190900:
RP/0/RP0/CPU0:router(config-if)# show running-config interface POS0/1/0/0 ipv4 address 10.0.0.2 255.255.255.0 encapsulation ppp ppp pap password 7 1514190900 shutdown
On subsequent logins, entering any of the three following commands would have the same effect of making xxxx the password for remote PAP authentication:
RP/0/RP0/CPU0:router# configuration RP/0/RP0/CPU0:router(config)# interface POS 0/1/0/0 RP/0/RP0/CPU0:router(config-if)# ppp pap sent-username xxxx password notified RP/0/RP0/CPU0:router(config-if)# ppp pap sent-username xxxx password 0 notified RP/0/RP0/CPU0:router(config-if)# ppp pap sent-username xxxx 7 1514190900
Related Commands
Description Specifies one or more authentication, authorization, and accounting (AAA) methods for use on serial interfaces running PPP. Enables Challenge Handshake Authentication Protocol (CHAP) or PAP or both and specifies the order in which CHAP and PAP authentication is selected on the interface. Refuses PAP authentication from peers requesting it Enables the wait period for CHAP, MS-CHAP, and PAP authentication. Displays the contents of the currently running configuration file or the configuration for a specific interface, or map class information.
ppp pap refuse ppp timeout authentication show running-config
HR-392
PPP Commands on Cisco IOS XR Software ppp timeout authentication
ppp timeout authentication

To set PPP authentication timeout parameters, use the ppp timeout authentication command in interface configuration mode. To reset the default value, use the no form of this command. ppp timeout authentication seconds no ppp timeout authentication seconds
Syntax Description
seconds
Maximum time, in seconds, to wait for a response to an authentication packet. Range is from 3 to 30 seconds. Default is 10 seconds.
Defaults
seconds: 10
Command Modes
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. The default authentication time is 10 seconds, which should allow time for a remote router to authenticate and authorize the connection and provide a response. However, it is also possible that it will take much less time than 10 seconds. In such cases, use the ppp timeout authentication command to lower the timeout period to improve connection times in the event that an authentication response is lost.
Note
The timeout affects connection times only if packets are lost and time out.
Examples
In the following example, PPP timeout authentication is set to 20 seconds:

RP/0/RP0/CPU0:router# configuration RP/0/RP0/CPU0:router(config)# interface POS 0/3/0/1 RP/0/RP0/CPU0:router(config-if)# encapsulation ppp RP/0/RP0/CPU0:router(config-if)# ppp timeout authentication 20
HR-393
PPP Commands on Cisco IOS XR Software ppp timeout authentication
Related Commands
Description Specifies one or more authentication, authorization, and accounting (AAA) methods for use on serial interfaces running PPP. Enables Challenge Handshake Authentication Protocol (CHAP) or Password Authentication Protocol (PAP) or both and specifies the order in which CHAP and PAP authentication is selected on the interface.
HR-394
PPP Commands on Cisco IOS XR Software ppp timeout ncp
ppp timeout ncp

To set a time limit for the successful negotiation of at least one network layer protocol after a PPP connection is established, use the ppp timeout ncp command in interface configuration mode. To reset the default condition, use the no form of this command. ppp timeout ncp seconds no ppp timeout ncp
Syntax Description
seconds
Maximum time, in seconds, PPP should negotiate for a network layer protocol. If no network protocol is negotiated in the given time, the connection is disconnected. Range is from 20 to 255 seconds.
Defaults
No time limit is imposed (no ppp timeout ncp).
Command Modes
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. The ppp timeout ncp command protects against the establishment of links that are physically up and carrying traffic at the link level, but are unusable for carrying data traffic due to failure to negotiate the capability to transport any network level data. This command is particularly useful for dialed connections, in which it is usually undesirable to leave a telephone circuit active when it cannot carry network traffic.
Examples
In the following example, the Network Control Protocol (NCP) timer is set to 255 seconds:
RP/0/RP0/CPU0:router# configuration RP/0/RP0/CPU0:router(config)# interface POS 0/3/0/1 RP/0/RP0/CPU0:router(config-if)# encapsulation ppp RP/0/RP0/CPU0:router(config-if)# ppp timeout ncp 255
HR-395
PPP Commands on Cisco IOS XR Software ppp timeout ncp
Related Commands
Command encapsulation ppp
Description Enables encapsulation for communication with routers or bridges using PPP.
HR-396
PPP Commands on Cisco IOS XR Software ppp timeout retry
ppp timeout retry

To set PPP timeout retry parameters, use the ppp timeout retry command in interface configuration mode. To reset the time value, use the no form of this command. ppp timeout retry seconds no ppp timeout retry
Syntax Description
seconds
Maximum time, in seconds, to wait for a response during PPP negotiation. Range is from 1 to 10 seconds. Default is 3 seconds.
Defaults
seconds: 3
Command Modes
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. The ppp timeout retry command is useful for setting a maximum amount of time PPP should wait for a response to any control packet it sends.
Examples
The following example shows the retry timer being set to 8 seconds:
RP/0/RP0/CPU0:router# configuration RP/0/RP0/CPU0:router(config)# interface POS 0/3/0/1 RP/0/RP0/CPU0:router(config-if)# encapsulation ppp RP/0/RP0/CPU0:router(config-if)# ppp timeout retry 8
Related Commands
Command keepalive ppp timeout authentication
Description Controls how often Link Control Protocol (LCP) EchoRequest packets are sent once LCP has been negotiated. Sets PPP authentication timeout parameters.
HR-397
PPP Commands on Cisco IOS XR Software show ppp interfaces
show ppp interfaces

To display PPP state information for an interface, use the show ppp interfaces command in EXEC mode. show ppp interfaces {POS interface_instance | all | brief {POS interface_instance | all | location node-id] | detail {POS interface_instance | all | location node-id] | location node-id}
Syntax Description
POS (Optional) Interface name and instance. May be any POS interface, but some may interface_instance not have PPP encapsulation configured. If this is the case, no output is generated. You may also use a wildcard for the interface name (only at the end); for example, POS 0/2/0/*. all brief detail location node-id (Optional) Displays detailed PPP information for all nodes. (Optional) Displays brief output for all POS interfaces on the router, for a specific POS interface instance, or for all POS interfaces on a specific node. (Optional) Displays detailed output for all POS interfaces on the router, for a specific POS interface instance, or for all POS interfaces on a specific node. (Optional) Displays detailed PPP information for the designated node. The node-id argument is entered in the rack/slot/module notation.
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. There are seven possible PPP states applicable for either the Link Control Protocol (LCP) or the Network Control Protocol (NCP).
Examples
The following example shows PPP state information for POS interface 0/2/0/0:
RP/0/RP0/CPU0:router# show ppp interfaces POS 0/2/0/0 POS0/2/0/0 is up, line protocol is up Internet address is 10.0.0.1/24 MRU 4470 bytes Keepalive set (10 sec) LCP Open Closed: IPCP
HR-398

Table 86 show ppp interfaces Field Descriptions
Field Internet address MRU
Description IP address of the specified interface. Maximum receive unit. The maximum size of the information transported, in bytes, in the PPP packet received by the local equipment. Keepalive setting and interval in seconds for echo request packets. Indicates the current state of LCP. The state of the LCP will report one of the following states:

Keepalive LCP
OpenLCP is functioning properly. ListenLCP has tried to negotiate with the peer machine, but failed. REQsentLCP is attempting to negotiate with the peer machine; it has sent LCP packets, but not yet received a response. ACKsentLCP has received a request and has replied to it. ACKrcvdLCP has received a reply to a request it sent. TERMsentLCP has sent a TERMreq message to the peer machine. Closed LCP is not currently trying to negotiate.
Listen
Indicates that LCP is in the listen state because it has tried to negotiate with the peer machine but failed for some reason. LCP can negotiate the properties of the following data protocols: IP Control Protocol (IPCP) to negotiate IP properties; Multiprotocol Label Switching control processor (MPLSCP) to negotiate MPLS properties, Cisco Discovery Protocol Control Protocol (CDPCP) to negotiate Cisco Discovery Protocol (CDP) properties, IPv6CP to negotiate IP Version 6 (IPv6) properties, OSICP to negotiate Open Systems Interconnection (OSI) properties.
Open
Displays the NCPs that are established (or open) on this link. Protocols are:

CDPCPnegotiates CDP properties IPCPnegotiates IP properties IPv6CP negotiates IPv6 properties MPLSCPnegotiates MPLS properties OSICPnegotiates OSI properties
Closed
Displays the NCPs that are no longer established on this link.
HR-399
Related Commands
Command encapsulation ppp ipv4 address ipv6 address keepalive mtu
Description Enables encapsulation for communication with routers or bridges using PPP. Specifies an IPv4 family address. Specifies an IPv6 family address. Controls how often LCP EchoRequest packets are sent once LCP has been negotiated. Specifies the MTU to be used.
HR-400
SONET APS Commands on Cisco IOS XR Software

This module describes the commands used to configure SONET automatic protection switching (APS). The SONET APS is a feature offering recovery from fiber (external) or equipment (interface and internal) failures at the SONET line layer.
HR-401
SONET APS Commands on Cisco IOS XR Software aps group
aps group
To add an automatic protection switching (APS) group and enter APS group configuration mode, use the aps group command in global configuration mode. To remove a group, use the no form of this command. aps group number no aps group number
Syntax Description
number
Number of the group. Value range is from 1 to 255.
Defaults
No groups exist.
Command Modes
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. Use the aps group command to enter APS group configuration mode and configure APS connections with other SONET equipment. Use the no form of this command to remove a group. An APS group contains one protect (P) SONET port and one working (W) SONET port. The working and protect ports can reside on the same logical channel (LC), on different LCs in the same router, or on different routers. One APS group must be configured for each protect port and its corresponding working ports.
Examples
The following example shows how the aps group command is used to configure APS group 1 and enter APS group configuration mode:
RP/0/RP0/CPU0:router(config)# aps group 1
Related Commands
Command show aps
Description Displays SONET APS group operational status.
HR-402
SONET APS Commands on Cisco IOS XR Software authenticate (PGP)
authenticate (PGP)
To configure the authentication string for the Protect Group Protocol (PGP) message exchange between the protect and working routers, use the authenticate command in APS group configuration mode. To revert to the default authentication string, use the no form of this command. authenticate string no authenticate string
Syntax Description
string
Authentication string that the router will use to authenticate PGP message exchange between protect or working routers. The maximum length of the string is eight alphanumeric characters. Spaces are not accepted.
Defaults
Authentication is always disabled by using the string cisco.
Command Modes
APS group configuration
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. Use the authenticate command to configure the authentication string for the PGP message exchange between the protect and working routers. Use the no form of this command to revert to the default authentication string. The authenticate command applies only in multirouter automatic protection switching (APS) group configurations. In multirouter APS topologies, the protect and working routers communicate with each other through the User Datagram Protocol (UDP)-based Pretty Good Privacy protocol. Each Pretty Good Privacy packet contains an authentication string used for packet validation. The authentication string on all routers involved in the same APS group operation must all match for proper APS operation.
Examples
The following example enables authentication for APS group 1 in abctown:

RP/0/RP0/CPU0:router(config)# aps group 1 RP/0/RP0/CPU0:router(config-aps)# authenticate abctown
HR-403
SONET APS Commands on Cisco IOS XR Software authenticate (PGP)
Related Commands
Command channel local channel remote show aps
Description Assigns a port and interface local to the router as a SONET APS channel. Assigns a port and interface that is physically located in a remote router as a SONET APS channel. Displays SONET APS-related information.
HR-404
SONET APS Commands on Cisco IOS XR Software channel local
channel local
To assign local SONET physical ports as SONET automatic protection switching (APS) channels in the current APS group, use the channel local command in APS group configuration mode. To return to the default setting, use the no form of this command. channel channel-number {0 | 1} local {sonet | preconfigure} interface-type interface-instance no channel channel-number {0 | 1} local {sonet | preconfigure} interface-type interface-instance
Syntax Description
channel-number sonet preconfigure interface-type interface-instance
The assigned channel number: 0 = protect, 1 = working. Configures SONET port controllers. Specifies a SONET pre-configuration. This keyword is only used when a card is not physically installed in a slot Interface type. For more information, use the question mark (?) online help function. Either a physical interface instance or a virtual interface instance:
rack: Chassis number of the rack. slot: Physical slot number of the card. module: Module number. A physical layer interface module (PLIM)
is always 0.
Defaults
A SONET APS local channel is not assigned.
Command Modes
Command History
HR-405
SONET APS Commands on Cisco IOS XR Software channel local
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. Use the channel local command to designate SONET physical ports as SONET APS channels in the current APS group. Use the channel remote command to assign channels that are physically located in a different router. Preconfigured interfaces are supported. If the protect channel is local, it must be assigned using a channel command before any of the working channels are assigned. The reason is that having only a working channel assigned is a valid configuration for a working router in a multirouter APS topology and further attempts to configure a local protect channel will be rejected. The interface type must be a SONET controller.
Examples
The following example configures SONET 0/2/0/2 as a local protect channel:

RP/0/RP0/CPU0:router(config)# aps group 1 RP/0/RP0/CPU0:router(config-aps)# channel 0 local SONET 0/2/0/2
Related Commands
Command channel remote show aps
Description Assigns a port and interface that is physically located in a remote router as a SONET APS channel. Displays SONET APS group operational status.
HR-406
SONET APS Commands on Cisco IOS XR Software channel remote
channel remote
To assign a port and interface that is physically located in a remote router as a SONET automatic protection switching (APS) channel (working or protect), use the channel remote command in APS group configuration mode. To return to the default setting, use the no form of this command. channel channel-number {0 | 1} remote ip-address no channel channel-number {0 | 1} remote ip-address
Syntax Description
channel-number ip-address
The assigned channel number. 0 = protect, 1 = working. The remote router IP address in A.B.C.D format.
Defaults
A SONET APS remote channel is not assigned.
Command Modes
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. Use the channel remote command to assign working or protect channels that are physically located in a different router. Use the channel local command to assign channels in the local router.
Note
This command should not be used in single-router APS topologies. The IP address of the remote router is required only if a working channel configured as the protect router contacts all working routers. Specifying a remote protect channel is optionalif it is not used, the default value of 0.0.0.0 is used. The protect router is always the one that contacts the working router. The working router replies to the protect router using the source address extracted from the incoming messages as the destination address. If an address other than 0.0.0.0 (the default value) is specified, the working router will always use that address when sending messages to the protect router.
HR-407
SONET APS Commands on Cisco IOS XR Software channel remote
Examples
In the following examples, a remote channel with IP address 192.168.1.1 is assigned as the working channel:
RP/0/RP0/CPU0:router(config)# aps group 1 RP/0/RP0/CPU0:router(config-aps)# channel 1 remote 192.168.1.1
Related Commands
Command channel local show aps
Description Assigns a port and interface local to the router as a SONET APS channel. Displays SONET APS group operational status.
HR-408
SONET APS Commands on Cisco IOS XR Software force
force
To initiate a forced automatic protection switching (APS) request at the local end of the SONET link, unless a request of equal or higher priority is in effect, use the force command in APS group configuration mode. To cancel the switch, use the no form of this command. force channel-number {0 | 1} no force channel-number {0 | 1}
Syntax Description
channel-number
The assigned channel number. 0 = protect, 1 = working.
Command Modes
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. Use the force command to manually switch the traffic to a protect channel. For example, if you need to change the fiber connection, you can manually force the working channel to switch to the protect interface. The 0 or 1 keyword (by default 1) identifies on which channel the traffic should be stopped and moved on the protect channel. The force 1 command will move traffic from the working channel to the protect channel; the force 0 command will move traffic from the protect channel back to the working channel. A forced switch can be used to override an automatic (Signal Failed of Signal Degraded) or a manual switch request. A lockout request (via the lockout command) will override a force request. In a multirouter APS topology, a force request is allowed only on the protect router. This command remains in effect until it is unconfigured by using the no form of the command.
Examples
The following example moves traffic from the working channel back to the protect channel:
RP/0/RP0/CPU0:router(config)# aps group 1 RP/0/RP0/CPU0:router(config-aps)# force 1
HR-409
SONET APS Commands on Cisco IOS XR Software force
Related Commands
Command lockout manual
Description Initiates an APS lockout switch request at the local end of the SONET link. Initiates an APS manual switch request at the local end of the SONET link.
HR-410
SONET APS Commands on Cisco IOS XR Software lockout
lockout
To initiate a forced automatic protection switching (APS) request at the local end of the SONET link, use the lockout command in APS group configuration mode. To remove the lockout, use the no form of this command. lockout channel-number {0 | 1} no lockout channel-number {0 | 1}
Syntax Description
channel-number
(Optional) The assigned channel number. 0 = protect, 1 = working. Default is 0.
Defaults
The default is 0.
Command Modes
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. The optional 0 or 1 keyword (by default 0) identifies the channel from which the traffic should not be moved on the protect channel:

The lockout 1 command will keep traffic away from the working router. The lockout 0 command will keep traffic away from the protect router.
A lockout switch request can be used to override a force, an automatic (Signal Failed of Signal Degraded), or a manual switch request. No other request can override a lockout request; it has the highest possible priority. In a multirouter APS topology, a lockout request is allowed only on the protect router. This command remains in effect until it is unconfigured by using the no form of the command.
Examples
The following example locks out or prevents the circuit from switching to a working router in the event that the protect circuit becomes unavailable:
RP/0/RP0/CPU0:router(config)# aps group 1 RP/0/RP0/CPU0:router(config-aps)# lockout 1
HR-411
SONET APS Commands on Cisco IOS XR Software lockout
Related Commands
Command force manual
Description Initiates an APS force switch request at the local end of the SONET link. Initiates an APS manual switch request at the local end of the SONET link.
HR-412
SONET APS Commands on Cisco IOS XR Software manual
manual
To initiate a forced automatic protection switching (APS) request at the local end of the SONET link, use the manual command in APS group configuration mode. To cancel the switch, use the no form of this command. manual channel-number {0 | 1} no manual channel-number {0 | 1}
Syntax Description
channel-number
The assigned channel number: 0 = protect, 1= working.
Defaults
No circuit is switched.
Command Modes
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. Use the manual command to manually switch the circuit to a protect channel. For example, you can use this feature when you need to perform maintenance on the working channel. If a protection switch is already up, you can also use the manual command to revert the communication link to the working channel before the wait to restore (WTR) time period has expired. The WTR time period is set by the revert command. Use the no form of this command to cancel the switch. A manual switch request can be used to control which channel carries the traffic when no other higher priority user-initiated or automatic requests are in effect. The 0 or 1 keyword identifies the channel from which the traffic should be moved on the protect channel:

The manual 1 command will move traffic on to the protect channel. The manual 0 command will move traffic on to the working channel.
The manual request has the lowest priority among all user-initiated or automatic requests. Any other such requests will override a manual request. In a multirouter APS topology a manual request is allowed only on the protect router. This command remains in effect until it is unconfigured by using the no form of the command.
HR-413
SONET APS Commands on Cisco IOS XR Software manual
Examples
The following example moves traffic on to the protect router:

RP/0/RP0/CPU0:router(config)# aps group 1 RP/0/RP0/CPU0:router(config-aps)# manual 1
Related Commands
Command force lockout
Description Initiates an APS force switch request at the local end of the SONET link. Initiates an APS lockout switch request at the local end of the SONET link.
HR-414
SONET APS Commands on Cisco IOS XR Software revert
revert
To enable automatic switchover from the protect interface to the working interface after the working interface becomes available, use the revert command in APS configuration mode. To disable automatic switchover, use the no form of this command. revert minutes no revert
Syntax Description
minutes
Number of minutes until the circuit is switched back to the working interface after the working interface is available.
Defaults
minutes: 0. Automatic switchover is disabled.
Command Modes
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. Use the revert command to enable and disable revertive APS operation mode, if needed. The revertive APS operation mode of the routers should be matched with the APS operation mode of the connected SONET equipment. Use the no form of this command to disable automatic switchover. The revertive APS operation mode is the recommended operation mode because it offers better traffic protection during various possible software failures and upgrade or downgrade scenarios. The minutes argument indicates how many minutes will elapse until automatic protection switching (APS) decides to switch traffic back from protect to working after the condition that caused an automatic (Signal Failed or Signal Degrade) switch to protect disappears. A value of 0 (default) will disable APS revertive mode. In a multirouter APS topology, the revert command is allowed only on the protect router.
Examples
The following example enables APS to revert to the protect or working channel after 5 minutes have elapsed:
RP/0/RP0/CPU0:router(config)# aps group 1 RP/0/RP0/CPU0:router(config-aps)# revert 5
HR-415
SONET APS Commands on Cisco IOS XR Software revert
Related Commands
Command show aps
HR-416
SONET APS Commands on Cisco IOS XR Software show aps
show aps
To display the operational status for all configured SONET automatic protection switching (APS) groups, use the show aps command in EXEC mode. show aps
Syntax Description
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. Use the show aps command to display operational status for all configured SONET APS groups. Displaying the SONET APS operational data is considered of lower priority than the APS operation itself. Because the information is collected from several sources scattered across the various nodes involved, there is a small probability that some states will change while the command is executed. The command should be reissued for confirmation before decisions are made based on the results displayed.
Examples
The following is sample output from the show aps command:

RP/0/RP0/CPU0:router# show aps APS Group 1: Protect ch 0 (SONET3_0):Enabled SONET framing, SONET signalling, bidirectional, revertive (300 sec) Rx K1:0x21 (Reverse Request - Working) K2:0x15 (bridging Working, 1+1, bidirectional) Tx K1:0x81 (Manual Switch - Working) K2:0x15 (bridging Working, 1+1, bidirectional) Working ch 1 (SONET2_0):Disabled Rx K1:0x00 (No Request - Null) K2:0x00 (bridging Null, 1+1, non-aps) Tx K1:0x00 (No Request - Null) K2:0x00 (bridging Null, 1+1, non-aps) APS Group 3: PGP:protocol version: native 2 adopted 2 PGP:Authentication "cisco", hello timeout 1 sec, hold timeout 3 sec Protect ch 0 (SONET3_1):Disabled SONET framing, SONET signalling, bidirectional, non-revertive
HR-417
SONET APS Commands on Cisco IOS XR Software show aps
Rx K1:0x00 (No Request - Null) K2:0x05 (bridging Null, 1+1, bidirectional) Tx K1:0x00 (No Request - Null) K2:0x05 (bridging Null, 1+1, bidirectional) Working ch 1 (192.168.1.1):Enabled APS Group 5: Protect ch 0 (SONET3_2):Disabled SONET framing, SONET signalling, unidirectional (auto), non-revertive Rx K1:0x00 (No Request - Null) K2:0x04 (bridging Null, 1+1, unidirectional) Tx K1:0x00 (No Request - Null) K2:0x05 (bridging Null, 1+1, bidirectional) Working ch 1 (SONET3_3):Enabled Rx K1:0x00 (No Request - Null) K2:0x00 (bridging Null, 1+1, non-aps) Tx K1:0x00 (No Request - Null) K2:0x00 (bridging Null, 1+1, non-aps) APS Group 6: PGP:protocol version: native 2 adopted 2 PGP:Authentication "cisco", hello timeout 1 sec, hold timeout 3 sec Protect ch 0 (192.168.3.2 - auto):Disabled Working ch 1 (SONET6_0):Enabled Rx K1:0x00 (No Request - Null) K2:0x00 (bridging Null, 1+1, non-aps) Tx K1:0x00 (No Request - Null) K2:0x00 (bridging Null, 1+1, non-aps)

Table 87 show aps Field Descriptions
Field APS Group Protect ch Working ch
Description Assigned number of the APS group. Number value range is 1 through 255. The number and address of the protect channel interface. The number and address of the working channel interface.
Related Commands
Command show aps agents show aps group
Description Displays the status of the APS WP distributed communication subsystem. Displays information about the APS groups.
HR-418
SONET APS Commands on Cisco IOS XR Software show aps agents
show aps agents

To display the status of the automatic protection switching (APS) working to protect (WP) distributed communication subsystem, use the show aps agents command in EXEC mode. show aps agents
Syntax Description
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. Use the show aps agents command to display the status of the APS WP distributed communication subsystem. The WP communication is critical for the APS functionality. This command is typically used as a debugging aid for unexpected or unusual APS operation. Displaying the APS operational data is considered of lower priority than the APS operation itself. Because the information is collected from several sources scattered across the various nodes involved, there is a small probability that some states will change while the command is executed. The command should be reissued for confirmation before decisions are made based on the results displayed.
Examples
The following is sample output from the show aps agents command:
RP/0/RP0/CPU0:router# show aps agents SONET APS Manager working-Protect (WP) connections: Remote peer (192.168.3.2 - auto) is up: Group 6 [P.Ch0] 192.168.3.2 === Manager --- SONET6_0 (node6) --- [W.Ch1] Remote peer (10.1.1.1) is up: Group 3 [W.Ch1] 192.168.1.1 === Manager --- SONET3_1 (node3) --- [P.Ch0] Local agent (node2) is up: Group 1 [W.Ch1] --- SONET2_0 --- SONET3_0 (node3) --- [P.Ch0] Local agent (node3) is up: Group 1 [P.Ch0] --- SONET3_0 --- SONET2_0 (node2) --- [W.Ch1] Group 3 [P.Ch0] --- SONET3_1 --- Manager === 192.168.1.1 [W.Ch1] Group 5 [P.Ch0] --- SONET3_2 --- SONET3_3 (node3) --- [W.Ch1] Group 5 [W.Ch1] --- SONET3_3 --- SONET3_2 (node3) --- [P.Ch0]
HR-419
SONET APS Commands on Cisco IOS XR Software show aps agents
Local agent (node6) is up: Group 6 [W.Ch1] --- SONET6_0 --- Manager === 192.168.3.2 [P.Ch0]

Table 88 show aps agents Field Descriptions
Field Remote peer
Description IP address of the remote Protect Group Protocol (PGP) peer for the working router in an APS group. An IP address of 0.0.0.0 indicates a dynamically discovered PGP peer not yet contacted, shown on working routers only (the protect router contacts the working router). Node name of the local agent, such as (node2). The interface location or IP address of the SONET APS group. Internal WP communication channel segments are represented as --- if the segment is operational or -/- if the connection is broken. PGP segments are represented as === if operational or == if broken.
Local agent Group
Related Commands
Command show aps
HR-420
SONET APS Commands on Cisco IOS XR Software show aps group
show aps group

To display information about the automatic protection switching (APS) groups, use the show aps group command in EXEC mode. show aps group [number]
Syntax Description
number
(Optional) The assigned group number.
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. The show aps group command displays information about APS groups, and is useful if multiple APS groups are configured. Displaying the APS operational data is considered of lower priority than the APS operation itself. Because the information is collected from several sources scattered across the various nodes involved, there is a small probability that some states will change while the command is executed. The command should be reissued for confirmation before decisions are made based on the results displayed.
Examples
The following is sample output from the show aps group command:
RP/0/RP0/CPU0:router# show aps group 3 APS Group 3: PGP:Authentication "cisco", hello timeout 1 sec, hold timeout 3 sec Protect ch 0 (SONET3_1):Admin Down, Disabled SONET framing, SONET signalling, bidirectional, non-revertive Rx K1:0x00 (No Request - Null) K2:0x05 (bridging Null, 1+1, bidirectional) Tx K1:0x00 (No Request - Null) K2:0x05 (bridging Null, 1+1, bidirectional) Working ch 1 (192.168.1.1):Admin Down, Enabled
HR-421

Table 89 show aps group Field Descriptions
Field APS Group
Description Group number assigned to the displayed APS group. For each channel in the group, the following information is displayed:

Authentication string Hello timer value Hold timer value Role of the channel (working or protect) Channel number Name of the assigned physical port Channel status (Enabled, Disabled, Admin Down, Signal Fail, Signal Degraded, or Not Contacted) Group-related information (for protect channels only) that includes:
Framing of the SONET port Kilobytes signaling protocol Unidirectional or bidirectional APS
mode
APS revert time, in seconds (in revertive
operation mode only) Rx Tx Working ch Received error signalling bytes and their APS decoded information. Sent error signalling bytes and their APS decoded information. IP address of the corresponding Protect Group Protocol (PGP) peer.
The following is sample output for a multirouter APS group:

RP/0/RP0/CPU0:router# show aps group 3 APS Group 3: PGP: Authentication cisco, hello timeout 1 sec, hold timeout 3 sec Protect ch 0 (SONET3_1): Disabled SONET framing, SONET signalling, bidirectional, non-revertive Rx K1: Ox11 (Do Not Revert - Working) K2: 0x15 (bridging Working, 1+1, bidirectional) Tx K1: 0x21 (Reverse Request - Working) K2: )x15 (bridging Working, 1+1, bidirectional) Working ch 1 (10.1.1.1): Enabled
The information displayed for the channels local to the routers is identical to the channel information displayed for single-router APS groups.
HR-422
Related Commands
Command show aps show aps agents
Description Displays SONET APS group operational status. Displays information about all the peers involved in WP communication.
HR-423
SONET APS Commands on Cisco IOS XR Software signalling
signalling
To configure the K1K2 overhead byte signaling protocol used for automatic protection switching (APS), use the signalling command in APS group configuration mode. To reset APS signaling to the default, use the no form of this command. signalling {sonet | sdh} no signalling {sonet | sdh}
Syntax Description
sonet sdh
Sets signaling to SONET. Sets signaling to Synchronous Digital Hierarchy (SDH).
Defaults
SONET signaling is set by default.
Command Modes
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. By default, APS uses the signaling mode matching the framing mode. The signalling command may be required, depending upon the transport equipment capabilities, only on transition links interconnecting SONET and SDH networks. In a multirouter APS topology, the signalling command is allowed only on the protect router.
Examples
The following example resets the signaling protocol from the default SONET value to SDH:
RP/0/RP0/CPU0:router(config)# aps group 1 RP/0/RP0/CPU0:router(config-aps)# signalling sdh
HR-424
SONET APS Commands on Cisco IOS XR Software timers (APS)
timers (APS)
To change the time between hello packets and the time before the protect interface process declares a working interface router to be down, use the timers command in APS group configuration mode. To return to the default timers, use the no form of this command. timers hello-seconds hold-seconds no timers
Syntax Description
hello-seconds hold-seconds
Number of seconds to wait before sending a hello packet (hello timer). Value range is from 1 to 255 seconds. The default is 1 second. Number of seconds to wait to receive a response from a hello packet before the interface is declared down (hold timer). Value range is from 255 to 1 seconds. The default is 3 seconds.
Defaults
hello-seconds: 1 hold-seconds: 3
Command Modes
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. Use the timers command to change the time between hello packets and the time before the protect interface process declares a working interface router to be down. The hello time, in seconds, represents the interval between the periodic message exchange between the Protect Group Protocol (PGP) peers. The hold time, in seconds, represents the interval starting with the first failed periodic message after which, if no successful exchange takes place, the PGP link is declared dead. If many multirouter APS groups are configured and the CPU load or the User Datagram Protocol (UDP) traffic associated with the PGP communication is considered too high, then the hello interval should be increased. Increasing the hold time is suggested if the PGP link is flapping. The possible causes include high Route Processor (RP) CPU load, high traffic, or high error rates on the links between the working and the protect routers.
HR-425
SONET APS Commands on Cisco IOS XR Software timers (APS)
It is recommended to have a hold time at least three times longer than the hello time (allowing three or more consecutive failed periodic message exchange failures). The timers command is typically used only on the protect router. After the PGP connection is established, the working router learns about the timer settings from the protect router and automatically adjusts accordingly, irrespective of its own timer configuration. The timers command is meaningful only in multirouter automatic protection switching (APS) topologies and is ignored otherwise.
Examples
The following example configures APS group 3 with the hello timer at 2 seconds and the hold timer at 6 seconds:
RP/0/RP0/CPU0:router(config)# aps group 3 RP/0/RP0/CPU0:router(config-aps)# timers 2 6
HR-426
SONET APS Commands on Cisco IOS XR Software unidirectional
unidirectional
To configure a protect interface for unidirectional mode, use the unidirectional command in APS group configuration mode. To restore the default setting, bidirectional mode, use the no form of this command. unidirectional no unidirectional
Syntax Description
Defaults
Bidirectional mode
Command Modes
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. Use the unidirectional command to configure a protect interface for unidirectional mode. Use the no form of this command to restore the default setting. The unidirectional or bidirectional automatic protection switching (APS) operation mode of the routers should be matched with the APS operation mode of the connected SONET equipment.
Note
We recommend using bidirectional APS mode when it is supported by the interconnecting SONET equipment. When the protect interface is configured as unidirectional, the working and protect interfaces must cooperate to switch the transmit and receive SONET channel in a bidirectional fashion. Cooperation occurs automatically when the SONET network equipment is in bidirectional mode. In a multirouter APS topology, the unidirectional command is allowed only on the protect router.
Examples
The following example configures an APS group for unidirectional mode:

RP/0/RP0/CPU0:router(config)# aps group 1 RP/0/RP0/CPU0:router(config-aps)# unidirectional
HR-427
SONET APS Commands on Cisco IOS XR Software unidirectional
Related Commands
Command show aps
HR-428
Logical Router Commands on Cisco IOS XR Software

Logical routers (LRs) provide a means of partitioning a router into multiple, independent routers. LRs perform routing functions in the same manner as a physical router, but share resources with the rest of the system. For example, the applications, configurations, protocols, and routing tables assigned to an LR belong to that LR only, but other functions such as chassis control, Stage 2 (S2) switch fabric, and partitioning are shared with the rest of the system. For detailed information about logical router concepts, configuration tasks, and examples, refer to the Configuring Logical Routers on Cisco IOS XR Software module.
HR-429
Logical Router Commands on Cisco IOS XR Software location
location
To assign a node to a logical router (LR), use the location command in LR configuration mode. To remove a node from an LR and return the node to the Owner LR, use the no form of this command. location node-id no location node-id
Syntax Description
node-id
Specifies the node to be assigned to the specified logical router. The node-id argument is entered in the rack/slot/* notation.
Defaults
All nodes are assigned to the Owner LR.
Command Modes
LR configuration
Command History
Release Release 3.1
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. Use this command to assign a node to an LR. When a node is reassigned from the Owner LR to another LR, that node will no longer be used as a resource by the Owner LR. Use the no form of this command to remove a node from an LR. Removing a node from a LR implicitly returns it to the Owner LR. Once a node has been removed from an LR, it can be reassigned to another LR.
Note
Removing all nodes from an LR deletes the logical router from the configuration.
Examples
The following example shows how to enter admin configuration mode, create an LR named lr1, and assign node 0/3/* and node 0/4/* to the LR:
RP/0/0/CPU0:router# admin configure RP/0/0/CPU0:router(admin-config)# logical-router lr1 RP/0/0/CPU0:router(admin-config-lr:lr1)# location 0/3/* RP/0/0/CPU0:router(admin-config-lr:lr1)# location 0/4/*
HR-430
Logical Router Commands on Cisco IOS XR Software location
Related Commands
Command logical-router
Description Creates an LR or modifies an existing LR.
HR-431
Logical Router Commands on Cisco IOS XR Software logical-router
logical-router
To specify a logical router (LR) to be provisioned and enter LR configuration mode, use the logical-router command in admin configuration mode. To remove a logical router from the configuration, use the no form of this command. logical-router lr-name no logical-router lr-name
Syntax Description
lr-name
Name of the logical router to be provisioned.
Defaults
The system comes configured as a single logical router known as the Owner LR.
Command Modes
Admin configuration
Command History
Release Release 3.1
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. Use the logical-router command to create an LR or modify an existing LR.
Note
The lr-name argument creates an LR, if the LR specified for the lr-name argument does not exist. By default, a router running the Cisco IOS XR software contains one LR: the Owner LR. You cannot create the Owner LR, as it always exists, nor can you completely remove it because it is necessary for managing the router. After this command is issued, the router enters LR configuration mode. From LR configuration mode, you can add nodes to the LR or remove nodes from the LR using the location command. By default, every node in the router belongs to the Owner LR. When a node is reassigned from the Owner LR to another LR, that node will no longer be used as a resource by the Owner LR. Use the no form of the command to remove a logical router configuration. When a logical router is removed from the configuration, all nodes that composed the logical router are returned to the Owner LR.
Examples
The following example shows how to enter LR configuration mode to configure an LR:
RP/0/0/CPU0:router(admin-config)# logical-router lr1 RP/0/0/CPU0:router(admin-config-lr:lr1)#
HR-432
Related Commands
Command location
Description Adds or removes a node from an LR.
HR-433
HR-434
Netflow Commands on Cisco IOS XR Software

This module describes the Netflow commands on Cisco IOS XR software.
HR-435
Netflow Commands on Cisco IOS XR Software clear flow exporter
clear flow exporter

To clear flow exporter statistics or restart the flow exporter statistics collector, enter the clear flow exporter command in EXEC mode. clear flow exporter [fem-name] {restart | statistics} location node-id
Syntax Description
fem-name restart statistics location node-id
(Optional) Flow exporter name. Restarts the collector. Clears the exporter statistics. Identifies the node whose flow exporter statistics you want to clear, or whose flow exporter statistics collector you want to restart. The node-id argument is expressed in the rack/slot/module notation.
Defaults
Command Modes
EXEC
Command History
Release Release 3.2
Usage Guidelines
Examples
The following example shows how to restart the flow exporter statistics collector on a specific node:
RP/0/RP0/CPU0:router# clear flow exporter restart location 0/0/SP Restart exporter all locations. Continue? [confirm]
The following example shows how to clear flow exporter statistics on a specific node.
RP/0/RP0/CPU0:router# clear flow exporter statistics location 0/0/CPU0 Clear statistics for all exporters on the location. Continue? [confirm] %Unable to clear exporter statistics RP/0/RP1/CPU0:MiniQ#
Related Commands
Command flow exporter-map show flow exporter show flow exporter-map
Description Configures a flow exporter map. Displays flow exporter data. Displays flow exporter map information for a specific node, or for all nodes installed in the router.
HR-436
Netflow Commands on Cisco IOS XR Software clear flow exporter
HR-437
Netflow Commands on Cisco IOS XR Software clear flow monitor
clear flow monitor

To clear the flow monitor data, enter the clear flow monitor command in EXEC mode. clear flow monitor [name] cache [force-export | statistics] location node-id
Syntax Description
name cache force-export statistics location node-id
(Optional) Identifies a specific cache you want to clear. Clears all cache related information. (Optional) Forces the export of flow records on flushing the cache on the specified node. (Optional) Clears cache statistics on a specific node. Node whose flow monitor you want to clear. The node-id argument is expressed in the rack/slot/module notation.
Defaults
Command Modes
EXEC
Command History
Release Release 3.2
Usage Guidelines
Examples
The following example shows how to clear the cache-related flow records on a specific node:
RP/0/RP0/CPU0:router# clear flow monitor cache force-export location 0/0/CPU0 Clear cache entries for this monitor on this location. Continue? [confirm] %Unable to clear cache and export. Possible bad flow monitor or bad/disabled exp orter. RP/0/RP0/CPU0:router#
Related Commands Command flow monitor-map show flow monitor-map Description Configures a flow monitor map. Displays flow monitor map information for a specific node, or for all nodes installed in the router.
HR-438
Netflow Commands on Cisco IOS XR Software flow exporter-map
flow exporter-map
To configure a flow exporter map, enter the flow exporter-map command in Global Configuration mode. flow exporter-map {collector collector_name {destination hostname_or_IP_address | dscp dscp_value | source {Bundle-Ether interface_instance | Bundle-POS interface_instance | GigabitEthernet Interface_Instance | Loopback interface_instance | MgmtEth Interface_Instance| Null 0 | POS Interface_Instance | tunnel-te interface_instance}| transport udp port} | version v9 {options {cache-stats timeout seconds | exporter-stats timeout seconds | interface-table timeout seconds | sampler-table timeout seconds} | template [data timeout seconds | options timeout seconds]} To remove a flow exporter map configuration, use the no form of this command: no flow exporter-map {collector collector_name {destination hostname_or_IP_address | dscp dscp_value | source {Bundle-Ether interface_instance | Bundle-POS interface_instance | GigabitEthernet Interface_Instance | Loopback interface_instance | MgmtEth Interface_Instance| Null 0 | POS Interface_Instance | tunnel-te interface_instance}| transport udp port} | version v9 {options {cache-stats timeout seconds | exporter-stats timeout seconds | interface-table timeout seconds | sampler-table timeout seconds} | template [data timeout seconds | options timeout seconds]}
Syntax Description
collector collector_name destination hostname_or_IP_address dscp dscp_value
Specifies collector configuration and a collector name. Enter the collector name - maximum 32 characters. Exports destination configuration. Enter the hostname or A.B.C.D destination IP address. Specifies the differentiated services codepoint (DSCP) value for export packets.Replace dscp_value with a DSCP value, in the range from 0 through 63. Specifies a source interface. Follow the source keyword with one of the following keyword arguments:

source
Bundle-Ether Interface_Instance Bundle-POS Interface_Instance GigabitEthernet Interface_Instance Loopback Interface_Instance MgmtEth Interface_Instance Null 0 POS Interface_Instance
Bundle-Ether interface_instance Bundle-POS interface_instance
Specifies an aggregated Ethernet interface. Replace interface_instance with a number in the range from 1 through 65535. Specifies an aggregated POS interface. Replace interface_instance with a number in the range from 1 through 65535.
HR-439
GigabitEthernet Interface_Instance
Specifies a Gigabit Ethernet/IEEE 802.3 interface. Replace Interface_Instance with a number that identifies the interface you want to configure as a source.
Note
To see a list of all available gigabit ethernet interfaces, enter the GigabitEthernet command, followed by a ?.
Loopback interface_instance MgmtEth Interface_Instance
Specifies a loopback interface. Replace interface_instance with a number in the range from 1 through 65535. Specifies a Ethernet/IEEE 802.3 interface. Replace Interface_Instance with a number that identifies the interface you want to configure as a source.
Note
To see a list of all available ethernet interfaces, enter the MgmtEth command, followed by a ?.
Null 0 POS Interface_Instance
Specifies the Null interface, which is always represented by a 0. Specifies a Packet over SONET (POS) interface. Replace Interface_Instance with a number that identifies the interface you want to configure as a source.
Note
To see a list of all available POS interfaces, enter the MgmtEth command, followed by a ?.
tunnel-te Interface_Instance transport udp port version v9 options
Specifies a tunnel interface. Replace Interface_Instance with a number that identifies the interface you want to configure as a source, in the range from 1through 65535. Specifies the destination port for UDP packets. Replace port with the destination UDP port value in the range from 1024 through 65535. Specifies the version 9 export format. Specifies the options template configuration. Follow the options keyword with one of the following keyword arguments:

cache-stats timeout seconds exporter-stats timeout seconds interface-table timeout seconds sampler-table timeout seconds
cache-stats timeout seconds exporter-stats timeout seconds interface-table timeout seconds sampler-table timeout seconds
Specifies the export timeout value for cache statistics. Replace seconds with the export timeout value. Range is from 1 through 604800 seconds. The default value is 1800 seconds. Specifies the export timeout value for exporter statistics. Replace seconds with the export timeout value. Range is from 1 through 604800 seconds. The default value is 1800 seconds. Specifies the export timeout value for the interface table. Replace seconds with the export timeout value. Range is from 1 through 604800 seconds. The default value is 1800 seconds. Export timeout value for the sampler table. Replace seconds with the export timeout value, in the range from 1 through 604800 seconds. The default value is 1800 seconds.
HR-440
template
Specifies one of the following template export parameters:

data timeout (follow the template keyword with the data timeout seconds argument.) options timeout (follow the template keyword with the options timeout seconds argument.)
data timeout seconds options timeout seconds
Export timeout value for data packets. Replace seconds with the export timeout value, in the range from 1 through 604800 seconds. Export timeout value for options packets. Replace seconds with the export timeout value, in the range from 1 through 604800 seconds.
Defaults
Command Modes
Global Configuration
Command History
Release Release 3.2
Usage Guidelines
Examples
The following example shows how to configure the export version timeout template parameters for the flow exporter-map called map1:
RP/0/RP0/CPU0:router(config)# flow exporter-map map1 version v9 template data timeout 100 RP/0/RP0/CPU0:router(config)#
Related Commands Command flow monitor-map show flow exporter show flow exporter-map Description Configures a flow monitor map and associates an exporter map with a monitor map. Displays flow exporter data. Displays flow exporter map information for a specific node, or for all nodes installed in the router.
HR-441
Netflow Commands on Cisco IOS XR Software flow ipv4 monitor
flow ipv4 monitor

To specify a flow monitor map and a sampler map for IPv4 packets, enter the flow ipv4 monitor command in interface configuration mode. flow ipv4 monitor name [sampler name] {egress | ingress}
Syntax Description
name sampler name egress ingress
Name of the flow monitor map you want to specify for IPv4 packets. (Optional) Name of the sampler map you want to apply to the flow monitor map. Applies the flow monitor map on outgoing packets. Applies the flow monitor map on incoming packets.
Defaults
Command Modes
Interface Configuration
Command History
Release Release 3.2
Usage Guidelines
Examples
The following example shows how to apply a flow monitor map, named map1, on outgoing IPv4 packets:
RP/0/RP0/CPU0:router(config-if)# flow ipv4 monitor map1 egress RP/0/RP0/CPU0:router(config-if)#
Related Commands Command flow monitor-map show flow monitor-map Description Configures a flow monitor map. Displays flow monitor map information for a specific node, or for all nodes installed in the router.
HR-442
Netflow Commands on Cisco IOS XR Software flow monitor-map
flow monitor-map
To configure a flow monitor map, enter the flow monitor-map command in global configuration mode. flow monitor-map map_name {cache {entries number | permanent | timeout {active timeout_value | inactive timeout_value| update timeout_value}} | exporter map_name| record ipv4-raw} To remove a flow monitor map configuration, use the no form of this command: no flow monitor-map map_name {cache {entries number | permanent | timeout {active timeout_value | inactive timeout_value| update timeout_value}} | exporter map_name| record ipv4-raw}
Syntax Description
map_name cache entries number
Name of the monitor map. The monitor map name can be a maximum 32 characters. Specifies the number of entries in the flow cache. Replace the number argument with the number of flow entries allowed in the flow cache. Range is from 0 through 1000000. Disables removal of entries from flow cache. Specifies the active, inactive, or update flow cache timeout value. Follow the cache timeout keywords with one of the following arguments:

cache permanent cache timeout
active timeout_value inactive timeout_value update timeout_value
active timeout_value
Specifies the active flow timeout. Replace the timeout_value argument with a number in the range from 1 through 604800 seconds.
inactive timeout_value Specifies the inactive flow timeout. Replace the timeout_value argument with a number. Range is from 1 through 604800 seconds. update timeout_value Specifies the update timeout. Enter the timeout value in seconds. Replace the timeout_value argument with a number. Range is from 1 through 604800 seconds. Associates a flow exporter map with the flow monitor map. Replace the map_name argument with the exporter map name. The exporter map name can be a maximum of 32 characters. Specifies the flow record map name as ipv4-raw.
Note
exporter map_name
record ipv4-raw
Release 3.2 of IOS XR supports only the ipv4-raw record format. You must specify ipv4-raw as the record map for every flow monitor-map in the system.
Defaults
Command Modes
HR-443
Netflow Commands on Cisco IOS XR Software flow monitor-map
Command History
Release Release 3.2
Usage Guidelines
Examples
The following example shows how to configure the number of entries in a flow cache:
RP/0/RP0/CPU0:router(config)# RP/0/RP1/CPU0:single10-hfr(config)# flow monitor-map map1 cache entries 20
The following example shows how to configure the inactive flow cache timeout:
RP/0/RP1/CPU0:single10-hfr(config)# flow monitor-map map1 cache timeout inactive 1000 RP/0/RP1/CPU0:single10-hfr(config)#
Related Commands Command flow ipv4 monitor flow monitor-map Description Specifies a flow monitor map for IPv4 packets. Configures a flow monitor map.
HR-444
Netflow Commands on Cisco IOS XR Software sampler-map
sampler-map
To configure the sampler map, enter the sampler-map command in global configuration mode. sampler-map random 1 out-of number_of_packets
Syntax Description
number_of_packets
Sets the sampling interval in units of packets. Replace the number_of_packets argument with a number. Range is from1 through 104857 units.
Defaults
The default value for the sampling interface is 1 out of 1000 units.
Command Modes
Command History
Release Release 3.2
Usage Guidelines
Examples
The following example shows how to configure the sampler map to randomly sample 1 out of every 10 packets:
RP/0/RP0/CPU0:router(config)# sampler map1 random 1 out-of 10 RP/0/RP0/CPU0:router(config)##
Related Commands
Command flow ipv4 monitor show sampler-map
Description Specifies a flow monitor map and a sampler map for IPv4 packets. Displays sampler map information.
HR-445
Netflow Commands on Cisco IOS XR Software show flow exporter
show flow exporter

To display flow exporter data, enter the show flow exporter command in EXEC mode. show flow exporter [exporter_name] location node-id
Syntax Description
exporter_name location node-id
Identifies the flow exporter whose data you want to display. Location where the cache resides. The node-id argument is expressed in the rack/slot/module notation.
Note
Defaults
Command Modes
EXEC
Command History
Release Release 3.2
Usage Guidelines
Examples
The following example shows how to display flow exporter data from the CPU node in slot 0:
RP/0/RP0/CPU0:router(config)# show flow exporter location 0/0/CPU0 RP/0/RP0/CPU0:router(config)#
Related Commands Command clear flow exporter flow exporter-map show flow exporter-map Description Clears flow exporter statistics or restarts the flow exporter statistics collector. Configures a flow exporter map. Displays flow exporter map information for a specific node, or for all nodes installed in the router.
HR-446
Netflow Commands on Cisco IOS XR Software show flow exporter-map
show flow exporter-map

To display flow exporter map information for a specific node, or for all nodes installed in the router, enter the show flow exporter-map command in EXEC mode. show flow exporter-map [name]
Syntax Description
name
Name of the exporter map whose information you want to display.
Defaults
Enter the show flow exporter-map command without the [word] option to display flow exporter map information for all nodes installed in the router.
Command Modes
EXEC
Command History
Release Release 3.2
Usage Guidelines
Examples
The following example shows how to display flow exporter map information:
RP/0/RP0/CPU0:router# show flow exporter-map map1
Flow Exporter Map : map1 ------------------------------------------------Id : 2 NumCollectors : 1 Collector: collector1 DestinationIpAddr : 255.255.255.255 SourceIfName : Bundle-Ether1 SourceIpAddr : 0.0.0.0 DSCP : 10 TransportProtocol : UDP TransportDestPort : 3000
Export Version: 9 Common Template Timeout : 1800 seconds Options Template Timeout : 1800 seconds Data Template Timeout : 1800 seconds Interface-Table Export Timeout : 0 seconds Sampler-Table Export Timeout : 0 seconds Cache-Stats Export Timeout : 0 seconds Exporter-Stats Export Timeout : 0 seconds RP/0/RP1/CPU0:single10-hfr#
HR-447

Table 90 show flow exporter-map Field Descriptions
Field Id NumCollectors Collector DestinationIpAddr SourceIfName SourceIpAddr DSCP TransportProtocol
Description Identifies the flow exporter map. Number the identifies the collector. Name of the collector. You can specify the collector name with the flow exporter-map command. Exports destination configuration. You can specify the destination IP address with the flow exporter-map command. Source interface for this exporter map. You can specify the source interface with the flow exporter-map command. IP address of the source interface (SourceIfName). Differentiated services codepoint (DSCP) value for export packets. You can specify the DSCP with the flow exporter-map command. Displays the configured transport protocol.
Note
Release 3.2 supports the UDP transport protocol only.
You can specify the transport protocol with the flow exporter-map command. TransportDestPort Displays the configured destination port for UDP packets. You can specify the transport destination port with the flow exporter-map command. Export Version Common Template Timeout Displays the configured export format.
Note
Release 3.2 supports export format version 9 only. You can specify the common template timeout with the flow exporter-map command. You can specify the options template timeout with the flow exporter-map command. You can specify the data template timeout with the flow exporter-map command. You can specify the export timeout for the interface table with the flow exporter-map command. You can specify the export timeout for the sampler table with the flow exporter-map command.
Displays the configured common template timeout.

Note
Options Template Timeout
Displays the configured options template timeout.

Note
Data Template Timeout
Displays the configured data template timeout.

Note
Interface-Table Export Timeout
Displays the export timeout value for the interface table.

Note
Sampler-Table Export Timeout
Displays the export timeout value for the sampler table.

Note
HR-448
Table 90
show flow exporter-map Field Descriptions
Field Cache-Stats Export Timeout
Description Export timeout value for cache statistics.

Note
You can specify the export timeout for cache statistics with the flow exporter-map command. You can specify the export timeout for the exporter statistics with the flow exporter-map command.
Exporter-Stats Export Timeout
Export timeout value for exporter statistics.

Note
Related Commands Command clear flow exporter flow exporter-map show flow exporter Description Clears flow exporter statistics or restarts the flow exporter statistics collector. Configures a flow exporter map. Displays flow exporter data.
HR-449
Netflow Commands on Cisco IOS XR Software show flow monitor-map
show flow monitor-map

To display flow monitor map data, enter the show flow monitor-map command in EXEC mode. show flow monitor-map [exporter-name]
Syntax Description
exporter-name
Name of the monitor map whose data you want to display.
Defaults
Enter the show flow monitor-map command without the optional [exporter-name] argument to display flow monitor map data on the router.
Command Modes
EXEC
Command History
Release Release 3.2
Usage Guidelines
Examples
The following example shows how to display monitor-map data for a specific flow:
RP/0/RP0/CPU0:router# show flow monitor-map map1 Flow Monitor Map : map1 ------------------------------------------------Id: 2 RecordMapName: ExportMapName: CacheAgingMode: Normal CacheMaxEntries: 300 CacheActiveTout: 1800 seconds CacheInactiveTout: 1000 seconds CacheUpdateTout: N/A RP/0/RP1/CPU0:single10-hfr#

Table 91 show flow monitor-map Field Descriptions
Field Id RecordMapName ExportMapName
Description Flow monitor map identifier. Record map associated with this monitor map. Exporter map associated with this monitor map.
HR-450
Netflow Commands on Cisco IOS XR Software show flow monitor-map
Table 91
show flow monitor-map Field Descriptions
Field CacheAgingMode
Description Sampling interval in units of packets. Normal mode is 1 out of 1000 units. Random mode is any other mode that was configured with the flow monitor-map command. Number of entries in the flow cache. You can set the maximum number of cache entries with the flow monitor-map command. Active flow timeout, in seconds. You can set active flow timeout with the flow monitor-map command. Inactive flow timeout, in seconds. You can set inactive flow timeout with the flow monitor-map command. Update flow timeout, in seconds. You can set update flow timeout with the flow monitor-map command.
CacheMaxEntries CacheActiveTout CacheInactiveTout CacheUpdateTout:
Related Commands Command clear flow monitor flow monitor-map flow ipv4 monitor Description Clears the flow monitor data. Configures a flow monitor map. Specifies a flow monitor map and a sampler map for IPv4 packets.
HR-451
Netflow Commands on Cisco IOS XR Software show sampler-map
show sampler-map
To display sampler map information, enter the show sampler-map command in EXEC mode. show sampler-map [sampler-name]
Syntax Description
sampler-name
Identifies the sampler map whose information you want to display.
Defaults
Enter the command without the [exporter-name] argument to display information about all sampler maps in the router.
Command Modes
EXEC
Command History
Release Release 3.2
Usage Guidelines
Examples
The following example shows how to display sampler map information for a router:
RP/0/RP0/CPU0:router(config)# show sampler-map map1 Sampler Map : map1 ------------------------------------------------Id: 1 Mode: Random (1 out of 100 Pkts) RP/0/RP1/CPU0:single10-hfr#

Table 92 show sampler map Field Descriptions
Field Id Mode
Description Flow sampler map identifier. Sampling interval in units of packets. Normal mode is 1 out of 1000 units. Random mode is any other mode that was configured with the flow monitor-map command.
HR-452
Related Commands Command sampler-map flow ipv4 monitor Description Configures the sampler map. Specifies a flow monitor map and a sampler map for IPv4 packets.
HR-453
HR-454
Gigabit Ethernet Commands on Cisco IOS XR Software

This module describes the commands used to administer and configure Gigabit Ethernet commands on Cisco IOS XR software.
HR-455
Gigabit Ethernet Commands on Cisco IOS XR Software clear mac-accounting
clear mac-accounting
To clear Media Access Control (MAC) accounting statistics, use the clear mac-accounting command in EXEC mode. clear mac-accounting type [location node-id]
Syntax Description
type
Type of interface whose MAC accounting statistics you want to clear.

Note
In Release 3.0, the only supported interface is 10-Gigabit Ethernet (TenGigE).
location node-id
(Optional) Clears MAC accounting statistics for the designated node. The node-id argument is entered in the rack/slot/module/port notation.
Command Modes
EXEC
Command History
Modification This command was first introduced on the Cisco CRS-1 router . No modification. This command was first supported on the Cisco 12000 Series router.
Usage Guidelines
Examples
The following example shows how to clear all MAC accounting statistics for TenGigE on the node at 1/0/0/1:
RP/0/RP0/CPU0:router# clear mac-accounting TenGigE location 1/0/0/1
Related Commands
Command mac-accounting show mac-accounting
Description Configures MAC accounting on an interface. Displays MAC accounting statistics for an interface.
HR-456
Gigabit Ethernet Commands on Cisco IOS XR Software flow-control
flow-control
To enable the sending of flow-control pause frames, use the flow-control command in interface configuration mode. To disable flow control, use the no form of this command. flow-control ingress no flow-control ingress
Syntax Description
ingress
Sends flow-control pause frames for ingress traffic.
Defaults
The sending of flow-control pause frames is disabled by default.
Command Modes
Command History
Modification This command was first introduced on the Cisco CRS-1 router . This command was first supported on the Cisco 12000 Series router.
Usage Guidelines
Examples
The following example enables shows how to enable the sending of flow-control pause frames for ingress traffic on the TenGigE interface 0/3/0/0:
RP/0/RP0/CPU0:router(config)# interface TenGigE 0/3/0/0 RP/0/RP0/CPU0:router(config-if)# flow-control ingress
Related Commands
Description Displays statistics for all interfaces enabled on the router.
HR-457
Gigabit Ethernet Commands on Cisco IOS XR Software loopback (TenGigE)
loopback (TenGigE)
To configure the 10-Gigabit Ethernet (TenGigE) controller for loopback mode, use the loopback command in interface configuration mode. To disable loopback, use the no form of this command. loopback {internal | line} no loopback
Syntax Description
internal line
All packets will be looped back internally within the router before reaching an external cable. Incoming network packets will be looped back via the external cable.
Defaults
Loopback mode on the 10-Gigabit Ethernet (TenGigE) controller is disabled by default.
Command Modes
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. Two loopback operation modes are supported for diagnostic purposes: internal and line. In the terminal (internal) loopback, the sent signal is looped back to the receiver. While in the facility (line) loopback, the signal received from the far end is looped back and sent on the line. The two loopback modes cannot be active at the same time. In normal operation mode, neither of the two loopback modes is enabled.
Examples
In the following example, all packets are looped back to the TenGigE controller:
RP/0/RP0/CPU0:router(config)# interface TenGigE 0/3/0/0 RP/0/RP0/CPU0:router(config-if)# loopback internal
HR-458
Gigabit Ethernet Commands on Cisco IOS XR Software mac-accounting
mac-accounting
To generate accounting information for IP traffic based on the source and destination Media Access Control (MAC) addresses on LAN interfaces, use the mac-accounting command in interface configuration mode. To disable MAC accounting, use the no form of this command. mac-accounting {egress | ingress}
Syntax Description
egress ingress
Generates accounting information for IP traffic based on the destination MAC addresses (egress direction). Generates accounting information for IP traffic based on the source MAC addresses (ingress direction).
Defaults
MAC accounting is disabled by default.
Command Modes
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. The mac-accounting command calculates the total packet and byte counts for a LAN interface that receives or sends IP packets to or from a unique MAC address.
Note
Some 10-Gigabit Ethernet (TenGigE) modular services cards support only ingress MAC accounting, in which case the egress keyword is unavailable.
Examples
The following example shows how to enable MAC accounting for the source MAC address on the ingress direction:
RP/0/RP0/CPU0:router(config-if)# mac-accounting ingress
Related Commands
Command clear mac-accounting show mac-accounting
Description Clears MAC accounting statistics for a specified interface. Displays MAC accounting statistics for a specified interface.
HR-459
Gigabit Ethernet Commands on Cisco IOS XR Software packet-gap non-standard
packet-gap non-standard
To change the packet interval for traffic on an interface for improved interoperability with Cisco Catalyst 6000 series switches, use the packet-gap non-standard command in interface configuration mode. To use the standard packet interval as defined by the IEEE 802.ae specification, use the no form of this command. packet-gap non-standard no packet-gap non-standard
Syntax Description
Defaults
The interface uses the standard packet interval as defined by the IEEE 802.ae specification by default.
Command Modes
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. An interface that is connected to a Cisco Catalyst 6000 series switch may experience packet loss problems that can be resolved by changing the packet interval of traffic from standard (as defined by the IEEE 802.ae specification) to nonstandard using the packet-gap non-standard command.
Examples
The following example shows how to change the packet interval for traffic on an interface from standard to nonstandard:
RP/0/RP0/CPU0:router(config)# interface TenGigE 0/3/0/0RP/0/RP0/CPU0:router(config-if)# packet-gap non-standard
HR-460
Gigabit Ethernet Commands on Cisco IOS XR Software show mac-accounting
show mac-accounting
To display MAC accounting statistics for an interface, use the show mac-accounting command in EXEC mode. show mac-accounting type location node-id
Syntax Description
type location node-id
Type of interface whose MAC accounting statistics you want to display. Displays detailed MAC accounting information for the specified interface on the specified node. The node-id argument is entered in the rack/slot/module/port notation.
Command Modes
EXEC
Command History
Modification This command was first introduced on the Cisco CRS-1 router. This command was first supported on the Cisco 12000 Series router.
Usage Guidelines
Examples
The following is sample output from the show mac-accounting command, which displays MAC accounting statistics on the specified interface:
RP/0/RP0/CPU0:router# show mac-accounting TenGigE location 0/2/0/4 TenGigE0/2/0/4 Input (511 free) 000b.4558.caca: 4 packets, 456 bytes Total: 4 packets, 456 bytes

Table 93 show mac-accounting Field Descriptions
Field Interface Input Total
Description The interface from which the statistics are generated. Heading for the ingress MAC accounting statistics. The number of MAC accounting entries still available is shown in parentheses. Total statistics for the traffic accounted for by MAC accounting. This excludes any traffic for which there is no MAC address entry, such as non-IP traffic from an unknown MAC source address.
HR-461
Gigabit Ethernet Commands on Cisco IOS XR Software show mac-accounting
Related Commands
Command clear mac-accounting mac-accounting
Description Clears MAC accounting statistics. Generates MAC accounting statistics.
HR-462
Gigabit Ethernet Commands on Cisco IOS XR Software show controllers tengige
show controllers tengige

To display 10-Gigabit Ethernet (TenGigE) port information, use the show controllers tengige command in EXEC mode. show controllers tengige node-id
Syntax Description
node-id
Node whose detailed TenGigE information you want to display. The node-id argument is entered in the rack/slot/module/port notation.
Command Modes
EXEC
Command History
Usage Guidelines
Examples
The following is sample output from the show controllers tengige command, which displays detailed information about the TenGigE controllers:
RP/0/RP1/CPU0:router# show controllers tengige 0/3/0/0 PHY: XENPAK device registers: ======================== Vendor Name: VENDOR1 Vendor PN: TXN174012013F06 Vendor Rev: A Vendor SN: USC2021W09 Package OUI: 410024f4 Vendor OUI: 00137b01 Vendor Date Code: 2003022700 nvr_control_status = 0x0007 nvr_version = 0x1e nvr_size0 = 0x01 nvr_size1 = 0x00 mem_used0 = 0x01 mem_used1 = 0x00 basic_addr = 0x0b cust_addr = 0x77 vend_addr = 0xa7 ext_vend_addr0= 0x00 ext_vend_addr1= 0xff reserved0 = 0x00 tcvr_type = 0x01
HR-463
connector = 0x00 encoding = 0x01 bitrate0 = 0x27 bitrate1 = 0x10 protocol = 0x01 x_gbe_code_byte_0 = 0x02 x_gbe_code_byte_1 = 0x00 sonet_sdh_code_byte_0 = 0x00 sonet_sdh_code_byte_1 = 0x00 sonet_sdh_code_byte_2 = 0x00 sonet_sdh_code_byte_3 = 0x00 x_gfc_code_byte_0 = 0x00 x_gfc_code_byte_1 = 0x00 x_gfc_code_byte_2 = 0x00 x_gfc_code_byte_3 = 0x00 range0 = 0x03 range1 = 0xe8 fibre_type_byte_0 = 0x20 fibre_type_byte_1 = 0x00 basic_checksum = 0x5a Link Alarm Status Registers: rx_alarm_control = 0x0019 tx_alarm_control = 0x0059 lasi_control = 0x0000 rx_alarm_status = 0x0019 tx_alarm_status = 0x0058 lasi_status = 0x0001 Quake: devid 0x0043a400 10GE PMA/PMD Registers: Control = 0x2040 Status = 0x0002 Dev ID 0 = 0x0043 Dev ID 1 = 0xa400 Speed Ability = 0x0001 Devices 1 = 0x001a Devices 2 = 0x0000 Control 2 = 0x0006 Status 2 = 0xb141 Tx Disable = 0x0000 Rx Signal Detect = 0x0001 OUI 0 = 0x4100 OUI 1 = 0x24f4 Quake (1.c001) = 0x0001 10GE PCS Registers: Control = 0x2040 Status = 0x0002 Dev ID 0 = 0x0043 Dev ID 1 = 0xa400 Speed Ability = 0x0001 Devices 1 = 0x001a Devices 2 = 0x0000 Control 2 = 0x0000 Status 2 = 0x8001 PKG ID 0 = 0x0000 PKG ID 1 = 0x0000 Base X Status = 0x0000 Base X Control = 0x0000 Base R Status 1 = 0x1005 Base R Status 2 = 0x0000 Base R jitter seed a0 = 0x0000 Base R jitter seed a1 = 0x0000 Base R jitter seed a2 = 0x0000 Base R jitter seed a3 = 0x0000 Base R jitter seed b0 = 0x0000 Base R jitter seed b1 = 0x0000 Base R jitter seed b2 = 0x0000 Base R jitter seed b3 = 0x0000 Base R jitter test control = 0x0000 Base R jitter test counter = 0x0000 10GE XS/XS Registers: Control = 0x2040 Status = 0x0002 Dev ID 0 = 0x0043 Dev ID 1 = 0xa400 Speed Ability = 0x0001 Devices 1 = 0x001a Devices 2 = 0x0000 Status 2 = 0x8000 PKG ID 0 = 0x0000 PKG ID 1 = 0x0000 Lane Status = 0x1c0f Test Control = 0x0000 DTE XGXS (BCM8011): Control = 0x0000 Status = 0x801f Dev ID 0 = 0x0040 Dev ID 1 = 0x6092 Control 2 = 0x202f Status 2 = 0x8b01
HR-464
MAC (PLA): Unicast MAC Address entries = 3 Entry 0: 0004.5416.f623 Entry 1: 0000.5e00.0101 Entry 2: 0000.0c07.ac01 MAC (PLA) device is enabled MAC (PLA) device is in promiscuous mode MAC (PLA) device loopback is disabled MAC (PLA) device MTU = 1514
8x10GE PLIM Registers: local_regs_id = 0x96602000 local_regs_inter_stat = 0x00000080 local_regs_inter_stat_alias = 0x00000000 local_regs_inter_enbl_woset = 0x0000ff00 local_regs_inter_enbl_woclr = 0x0000ff00 local_regs_chip_reset = 0x00000000 local_regs_reset = 0xff000000 local_regs_misc_io = 0x00010000 sn_link_framed = 0x00000001 sn_link_crc_errors = 0x00000000 sn_link_force_reframe = 0x00000000 sn_link_error_reframe = 0x00000001 sn_link_force_error = 0x00000000 sn_link_error_cause = 0x00000000 sn_link_error_interrupt_mask = 0x00000003 channel0_control = 0x000000a6 channel1_control = 0x000000a6 channel2_control = 0x000000a6 channel3_control = 0x000000a6 channel4_control = 0x0000008e channel5_control = 0x000000a6 channel6_control = 0x000000a6 channel7_control = 0x000000a6 Field descriptions: PHY - Vendor details and physical register details for the optic. MAC (PLA) - Details of the MAC settings on the interface including unicast MAC addresses set.

Table 94 show controllers tengige Field Descriptions
Field PHY MAC (PLA)
Description Vendor details and physical register details for the optic. Details of the MAC settings on the interface, including unicast MAC addresses set.
HR-465
HR-466
Link Bundling Commands on Cisco IOS XR Software

This module contains commands for configuring and monitoring link bundling commands on Cisco IOS XR software.
HR-467
Link Bundling Commands on Cisco IOS XR Software bundle-id
bundle-id
To add a port to an aggregated interface (or bundle), enter the bundle-id command in interface configuration mode. bundle-id bundle-id [mode {active| on | passive] no bundle-id bundle-id
Syntax Description
bundle-id mode
Bundle on which you want to add a port. Replace bundle-id with a port number. Range is from 1 through 65535. Specifies the mode of operation, as follows:
activeUse the mode active keywords to run Link Aggregation Control Protocol (LACP) in active mode over the port. When you specify active, the port joins the bundle and is activated if LACP determines that it is compatible. onUse the mode on keywords to add the link to a bundle withough running LACP over the port. passiveUse the mode passive keywords to run LACP in passive mode over the port. When you specify passive, LACP packets are sent only if the other end of the link is using active LACP. The link joins the bundle and is activated if LACP packets are exchanged and the port is compatible.
Defaults
If you do not specify a mode, the default mode is on (LACP is not run over the port).
Command Modes
interface configuration
Command History
Release Release 3.2
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. If you enter the bundle-id command and specify a port is already bound to a bundle, the port unbinds from the original bundle and becomes attached to the new bundle. If the bundle numbers are the same, then the port does not unbind, but the mode changes to mode you specified with the bundle-id command.
Examples
The following example shows how to add a port onto a bundle:

RP/0/RP1/CPU0:HalfQ(config-if)# bundle-id 1
HR-468
Link Bundling Commands on Cisco IOS XR Software bundle-id
The following example shows how to add an active LACP port onto an aggregated interface (or bundle):
RP/0/RP1/CPU0:HalfQ(config-if)# bundle-id 5 mode active
Related Commands
Command show bundle Bundle-Ether show bundle Bundle-POS
Description Displays hardware-related information for a specific Ethernet bundle. Displays hardware-related information for a specific PoS bundle.
show bundle members Displays hardware-related information for all bundles and their members, or for a specific bundle and its members, show lacp bundle show lacp port Displays detailed information about LACP ports and their peers. Displays detailed information about LACP ports.
HR-469
Link Bundling Commands on Cisco IOS XR Software clear lacp counters
clear lacp counters

To clear Link Aggregation Control Protocol (LACP) counters for all members of all bundles, all members of a specific bundle, or for a specific port, enter the clear lacp counters command in EXEC mode. clear lacp counters [bundle | port]
Syntax Description
bundle port
Clears LACP counters for all members of a bundle. Clears all LACP counters on the router.
Defaults
Enter the clear lacp counters command without the optional bundle or port keywords to clear all LACP counters on the router.
Command Modes
EXEC
Command History
Release Release 3.2
Usage Guidelines
Examples
The following example shows how to clear LACP counters:

RP/0/RP1/CPU0:MiniQ#clear lacp counters RP/0/RP1/CPU0:MiniQ#
Related Commands
Command show lacp counters
Description Displays LACP statistics.
HR-470
Link Bundling Commands on Cisco IOS XR Software lacp period short
lacp period short

To configure a one second interval between LACP packets that are received from peer, enter the lacp period command in interface configuration mode. To return to the default LACP period, use the no form of this command. lacp period short no lacp period short
Syntax Description
None.
Defaults
If you do not enter the lacp period short command, then the peer transmits LACP packets every 30 seconds.
Command Modes
Command History
Release Release 3.2
Usage Guidelines
Examples
The following example shows how to configure a one second interval between LACP packets that are received from the peer:
RP/0/RP0/CPU0:router(config-if)# lacp period short RP/0/RP0/CPU0:router(config-if)#
Related Commands
None.
HR-471
Link Bundling Commands on Cisco IOS XR Software lacp port-priority
lacp port-priority
To configure LACP priority for a port, enter the lacp port-priority command in interface configuration mode. To return to the default LACP priority value, use the no form of this command. lacp port-priority priority no lacp port-priority priority
Syntax Description
priority
Priority for this port, where a lower value equals a higher priority. Replace the priority argument with a number. Range is from 0 through 65535.
Defaults
The default LACP priority is 32768.
Command Modes
Command History
Release Release 3.2
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. The LACP priority value forms part of the port ID, which is transmitted within the LACP packets that are exchanged with the peer. The peer uses the LACP packets to determine whether a given port should carry traffic for the bundle.
Note
A lower LACP value is a higher LACP priority for the port.
Examples
The following example shows how to configure LACP priority on a port:

RP/0/RP1/CPU0:single10-hfr(config-if)# lacp port-priority 1
Related Commands
Command show lacp system-id
Description Displays the local system ID used by LACP.
HR-472
Link Bundling Commands on Cisco IOS XR Software lacp system-priority
lacp system-priority
To configure the priority for the current system, enter the lacp system-priority command in global configuration mode. To return to the default LACP system-priority value, use the no form of this command. lacp system-priority priority
Syntax Description
priority
Priority for this system. Replace priority with a number. Range is from 0 through 65535. A lower value is higher priority.
Defaults
The default system priority is 32768.
Command Modes
global configuration
Command History
Release Release 3.2
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. The system priority value forms part of the LACP system ID, which is transmitted within each LACP packet. The system ID, port ID and key combine to uniquely define a port within a LACP system.
Examples
The following example shows how to configure an LACP priority of 100 on a router:
P/0/RP1/CPU0:single10-hfr(config)# lacp system-priority 100 P/0/RP1/CPU0:single10-hfr(config)#
Command show lacp bundle show lacp port
Description Displays detailed information about LACP ports and their peers. Displays detailed information about LACP ports.
HR-473
Link Bundling Commands on Cisco IOS XR Software show bundle Bundle-Ether
show bundle Bundle-Ether

To display hardware-related information for a specific Ethernet bundle, enter the show bundle Bundle-Ether command in EXEC mode. show bundle Bundle-Ether bundle-id
Syntax Description
bundle-id
Ethernet bundle whose hardware-related information you want to display. Replace bundle-id with a bundle identifier. Range is from 1 through 65535.
Defaults
Command Modes
EXEC
Command History
Release Release 3.2
Usage Guidelines
Examples
The following example shows how to display hardware-related information for a specific Ethernet bundle:
RP/0/RP1/CPU0:HalfQ#show bundle Bundle-Ether 3 Bundle-Ether3 Bandwidth: 0 Kbit/sec MAC addr: 0000.0000.0000 RP/0/RP1/CPU0:HalfQ#

Table 95 show bundle Bundle-Ether Field Descriptions
Field Bandwidth MAC addr
Description Bundled interface bandwidth, in KB per second. The interface is identified by Bundle-Ethern, where n is the interface ID. MAC address associated with the specified interface (bundle member).
Related Commands
HR-474
Link Bundling Commands on Cisco IOS XR Software show bundle Bundle-Ether
Command bundle-id
Description Adds a port to an aggregated interface (or bundle).
show bundle members Displays hardware-related information for all bundles and their members, or for a specific bundle and its members.
HR-475
Link Bundling Commands on Cisco IOS XR Software show bundle Bundle-POS
show bundle Bundle-POS

To display hardware-related information for a specific PoS bundle, enter the show bundle Bundle-POS command in EXEC mode. show bundle Bundle-POS bundle-id
Syntax Description
bundle-id
Ethernet bundle whose hardware-related information you want to display. Replace bundle-id with a bundle identifier. Range is from 1 through 65535.
Defaults
Command Modes
EXEC
Command History
Release Release 3.2
Usage Guidelines
Examples
The following example shows how to display hardware-related information for a specific PoS bundle:
RP/0/RP1/CPU0:HalfQ#show bundle Bundle-POS 1 Bundle-POS1 Bandwidth: 0 Kbit/sec MAC addr: N/A RP/0/RP1/CPU0:HalfQ#

Table 96 show bundle Bundle-PoS Field Descriptions
Field Bandwidth MAC addr
Description Bundled interface bandwidth, in KB per second. The interface is identified by Bundle-POS1n, where n is the interface ID. MAC address associated with the specified interface (bundle member).
Related Commands
HR-476
Link Bundling Commands on Cisco IOS XR Software show bundle Bundle-POS
Command bundle-id
HR-477
Link Bundling Commands on Cisco IOS XR Software show bundle members
show bundle members

To display hardware-related information for all bundles and their members, or for a specific bundle and its members, enter the show bundle members command in EXEC mode. show bundle members [Bundle-Ether bundle-id location node-id | Bundle-POS bundle-id location node-id]
Syntax Description
Bundle-Ether node-id location node-id
Ethernet bundle whose hardware-related information you want to display. Replace with a number in the range from 1 through 65535. Identifies the node that hosts the bundled interface whose hardware-related information you want to display. The node-id argument is expressed in the rack/slot/module notation.
Bundle-POS bundle-id PoS bundle whose hardware-related information you want to display. Replace bundle-id with a bundle identifier. Range is from 1 through 65535.
Defaults
Enter the show bundle members command without any of the optional arguments to display information about all bundles on the router and their members.
Command Modes
EXEC
Command History
Release Release 3.2
Usage Guidelines
Examples
The following example shows how to display hardware-related information for all bundles and members on a router:
RP/0/RP1/CPU0:HalfQ#show bundle members Bundle-Ether3 Bandwidth: 0 Kbit/sec MAC addr: 0000.0000.0000 Bundle-POS1 Bandwidth: 0 Kbit/sec MAC addr: N/A
RP/0/RP1/CPU0:HalfQ#
HR-478
Link Bundling Commands on Cisco IOS XR Software show bundle members
Table 97
show bundle members Field Descriptions
Field Bandwidth
Description Bundled interface bandwidth, in KB per second. The Bandwidth field applies to each individual interface in the bundle. The interface is identified by Bundle-Ethern or Bundle-POS1n, where n is the interface ID. MAC address associated with the specified interface.
Note
MAC addr
An asterisk next to a MAC address means it is the MAC address for the entire bundle.
Related Commands
Command bundle-id
HR-479
Link Bundling Commands on Cisco IOS XR Software show lacp bundle
show lacp bundle

To display detailed information about Link Aggregation Control Protocol (LACP) ports and their peers, enter the show lacp bundle command in EXEC mode. show lacp bundle [Bundle-Ether bundle-id | Bundle-POS bundle-id]
Syntax Description
bundle-id
Bundle you want to display. Replace bundle-id with a bundle identifier. Range is from1 through 65535.
Defaults
Enter the show lacp bundle command without the optional keywords to display LACP information for all link bundles on the router.
Command Modes
EXEC
Command History
Release Release 3.2
Usage Guidelines
Examples
The following example shows how to display LACP information for a specific Ethernet Bundle:
RP/0/RP1/CPU0:HalfQ#show lacp bundle Bundle-Ether 4 Flags: A S D E State: 0 2 4 Device is in Active mode. P - Device is in Passive mode. Device sends PDUs at slow rate. F - Device sends PDUs at fast rate. Port is using default values for partner information Information about partner has expired Port is not aggregatable. 1 - Port is out of sync with peer. Port is in sync with peer. 3 - Port is Collecting. Port is Collecting and Distributing
Bundle-Ether4 Port ---0/3/0/3 PEER
State ----1 0
Flags ----ASDE PSD
Port ID ------0x8000, 0x0001 0x0000, 0x0000
Key --0x0004 0x0000
System-ID --------0x8000, 08-00-45-3d-69-01 0x0000, 00-00-00-00-00-00
HR-480
Link Bundling Commands on Cisco IOS XR Software show lacp bundle
Table 98
show lacp bundle Field Descriptions
Field Flags State Port State Flags
Description Describes the possible flags that may apply to a device or port, under the Flags field. Describes the possible flags that may apply the port state, under the State field. Port identifier, in the rack/slot/module/port notation. Provides information about the state of the specified port. Possible flags are:

0 - Port is not aggregatable. 1 - Port is out of sync with peer. 2 - Port is in sync with peer. 3 - Port is Collecting. 4 - Port is Collecting and Distributing
Flags
Provides information about the state of the specified device or port. Possible flags are:

A - Device is in Active mode. P - Device is in Passive mode. S - Device sends PDUs at slow rate. F - Device sends PDUs at fast rate. D - Port is using default values for partner information E - Information about partner has expired
Port ID Key
Port ID in hexadecimal format. 2-byte number associated with the specified link and aggregator. Each port assigned an operational Key. The ability of one port to aggregate with another is summarized by this key. Ports which have the same key select the same bundle interface. The system ID, port ID and key combine to uniquely define a port within a LACP system. System identifier. The System ID is a LACP property of the system which is transmitted within each LACP packet together with the details of the link.
System-ID
Related Commands
Command bundle-id show bundle Bundle-Ether show bundle Bundle-POS
Description Adds a port to an aggregated interface (or bundle). Displays hardware-related information for a specific Ethernet bundle. Displays hardware-related information for a specific PoS bundle.
HR-481
Link Bundling Commands on Cisco IOS XR Software show lacp counters
show lacp counters

To display Link Aggregation Control Protocol (LACP) statistics, enter the show lacp counters command in EXEC mode. show lacp counters [Bundle-Ether bundle-id | Bundle-POS bundle-id]
Syntax Description
bundle-id
Bundle whose counters you want to display. Replace bundle-id with a bundle identifier. Range is from 1 through 65535.
Defaults
Enter the show lacp counters command without the optional keywords to display LACP counters for all link bundles on the router.
Command Modes
EXEC
Command History
Release Release 3.2
Usage Guidelines
Examples
The following example shows how to display LACP counters on an Ethernet bundle:
RP/0/RP1/CPU0:HalfQ#show lacp counters bundle-ether 4 Bundle-Ether4 Port ----------0/3/0/3 Port ----------0/3/0/3 LACPDUs Sent Received ---------------------0 Excess ---------0 Marker Received Resp. Sent ---------------------0 0 Excess ---------0 Last Cleared -----------0 never Pkt Errors ---------0
HR-482
Link Bundling Commands on Cisco IOS XR Software show lacp counters
Table 99
show lacp counters Field Descriptions
Field LACPDUs
Description Provides the following statistics for transmit and receive Link Aggregation Control Protocol data units (LACPDUs):

Port Sent Received Excess Received Resp. Sent Last Cleared Excess Pkt Errors The Marker Protocol is used by 802.3ad bundles to ensure that data no longer is transmitted on a link when a flow is redistributed away from that link.
Marker
Provides the following statistics for marker packets:

Note
Related Commands
Command clear lacp counters
Description Clears LACP counters for all members of all bundles, all members of a specific bundle, or for a specific port.
HR-483
Link Bundling Commands on Cisco IOS XR Software show lacp port
show lacp port

To display detailed information about Link Aggregation Control Protocol (LACP) ports, enter the show lacp port command in EXEC mode. show lacp port [Bundle-Ether bundle-id | Bundle-POS bundle-id | Loopback bundle-id | MgmtEth interface_instance| Null 0| POS interface_instance]
Syntax Description
Ethernet interface bundle whose LACP port information you want to display. Replace bundle-id with the number of the bundle you want to display.
Bundle-POS bundle-id PoS interface bundle whose LACP port information you want to display. Replace bundle-id with the number of the bundle you want to display. Loopback bundle-id Loopback interface bundle whose LACP port information you want to display. Replace bundle-id with the number of the bundle you want to display. Ethernet/IEEE 802.3 interface whose LACP port information you want to display. The interface_instance is expressed in the rack/slot/module/port notation. Null interface whose LACP port information you want to display. The null interface is always represented by a 0. Packet over SONET network whose LACP port information you want to display. The interface_instance is expressed in the rack/slot/module/port notation.
MgmtEth interface_instance Null 0 POS interface_instance
Defaults
Enter the show lacp port command without any of the optional parameters to show LACP port information for all link bundles on the router.
Command Modes
EXEC
Command History
Release Release 3.2
Usage Guidelines
Examples
The following example shows how to display LACP port information for all link bundles on a router:
RP/0/RP1/CPU0:HalfQ#show lacp port Flags: A - Device is in Active mode. P - Device is in Passive mode. S - Device sends PDUs at slow rate. F - Device sends PDUs at fast rate. D - Port is using default values for partner information
HR-484
E State: 0 2 4
Information about partner has expired Port is not aggregatable. 1 - Port is out of sync with peer. Port is in sync with peer. 3 - Port is Collecting. Port is Collecting and Distributing
Bundle-Ether4 Port ---0/3/0/3 PEER
State ----1 0
Flags ----ASDE PSD
Port ID ------0x8000, 0x0001 0x0000, 0x0000
Key --0x0004 0x0000
System-ID --------0x8000, 08-00-45-3d-69-01 0x0000, 00-00-00-00-00-00

Table 100 show lacp port Field Descriptions
Field Port State
Description Identifies the LACP port whose information is displayed. The port number is expressed in the rack/slot/module/port notation. Provides information about the state of the specified device or port. Possible flags are:

A - Device is in Active mode. P - Device is in Passive mode. S - Device sends PDUs at slow rate. F - Device sends PDUs at fast rate. D - Port is using default values for partner information E - Information about partner has expired
Flags
Provides information about the state of the specified port. Possible flags are:

0 - Port is not aggregatable. 1 - Port is out of sync with peer. 2 - Port is in sync with peer. 3 - Port is Collecting. 4 - Port is Collecting and Distributing
Port ID Key
Port ID in hexadecimal format. 2-byte number associated with the specified link and aggregator. Each port assigned an operational Key. The ability of one port to aggregate with another is summarized by this key. Ports which have the same key select the same bundle interface. The system ID, port ID and key combine to uniquely define a port within a LACP system. System identifier. The System ID is an LACP property of the system which is transmitted within each LACP packet together with the details of the link.
System-ID
Related Commands
HR-485
HR-486
Link Bundling Commands on Cisco IOS XR Software show lacp system-id
show lacp system-id

To display the local system ID used by the Link Aggregation Control Protocol (LACP), enter the show lacp system-id command in EXEC mode. show lacp system-id
Syntax Description
None.
Defaults
Command Modes
EXEC
Command History
Release Release 3.2
Usage Guidelines
Note
The System ID and details about the specific link are transmitted within each LACP packet.
Examples
The following example shows how to display the system ID used by the LACP:
RP/0/RP1/CPU0:MiniQ#show lacp system-id Priority -------0x8000 MAC Address ----------------08-00-45-3a-65-01
RP/0/RP1/CPU0:MiniQ#

Table 101 show lacp system-id Field Descriptions
Field Priority MAC Address
Description Priority for this system. A lower value is higher priority. MAC address associated with the LACP system ID.
HR-487
Link Bundling Commands on Cisco IOS XR Software show lacp system-id
Related Commands
HR-488
Bidirectional Forwarding Detection Commands on Cisco IOS XR Software

Beta Draft Highly Confidential Information - Available to authorized customers under nondisclosure
This chapter describes the commands used to configure and monitor Bidirectional Forwarding Detection (BFD).
HR-489
Bidirectional Forwarding Detection Commands on Cisco IOS XR Software bfd fast-detect
bfd fast-detect
To enable bidirectional forwarding detection (BFD) to detect failures in the path between adjacent forwarding engines, use the bfd fast detect command in the appropriate configuration mode. To return the software to the default state in which BFD is not enabled, use the no form of this command. bfd fast-detect [disable | ipv4] no bfd fast-detect
Syntax Description
disable ipv4
Prevents Border Gateway Protocol (BGP) BFD settings from being inherited from the parent. Enables Intermediate System-to-Intermediate System (IS-IS) BFD detection of failures in the path between adjacent forwarding engines.
Defaults
BFD is not enabled.
Command Modes
BGP router configuration mode
Neighbor configuration Session group configuration Neighbor group configuration

IS-IS router configuration mode
MPLS-TE configuration mode
OSPF router configuration mode
Address family configuration
Command History
Release Release 3.2
Usage Guidelines
Note
BFD is supported on IPv4 directly connected eBGP peers.
HR-490
Bidirectional Forwarding Detection Commands on Cisco IOS XR Software bfd fast-detect
Use the bfd fast-detect command to provide protocol- and media-independent BFD for short duration detection of failures in the path between adjacent forwarding engines, including the interfaces and data links. The fast detection of failures allows BGP to quickly react to failures and compute and advertise alternate routes to avoid the failed link or peer. BFD must be configured on directly connected neighbors for a BFD session to be established between the neighbors. When MPLS-TE tunnels are protected by backup tunnels, BFD failure triggers fast reroute on affected tunnels.
Examples
The following example shows how to enable BFD :

RP/0/RP0/CPU0:router(config)# router bgp 65000 RP/0/RP0/CPU0:router(config-bgp)# neighbor 192.168.70.24 RP/0/RP0/CPU0:router(config-bgp)# remote-as 2 RP/0/RP0/CPU0:router(config-bgp)# bfd fast-detect
Related Commands
Command bfd minimum-interval (BGP) bfd multiplier (BGP) show bfd
Description Sets the BFD interval for BGP. Sets the BFD multiplier for BGP. Displays BFD information.
HR-491
Bidirectional Forwarding Detection Commands on Cisco IOS XR Software bfd minimum-interval (BGP)
bfd minimum-interval (BGP)

To set the bidirectional forwarding detection (BFD) interval for BGP, use the bfd minimum-interval command in in the appropriate configuration mode. To return the router to the default setting, use the no form of this command. bfd minimum-interval milliseconds no bfd minimum-interval
Syntax Description
milliseconds
Interval between sending BFD packets to the neighbor. The ranges are:

BGP250 to 60000 milliseconds. IS-IS 20 to 5000 milliseconds. MPLS-TE15 to 200 milliseconds. OSPF10 to 5000 milliseconds.
Defaults
BGP interval: TBD millisecond IS-IS interval: TBD millisecond MPLS-TE interval: 15 millisecond OSPF interval: TBD millisecond
Command Modes
BGP configuration mode
Router configuration
IS-IS configuration mode
MPLS-TE configuration
OSPF configuration mode
Command History
Release Release 3.2
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. If the minimum interval is changed using the bfd minimum-interval command, the new parameter updates all existing BFD sessions for the protocol (BGP, IS-IS, MPLS-TE, or OSPF).
HR-492
Bidirectional Forwarding Detection Commands on Cisco IOS XR Software bfd minimum-interval (BGP)
Examples
The following example shows how to set the BFD minimum interval:
RP/0/RP0/CPU0:router(config)# router bgp 6500 RP/0/RP0/CPU0:router(config-bgp)# bfd minimum-interval 10
Related Commands
Command bfd fast-detect bfd multiplier (BGP) show bfd
Description Enables BFD for communication failure detection. Sets the BFD multiplier for BGP. Displays BFD information.
HR-493
Bidirectional Forwarding Detection Commands on Cisco IOS XR Software bfd multiplier (BGP)
bfd multiplier (BGP)

To set the bidirectional forwarding detection (BFD) multiplier for BGP, use the bfd multiplier command in the appropriate configuration mode. To return the router to the default setting, use the no form of this command. bfd multiplier multiplier no bfd multiplier
Syntax Description
multiplier
Number of times a packets is missed before BFD declares the neighbor down. The ranges are: BGP1 to 16. IS-IS1 to 16. MPLS-TE2 to 10. OSPF1 to 16.
Defaults
multiplier: 3
Command Modes
BGP configuration mode
Router configuration
IS-IS configuration mode
MPLS-TE configuration
OSPF configuration mode
Command History
Release Release 3.2
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. If the multiplier is changed using the bfd multiplier command, the new parameter is used to update all existing BFD sessions for the protocol (BGP, IS-IS, MPLS-TE, or OSPF).
HR-494
Bidirectional Forwarding Detection Commands on Cisco IOS XR Software bfd multiplier (BGP)
Examples
The following example shows how to set the BFD multiplier:

RP/0/RP0/CPU0:router(config)# router bgp 65000 RP/0/RP0/CPU0:router(config-bgp)# bfd multiplier 2
Related Commands
Command bfd fast-detect bfd minimum-interval (BGP) show bfd
Description Enables BFD for communication failure detection. Sets the BFD interval for BGP. Displays BFD information.
HR-495
Bidirectional Forwarding Detection Commands on Cisco IOS XR Software clear bfd counters
clear bfd counters

To clear Bidirectional Forwarding Detection (BFD) counters, use the clear bfd counters command in EXEC mode. clear bfd counters packet [interface type instance] location node-id
Syntax Description
packet interface type instance
(Optional) Clears BFD packets counters. (Optional) Clears BFD counters from the specified interface. (Optional) Interface type. For more information, use the question mark (?) online help function. (Optional) Either a physical interface instance or a virtual interface instance:
is always 0.
In references to a Management Ethernet interface located on a Route Processor card, the physical slot number is alphanumeric (RP0 or RP1) and the module is CPU0. Example: interface MgmtEth0/RP1/CPU0/0. Virtual interface instance. Number range varies depending on interface type.
For more information about the syntax for the router, use the question mark (?) online help function. location node-id (Optional) Clears BFD counters from the specified location. The node-id argument is entered in the rack/slot/module notation.
Command Modes
EXEC
Command History
Release Release 3.2
Usage Guidelines
HR-496
Bidirectional Forwarding Detection Commands on Cisco IOS XR Software clear bfd counters
Examples
The following is sample output from the clear bfd counters packet command.
RP/0/RP0/CPU0:router# clear bfd counters packet
Related Commands
Command bfd fast-detect
Description Enables BFD for communication failure detection.
bfd minimum-interval Sets the BFD interval for BGP. (BGP) bfd multiplier (BGP) show bfd Sets the BFD multiplier for BGP. Displays BFD information.
HR-497
Bidirectional Forwarding Detection Commands on Cisco IOS XR Software show bfd
show bfd
To display Bidirectional Forwarding Detection (BFD) information, use the show bfd command in EXEC mode. show bfd [ipv4 | all] [session [detail] interface type instance [destination ip-address]] [[agent] location node-id]
Syntax Description
ipv4 all session detail interface type instance
(Optional) Specifies IP Version 4 address prefixes. (Optional) Specifies prefixes for all subaddress families. (Optional) Specifies BFD sessions. (Optional) Specifies detailed session information, including statistics and number of state transitions. (Optional) Specifies an interface. (Optional) Interface type. For more information, use the question mark (?) online help function. (Optional) Either a physical interface instance or a virtual interface instance:
is always 0.
For more information about the syntax for the router, use the question mark (?) online help function. destination ip-address agent location node-id (Optional) Displays the BFD session destined for the specified IP address. (Optional) Displays information directly from the agent. (Optional) Displays BFD sessions hosted from the specified location. The node-id argument is entered in the rack/slot/module notation.
Command Modes
EXEC
Command History
Release Release 3.2
HR-498
Bidirectional Forwarding Detection Commands on Cisco IOS XR Software show bfd
Usage Guidelines
Examples
The following is sample output from the show bfd command.

RP/0/RP0/CPU0:router# show bfd IPV4 Sessions Up: 0, Down: 0, Total: 0

Table 102 show bfd Field Descriptions
Field IPV4 Sessions Up Down Total
Description Number of active BFD sessions. Number of down BFD sessions. Total number of BFD sessions.
Related Commands
Command bfd fast-detect bfd minimum-interval (BGP) bfd multiplier (BGP)
Description Enables BFD for communication failure detection. Sets the BFD interval for BGP. Sets the BFD multiplier for BGP.
HR-499
Bidirectional Forwarding Detection Commands on Cisco IOS XR Software show bfd client
show bfd client

To display Bidirectional Forwarding Detection (BFD) client information, use the show bfd client command in EXEC mode. show bfd client [detail]
Syntax Description
detail
(Optional) Specifies detailed client information including number of sessions and client reconnects.
Command Modes
EXEC
Command History
Release Release 3.2
Usage Guidelines
Examples
The following is sample output from the show bfd client command with3.
RP/0/RP0/CPU0:router# show bfd client Name --------------bgp isis isis Node ---------0/RP1/CPU0 0/RP1/CPU0 0/RP1/CPU0 Num sessions -------------0 0 0

Table 103 show bfd client Field Descriptions
Field Name Node Num sessions
Description Name of the BFD client. Location of the BFD client. Number of active sessions for the BFD client.
HR-500
Bidirectional Forwarding Detection Commands on Cisco IOS XR Software show bfd client
Related Commands
Command bfd fast-detect bfd minimum-interval (BGP) bfd multiplier (BGP) show bfd
Description Enables BFD for communication failure detection. Sets the BFD interval for BGP. Sets the BFD multiplier for BGP. Displays BFD information.
HR-501
Bidirectional Forwarding Detection Commands on Cisco IOS XR Software show bfd counters
show bfd counters

To display Bidirectional Forwarding Detection (BFD) counter information, use the show bfd counters command in EXEC mode. show bfd counters packet [interface type instance] location node-id
Syntax Description
packet interface type instance
(Optional) Displays BFD packets counters. (Optional) Specifies BFD counters from the specified interface. (Optional) Interface type. For more information, use the question mark (?) online help function. (Optional) Either a physical interface instance or a virtual interface instance:
is always 0.
For more information about the syntax for the router, use the question mark (?) online help function. location node-id (Optional) Displays BFD counters from the specified location. The node-id argument is entered in the rack/slot/module notation.
Command Modes
EXEC
Command History
Release Release 3.2
Usage Guidelines
HR-502
Examples
The following is sample output from the show bfd counters packet command.
RP/0/RP0/CPU0:router# show bfd counters packet

Table 104 show bfd counters packet Field Descriptions
Field
Description
Related Commands
Command bfd fast-detect bfd minimum-interval (BGP) bfd multiplier (BGP) show bfd
Description Enables BFD for communication failure detection. Sets the BFD interval for BGP. Sets the BFD multiplier for BGP. Displays BFD information.
HR-503
HR-504
SPA Interface Processor and Shared Port Adapter Commands on Cisco IOS XR Software
This module describes the Cisco IOS XR commands which are specific to SPA interface processors (SIPs) and shared port adapters (SPAs). For general configuration and troubleshooting commands, refer to the Ethernet Switch and Server Platform Commands on Cisco IOS XR Software or Packet-over-SONET User Interface and SONET Layer 1 Commands on Cisco IOS XR Software modules.hw-module subslot power-cycle To power-cycle the subslot and reload Cisco IOS XR software, use the hw-module subslot power-cycle command in EXEC mode. hw-module subslot subslot-id power-cycle
Syntax Description
subslot-id
Specifies the subslot to be power-cycled. The subslot-id argument is entered in the rack/slot/subslot notation.
Defaults
Command Modes
EXEC
Command History
Release Release 3.2
Modification This command was introduced on the Cisco CRS-1 and the Cisco 12000 Series router.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. This command power-cycles the subslot (including the installed SPA).
HR-505
SPA Interface Processor and Shared Port Adapter Commands on Cisco IOS XR Software
Examples
The following example shows how to power-cycle the SPA in slot 2, subslot 1:
RP/0/RP1/CPU0:router# hw-module subslot 0/2/1 power-cycle
Related Commands
Command hw-module subslot reload
Description Reloads the Cisco IOS XR software on a specific SPA module.
HR-506
SPA Interface Processor and Shared Port Adapter Commands on Cisco IOS XR Software hw-module subslot reload
hw-module subslot reload

To reload Cisco IOS XR software on a specific subslot, use the hw-module subslot reload command in EXEC mode. hw-module subslot subslot-id reload
Syntax Description
subslot-id
Specifies the subslot to be restarted. The subslot-id argument is entered in the rack/slot/subslot notation.
Defaults
Command Modes
EXEC
Command History
Release Release 3.2
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. This command reloads Cisco IOS XR software on the specified SPA and restarts the SPA interfaces. The SPA reloads with the current running configuration and active software set for the SPA.
Examples
The following example shows how to restart the SPA in slot 2, subslot 1:
RP/0/RP1/CPU0:GRP-7-TOP# hw-module subslot 0/2/1 reload
Related Commands
Command hw-module subslot power-cycle
Description Power-cycles a SPA module.
HR-507
SPA Interface Processor and Shared Port Adapter Commands on Cisco IOS XR Software hw-module subslot shutdown
hw-module subslot shutdown

To administratively shut down a specified SPA, use the hw-module subslot shutdown command in global configuration mode. To return a SPA to the up state, use the no form of this command. hw-module subslot subslot-id shutdown [powered | unpowered] no hw-module subslot subslot-id shutdown
Syntax Description
subslot-id powered unpowered
Specifies the subslot to be shut down. The subslot-id argument is entered in the rack/slot/subslot notation. (Optional) Retains power to the specified subslot. (Optional) Powers down completely the specified subslot.
Defaults
Shutdown is powered if no option is specified.
Command Modes
Command History
Release Release 3.2
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. This command administratively shuts down the SPA in the specified subslot. Subslots that are shut down still have power, but cannot load or operate Cisco IOS XR software.
Examples
The following example shows how to shut down the SPA in subslot 1 of the SIP in slot 2:
RP/0/RP1/CPU0:GRP-7-TOP(config)# hw-module subslot 0/2/1 shutdown powered
Related Commands
Command shutdown
Description Disables an interface (forces an interface to be administratively down).
HR-508
SPA Interface Processor and Shared Port Adapter Commands on Cisco IOS XR Software show fpd package
show fpd package

To display which field-programmable device (FPD) image package is needed for the router to properly support the modules for the running Cisco IOS XR software release, use the show fpd package command. show fpd package
Syntax Description
Defaults
Command Modes
Admin EXEC
Command History
Release Release 3.2
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. Use the show fpd package command to determine which FPD image should be running on the module installed in your system.
Examples
The following example shows how to display FPD image information:

RP/0/0/CPU0:Router(admin)# show fpd package =============================== ================================================ Field Programmable Device Package ================================================ SW Min Req Card Type FPD Description Type Subtype Version HW Vers ==================== ========================== ==== ======= =========== ======= SPA-OC192RPR-XFP SPA FPGA swv1.2 spa fpga 1.2 0.0 -------------------------------------------------------------------------------SPA-OC192POS-XFP SPA FPGA swv1.2 spa fpga 1.2 0.0 SPA FPGA swv1.2 hwv2 spa fpga 1.2 2.0 -------------------------------------------------------------------------------SPA-10X1GE SPA FPGA swv1.6 spa fpga 1.6 0.0 -------------------------------------------------------------------------------SPA-5X1GE SPA FPGA swv1.6 spa fpga 1.6 0.0 -------------------------------------------------------------------------------SPA-1XTENGE-XFP SPA FPGA swv1.6 spa fpga 1.6 0.0 --------------------------------------------------------------------------------
HR-509
SPA Interface Processor and Shared Port Adapter Commands on Cisco IOS XR Software show fpd package

Table 105 show fpd package Field Descriptions
Field Card Type FPD Description Type Subtype SW Version Min Req HW Vers
Description Module part number. Description of all FPD images available for the SPA. Hardware type can be: spashared port adapter; lcline card. FPD type can be: fabldrfabric downloader; fpgafield-programmable gate array; rommonread-only memory monitor FPD software version required for the associated module running the current Cisco IOS XR software. Minimum required hardware version for the associated FPD image.
Related Commands
Command show hw-module fpd upgrade hw-module fpd
Description Displays the FPD compatibility for all moduless or a specific module. Manually upgrades the current FPD image package on a module.
HR-510
SPA Interface Processor and Shared Port Adapter Commands on Cisco IOS XR Software show hw-module fpd
show hw-module fpd

To display field-programmable device (FPD) compatibility for all modules or a specific module, use the show hw-module fpd command. show hw-module fpd location [all | node-id] location all node-id Specifies the location of the module. Upgrades the FPD image of all modules in the router. Location of the module in the rack/slot/module notation.
Syntax Description
Defaults
Command Modes
EXEC
Command History
Release Release 3.2
Usage Guidelines
Examples
The following example shows how to display FPD compatibility for a specific module. Because the current FPGA image needs to be upgraded, a note is displayed at the end of the output:
RP/0/0/CPU0:Router# show hw-module fpd location 0/3/1 =============================== ================================================ Existing Field Programmable Devices ================================================ Current SW HW Upg/ Location Card Type Type Subtype Inst Version Version Dng? ============ ======================== ==== ======= ==== =========== ======= ==== 0/3/1 SPA-1XTENGE-XFP spa fpga 1 0.17 2.0 Yes -------------------------------------------------------------------------------NOTES: 1. One or more FPD needs an upgrade or a downgrade. This can be accomplished using the "admin upgrade hw-module fpd" CLI.
HR-511
SPA Interface Processor and Shared Port Adapter Commands on Cisco IOS XR Software show hw-module fpd

Table 106 show hw-module fpd Field Descriptions
Field Location Card Type Type Subtype Inst Current SW Version Min Req HW Vers Upg/Dng
Description Location of the module in the rack/slot/module notation. Module part number. Hardware type can be: spashared port adapter; lcline card. FPD type can be: fabldrfabric downloader; fpgafield-programmable gate array; rommonread-only memory monitor InstanceA unique identifier that is used by the FPD process to register an FPD. Currently running FPD image version. Minimum required hardware version for the associated FPD image. Specifies whether an FPD upgrade or downgrade is required. A downgrade will be required in rare cases when the version of the FPD image has a higher major revision than the version of the FPD image in the current Cisco IOS XR software package.
Related Commands
Command show fpd package upgrade hw-module fpd
Description Displays which FPD image package is needed for the router to properly support the modules for the running Cisco IOS XR software release. Manually upgrades the current FPD image package on a module.
HR-512
SPA Interface Processor and Shared Port Adapter Commands on Cisco IOS XR Software show hw-module subslot brief
show hw-module subslot brief

To display summary diagnostic information about internal hardware devices for a SPA, use the show hw-module subslot brief command in EXEC mode. show hw-module subslot [node-id] brief device device-index device-subindex
Syntax Description
node-id
(Optional) Specifies the location for which to display the specified information. The node-id argument is entered in the rack/slot/module notation. Specifies the internal hardware device for which to display the specified information. Valid devices include:

device
analog-digital-converterDisplays analog-to-digital converter information. c2wDisplays Cisco-to-wire bus device information. fpgaDisplays SPA field-programmable gate array information. framerDisplays SONET framer information. (Not applicable to Ethernet SPAs.) l2-tcamDisplays SPA Layer 2 ternary content addressable memory information. (Not applicable to POS SPAs.) macDisplays SPA MAC information. (Not applicable to POS SPAs.) pluggable-opticsDisplays pluggable-optics module information. power-marginingDisplays power-margining device information. sdccDisplays section data communications channel device information. (Not applicable to Ethernet SPAs.) serdesDisplays SPA serializer/deserializer information. spi4.2Displays system packet interface level 4.2 bus device information. temperature-sensorDisplays temperature sensor information.
device-index device-subindex
Index of the specific device if there are multiple devices of the same type. Subindex of the specific device if there are multiple devices of the same device index.
Defaults
Command Modes
EXEC
Command History
Release Release 3.2
HR-513
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. Enter the command show platform to display the nodes on the router. You can enter a partially qualified location specifier by using the wildcard (*) character. For example, 0/1/* would display information for all modules on slot 1 in rack 0. Use the show hw-module subslot brief command to obtain summary diagnostic information about an interface on the SPA.
Examples
The following is sample output for the show hw-module subslot brief command:
RP/0/RP1/CPU0:GRP-7-TOP# show hw-module subslot brief BAY 0 brief info: ------------------SPA inserted: YES SPA type: 1xOC192 POS/RPR HHSPA with XFP SPA operational state: READY SPA cfg admin up: YES BAY 1 brief info: ------------------SPA inserted: YES SPA type: 1xOC192 POS/RPR FHSPA SPA operational state: READY SPA cfg admin up: YES

Table 107 show hw-module subslot brief Field Descriptions
Field SPA inserted SPA type
Description Indicates if a SPA is currently detected in the subslot. Description of SPA including the technology type, number of ports, height of SPA (HHSPAsingle height, FHSPAdouble height), and optics type. Current state of the SPA module. Configured state of the SPA: YESthe SPA is not shut down, NOthe SPA is shut down.
SPA operational state SPA cfg admin
The following is sample output for the show hw-module subslot brief command with the c2w option:
RP/0/RP1/CPU0:ios# show hw-module subslot 0/2/cpu0 brief c2w SPA device c2w index 0 subindex 0 info: Auxiliary C2W (0x0803bfbc), name AUX C2W (busywait), state 4 SPA device c2w index 0 subindex 0 info: Auxiliary C2W (0x080638c4), name AUX C2W (busywait), state 4
HR-514
Related Commands
Command show controllers
Description Displays the controller type and other information.
HR-515
SPA Interface Processor and Shared Port Adapter Commands on Cisco IOS XR Software show hw-module subslot config
show hw-module subslot config

To display information related to configuration of the specified internal hardware device on a SPA, use the show hw-module subslot config command in EXEC mode. show hw-module subslot [node-id] config device device-index device-subindex
Syntax Description
node-id

device
Defaults
Command Modes
EXEC
Command History
Release Release 3.2
HR-516
SPA Interface Processor and Shared Port Adapter Commands on Cisco IOS XR Software show hw-module subslot config
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. Enter the command show platform to display the nodes on the router. You can also enter a partially qualified location specifier by using the wildcard (*) character. For example, 0/1/* would display information for all modules on slot 1 in rack 0. Use the show hw-module subslot config command to obtain diagnostic information about the configuration of an interface on the SPA.
Examples
The following is sample output for the show hw-module subslot config command:
RP/0/RP1/CPU0:ios# show hw-module subslot 0/2/cpu0 config BAY 0 config info: ------------------SPA inserted: YES SPA cfg admin up: YES SPA cfg power up: YES BAY 1 config info: ------------------SPA inserted: YES SPA cfg admin up: YES SPA cfg power up: YES

Table 108 show hw-module subslot config Field Descriptions
Field SPA inserted SPA cfg admin up SPA cfg power up
Description Indicates if a SPA is currently detected in the subslot. Configured state of the SPA: YESthe SPA is not shut down, NOthe SPA is shut down. Indicates whether the subslot is currently configured as powered or not.
Related Commands
HR-517
SPA Interface Processor and Shared Port Adapter Commands on Cisco IOS XR Software show hw-module subslot counters
show hw-module subslot counters

To display statistics related to the processing of internal hardware devices for a SPA, use the show hw-module subslot counters command in EXEC mode. show hw-module subslot [node-id] counters device device-index device-subindex
Syntax Description
node-id

device
Defaults
Command Modes
EXEC
Command History
Release Release 3.2
HR-518
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. Enter the command show platform to display the nodes on the router. You can also enter a partially qualified location specifier by using the wildcard (*) character. For example, 0/1/* would display information for all modules on slot 1 in rack 0. Use the show hw-module subslot counters command to display statistics related to the processing by the specified internal hardware device.
Examples
The following is sample output for the show hw-module subslot counters command:
RP/0/RP1/CPU0:ios# show hw-module subslot 0/2/cpu0 counters BAY 0 counts info: ------------------SPA inserted: YES SPA type: 5xGE SPA SPA operational state: READY SPA insertion time: Fri Nov 19 01:49:07 2004 SPA last time ready: Fri Nov 19 01:49:42 2004 SPA uptime [HH:MM:SS]: 49:49:29 BAY 1 counts info: ------------------SPA inserted: YES SPA type: 1xOC192 POS/RPR HHSPA with XFP SPA operational state: READY SPA insertion time: Fri Nov 19 01:49:08 2004 SPA last time ready: Fri Nov 19 01:49:35 2004 SPA uptime [HH:MM:SS]: 49:49:36

Table 109 show hw-module subslot counters Field Descriptions
Field SPA inserted SPA type
Description Indicates if a SPA is currently detected in the subslot. Description of SPA including the technology type, number of ports, height of SPA (HHSPAsingle height, FHSPAdouble height), and optics type. Current state of the SPA module. Time the SPA module was last physically inserted or power-cycled. Time the SPA module last changed state to up or ready (the last time the module was loaded or reloaded). The time in service or amount of time since the module was last out of service due to a reload, power-cycle, or configuration event.
SPA operational state SPA insertion time SPA last time ready SPA uptime
The following is sample output for the show hw-module subslot counters command with the framer option:
HR-519
RP/0/RP1/CPU0:ios# show hw-module subslot counters framer SPA device framer index 0 subindex 0 info: Milan Framer counters: STREAM 0 Rx Bytes (48-bit) (#0x381fa078-0x883c): 163857232569448 Rx Good Bytes (48-bit) (#0x381fa080-0x8840): 1964924 Rx Good Packets (48-bit) (#0x381fa040-0x8820): 26234 Tx Byte Cnt Reg (48-bit) (#0x381fe070-0xa838): 9375380 Tx Good Bytes Cnt Reg (48-bit) (#0x381fe068-0xa834): 8909442 Tx Transmitted Packet Cnt Reg (48-bit) (#0x381fe040-0xa820): 114692
HR-520
SPA Interface Processor and Shared Port Adapter Commands on Cisco IOS XR Software show hw-module subslot errors
show hw-module subslot errors

To display error information about internal hardware devices for a SPA, use the show hw-module subslot errors command in EXEC mode. show hw-module subslot [node-id] errors device device-index device-subindex
Syntax Description
node-id

device
Defaults
Command Modes
EXEC
Command History
Release Release 3.2
HR-521
SPA Interface Processor and Shared Port Adapter Commands on Cisco IOS XR Software show hw-module subslot errors
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. Enter the command show platform to display the nodes on the router. You can also enter a partially qualified location specifier by using the wildcard (*) character. For example, 0/1/* would display information for all modules on slot 1 in rack 0. Use the show hw-module subslot errors command to display error information related to the specified internal hardware device on a SPA.
Examples
The following is sample output for the show hw-module subslot errors command with the pluggable-optics option:
RP/0/RP1/CPU0:ios# show hw-module subslot 0/2/cpu0 errors pluggable-optics SPA device pluggable-optics index 0 subindex 0 info: Phased Initialization Phase Reached: 4 Phase Exit Code: 0 Phase Read Offset: 256 Socket Verification Not supported SPA device pluggable-optics index 0 subindex 0 info: Phased Initialization Phase Reached: 2 Phase Exit Code: 3 Phase Read Offset: 256 Socket Verification Not supported
Related Commands
HR-522
SPA Interface Processor and Shared Port Adapter Commands on Cisco IOS XR Software show hw-module subslot registers
show hw-module subslot registers

To display register information about internal hardware devices for a SPA, use the show hw-module subslot registers command in EXEC mode. show hw-module subslot [node-id] registers device device-index device-subindex
Syntax Description
node-id

device
Defaults
Command Modes
EXEC
Command History
Release Release 3.2
HR-523
SPA Interface Processor and Shared Port Adapter Commands on Cisco IOS XR Software show hw-module subslot registers
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. Enter the command show platform to display the nodes on the router. You can also enter a partially qualified location specifier by using the wildcard (*) character. For example, 0/1/* would display information for all modules on slot 1 in rack 0. Use the show hw-module subslot registers command to display register information for the specified internal hardware device on the SPA.
Examples
The following example shows sample output for the show hw-module subslot registers command:
RP/0/RP1/CPU0:ios# show hw-module subslot 0/2/cpu0 registers BAY 0 registers info: -----------------------SPA hardware ID : 0x1 SPA SW FPGA rev.: 0x10 BAY 1 registers info: -----------------------SPA hardware ID : 0x90000000 SPA SW FPGA rev.: 0xD
Related Commands
HR-524
SPA Interface Processor and Shared Port Adapter Commands on Cisco IOS XR Software show hw-module subslot status
show hw-module subslot status

To display status information about internal hardware devices for a SPA, use the show hw-module subslot status command in EXEC mode. show hw-module subslot [node-id] status device device-index device-subindex
Syntax Description
node-id

device
Defaults
Command Modes
EXEC
Command History
Release Release 3.2
HR-525
SPA Interface Processor and Shared Port Adapter Commands on Cisco IOS XR Software show hw-module subslot status
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. Enter the command show platform to display the nodes on the router. You can also enter a partially qualified location specifier by using the wildcard (*) character. For example, 0/1/* would display information for all modules on slot 1 in rack 0. Use the show hw-module subslot status command to obtain status information about an interface on the SPA.
Examples
The following example shows sample output for the show hw-module subslot status command with the temperature-sensor option:
RP/0/RP1/CPU0:ios# show hw-module subslot 0/2/cpu0 status temperature-sensor SPA device temperature-sensor index 0 subindex 0 info: DS1631 (0x0803c2e4) device status: temperature = 0x1c80 (28.5 degree C)
SPA device temperature-sensor index 0 subindex 0 info: DS1631 (0x08063bec) device status: temperature = 0x1e00 (30.0 degree C)
Related Commands
HR-526
SPA Interface Processor and Shared Port Adapter Commands on Cisco IOS XR Software upgrade hw-module fpd
upgrade hw-module fpd

To manually upgrade the current field-programmable device (FPD) image package on a module, use the upgrade hw-module fpd command in admin EXEC mode. upgrade hw-module fpd {all | fabldr | fpga | rommon} [force] location [all | node-id]
Syntax Description
all fabldr fpga rommon force
Upgrades all FPD images on the selected module. Upgrades the fabric-downloader image on the module. Upgrades the field-programmable gate array (FPGA) image(s) on the module. Upgrades the rommon on the module. Forces the update of the indicated FPD image package on the SPA that meet the minimal version requirements. Without this option, the manual upgrade will only upgrade incompatible FPD images. Specifies the location of the module. Upgrades the FPD image of all modules in the router. Location of the module in the rack/slot/module notation.
location all node-id
Defaults
Command Modes
Admin EXEC
Command History
Release Release 3.2
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide. During the upgrade procedure, the module needs to be offline (shutdown but powered).
Examples
The following example shows how to upgrade the FPGA on a SPA and the output generated:
RP/0/0/CPU0:Router(admin)# upgrade hw-module fpd fpga force location 0/3/0 LC/0/3/CPU0:Feb 12 12:00:22.157 : spa_192_jacket[188]: %L2-SPA-5-STATE_CHANGE : SPA in bay 0 exiting ready state LC/0/3/CPU0:Feb 12 12:00:40.172 : spa_192_jacket[188]: %L2-SPA_192-6-UPGRADE_FPGA : Prepared SPA in bay 0 for FPGA upgrade, spa_type 0x44e LC/0/3/CPU0:Feb 12 12:00:40.348 : spa_192_jacket[188]: %L2-SPA_192-6-UPGRADE_FPGA : Writing FPGA image to SPA bay 0...
HR-527
SPA Interface Processor and Shared Port Adapter Commands on Cisco IOS XR Software upgrade hw-module fpd
LC/0/3/CPU0:Feb 12 12:01:04.326 : spa_192_jacket[188]: %L2-SPA_192-6-UPGRADE_FPGA : Programmed SPA in bay 0 FPGA, spa_type 0x44e SuccesLC/0/3/CPU0:Feb 12 12:01:04.328 : spa_192_jacket[188]: %L2-SPA_192-6-UPGRADE_FPGA : Launched SPA in bay 0 after FPGA upgrade, spa_type 0x44e sLC/0/3/CPU0:Feb 12 12:01:04.329 : spa_192_jacket[188]: %L2-SPA-5-OIR_INSERTED : SPA discovered in bay 0 fully upgraded spa fpga instance 0 on location 0/3/0 LC/0/3/CPU0:Feb 12 12:01:15.099 : spa_192_jacket[188]: %L2-SPA-5-STATE_CHANGE : SPA in bay 0 entering ready state LC/0/3/CPU0:Feb 12 12:01:18.549 : spa_192_jacket[188]: %SCC-2-PROTO_HW : Module (0/3/0) is a registered proto-type for Cisco Lab use only, and not certified for live network operation.
Related Commands
Command show fpd package show hw-module fpd
Description Displays which FPD image package is needed for the router to properly support the modules for the running Cisco IOS XR software release. Displays the FPD compatibility for all modules or a specific module.
HR-528
INDEX
clear mac-accounting command clear mbus location command controller command
HR-301 HR-181 HR-182 HR-153 HR-219 HR-300
HR IR MCR MPR QR RR SMR SR
Cisco IOS XR Interface and Hardware Component Command Reference Cisco IOS XR IP Addresses and Services Command Reference Cisco IOS XR Multicast Command Reference Cisco IOS XR MPLS Command Reference Cisco IOS XR Modular Quality of Service Command Reference Cisco IOS XR Routing Command Reference Cisco IOS XR System Management Command Reference Cisco IOS XR System Security Command Reference
clock source (SONET) command
controllers fabric plane shutdown command crc command

HR-303
controllers fabric statistics collection command
A
ais-shut (SONET) command aps group command
HR-372 HR-373 HR-296 HR-297
D
dampening command delay trigger command diag command
HR-220 HR-276 HR-305
ais-shut (SONET path) command authenticate (PGP) command
E C
ce tftp server enable command channel local command channel remote command
HR-375 HR-377 HR-18 HR-218
encapsulation (interface) command encapsulation hdlc command encapsulation ppp command

HR-15 HR-342
HR-278
clear card-message command
clear controller backplane ethernet location statistics command HR-152 clear controller egressq queue all location command HR-20 clear controller egressq queue location command clear controller egressq statistics location command HR-21 clear controller fabricq counters all command clear controller fabric statistics command clear controller ingressq command clear counters sonet command clear fabricq counters command clear interface command
HR-274 HR-178 HR-22 HR-177 HR-176 HR-19
F
facility-alarm contacts command flow-control command force command
HR-379 HR-306 HR-154 HR-226
framing (SONET) command full-duplex command

HR-24
H
half-duplex command
HR-26 HR-28, HR-30 HR-228 HR-231
clear controller pse statistics command

HR-298
hardware-module command
clear fabricq counters all command
HR-180
hw-module node power command
HR-179
hw-module node shutdown command
HR-529
Index
I
interface (PFI) command
HR-280
ppp chap hostname command ppp chap password command ppp chap refuse command ppp max-bad-auth command
HR-345 HR-347
HR-349 HR-351 HR-357
K
keepalive (chdlc) command
HR-14
ppp max-terminate command ppp pap refuse command
HR-359 HR-361
ppp pap sent-username password command ppp timeout authentication command

HR-363
L
led mode command location command lockout command
HR-233 HR-400 HR-381 HR-402 HR-307 HR-155
ppp timeout ncp command ppp timeout retry command
HR-365 HR-367
R
redundancy command
HR-235 HR-237 HR-239 HR-317 HR-319
logical-router command
loopback (SONET) command loopback (TenGigE) command
redundancy failover command redundancy reddrv command report (SONET) command report (SONET path) command revert command
HR-385
M
mac-accounting command manual command mtu command
HR-383 HR-135 HR-156 HR-32
mac-address mgmteth command memory slot command

HR-282
S
scrambling (SONET path) command set card-message command show aps agents command show aps command
HR-387 HR-391 HR-33 HR-389 HR-321
O
overhead (SONET) command
HR-308 HR-310
show aps group command
overhead (SONET path) command
show controller backplane ethernet local clients command HR-160 show controller backplane ethernet local command HR-158
P
packet-gap non-standard command pair command pos command
HR-403 HR-312 HR-157
show controllers backplane ethernet location clients command HR-165 show controllers backplane ethernet location command HR-162 show controllers command
HR-70 HR-38 HR-40 HR-43 HR-46
path (SONET) command

HR-314
show controllers cpuctrl clear command

HR-315 HR-343
pos transmit-delay command ppp authentication command
show controllers cpuctrl clients command show controllers cpuctrl devices command show controllers cpuctrl internal command
HR-530
Index
show controllers cpuctrl ports command show controllers fabric command

HR-183
HR-49 HR-52
show controllers switch stats command show controllers tengige show diag command
HR-172 HR-74
HR-168
show controllers cpuctrl summary command show controllers fabric connectivity command
show controllers xgxs command

HR-185 HR-187 HR-240
show controllers fabric fgid statistics command show controllers fabric plane command show controllers fabricq drop command show controllers fabricq errors command show controllers fabricq frfab command show controllers fabricq output command show controllers fabricq queue command show controllers fabricq tofab command show controllers fia eio link command show controllers fia location command show controllers fia rxslice command show controllers fia txslice command show controllers mgmteth command
HR-191 HR-195 HR-198 HR-200
show environment command show im dampening command show interfaces command show inventory command show led command
HR-252
HR-245 HR-248
show facility-alarm contacts command

HR-284 HR-286 HR-250
HR-203 HR-205
show controllers fabricq packet-stats command show controllers fabricq registers command
HR-54 HR-57
show led location command
HR-253 HR-268 HR-271 HR-170
HR-207 HR-210
show lpts pifib hardware entry show lpts pifib hardware usage show mac-accounting command show mbus command
HR-255
HR-213
show packet-memory command

HR-60
HR-146
show controllers fia register location command

HR-63 HR-68
show platform command show screddrv command show version command
HR-257 HR-261 HR-263 HR-293 HR-332
show controllers ingressq statistics command

HR-76
HR-215
shutdown (PFI) command signalling command speed command
shutdown (SONET) command

HR-394 HR-89 HR-91 HR-148
show controllers null interface command
HR-80
show controllers plim asic pla768 command show controllers plim asic pla command show controllers pos command
HR-322
show controllers plim asic pla768 eio command

HR-87
T
threshold (SONET) command timers (APS) command
HR-94 HR-395 HR-333 HR-335
show controllers pse egress gather command show controllers pse egress precam command show controllers pse eio links command show controllers pse ingress gather command show controllers pse ingress precam command show controllers pse ipc command show controllers pse mem command show controllers pse mp command
HR-108 HR-114 HR-117
HR-131 HR-94
threshold (SONET path) command
HR-100 HR-108
U
uneq-shut (SONET path) command unidirectional command upgrade command
HR-397 HR-265 HR-339
show controllers pse statistics command show controllers pse summary command show controllers sonet command
HR-328
HR-122 HR-128 HR-131
show controllers pse trace pmugger command show controllers switch ports command
HR-167
HR-531

Cisco

Uploaded by

Copyright:

Available Formats

Cisco

Uploaded by

Document Information

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Cisco

Uploaded by

Copyright:

Available Formats

Release 3.

2 Beta DraftCisco Highly Conf idential Information

Cisco IOS XR Interface and Hardware Component Command Reference

Text Part Number: OL-5563-03

Release 3.2 Beta DraftCisco Highly Conf idential Information

802.1Q VLAN Commands on Cisco IOS XR Software

Cisco IOS XR Interface and Hardware Component Command Reference

802.1Q VLAN Commands on Cisco IOS XR Software dot1q native vlan

dot1q native vlan

Release Release 3.0 Release 3.1

Modification This command was introduced on the Cisco CRS-1. No modification.

Cisco IOS XR Interface and Hardware Component Command Reference

802.1Q VLAN Commands on Cisco IOS XR Software dot1q native vlan

Command dot1q vlan

Description Assigns a VLAN ID to a subinterface, or changes the VLAN ID assigned to a subinterface.

Cisco IOS XR Interface and Hardware Component Command Reference

802.1Q VLAN Commands on Cisco IOS XR Software dot1q vlan

Release Release 3.0 Release 3.1

Cisco IOS XR Interface and Hardware Component Command Reference

802.1Q VLAN Commands on Cisco IOS XR Software dot1q vlan

Command dot1q native vlan

Description Defines the native VLAN ID associated with a VLAN trunk.

Cisco IOS XR Interface and Hardware Component Command Reference

802.1Q VLAN Commands on Cisco IOS XR Software interface (VLAN)

Release Release 3.0 Release 3.1

Cisco IOS XR Interface and Hardware Component Command Reference

802.1Q VLAN Commands on Cisco IOS XR Software interface (VLAN)

A subinterface does not pass traffic without an assigned VLAN ID.

Command dot1q native vlan dot1q vlan

Cisco IOS XR Interface and Hardware Component Command Reference

802.1Q VLAN Commands on Cisco IOS XR Software show vlan interface

show vlan interface

interface type instance location node-id

Release Release 3.0 Release 3.1

Cisco IOS XR Interface and Hardware Component Command Reference

802.1Q VLAN Commands on Cisco IOS XR Software show vlan interface

Table 1 describes the significant fields shown in the display

Field interface encapsulation vlan-id intf-state

Cisco IOS XR Interface and Hardware Component Command Reference

802.1Q VLAN Commands on Cisco IOS XR Software show vlan trunks

show vlan trunks

brief summary location node-id

interface type instance

Release Release 3.0 Release 3.1

Cisco IOS XR Interface and Hardware Component Command Reference

802.1Q VLAN Commands on Cisco IOS XR Software show vlan trunks

802.1Q VLANs: 3, 2 have VLAN Ids, No native VLAN.

Table 2 describes the significant fields shown in the display.

Table 3 describes the significant fields shown in the display.

Field interface encapsulations

Table 4 describes the significant fields shown in the display.

Cisco IOS XR Interface and Hardware Component Command Reference

802.1Q VLAN Commands on Cisco IOS XR Software show vlan trunks

show vlan trunks summary Field Descriptions

Field VLAN trunks Sub-interfaces

Command interface (VLAN)

Cisco IOS XR Interface and Hardware Component Command Reference

Release 3.2 Beta DraftCisco Highly Conf idential Information

cHDLC Commands on Cisco IOS XR Software

Cisco IOS XR Interface and Hardware Component Command Reference