To display status
and configuration information about the Ethernet interfaces on a specific node,
use the
show controllers
command in
EXEC mode.
show
controllers
{
GigabitEthernet
| GigabitEthCtrlr
| HundredGigE
| HundredGigECtrlr
| TenGigE
| TenGigECtrlr
| FortyGigE
}
interface-path-id
[
all
| bert
| control
| internal
| mac
| periodic
| phy
| pm
| priority-flow-control
| regs
| stats
| xgxs
]
Syntax Description
{GigabitEthernet | GigabitEthCtrlr | HundredGigE | HundredGigECtrlr | TenGigE | TenGigECtrlr|FortyGigE}
|
Specifies
the type of Ethernet interface or controller whose status and configuration
information you want to display. Enter GigabitEthernet, GigabitEthernetCtrlr,
HundredGigE, HundredGigeCtrlr, TenGigE, or TenGigeCtrlr.
|
interface-path-id
|
Physical
interface or virtual interface.
Note
|
Use the
show
interfaces command to see a list of all interfaces
currently configured on the router.
|
For more
information about the syntax for the router, use the question mark (? ) online help function.
|
all
|
Displays
detailed information for the specified interface.
|
bert
|
Displays
BERT status information for the interface.
|
control
|
Displays
configuration and control information.
|
internal
|
Displays
internal information for the interface.
|
mac
|
Displays mac address information for the interface.
|
periodic
|
Displays
performance monitoring data periodically.
|
phy
|
Displays
physical information for the interface.
|
pm
|
Displays
Ethernet performance monitoring.
|
priority-flow-control
|
Displays priority flow control information.
|
regs
|
Displays
register information.
|
stats
|
Displays
statistical information for the interface.
|
xgxs
|
Displays
information about the 10 Gigabit Ethernet Extended Sublayer (XGXS).
|
Command Default
No default
behavior or values
Command History
Release
|
Modification
|
Release 3.7.2
|
This
command was first introduced.
|
Release
6.0.x
|
This
command was modified. The
GigabitCtrlr,
TenGigECtrlr, and
HundredGigECtrlr keywords were added.
|
Release 6.2.1
|
The
command was updated to display receiving optical power threshold value
configured, and the minimum and maximum threshold values, as part of Early
Indication of Link Loss Change feature.
|
Release 7.1.3
|
This command was modified. The FortyGE keyword was added.
|
Usage Guidelines
For the
interface-path-id argument, use the following
guidelines:
-
If specifying a physical interface, the naming notation is rack/slot/module/port. The slash between values is required as part of the notation. An explanation of each component of the naming notation is
as follows:
-
rack: Chassis number of the rack.
-
slot: Physical slot number of the line card.
-
module: Module number. A physical layer interface module (PLIM) is always 0.
-
port: Physical port number of the interface.
-
If specifying a virtual interface, the number range varies, depending on interface type.
For controllers,
use the following keywords only.
Task ID
Task ID
|
Operations
|
cisco-support
|
read
Note
|
Required
in addition to the interface (read) task ID to use the
control
keyword only.
|
|
dwdm
|
read
|
interface
|
read
|
sonet-sdh
|
read
|
Examples
The port speed on QSFP-40/100G-SRBD dual-mode optic was changed from 100Gps to 40Gps. This example shows the QSFP-40/100G-SRBD
dual-mode optic status on FortyGigE 0/0/0/21/0:RP/0/RSP0/CPU0:router#show controllers FortyGigE0/0/0/21/0 internal
Wed Nov 11 06:34:26.861 UTC
Internal data for interface: FortyGigE0/0/0/21/0
Subport Number : 0
Port Number : 21
Bay Number : 0
Ifinst : 6
Ifinst Subport : 21
Board Type : 0x003d1013
Port Type : 40GE
Bandwidth(Kbps) : 40000000
Transport mode : LAN
BIA MAC addr : badb.ad03.a84d
Oper. MAC addr : badb.ad03.a84d
Egress MAC addr : badb.ad03.a84d
Port Available : true
Status polling is : enabled
Status events are : enabled
I/F Handle : 0x04001300
Cfg Link Enabled : tx/rx enabled
H/W Tx Enable : yes
MTU : 1514
H/W Speed : 40 Gbps
H/W Loopback Type : None
FEC : Disable
H/W FlowCtrl Type : None
H/W AutoNeg Enable : Off
Rx OPD : Not Supported
H/W Link Defects : (0x0000000000000000) none
H/W Raw Link Defects : (0x0000000000000000) none
Link Up : yes
Link Led Status : Link up -- Green/Amber
Serdes fw version : 100.0
Pluggable Present : yes
Pluggable Type : 100/40G SRBD
Pluggable PID : QSFP-40/100-SRBD
Pluggable Compl. : Compliant
Pluggable Type Supp.: Supported
Pluggable PID Supp. : Supported
Examples
This example shows the receiving optical power
alarm status on HuGigE0/1/2/3:
RP/0/RSP0/CPU0:router#show controllers GigabitEthernet0/0/0/4
Operational data for interface HuGigE0/1/2/3:
State:
Administrative state: Enabled
Operational state: Up,
LED state: Green On
Phy:
Media type: 100GBASE-LR4, fiber over 4 Lane optics (long reach),
Optics:
Vendor: CISCO-AVAGO
Part number: 10-2134-01 (ver.: V01)
Serial number: IPUIALJRAA
Digital Optical Monitoring:
Transceiver Temp: 98.781 C
Transceiver Voltage: 3.283 V
Alarms key: (H) Alarm high, (h) Warning high
(L) Alarm low, (l) Warning low
Wavelength Tx Power Rx Power Laser Bias
Lane (nm) (dBm) (mW) (dBm) (mW) (mA)
-- ----- ------ ------ ------ ------ ------
01 1270 -1.6 0.699h -37.0 0.0002L 9.408
02 1290 -1.6 0.493 -37.0 0.0003L 9.406
03 1310 -1.6 0.501h -37.0 0.0002L 9.407
04 1330 -1.6 0.400 -37.0 0.0003L 9.399
DOM alarms:
Transceiver Temp: Alarm high
Transmit Power: Warning high
Receive Power: Alarm low
Alarm Alarm Warning Warning Alarm
Thresholds High High Low Low
------- ------- ------- -------
Transceiver Temp (C): 90.000 85.000 -5.000 -10.000
Transceiver Voltage (V): 3.630 3.470 3.140 2.970
Laser Bias (mA): 15.000 15.000 2.000 2.000
Transmit Power (mW): 1.000 0.501 0.112 0.045
Receive Power (mW): 1.995 1.000 0.020 0.008
Alarms:
Current:
SD-BER
SF-BER
Previous:
No alarms
Statistics:
Sync Header Error Count: <count>
PCS BIP Error count: <count>
FEC:
Corrected Codeword Count: <count>
Uncorrected Codeword Count: <count>
MAC address information:
Operational address: 0003.6cff.0c00
Burnt-in address: 0003.6cff.0c00
1 unicast address(es) in filter:
0012.3456.7890
Operating in multicast promiscuous mode
Autonegotiation disabled
Priority Flow Control:
Total Rx PFC Frames: 1030
Total Tx PFC Frames: 4440
CoS Status Rx Frames Tx Frames
--- ------ ---------- ----------
0 off 15 125
1 on 115 115
2 on 125 1225
3 on 135 135
4 off 145 1245
5 off 155 155
6 off 165 1265
7 off 175 175
Operational values:
Speed: 10 Gbps,
Bandwidth utilization: 19.73%,
Duplex: Full Duplex,
Flowcontrol: None,
Priority flow control: On,
Loopback: None (or external),
MTU: 1514 bytes,
MRU: 1514 bytes,
Inter-packet gap: standard (12),
Forward error correction: Standard (Reed-Solomon)
![](https://www.cisco.com/content/dam/en/us/td/i/templates/note.gif)
Note
|
A higher count of Bit Interleaved Parity (BIP) errors lead to Bit Error Rate (BER) errors. Ethernet interfaces must be continuously
monitored in order to detect any link that is not working due to BER errors (bit error rate) and to bring down the interface
connected to that link. BER informs you of the number of bit errors per unit time and helps you test cables and diagnose signal
problems in the field. For more information on BER, see the
Interface and Hardware Component Configuration Guide for Cisco ASR 9000 Series Routers.
|
Examples
This example shows the receiving
optical power degrade threshold value configured on GigabitEther interface
location 0/0/0/4:
RP/0/RSP0/CPU0:router#show controllers GigabitEthernet0/0/0/4 control
Management information for interface GigabitEthernet0/0/0/4:
Port number: 4
Interface handle: 0x08000400
Config:
Auto-negotiation: Off
Carrier delay (up): None
Carrier delay (down): None
Duplex: Not configured
Flow Control: None
Priority Flow Control: None
Forward Error Correction: Standard (Reed-Solomon)
IPG: Standard (12)
Loopback: None
MTU: Not configured
Speed: Not configured
Soft BW: Not configured
MAC Address: Not configured
Rx Optical Power Degrade Threshold: -10db
Driver constraints:
Min MTU: 64 bytes
Max MTU: 9000 bytes
Max speed: 1Gbps
Interface type: Gigabit Ethernet
Mgmt interface: No
Allowed config mask: 0x26f
Cached driver state:
MTU: 1514 bytes
Burnt-in MAC Address: 0001.0203.0404
Not a member of a bundle interface.
Port FSM state:
Port is disabled due to an admin down condition.
Complete FSM state:
Admin down
Bundle admin up
Client admin up
Client admin tx up
Port disabled
Port tx disabled
HW link down
IDB interface state information:
IDB bundle admin up
IDB client admin up
IDB client tx admin up
IDB error disable not set
0 Unicast MAC Addresses:
0 Multicast MAC Addresses:
Examples
The following
example shows sample output from the
show controllers
hundredGigE phy command for A9K-2x100GE line card:
RP/0/RSP0/CPU0:router# show controller hundredGigE 0/9/0/0 phy
PHY data for interface: HundredGigE0/9/0/0:
Rx 64B66B Lane Sync PCS Virt PCS
Service Block Marker Header Lane Lane Lane
Lane Lock Sync Err Cnt BIP Errors Error Mapping
-- --------- --------- ---------- ---------- ----- -------
0 Locked Locked 0 0 Clean 0
1 Locked Locked 0 0 Clean 10
2 Locked Locked 0 0 Clean 1
3 Locked Locked 0 0 Clean 11
4 Locked Locked 0 0 Clean 12
5 Locked Locked 0 0 Clean 2
6 Locked Locked 0 0 Clean 3
7 Locked Locked 0 0 Clean 13
8 Locked Locked 0 0 Clean 14
9 Locked Locked 0 0 Clean 4
10 Locked Locked 0 0 Clean 15
11 Locked Locked 0 0 Clean 5
12 Locked Locked 0 0 Clean 6
13 Locked Locked 0 0 Clean 16
14 Locked Locked 0 0 Clean 17
15 Locked Locked 0 0 Clean 7
16 Locked Locked 0 0 Clean 8
17 Locked Locked 0 0 Clean 18
18 Locked Locked 0 0 Clean 9
19 Locked Locked 0 0 Clean 19
CFP EEPROM port: 0
Xcvr Type: CFP
Ext Type: 8W,
Connector Type: MPO
Ethernet Application Codes: 100GE-SR10,
Number of Lanes: Network 10, Host 10
Max Bit Rate: Network Lane 10.4Gbit/s, Host Lane 10.4Gbit/s
Link Reaches: SM Fiber 0KM, MM Fiber: 100M, Copper: 0M
Device Tech1: VCSEL, DML,
Device Tech2: No WL, Uncool Xmtr, Xmtr not tunable, No VOA, PIN detector, No EDC,
Encoding: NRZ, Non-PSK,
Vendor Name: Reflex Photonics
Vendor OUI: 00.00.00
Vendor Part Number: CF-X12-C11801
Vendor Serial Number: X000A906
Date Code (yyyymmdd): 20110527, Lot Code 25
DDM Type: RX Avg Power, TX OMA,
Module DDM: Power Supply Voltage, Temperature,
Per Lane DDM: Laser Temp,
Enhanced Options:
MSA Data (CFP NVR 1 Table - addr 0x8000-0x807F)
0x0000: 0e 30 09 03 00 00 00 00 : 08 aa 4a 34 34 00 0a 00
0x0010: 0a 01 83 40 86 60 4e 20 : 00 04 40 3c 50 26 fa 46
0x0020: 00 52 65 66 6c 65 78 20 : 50 68 6f 74 6f 6e 69 63
0x0030: 73 00 00 00 43 46 2d 58 : 31 32 2d 43 31 31 38 30
0x0040: 31 20 20 20 58 30 30 30 : 41 39 30 36 20 20 20 20
0x0050: 20 20 20 20 32 30 31 31 : 30 35 32 37 32 35 20 20
0x0060: 20 20 20 20 20 20 20 20 : 0a 0d 04 14 04 05 0c 03
0x0070: 01 00 01 01 01 00 01 01 : 40 00 00 00 00 00 00 17
Part Number: (ver.: )
Product ID:
Vendor Specific Data (Vendor Cisco NVR 1 Table - address 0x8400-0x847F)
0x0100: 00 00 00 00 00 00 00 00 : 00 00 00 00 00 00 00 00
0x0110: 00 00 00 00 00 00 00 00 : 00 00 00 00 00 00 00 00
0x0120: 00 00 00 00 00 00 00 00 : 00 00 00 00 00 00 00 00
0x0130: 00 00 00 00 00 00 00 00 : 00 00 00 00 00 00 00 00
0x0140: 00 00 00 00 00 00 00 00 : 00 00 00 00 00 00 00 00
0x0150: 00 00 00 00 00 00 00 00 : 00 00 00 00 00 00 00 00
0x0160: 00 00 00 00 00 00 00 00 : 00 00 00 00 00 00 00 00
0x0170: 00 00 00 00 00 00 00 00 : 00 00 00 00 00 00 00 00
Module
Thresholds: Alarm High Warning High Warning Low Alarm Low
Temperature: +0.273 C +0.253 C +0.019 C +0.000 C
Voltage: 5.031 Volt 5.338 Volt 0.013 Volt 2.879 Volt
Temperature: +45.132 C
Voltage: 3.355 Volt
Lanes
Thresholds: Alarm High Warning High Warning Low Alarm Low
Temperature: +0.273 C +0.253 C +0.019 C +0.000 C
Bias: 0.000 mAmps 0.000 mAmps 0.000 mAmps 0.000 mAmps
Transmit Power: 0.000 mW (<-40.00 dBm) 0.000 mW (<-40.00 dBm) 0.000 mW (<-40.00 dBm) 0.000 mW (<-40.00 dBm)
Receive Power: 0.000 mW (<-40.00 dBm) 0.000 mW (<-40.00 dBm) 0.000 mW (<-40.00 dBm) 0.000 mW (<-40.00 dBm)
Lane Temp Bias Tx Power Rx Power
0 +42.640 C N/A N/A N/A
1 +42.640 C N/A N/A N/A
2 +42.640 C N/A N/A N/A
3 +42.640 C N/A N/A N/A
4 +42.640 C N/A N/A N/A
5 +42.640 C N/A N/A N/A
6 +42.640 C N/A N/A N/A
7 +42.640 C N/A N/A N/A
8 +42.640 C N/A N/A N/A
9 +42.640 C N/A N/A N/A
Threshold Data (CFP NVR 2 Table - address 0x8080-0x80ff)
0x0080: 00 46 00 41 00 05 00 00 : c4 86 d0 84 00 7d 70 7b
0x0090: 00 00 00 00 00 00 00 00 : 00 00 00 00 00 00 00 00
0x00a0: 00 00 00 00 00 00 00 00 : 00 00 00 00 00 00 00 00
0x00b0: 00 00 00 00 00 00 00 00 : 00 46 00 41 00 05 00 00
0x00c0: 00 00 00 00 00 00 00 00 : 00 00 00 00 00 00 00 00
0x00d0: 00 00 00 00 00 00 00 00 : 00 00 00 00 00 00 00 00
0x00e0: 00 00 00 00 00 00 00 00 : 00 00 00 00 00 00 00 00
0x00f0: 00 00 00 00 00 00 00 00 : 00 00 00 00 00 00 00 1e
The following
example shows sample output from the
show controllers
hundredGigE phy command for A9K-400G-DWDM-TR line card:
RP/0/RSP0/CPU0:router# show controller hundredGigE0/2/0/20/0 phy
Rx 64B66B Lane Sync PCS Virt PCS
Service Block Marker Header Lane Lane Lane
Lane Lock Sync Err Cnt BIP Errors Error Mapping
-- --------- --------- ---------- ---------- ----- -------
0 Locked Locked 0 0 Clean 1
1 Locked Locked 0 0 Clean 2
2 Locked Locked 0 0 Clean 4
3 Locked Locked 0 0 Clean 7
4 Locked Locked 0 0 Clean 9
5 Locked Locked 0 0 Clean 10
6 Locked Locked 0 0 Clean 12
7 Locked Locked 0 0 Clean 14
8 Locked Locked 0 0 Clean 17
9 Locked Locked 0 0 Clean 18
10 Locked Locked 0 0 Clean 0
11 Locked Locked 0 0 Clean 3
12 Locked Locked 0 0 Clean 5
13 Locked Locked 0 0 Clean 6
14 Locked Locked 0 0 Clean 8
15 Locked Locked 0 0 Clean 11
16 Locked Locked 0 0 Clean 13
17 Locked Locked 0 0 Clean 15
18 Locked Locked 0 0 Clean 16
19 Locked Locked 0 0 Clean 19
*** PHY PCS PMA Statistics ***
Rx Rx Aligment PCS PCS
Service Block Marker Lane Lane
Lane Lock Lock BIP Errors Mapping
------- --------- --------- ---------- -------
0 Locked Locked 367 0
1 Locked Locked 367 0
2 Locked Locked 367 0
3 Locked Locked 367 0
4 Locked Locked 367 0
5 Locked Locked 367 0
6 Locked Locked 367 0
7 Locked Locked 367 0
8 Locked Locked 367 0
9 Locked Locked 367 0
10 Locked Locked 367 0
11 Locked Locked 367 0
12 Locked Locked 367 0
13 Locked Locked 367 0
14 Locked Locked 367 0
15 Locked Locked 367 0
16 Locked Locked 367 0
17 Locked Locked 367 0
18 Locked Locked 367 0
19 Locked Locked 367 0