- Preface
- ATM Commands on the Cisco IOS XR Software
- Ethernet Interface Commandson the Cisco IOS XR Software
- Ethernet OAM Commands on the Cisco IOS XR Software
- Frame Relay Commands on the Cisco IOS XR Software
- Global Interface Commandsonthe Cisco IOS XR Software
- Link Bundling Commands on the Cisco IOS XR Software
- Management Ethernet Interface Commands on the Cisco IOS XR Software
- Multilink Commands on the Cisco IOS XR Software
- Null Interface Commands
- Packet-over-SONET Interface Commands on the Cisco IOS XR Software
- PPP Commands onthe Cisco IOS XR Software
- Serial Interface Commands on the Cisco IOS XR Software
- SONET Controller Commands on the Cisco IOS XR Software
- T3, E3, T1, E1 Controller Commands on the Cisco IOS XR Software
- 802.1Q VLAN Subinterface Commandsonthe Cisco IOS XR Software
- Index
- carrier-delay
- clear mac-accounting (Ethernet)
- duplex full (Fast Ethernet)
- duplex half (Fast Ethernet)
- flow-control
- interface (Ethernet)
- loopback (Ethernet)
- mac-accounting
- mac-address (Ethernet)
- negotiation auto
- packet-gap non-standard
- show controllers (Ethernet)
- show mac-accounting (Ethernet)
- speed (Fast Ethernet)
Ethernet Interface Commandson
the Cisco IOS XR Software
This module provides command line interface (CLI) commands for configuring Ethernet interfaces on the Cisco XR 12000 Series Router.
- carrier-delay
- clear mac-accounting (Ethernet)
- duplex full (Fast Ethernet)
- duplex half (Fast Ethernet)
- flow-control
- interface (Ethernet)
- loopback (Ethernet)
- mac-accounting
- mac-address (Ethernet)
- negotiation auto
- packet-gap non-standard
- show controllers (Ethernet)
- show mac-accounting (Ethernet)
- speed (Fast Ethernet)
carrier-delay
To delay the processing of hardware link down notifications, use the carrier-delay command in interface configuration mode.
carrier-delay { down milliseconds [ up milliseconds ] | up milliseconds [ down milliseconds ] }
Syntax Description
|
down milliseconds |
Length of time, in milliseconds, to delay the processing of hardware link down notifications. Range is from 1 through 60000. |
|
up milliseconds |
Length of time, in milliseconds, to delay the processing of hardware link up notifications. Range is from 1 through 60000. |
Command Default
No carrier-delay is used, and the upper layer protocols are notified as quickly as possible when a physical link goes down.
Command Modes
Interface configuration
Command History
|
Release |
Modification |
|---|---|
|
Release 3.2 |
This command was introduced. |
|
Release 3.4.0 |
The msec keyword was replaced by the down keyword, and the value of the milliseconds argument was increased to 0 through 60000. The up keyword was added, and the value of the milliseconds argument was set at 0 through 60000. |
Usage Guidelines
When you delay the processing of hardware link down notifications, the higher layer routing protocols are unaware of a link until that link is stable.
If the carrier-delay down milliseconds command is configured on a physical link that fails and cannot be recovered, link down detection is increased, and it may take longer for the routing protocols to re-route traffic around the failed link.
In the case of very small interface state flaps, running the carrier-delay down milliseconds command prevents the routing protocols from experiencing a route flap.
![]() Note | Enter the show interface command to see the current state of the carrier-delay operation for an interface. No carrier-delay information is displayed if carrier-delay has not been configured on an interface. |
Task ID
|
Task ID |
Operations |
|---|---|
|
interface |
read, write |
Examples
This example shows how to delay the processing of hardware link down notifications:
RP/0/0/CPU0:router(config-if)# carrier-delay down 10
The following example shows how to delay the processing of hardware link up and down notifications:
RP/0/0/CPU0:router(config-if)# carrier-delay up 100 down 100
Related Commands
Command | Description |
| Turns on event dampening. |
clear mac-accounting (Ethernet)
To clear Media Access Control (MAC) accounting statistics, use the clear mac-accounting command in EXEC mode.
clear mac-accounting { GigabitEthernet | TenGigE | FastEthernet } interface-path-id [ location node-id ]
Syntax Description
|
{GigabitEthernet | TenGigE | FastEthernet} |
Type of Ethernet interface whose MAC accounting statistics you want to clear. Enter GigabitEthernet, TenGigE , or FastEthernet. |
||
|
interface-path-id |
Physical interface or virtual interface.
For more information about the syntax for the router, use the question mark (?) online help function. |
||
|
location node-id |
(Optional) Clears MAC accounting statistics for the designated node. The node-id argument is entered in the rack/slot/module notation. |
Command Default
No default behavior or values
Command Modes
EXEC
Command History
|
Release |
Modification |
|---|---|
|
Release 3.2 |
This command was introduced. |
Usage Guidelines
Task ID
|
Task ID |
Operations |
|---|---|
|
interface |
read, write |
|
basic-services |
read, write |
Examples
This example shows how to clear all MAC accounting statistics for the TenGigE port at 1/0/0/1:
RP/0/0/CPU0:router# clear mac-accounting TenGigE 0/1/5/0 location 1/0/0/1
Related Commands
Command | Description |
| Generates accounting information for IP traffic based on the source and destination MAC addresses on LAN interfaces. |
| Displays MAC accounting statistics for an interface. |
duplex full (Fast Ethernet)
To configure full-duplex operation on a Fast Ethernet interface, use the duplex full command in interface configuration mode. To return the system to the default duplex operation, use the no form of the duplex full command.
duplex full
no duplex full
Syntax Description
This command has no keywords or arguments.
Command Default
If autonegotiation is disabled on an interface, then the default duplex operation is full duplex.
Command Modes
Interface configuration
Command History
|
Release |
Modification |
|---|---|
|
Release 3.4.0 |
This command was introduced. |
Usage Guidelines
The duplex full command automatically replaces the duplex half command if half duplex was previously configured on your router.
![]() Note | The duplex full command and the duplex half command cannot be configured simultaneously. |
Task ID
|
Task ID |
Operations |
|---|---|
|
interface |
read, write |
Examples
The following example shows how to set the Fast Ethernet interface at full duplex:
RP/0/RP0/CPU0:router(config)# interface FastEthernet 0/2/0/0 RP/0/RP0/CPU0:router(config-if)# duplex full
Related Commands
Command | Description |
Configures half-duplex operation on a Fast Ethernet interface. | |
Enables link autonegotiation on Ethernet interfaces. | |
Displays statistics for all interfaces configured on the router or for a specific node. | |
Configures the speed for a Fast Ethernet interface. |
duplex half (Fast Ethernet)
To configure half-duplex operation on a Fast Ethernet interface, use the duplex half command in interface configuration mode. To return the system to the default duplex operation, use the no form of the duplex half command.
duplex half
no duplex half
Syntax Description
This command has no keywords or arguments.
Command Default
If autonegotiation is disabled on an interface, then the default duplex operation is full duplex.
Command Modes
Interface configuration
Command History
|
Release |
Modification |
|---|---|
|
Release 3.4.0 |
This command was introduced. |
Usage Guidelines
The duplex half command automatically replaces the duplex full command if full duplex was previously configured on your router.
![]() Note | The duplex half command and the duplex full command cannot be configured simultaneously. |
Task ID
|
Task ID |
Operations |
|---|---|
|
interface |
read, write |
Examples
The following examples shows how to set the Fast Ethernet interface at half duplex:
RP/0/RP0/CPU0:router(config)# interface mgmteth 0/RP0/CPU0/0 RP/0/RP0/CPU0:router(config-if)# duplex half
Related Commands
Command | Description |
| |
Enables link autonegotiation on Ethernet interfaces. | |
Displays statistics for all interfaces configured on the router or for a specific node. | |
Configures the speed for a Fast Ethernet interface. |
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 |
Enables flow-control for egress and ingress direction. |
|
egress |
Pauses egress traffic if IEEE 802.3x PAUSE frames are received. |
|
ingress |
Sends IEEE 802.3x PAUSE frames in case of congestion with ingress traffic. |
Command Default
If autonegotiate is enabled on the interface, then the default is negotiated.
If autonegotiate is disabled on the interface, then the sending of flow-control pause frames is disabled for both egress and ingress traffic.
Command Modes
Interface configuration
Command History
|
Release |
Modification |
|---|---|
|
Release 3.2 |
This command was introduced. |
Usage Guidelines
![]() Note | When you explicitly enable the sending of flow-control pause frames, the value you configured with the flow-control command overrides any autonegotiated value. This prevents a link from coming up if the value you set with the flow-control command conflicts with the allowable settings on the other end of the connection. |
![]() Note | The flow-control command is supported on Gigabit Ethernet, TenGigE, and FastEthernet interfaces only; the flow-control command is not supported on Management Ethernet Interfaces. |
![]() Note | The flow-control command syntax options may vary, depending on the type of PLIM or SPA that is installed in your router. |
Task ID
|
Task ID |
Operations |
|---|---|
|
interface |
read, write |
Examples
This 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/0/CPU0:router(config)# interface TenGigE 0/3/0/0 RP/0/0/CPU0:router(config-if)# flow-control ingress
Related Commands
Command | Description |
| Displays statistics for all interfaces configured on the router or for a specific node. |
interface (Ethernet)
To specify or create an Ethernet interface and enter interface configuration mode, use the interface (Ethernet) command in global configuration mode.
interface { FastEthernet | GigabitEthernet | TenGigE } interface-path-id
no interface { FastEthernet | GigabitEthernet | TenGigE } interface-path-id
Syntax Description
| FastEthernet |
Specifies or creates a Fast Ethernet (100 Mbps) interface. |
||
| GigabitEthernet |
Specifies or creates a Gigabit Ethernet (1000 Mbps) interface. |
||
| TenGigE |
Specifies or creates a Ten Gigabit Ethernet (10 Gbps) interface. |
||
| interface-path-id |
Physical interface.
For more information about the syntax for the router, use the question mark (?) online help function. |
Command Default
None
Command Modes
Global configuration (config)
Command History
| Release | Modification |
|---|---|
|
Release 3.2 |
This command was introduced. |
|
Release 3.3.0 |
This command was modified. The FastEthernet keyword was added. |
Usage Guidelines
Task ID
| Task ID | Operation |
|---|---|
|
interface |
read, write |
Examples
This example shows how to enter interface configuration mode for a Ten Gigabit Ethernet interface:
RP/0/0/CPU0:router(config)# interface TenGigE 0/4/0/0 RP/0/0/CPU0:router(config-if)#
Related Commands
Command | Description |
| Displays statistics for all interfaces configured on the router or for a specific node. |
loopback (Ethernet)
To configure an Ethernet controller for loopback mode, use the loopback command in interface configuration mode. To disable loopback, use the no form of this command.
loopback { external | internal | line }
no loopback
Syntax Description
|
external |
All IPv4 self-ping packets are sent out of the interface and looped back externally before being received on the ingress path. |
|
internal |
All packets are looped back internally within the router before reaching an external cable. |
|
line |
Incoming network packets are looped back through the external cable. |
Command Default
Loopback mode is disabled.
Command Modes
Interface configuration
Command History
|
Release |
Modification |
|---|---|
|
Release 3.2 |
This command was introduced. |
Usage Guidelines
The loopback command is available for all Ethernet interface types (Gigabit Ethernet, 10-Gigabit Ethernet, and Fast Ethernet).
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.
![]() Tip | Use the loopback external command when an external loopback connector is attached to the interface. |
Task ID
|
Task ID |
Operations |
|---|---|
|
interface |
read, write |
Examples
In the following example, all packets are looped back to the TenGigE controller:
RP/0/0/CPU0:router(config)# interface TenGigE 0/3/0/0 RP/0/0/CPU0:router(config-if)# loopback internal
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 }
no mac-accounting { egress | ingress }
Syntax Description
|
egress |
Generates accounting information for IP traffic based on the destination MAC addresses (egress direction). |
|
ingress |
Generates accounting information for IP traffic based on the source MAC addresses (ingress direction). |
Command Default
MAC accounting is disabled
Command Modes
Interface configuration
Command History
|
Release |
Modification |
|---|---|
|
Release 3.2 |
This command was introduced. |
Usage Guidelines
The mac-accounting command calculates the total packet and byte counts for a LAN interface that receives or sends IPv4 packets to or from a unique MAC address.
Task ID
|
Task ID |
Operations |
|---|---|
|
interface |
read, write |
Examples
This example shows how to enable MAC accounting for the source MAC address on the ingress direction:
RP/0/0/CPU0:routerconfigure RP/0/0/CPU0:routerinterface bundle-ether <bundle-id> RP/0/0/CPU0:router(config-if)# mac-accounting ingress
This example shows how to enable MAC accounting for the source MAC address on the egress direction:
RP/0/0/CPU0:routerconfigure RP/0/0/CPU0:routerinterface bundle-ether <bundle-id> RP/0/0/CPU0:router(config-if)# mac-accounting egress
![]() Note | In order to view the mac-accounting statistics for the configured bundle interface, use the show mac-accounting bundle-ether <bundle id> command. |
Related Commands
Command | Description |
| Clears MAC accounting statistics for an interface. |
| Displays MAC accounting statistics for an interface. |
mac-address (Ethernet)
To set the MAC layer address of an 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 this command.
mac-address value1.value2.value3
no mac-address
Syntax Description
|
value1. |
High 2 bytes of the MAC address in hexadecimal format. Range is from 0 to ffff. |
|
value2. |
Middle 2 bytes of the MAC address in hexadecimal. Range is from 0 to ffff. |
|
value3 |
Low 2 bytes of the MAC address in hexadecimal. Range is from 0 to ffff. |
Command Default
The default MAC address is read from the hardware burned-in address (BIA).
Command Modes
Interface configuration
Command History
|
Release |
Modification |
|---|---|
|
Release 3.2 |
This command was introduced. |
Usage Guidelines
The MAC address must be in the form of three 4-digit values (12 digits in dotted decimal notation).
The mac-address command is available for all types of line card Ethernet interfaces (Gigabit Ethernet, 10-Gigabit Ethernet, Fast Ethernet) and for the Management Ethernet interface.
Task ID
|
Task ID |
Operations |
|---|---|
|
interface |
read, write |
Examples
This example shows how to set the MAC address of a Ten Gigabit Ethernet interface located at 0/3/0/0:
RP/0/0/CPU0:router(config)# interface TenGigE 0/1/0/0 RP/0/0/CPU0:router(config-if)# mac-address 0001.2468.ABCD
negotiation auto
To enable link autonegotiation on Gigabit Ethernet Fast Ethernet interfaces, use the negotiation auto command in interface configuration mode. To disable link autonegotiation, use the no form of this command.
negotiation auto
no negotiation auto
Syntax Description
This command has no keywords or arguments.
Command Default
Link autonegotiation is disabled.
Command Modes
Interface configuration
Command History
|
Release |
Modification |
|---|---|
|
Release 3.3.0 |
This command was introduced. |
Usage Guidelines
The negotiation auto command is available on Gigabit Ethernet Fast Ethernet interfaces only.
Task ID
|
Task ID |
Operations |
|---|---|
|
interface |
read, write |
Examples
This example shows how to enable link autonegotiation on an interface:
RP/0/0/CPU0:router(config)# interface gigabitethernet 0/0/2/0 RP/0/0/CPU0:router(config-if)# negotiation auto
This example shows how to disable link autonegotiation on an interface:
RP/0/0/CPU0:router(config)# interface gigabitethernet 0/0/2/0 RP/0/0/CPU0:router(config-if)# no negotiation auto
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
This command has no keywords or arguments.
Command Default
The interface uses the standard packet interval as defined by the IEEE 802.ae specification.
Command Modes
Interface configuration
Command History
|
Release |
Modification |
|---|---|
|
Release 3.2 |
This command was introduced. |
Usage Guidelines
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.
![]() Note | The packet-gap non-standard command is available on 10-Gigabit Ethernet interfaces only. |
Task ID
|
Task ID |
Operations |
|---|---|
|
interface |
read, write |
Examples
This example shows how to change the packet interval for traffic on an interface from standard to nonstandard:
RP/0/0/CPU0:router(config)# interface TenGigE 0/3/0/0 RP/0/0/CPU0:router(config-if)# packet-gap non-standard
show controllers (Ethernet)
To display status and configuration information about the Ethernet interfaces on a specific node, use the show controllers command in EXEC mode.
show controllers { FastEthernet | GigabitEthernet | TenGigE } interface-path-id [ all | bert | internal | mac | phy | stats | xgxs ]
Syntax Description
|
{FastEthernet | GigabitEthernet | TenGigE} |
Specifies the type of Ethernet interface whose status and configuration information you want to display. Enter FastEthernet, GigabitEthernet, or TenGigE. |
||
|
interface-path-id |
Physical interface or virtual interface.
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. |
||
|
internal |
Displays internal information for the interface. |
||
|
mac |
Displays mac information for the interface. |
||
|
phy |
Displays physical information for the interface. |
||
|
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 Modes
Command History
|
Release |
Modification |
|---|---|
|
Release 3.2 |
This command was introduced. |
|
Release 3.5.0 |
This command was modified. The GigabitEthernet and TenGigE keywords were 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:
- If specifying a virtual interface, the number range varies, depending on interface type.
Task ID
|
Task ID |
Operations |
||
|---|---|---|---|
|
cisco-support |
read
|
||
|
dwdm |
read |
||
|
interface |
read |
||
|
sonet-sdh |
read |
show mac-accounting (Ethernet)
To display MAC accounting statistics for an interface, use the show mac-accounting command in EXEC mode.
show mac-accounting { GigabitEthernet | TenGigE | FastEthernet } interface-path-id [ location node-id ]
Syntax Description
|
{GigabitEthernet | TenGigEHundred GigEbundle-ether | FastEthernet} |
Indicates the type of Ethernet interface whose MAC accounting statistics you want to display. Enter GigabitEthernet, TenGigE , FastEthernet, . |
||
|
interface-path-id |
Physical interface or virtual interface.
For more information about the syntax for the router, use the question mark (?) online help function. |
||
|
location node-id |
(Optional) 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 Default
No default behavior or values
Command Modes
EXEC
Command History
|
Release |
Modification |
|---|---|
|
Release 3.2 |
This command was introduced. |
Usage Guidelines
For the interface-path-id argument, use these 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:
- If specifying a virtual interface, the number range varies, depending on interface type.
Task ID
|
Task ID |
Operations |
|---|---|
|
interface |
read |
Examples
These examples show the outputs from the show mac-accounting command, which displays MAC accounting statistics on any specified interface:
RP/0/0/CPU0:router# show mac-accounting TenGigE 0/2/0/4 location 0/1/CPU0
TenGigE0/2/0/4
Input (511 free)
000b.4558.caca: 4 packets, 456 bytes
Total: 4 packets, 456 bytes
|
Field |
Description |
|---|---|
|
Interface |
The interface from which the statistics are generated. |
|
Input |
Heading for the ingress MAC accounting statistics. The number of MAC accounting entries still available is shown in parentheses. |
|
Total |
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. This output also excludes any MAC addresses that have 0 packets currently, even if that MAC address was accounted before. Such type of MAC addresses still contribute towards the maximum address limit. |
Related Commands
Command | Description |
| Clears MAC accounting statistics for an interface. |
| Generates accounting information for IP traffic based on the source and destination MAC addresses on LAN interfaces. |
speed (Fast Ethernet)
To configure the speed for a Fast Ethernet interface, enter the speed command in interface configuration mode. To return the system to autonegotiate speed, use the no form of this command.
speed { 10 | 100 | 1000 }
no speed
Syntax Description
|
10 |
Configures the interface to transmit at 10 Mbps. |
|
100 |
Configures the interface to transmit at 100 Mbps. |
|
1000 |
Configures the interface to transmit at 1000 Mbps (1 Gbps). |
Command Default
If autonegotiation is enabled on an interface, the default speed is negotiated.
If autonegotiation is disabled on an interface, the default speed is the maximum speed allowed on the interface.
Command Modes
Interface configuration
Command History
|
Release |
Modification |
|---|---|
|
Release 3.2 |
This command was introduced. |
Usage Guidelines
![]() Note | The speed command is available on Management Ethernet interfaces and Fast Ethernet interfaces only. |
![]() Note | Keep in mind that both ends of a link must have the same interface speed. A manually configured interface speed overides any autonegotiated speed, which can prevent a link from coming up if the configured interface speed at one end of a link is different from the interface speed on the other end. |
Task ID
|
Task ID |
Operations |
|---|---|
|
interface |
read, write |
Examples
The following example shows how to configure the Fast Ethernet interface to transmit at one gigabit:
RP/0/0/CPU0:router(config)# interface FastEthernet 0/0/2/0 RP/0/0/CPU0:router(config-if)# speed 1000


Feedback