Cisco IOS XR Interface and Hardware Component Command Reference, Release 3.6
Internal Ethernet Control Network Commands on Cisco IOS XR Software

Table Of Contents

Internal Ethernet Control Network Commands on Cisco IOS XR Software

clear controller backplane ethernet location statistics

show controllers backplane ethernet local brief

show controllers backplane ethernet local clients

show controllers backplane ethernet local detail

show controllers backplane ethernet local multicast groups

show controllers backplane ethernet location brief

show controllers backplane ethernet location clients

show controllers backplane ethernet location detail

show controllers backplane ethernet location brief multicast groups

show controllers switch ports

show controllers switch stats

show spantree

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 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

Release
Modification

Release 2.0

This command was introduced on the Cisco CRS-1.

Release 3.0

No modification.

Release 3.2

This command was first supported on the Cisco XR 12000 Series Router.

Release 3.3.0

No modification.

Release 3.4.0

No modification.

Release 3.5.0

No modification.

Release 3.6.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.

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
Description

show controllers backplane ethernet location brief

Displays information about backplane Ethernet interfaces in a particular location.


show controllers backplane ethernet local brief

To display brief information about the Ethernet interface that connects the node to the router control Ethernet, use the show controllers backplane ethernet local brief command in EXEC mode.

show controllers backplane ethernet local brief

Syntax Description

This command has no arguments or keywords.

Command Modes

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

This command was first supported on the Cisco XR 12000 Series Router.

Release 3.3.0

No modification.

Release 3.4.0

No modification.

Release 3.5.0

No modification.

Release 3.6.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.

Examples

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

RP/0/RP0/CPU0:router# show controllers backplane ethernet local brief

FastEthernet0_RP1_0 (local) is up, MTU 1514 bytes

561688 packets input, 53760372 bytes

683424 packets output, 216565877 bytes

RP/0/RP0/CPU0:router#

Table 36 describes the significant fields shown in the display.

Table 36 show controllers backplane ethernet local 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 packets transmitted.


This line prevents blank table in PDF.

Related Commands

Command
Description

show controllers backplane ethernet local clients

Displays information about backplane Ethernet interfaces in a particular location.

show controllers backplane ethernet local detail

Displays detailed information for the Ethernet interface that connects the node to the router control Ethernet.

show controllers backplane ethernet local multicast groups

Displays all multicast addresses currently being used by active interfaces on the router.


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

Displays a list of client statistics for the specified client ID. Range is from 1 to 22.

all

Displays a list of all client applications and their IDs.


Command Modes

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

This command was first supported on the Cisco XR 12000 Series Router.

Release 3.3.0

No modification.

Release 3.4.0

No modification.

Release 3.5.0

No modification.

Release 3.6.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.

Examples

The following is sample output from the show controllers backplane ethernet local clients command, which displays a 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 37 describes the significant fields shown in the display.

Table 37 show controllers backplane ethernet local clients Field Descriptions

Field
Description

Client

Client application name and ID, followed by backplane client application statistics.

PID

Process ID.


Related Commands

Command
Description

show controllers backplane ethernet local brief

Displays brief information about the Ethernet interface that connects the node to the router control Ethernet.

show controllers backplane ethernet local detail

Displays detailed information for the Ethernet interface that connects the node to the router control Ethernet.

show controllers backplane ethernet local multicast groups

Displays all multicast addresses currently being used by active interfaces on the router.


show controllers backplane ethernet local detail

To display detailed information for the Ethernet interface that connects the node to the router control Ethernet, use the show controllers backplane ethernet local detail command in EXEC mode.

show controllers backplane ethernet local detail

Syntax Description

This command has no arguments or keywords.

Command Modes

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

This command was first supported on the Cisco XR 12000 Series Router.

Release 3.3.0

No modification.

Release 3.4.0

No modification.

Release 3.5.0

No modification.

Release 3.6.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.

Examples

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

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

Table 38 describes the significant fields shown in the display.

Table 38 show controllers backplane ethernet local detail Field Descriptions

Field
Description

Hardware

Provides the 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

Indicates the operating mode of the interface, followed by transmission data.


Related Commands

Command
Description

show controllers backplane ethernet local brief

Displays brief information about the Ethernet interface that connects the node to the router control Ethernet.

show controllers backplane ethernet local clients

Displays information about backplane Ethernet interfaces in a particular location.

show controllers backplane ethernet local multicast groups

Displays all multicast addresses currently being used by active interfaces on the router.


show controllers backplane ethernet local multicast groups

To display all multicast addresses currently being used by active interfaces on the router, use the show controllers backplane ethernet local multicast groups command in EXEC mode.

show controllers backplane ethernet local multicast groups

Syntax Description

This command has no arguments or keywords.

Command Modes

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

This command was first supported on the Cisco XR 12000 Series Router.

Release 3.3.0

No modification.

Release 3.4.0

No modification.

Release 3.5.0

No modification.

Release 3.6.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.

Examples

The following is sample output from the show controllers backplane ethernet local multicast groups command:

RP/0/RP0/CPU0:router# show controllers backplane ethernet local multicast groups
    Intf                    Multicast      Client registered for this address
    Name                     address                Id               Name
------------------------------------------------------------------------------
FastEthernet0_RP1_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.0072            2                 GSP
                          0100.0000.2774            2                 GSP
                          0100.0000.2775            2                 GSP
                          0100.0000.2776            2                 GSP
                          0100.0000.2778            2                 GSP
                          0100.0000.277a            2                 GSP
                          0100.0000.277c            2                 GSP
                          0100.0000.277e            2                 GSP
                          0100.0000.2780            2                 GSP
                          0100.0000.2782            2                 GSP
                          0100.0000.2784            2                 GSP
                          0100.0000.2786            2                 GSP
 --More--

Table 39 describes the significant fields shown in the display.

Table 39 show controllers backplane ethernet local multicast groups Field Descriptions

Field
Description

Intf Name

Identifies the 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 local brief

Displays brief information about the Ethernet interface that connects the node to the router control Ethernet.

show controllers backplane ethernet local clients

Displays information about backplane Ethernet interfaces in a particular location.

show controllers backplane ethernet local detail

Displays detailed information for the Ethernet interface that connects the node to the router control Ethernet.


show controllers backplane ethernet location brief

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

show controllers backplane ethernet location node-id brief

Syntax Description

This command has no arguments or keywords.

Command Modes

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

This command was first supported on the Cisco XR 12000 Series Router.

Release 3.3.0

No modification.

Release 3.4.0

No modification.

Release 3.5.0

No modification.

Release 3.6.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.

Examples

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

RP/0/RP0/CPU0:router# show controllers backplane ethernet location 0/1/0 brief
FastEthernet0_0_CPU0 (local) is up, MTU 1514 bytes
    57569 packets input, 5999749 bytes
    36963 packets output, 4105673 bytes
RP/0/RP0/CPU0:router#

Table 40 describes the significant fields shown in the display.

Table 40 show controllers backplane ethernet location 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 packets transmitted.

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:

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

Indicates the total number of broadcast and multicast packets transmitted by the interface.

Output errors

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:

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 location clients

Displays information about client applications in a particular location.

show controllers backplane ethernet location detail

Displays detailed information about the backplane interfaces in a particular location.

show controllers backplane ethernet location brief multicast groups

Displays information about backplane interfaces that are in multicast groups in a particular location.


show controllers backplane ethernet location clients

To display information about client applications in a particular location, 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

Displays a list of client statistics for the specified client ID. Range is from 1 through 22.

client-id all

Displays a list of all client applications and their IDs.


Command Modes

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

This command was first supported on the Cisco XR 12000 Series Router.

Release 3.3.0

No modification.

Release 3.4.0

No modification.

Release 3.5.0

No modification.

Release 3.6.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.

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
                         14                     0          Reserved for Attach
                         15                     0           Chassis controller
                         16                     0            Forwarding driver
                         17                 16414                    MBI hello
                         18                     0       MBI Boot Server Source
                         19                     0                HSR ES client
                         20                     0           Test application 1
                         21                     0           Test application 2
                         22                     0      Test client out-of-band
RP/0/RP1/CPU0:router#

Table 41 describes the significant fields shown in the display.

Table 41 show controllers backplane ethernet location clients Field Descriptions

Field
Description

Intf Name

Identifies the Ethernet interface.

Client ethernet server id

Identifies the Ethernet server for the specified interface.

Client process id

Identifies the client process running on the specified interface.

Description

Describes the backplane client application.


Related Commands

Command
Description

show controllers backplane ethernet location brief

Displays brief information about backplane Ethernet interfaces in a particular location.

show controllers backplane ethernet location detail

Displays detailed information about the backplane interfaces in a particular location.

show controllers backplane ethernet location brief multicast groups

Displays information about backplane interfaces that are in multicast groups in a particular location.


show controllers backplane ethernet location detail

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

show controllers backplane ethernet location node-id detail

Syntax Description

This command has no arguments or keywords.

Command Modes

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

This command was first supported on the Cisco XR 12000 Series Router.

Release 3.3.0

No modification.

Release 3.4.0

No modification.

Release 3.5.0

No modification.

Release 3.6.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.

Examples

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

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

Table 42 describes the significant fields shown in the display.

Table 42 show controllers backplane ethernet location detail Field Descriptions 

Field
Description

Hardware

Provides the 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

Indicates the 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

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:

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

Indicates the total number of broadcast and multicast packets transmitted by the interface.

Output errors

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:

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 location brief

Displays brief information about backplane Ethernet interfaces in a particular location.

show controllers backplane ethernet location clients

Displays information about client applications in a particular location.

show controllers backplane ethernet location brief multicast groups

Displays information about backplane interfaces that are in multicast groups in a particular location.


show controllers backplane ethernet location brief multicast groups

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

show controllers backplane ethernet location node-id multicast groups

Syntax Description

This command has no arguments or keywords.

Command Modes

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

This command was first supported on the Cisco XR 12000 Series Router.

Release 3.3.0

No modification.

Release 3.4.0

No modification.

Release 3.5.0

No modification.

Release 3.6.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.

Examples

The following is sample output from the show controllers backplane ethernet location multicast groups command, which displays detailed information about the backplane interfaces.

RP/0/RP0/CPU0:router# show controllers backplane ethernet location multicast groups

Intf                    Multicast      Client registered for this address
    Name                     address                Id               Name
------------------------------------------------------------------------------
  FastEthernet0_2_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.0071            2                 GSP
                          0100.0000.2774            2                 GSP
                          0100.0000.2775            2                 GSP
                          0100.0000.2776            2                 GSP
                          0100.0000.2778            2                 GSP
                          0100.0000.277a            2                 GSP
                          0100.0000.2782            2                 GSP
                          0100.0000.278a            2                 GSP
                          0100.0000.2796            2                 GSP
                          0100.0000.2798            2                 GSP

RP/0/RP0/CPU0:router#

Table 43 describes the significant fields shown in the display.

Table 43 show controllers backplane ethernet location multicast groups Field Description

Field
Description

Intf Name

Identifies the 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 location brief

Displays brief information about backplane Ethernet interfaces in a particular location.

show controllers backplane ethernet location clients

Displays information about client applications in a particular location.

show controllers backplane ethernet location 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 EXEC mode.

show controllers switch {0 | 1} ports

Syntax Description

{0 | 1}

Instance of the controller.


Command Modes

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

This command was first supported on the Cisco XR 12000 Series Router.

Release 3.3.0

No modification.

Release 3.4.0

No modification.

Release 3.5.0

No modification.

Release 3.6.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.

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 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 44 describes the significant fields shown in the display.

Table 44 show controllers switch ports Field Descriptions

Field
Description

Ports Active

Indicates the active switch ports on the controller.

FE Port

Identifies the FE port.

GE Port

Identifies the GE port.

STP State

The state of the Spanning-Tree Protocol: FORWARDING or DISABLED.

Connected to

The node that owns the specified port.


Related Commands

Command
Description

show controllers switch stats

Displays statistics on all ports on the switch controllers.


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

No default behavior or values.

Command Modes

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

This command was first supported on the Cisco XR 12000 Series Router.

Release 3.3.0

No modification.

Release 3.4.0

No modification.

Release 3.5.0

No modification.

Release 3.6.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.

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  1 : Tx Frames 541417  Tx Errors 0  Rx Frames 0  Rx Errors 0 
 Port  2 : Tx Frames 820214  Tx Errors 0  Rx Frames 707494  Rx Errors 1 
 Port  3 : Tx Frames 0  Tx Errors 0  Rx Frames 0  Rx Errors 0 
 Port  4 : Tx Frames 0  Tx Errors 0  Rx Frames 0  Rx Errors 0 
 Port  5 : Tx Frames 0  Tx Errors 0  Rx Frames 0  Rx Errors 0 
 Port  6 : Tx Frames 0  Tx Errors 0  Rx Frames 0  Rx Errors 0 
 Port  7 : Tx Frames 0  Tx Errors 0  Rx Frames 0  Rx Errors 0 
 Port  8 : Tx Frames 0  Tx Errors 0  Rx Frames 0  Rx Errors 0 
 Port  9 : Tx Frames 633546  Tx Errors 0  Rx Frames 158250  Rx Errors 2 
 Port 10 : Tx Frames 0  Tx Errors 0  Rx Frames 0  Rx Errors 0 
 Port 11 : Tx Frames 0  Tx Errors 0  Rx Frames 0  Rx Errors 0 
 Port 12 : Tx Frames 0  Tx Errors 0  Rx Frames 0  Rx Errors 0 
 Port 13 : Tx Frames 0  Tx Errors 0  Rx Frames 0  Rx Errors 0 
 Port 14 : Tx Frames 0  Tx Errors 0  Rx Frames 0  Rx Errors 0 
 Port 15 : Tx Frames 0  Tx Errors 0  Rx Frames 0  Rx Errors 0 
 Port 16 : Tx Frames 0  Tx Errors 0  Rx Frames 0  Rx Errors 0 
 Port 25 : Tx Frames 541417  Tx Errors 0  Rx Frames 0  Rx Errors 0 
 Port 26 : Tx Frames 541330  Tx Errors 0  Rx Frames 587917  Rx Errors 0 

Table 45 describes the significant fields shown in the display.

Table 45 show controllers switch stats Field Descriptions

Field
Description

Tx Frames 541417

Number of packets transmitted from the switch port.

Tx Errors 0

Number of transmission errors.

Rx Frames 0

Number of packets received on the switch port.

Rx Errors 0

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, 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

Show Multiple Spanning Tree (MST) information for instance 1.

mst config

Show Multiple Spanning Tree configuration information.

brief

Display a summary of spantree information.

detail

Display detailed spantree information.

port port-id

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.

vlan 1

Show Spanning Tree Information for a VLAN.


Defaults

No default behavior or values.

Command Modes

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.


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.

Examples

The following example shows how to display Multiple Spanning Tree configuration information:

RP/0/RP1/CPU0:router#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:router#

Table 46 describes the significant fields shown in the display.

Table 46 show spantree Field Descriptions 

Field
Description

Current MST Region Configuration

Identifies the MST whose information is displayed.

Revision

Revision of the current MST configuration.

Instance

MST instance.

Vlans Mapped

Lists the Vlans that are mapped to the displayed MST.


Related Commands

Command
Description

spantree

Configures spantree parameters.


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

Node identifier. Enter the name of the node whose spantree parameters you want to configure.

core

Spanning tree instance.

port-id

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.

portcost cost

Path cost for the port. Replace with a number. Range is 1 through 200000.

portpriority priority

Priority of the port. Range is 1 through 128.

fwddelay time

Forward delay timer. Replace time with a number. Range is 4 through 30.

hellotime time

Hello time. Replace time with a number. Range is 1 through 10.

maxage age

Bridge maximum age. Replace age with a number. Range is 6 through 40.

priority priority-num

Bridge priority. Replace priority-num with a priority number. Range is 1 through 65535.

mst

Enables configuration of the following options:

region word—MST region name

revision 1-65535—MST revision

region name

MST region name. Replace name with the MST region name.

revision rev-num

MST revision number. Replace rev-num with the revision number. Range is 1 through 65535


Defaults

No default behavior or values.

Command Modes

Admin configuration

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.


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.

Examples

The following example shows how to configure the hello time for a spantree:

RP/0/RP1/CPU0:router(admin-config)# spantree node1 core hellotime 5
RP/0/RP1/CPU0:router(admin-config)#

Related Commands

Command
Description

show spantree

Displays spantree configuration information.