Table Of Contents

Internal Ethernet Control Network Commands on Cisco IOS XR Software

clear controller backplane ethernet clients

clear controller backplane ethernet statistics

show controllers backplane ethernet brief

show controllers backplane ethernet clients

show controllers backplane ethernet detail

show controllers backplane ethernet multicast groups

show controllers switch ports

show controllers switch statistics

show spantree

Internal Ethernet Control Network Commands on Cisco IOS XR Software

---

This module describes the commands used to administer and configure internal control network commands on Cisco IOS XR software.

clear controller backplane ethernet clients

To clear the client applications of traffic sent and received over the control Ethernet, use the clear controller backplane ethernet clients command in administration EXEC mode.

clear controller backplane ethernet clients {client-id {statistics} | all} location node-id

Syntax Description

client-id	Client ID. Range is from 1 to 28.
all	Clears all client applications and their IDs.
statistics	Clears a list of client statistics.
location node-id	Clears the node or the controller information for a specified location.

Command Modes

Administration EXEC

Command History

Release	Modification
Release 3.3.0	This command was introduced on the Cisco CRS-1. This command replaces the clear controller backplane ethernet location statistics command.
Release 3.4.0	No modification.
Release 3.5.0	No modification.
Release 3.6.0	No modification.
Release 3.7.0	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, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Task ID

Task ID	Operations
system	execute

Examples

The following example shows how to clear all client statistics on the node at 0/1/1:

RP/0/RP0/CPU0:router# admin

RP/0/RP0/CPU0:router(admin)# clear controller backplane ethernet clients all statistics 
location 0/1/1

Related Commands

Command	Description
show controllers backplane ethernet clients	Displays information about client applications in a particular location.
show controllers backplane ethernet detail	Displays detailed information about the backplane interfaces in a particular location.

clear controller backplane ethernet statistics

To clear the aggregate statistics of traffic sent and received over the control Ethernet, use the clear controller backplane ethernet statistics command in administration EXEC mode.

clear controller backplane ethernet statistics location node-id

Syntax Description

location node-id

Clears the node or the controller information for a specified location.

Command Modes

Administration EXEC

Command History

Release	Modification
Release 3.3.0	This command was introduced on the Cisco CRS-1. This command replaces the clear controller backplane ethernet location statistics command.
Release 3.4.0	No modification.
Release 3.5.0	No modification.
Release 3.6.0	No modification.
Release 3.7.0	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, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Task ID

Task ID	Operations
system	execute

Examples

The following example shows how to clear all client statistics on the node at 0/1/1:

RP/0/RP0/CPU0:router# admin

RP/0/RP0/CPU0:router(admin)# clear controller backplane ethernet statistics location 0/1/1

Related Commands

Command	Description
show controllers backplane ethernet clients	Displays information about client applications in a particular location.
show controllers backplane ethernet detail	Displays detailed information about the backplane interfaces in a particular location.

show controllers backplane ethernet brief

To display brief information about backplane Ethernet interfaces in a particular location, use the show controllers backplane ethernet brief command in administration EXEC mode.

show controllers backplane ethernet brief location node-id

Syntax Description

location node-id

Displays brief backplane Ethernet information for a specified location.

Command Modes

Administration EXEC

Command History

Release	Modification
Release 3.3.0	This command was introduced on the Cisco CRS-1. This command replaces the show controllers backplane ethernet local brief and show controllers backplane ethernet location brief commands.
Release 3.4.0	No modification.
Release 3.5.0	No modification.
Release 3.6.0	No modification.
Release 3.7.0	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, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Task ID

Task ID	Operations
fabric	read
system	read

Examples

The following sample output is from the show controllers backplane ethernet brief command:

RP/0/RP0/CPU0:router# admin

RP/0/RP0/CPU0:router(admin)# show controllers backplane ethernet brief location 0/1/CPU0

FastEthernet0_1_CPU0 (local) is up, MTU 1514 bytes

    345166 packets input, 162769252 bytes

    147865 packets output, 22764013 bytes

Table 33 describes the significant fields shown in the display.

Table 33 show controllers backplane ethernet brief Field Descriptions 

Field	Description
MTU	Maximum packet size, in bytes, that a particular interface can handle.
packets input	Total number of packets received.
packets output	Total number of messages transmitted by the system.
bytes	Total number of bytes, including data and MAC encapsulation, in the error-free packets transmitted by the system.

Related Commands

Command	Description
show controllers backplane ethernet clients	Displays information about client applications in a particular location.
show controllers backplane ethernet detail	Displays detailed information about the backplane interfaces in a particular location.
show controllers backplane ethernet multicast groups	Displays information about backplane interfaces that are in multicast groups in a particular location.

show controllers backplane ethernet clients

To display information about client applications in a particular location, use the show controllers backplane ethernet clients command in administration EXEC mode.

show controllers backplane ethernet clients {client-id {statistics} | all} location node-id

Syntax Description

client-id	Client ID. Range is from 1 to 28.
statistics	Displays a list of client statistics for the specified client ID.
location node-id	Displays a list of all client applications and their IDs for a specified location.
all	Displays a list of all client applications and their IDs.

Command Modes

Administration EXEC

Command History

Release	Modification
Release 3.3.0	This command was introduced on the Cisco CRS-1. This command replaces the show controllers backplane ethernet local clients and show controllers backplane ethernet location clients commands.
Release 3.4.0	No modification.
Release 3.5.0	No modification.
Release 3.6.0	No modification.
Release 3.7.0	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, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Task ID

Task ID	Operations
fabric	read
system	read

Examples

The following sample output shows a list of client statistics for client ID 1:

RP/0/RP0/CPU0:router# admin

RP/0/RP0/CPU0:router(admin)# show controllers backplane ethernet clients 1 statistics 
location 0/1/CPU0

Client QNET, ES Client Id 1, PID 24600 running on FastEthernet0_1_CPU0

   LWM calls 1 open, 0 close, 0 close callback, 0 unblocks

   107065 packets input, 126686167 bytes

   107065 packets delivered,126043777 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

   0 (0 bytes) locking error discards

   0 packets waiting for client

   26513 packets output, 4800023 bytes, 0 could not be transmitted

   Packets output at high priority : 0

   Packets output at med  priority : 0

   Packets output at low  priority : 26513

   Out-of-packet write rejects (high) : 0

   Out-of-packet write rejects (med ) : 0

   Out-of-packet write rejects (low ) : 0

   DMA write rejects (high) : 0

   DMA write rejects (med ) : 0

   DMA write rejects (low ) : 0

Table 34 describes the significant fields shown in the display.

Table 34 show controllers backplane ethernet clients with statistics Keyword Field Descriptions 

Field	Description
Client	Client application name and ID, followed by backplane client application statistics.
PID	Process ID.

The following sample output shows detailed information about the backplane client applications:

RP/0/RP0/CPU0:router# admin

RP/0/RP0/CPU0:router(admin)# show controllers backplane ethernet clients all location 
0/1/CPU0

    Intf           Client ethernet         Client              Description

    Name              server id            Process Id

------------------------------------------------------------------------------

  FE0_1_CPU0               1                 24600          QNX network manager

                           2                 49216               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                 32804        Redundancy controller

                           9                     0          HFR Virtual console

                          10                 24599         HFR Virtual terminal

                          11                 24598        Control ethernet echo

                          12                     0       Control eth echo reply

                          13                     0  Card Configuration Protocol

                          14                     0          Reserved for Attach

                          15                     0           Chassis controller

                          16                     0            Forwarding driver

                          17                     0                    MBI hello

                          18                 32801       MBI Boot Server Source

                          19                     0                HSR ES client

                          20                     0  Packets for ethernet server

                          21                 81987         For Diag application

                          22                 24598                 QAD echo req

                          23                 24598               QAD echo reply

                          24                     0           Test application 1

                          25                     0           Test application 2

                          26                     0           Test application 1

                          27                     0      Test client out-of-band

                          28                     0                             

Table 35 describes the significant fields shown in the display.

Table 35 show controllers backplane ethernet clients with all Keyword Field Descriptions

Field	Description
Intf Name	Ethernet interface.
Client ethernet server id	Ethernet server for the specified interface.
Client process id	Client process running on the specified interface.
Description	Backplane client application.

Related Commands

Command	Description
show controllers backplane ethernet brief	Displays brief information about backplane Ethernet interfaces in a particular location.
show controllers backplane ethernet detail	Displays detailed information about the backplane interfaces in a particular location.
show controllers backplane ethernet multicast groups	Displays information about backplane interfaces that are in multicast groups in a particular location.

show controllers backplane ethernet detail

To display detailed information about the backplane interfaces in a particular location, use the show controllers backplane ethernet detail command in administration EXEC mode.

show controllers backplane ethernet detail location node-id

Syntax Description

location node-id

Displays detailed information about backplane interfaces for a specified location. Note Use the show platform command to obtain the node-id.

Command Modes

Administration EXEC

Command History

Release	Modification
Release 3.3.0	This command was introduced on the Cisco CRS-1. This command replaces the show controllers backplane ethernet local detail and show controllers backplane ethernet location detail commands.
Release 3.4.0	No modification.
Release 3.5.0	No modification.
Release 3.6.0	No modification.
Release 3.7.0	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, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Task ID

Task ID	Operations
fabric	read
system	read

Examples

The following sample output is from the show controllers backplane ethernet detail command:

RP/0/RP0/CPU0:router# admin

RP/0/RP0/CPU0:router(admin)# show controllers backplane ethernet detail location 0/1/CPU0

FastEthernet0_1_CPU0 is up

  Hardware is 10/100 Ethernet, H/W address is 5246.4800.0011

  Internet address is 10.0.0.17

  MTU 1514 bytes

  Encapsulation HFRIES (Platform Internal Ethernet Server)

  Mode : Full Duplex,  Rate : 100Mb/s

    167245 packets input, 136745473 bytes, 0 total input drops

    140015 driver inputs,139357 driver callbacks

    1 packets discarded (66 bytes) in garbage collection

    16 packets discarded (3752 bytes) in recv processing

    0 incomplete frames discarded

    0 packets discarded due to bad headers

    0 packets waiting for clients

    0 packets waiting on Rx

    Packets waiting at high priority : 0

    Packets waiting at med  priority : 0

    Packets waiting at low  priority : 0

    Received 5705 broadcast packets, 44702 multicast packets

    Input errors: 0 CRC, 0 overrun, 0 alignment, 0 length, 0 collision

    49017 packets output, 9145593 bytes, 0 total output drops

    Output 1 broadcast packets, 1 multicast packets

    Output errors: 0 underruns, 0 aborts, 0 loss of carrier

    Write rejects : 0

    Rx mem score 1000, alloc fails 0, free fails 0, retrieved buffers 0

    Rx mem threshold exceeded rejects 0, mutex lock fails 0

    Tx mem score 1, server held 0, alloc fails 0, free fails 0

    Tx mem threshold exceeded rejects 0, mutex lock fails 0, retrieved buffers 0

    Tx quota for high :  100  med  :  100  low  :  799

    Tx waits for high :    0  med  :    0  low  :    0

Table 36 describes the significant fields shown in the display.

Table 36 show controllers backplane ethernet detail Field Descriptions 

Field	Description
Hardware	Hardware type, followed by the hardware address.
Internet address	IP address of the interface.
MTU	Maximum packet size, in bytes, that a particular interface can handle.
Encapsulation	Encapsulation method assigned to the interface.
Mode	Operating mode of the interface, followed by transmission data.
packets input	Total number of packets received.
bytes	Total number of bytes, including data and MAC encapsulation, in the error-free packets received by the system.
total input drops	Total number of packets dropped from the input queue because the queue was full.
packets discarded in garbage collection	Number of packets and bytes discarded.
packets discarded in recv processing	Number of packets and bytes discarded.
Received broadcast packets and multicast packets	Total number of broadcast and multicast packets that are received by the interface.
Input errors	Number of errors that are received by the interface. Input errors occur when incoming cells are dropped or corrupted. The following input errors are listed: •CRC—Number of times that the checksum calculated from the data received did not match the checksum from the transmitted data. •overrun—Number 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. •alignment—Number of nonoctets received. •length—Number of times the interface prevented the ASIC from overrunning a maximum transmission unit (MTU) size. •collision—Number of messages retransmitted because of an Ethernet collision.
packets output	Total number of messages transmitted by the system.
bytes	Total number of bytes, including data and MAC encapsulation, in the error-free packets transmitted by the system.
total output drops	Total number of packets dropped from the output queue because the queue was full.
Output	Total number of broadcast and multicast packets that are transmitted by the interface.
Output errors	Number of errors that are transmitted on the interface. Output errors occur when outgoing cells are dropped or corrupted. The following types of output errors are listed: •underruns—Number of times that the far-end transmitter has been running faster than the near-end receiver can handle. •aborts—Number of illegal sequences of one bits on the interface. •loss of carrier—Number 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	Description
show controllers backplane ethernet brief	Displays brief information about backplane Ethernet interfaces in a particular location.
show controllers backplane ethernet clients	Displays information about client applications in a particular location.
show controllers backplane ethernet multicast groups	Displays information about backplane interfaces that are in multicast groups in a particular location.

show controllers backplane ethernet multicast groups

To display information about backplane interfaces that are in multicast groups in a particular location, use the show controllers backplane ethernet multicast groups command in administration EXEC mode.

show controllers backplane ethernet multicast groups location node-id

Syntax Description

location node-id

Displays backplane information for multicast groups for a specified location.

Command Modes

Administration EXEC

Command History

Release	Modification
Release 3.3.0	This command was introduced on the Cisco CRS-1. This command replaces the show controllers backplane ethernet local multicast groups and show controllers backplane ethernet location brief multicast groups commands.
Release 3.4.0	No modification.
Release 3.5.0	No modification.
Release 3.6.0	No modification.
Release 3.7.0	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, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Task ID

Task ID	Operations
fabric	read
system	read

Examples

The following sample output shows detailed information about the backplane interfaces:

RP/0/RP0/CPU0:router# admin

RP/0/RP0/CPU0:router(admin)# show controllers backplane ethernet multicast groups location 
0/1/CPU0

    Intf                    Multicast      Client registered for this address

    Name                     address                Id               Name

------------------------------------------------------------------------------

  FastEthernet0_1_CPU0    0100.0000.0064            2                 GSP

                          0100.0000.0065            2                 GSP

                          0100.0000.0066            2                 GSP

                          0100.0000.0068            2                 GSP

                          0100.0000.006a            2                 GSP

                          0100.0000.006c            2                 GSP

                          0100.0000.006e            2                 GSP

                          0100.0000.0070            2                 GSP

                          0100.0000.0073            2                 GSP

                          0100.0000.0075            2                 GSP

                          0100.0000.2774            2                 GSP

                          0100.0000.2776            2                 GSP

                          0100.0000.2777            2                 GSP

                          0100.0000.2778            2                 GSP

                          0100.0000.277a            2                 GSP

                          0100.0000.277e            2                 GSP

                          0100.0000.2782            2                 GSP

                          0100.0000.2786            2                 GSP

                          0100.0000.2790            2                 GSP

                          0100.0000.2793            2                 GSP

                          0100.0000.279c            2                 GSP

                          0100.0000.279e            2                 GSP

                          0100.0000.27a8            2                 GSP

                          0100.0000.27ab            2                 GSP 

--More--

Table 37 describes the significant fields shown in the display.

Table 37 show controllers backplane ethernet multicast groups Field Descriptions 

Field	Description
Intf Name	Interface whose multicast addresses are displayed. Note A multicast address is a single address that refers to multiple network devices.
Multicast address	Multicast addresses associated with the specified interface. Note A multicast address is a single address that refers to multiple network devices.
ID	Client identifier.
Name	Client application name.

Related Commands

Command	Description
show controllers backplane ethernet brief	Displays brief information about backplane Ethernet interfaces in a particular location.
show controllers backplane ethernet clients	Displays information about client applications in a particular location.
show controllers backplane ethernet detail	Displays detailed information about the backplane interfaces in a particular location.

show controllers switch ports

To display status on a switch port, use the show controllers switch ports command in administration EXEC mode.

show controllers switch {0 | 1} ports [FE port number | GE port number] location node-id

Syntax Description

0 | 1	Displays the instance of the controller.
FE port number	(Optional) Displays information for the Fast Ethernet (FE) port. Range is from 0 to 15.
GE port number	(Optional) Displays information for the Gigabit Ethernet (GE) port. Range is from 0 to 1.
location node-id	Displays the status of the switch port for a specified location.

Command Modes

Administration EXEC

Command History

Release	Modification
Release 2.0	This command was introduced on the Cisco CRS-1.
Release 3.0	No modification.
Release 3.2	No modification.
Release 3.3.0	No modification.
Release 3.4.0	No modification.
Release 3.5.0	No modification.
Release 3.6.0	No modification.
Release 3.7.0	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, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Task ID

Task ID	Operations
fabric	read
root-system	read

Examples

The following sample output shows the status about the switch controller ports on switch 0 for location 0/RP0/CPU0:

RP/0/RP0/CPU0:router# admin

RP/0/RP0/CPU0:router(admin)# show controllers switch 0 ports location 0/RP0/CPU0

Ports Active on Switch 0

 FE Port  2  STP State : FORWARDING  (Connected to - 0/RP1)

 FE Port  9  STP State : FORWARDING  (Connected to - 0/SM0)

 FE Port 10  STP State : FORWARDING  (Connected to - 0/SM1)

 GE Port  2  STP State : FORWARDING 

Table 38 describes the significant fields shown in the display.

Table 38 show controllers switch ports Field Descriptions 

Field	Description
Ports Active	Active switch ports on the controller.
FE Port	FE port.
GE Port	GE port.
STP State	State of the Spanning-Tree Protocol: FORWARDING or DISABLED.
Connected to	Node that owns the specified port.

Related Commands

Command	Description
show controllers switch statistics	Displays statistics on all ports on the switch controllers.

show controllers switch statistics

To display statistics on all ports on the switch controllers, use the show controllers switch statistics command in administration EXEC mode.

show controllers switch {0 | 1} statistics [FE port number | GE port number] location node-id

Syntax Description

0 | 1	Displays the instance of the controller.
FE port number	(Optional) Displays information for the Fast Ethernet (FE) port. Range is from 0 to 15.
GE port number	(Optional) Displays information for the Gigabit Ethernet (GE) port. Range is from 0 to 1.
location node-id	Displays the status of the switch port for a specified location.

Defaults

No default behavior or values

Command Modes

Administration EXEC

Command History

Release	Modification
Release 2.0	This command was introduced on the Cisco CRS-1.
Release 3.0	No modification.
Release 3.2	No modification.
Release 3.3.0	No modification.
Release 3.4.0	No modification.
Release 3.5.0	No modification.
Release 3.6.0	No modification.
Release 3.7.0	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, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Task ID

Task ID	Operations
fabric	read
root-system	read

Examples

The following sample output shows information about switch controller statistics on all ports for location 0/rp1/cpu0:

RP/0/RP0/CPU0:router# admin

RP/0/RP0/CPU0:router(admin)# show controllers switch 0 statistics location 0/rp1/cpu0

Switch Instance 0:

Port   Tx Frames   Tx Errors   Rx Frames   Rx Errors   Connects 

----------------------------------------------------------------

 0 :           0           0           0           0       0/RP0

 1 :      156117           0      329032           0       0/RP1

 2 :       62166           0       17030           2       0/SM0

 3 :       70291           0       24874           2       0/SM1

 4 :       69294           0       24495           2       0/SM2

 5 :       71515           0       25067           2       0/SM3

 6 :           0           0           0           0            

 7 :           0           0           0           0            

 8 :         123           0           1           1       0/LC0

 9 :           0           0           0           0       0/LC1

10 :      173553           0       56051           2       0/LC2

11 :           0           0           0           0       0/LC3

12 :           0           0           0           0       0/LC4

13 :           0           0           0           0       0/LC5

14 :           0           0           0           0       0/LC6

15 :           0           0           0           0       0/LC7

24 :           0           0           0           0        GE_0

25 :           0           0           0           0        GE_1

Table 39 describes the significant fields shown in the display.

Table 39 show controllers switch statistics Field Descriptions

Field	Description
Tx Frames	Number of packets transmitted from the switch port.
Tx Errors	Number of transmission errors.
Rx Frames	Number of packets received on the switch port.
Rx Errors	Number of receive errors.

Related Commands

Command	Description
show controllers switch ports	Displays status on a switch port.

show spantree

To display spantree configuration information, use the show spantree command in administration EXEC mode.

show spantree {mst 1 {brief | detail | port {FE port-id | GE port-id} | config} location node-id

Syntax Description

mst 1	Displays Multiple Spanning Tree (MST) information for instance 1.
config	Displays MST configuration information.
brief	Displays a summary of the spanning tree information.
detail	Displays detailed spanning tree information.
port	Displays spanning tree information for a specific Spanning Tree Protocol (STP) port.
FE port-id	Displays information for the Fast Ethernet (FE) port. Choose one of the following values: •0—FE port number 0. •1—FE port number 1.
GE port-id	Displays information for the Gigabit Ethernet (GE) port. Choose one of the following values: •0—GE port number 0. •1—GE port number 1.
location node-id	Displays the spantree information for a specified location.

Defaults

No default behavior or values

Command Modes

Administration EXEC

Command History

Release	Modification
Release 3.2	This command was introduced on the Cisco CRS-1.
Release 3.3.0	No modification.
Release 3.4.0	No modification.
Release 3.5.0	No modification.
Release 3.6.0	No modification.
Release 3.7.0	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, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Task ID

Task ID	Operations
system	read
root-system	read

Examples

The following sample output shows how to display Multiple Spanning Tree configuration information for location 0/rp1/cpu0:

RP/0/RP0/CPU0:router# show spantree mst config location 0/rp1/cpu0

Name      [STP_1]

Revision      1 

Instances configured 2

--------  ---------------------------------------------------------------------

   0      2-4094

   1      1

------------------------------------------------------------------------------- 

Table 40 describes the significant fields shown in the display.

Table 40 show spantree Field Descriptions 

Field	Description
Revision	Revision of the current MST configuration.
Instances configured	MST instance.