Cisco IOS XR Interface and Hardware Component Command Reference for the Cisco XR 12000 Series Router, Release 4.2.x
Ethernet Interface Commands on the Cisco IOS XR Software
Downloads: This chapterpdf (PDF - 1.29MB) The complete bookPDF (PDF - 7.4MB) | Feedback

Ethernet Interface Commands on the Cisco IOS XR Software

Ethernet Interface Commands on 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

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 0 through 65535.

up milliseconds

Length of time, in milliseconds, to delay the processing of hardware link up notifications. Range is from 0 through 65535.

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 65535. The up keyword was added, and the value of the milliseconds argument was set at 0 through 65535.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

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

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

dampening

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

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.

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.

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

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Task ID

Task ID

Operations

interface

read, write

basic-services

read, write

Examples

The following example shows how to clear all MAC accounting statistics for the TenGigE port at 1/0/0/1:

RP/0/0/CPU0:routerclear mac-accounting TenGigE 0/1/5/0 location 1/0/0/1
   

Related Commands

Command

Description

mac-accounting

Generates accounting information for IP traffic based on the source and destination MAC addresses on LAN interfaces.  

show mac-accounting (Ethernet)

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

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

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

duplex half (Fast Ethernet)

Configures half-duplex operation on a Fast Ethernet interface.  

negotiation auto

Enables link autonegotiation on Ethernet interfaces.  

show interfaces

Displays statistics for all interfaces configured on the router or for a specific node.  

speed (Fast Ethernet)

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

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

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

duplex full (Fast Ethernet)

 

negotiation auto

Enables link autonegotiation on Ethernet interfaces.  

show interfaces

Displays statistics for all interfaces configured on the router or for a specific node.  

speed (Fast Ethernet)

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

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.


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

The following example shows how to enable the sending of flow-control pause frames for ingress traffic on the TenGigE interface 0/3/0/0:

RP/0/0/CPU0:router(config)# interface TenGigE 0/3/0/0
RP/0/0/CPU0:router(config-if)# flow-control ingress
   

Related Commands

Command

Description

show interfaces

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.

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.

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

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

To specify a physical interface, the notation for the interface-path-id 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.

Task ID

Task ID Operation

interface

read, write

Examples

The following example shows how to enter interface configuration mode for a Gigabit Ethernet interface:

RP/0/0/CPU0:router(config)# interface GigabitEthernet 0/4/0/0
RP/0/0/CPU0:router(config-if)#

Related Commands

Command

Description

show interfaces

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

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

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 }

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

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

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

The following example shows how to enable MAC accounting for the source MAC address on the ingress direction:

RP/0/0/CPU0:router(config-if)# mac-accounting ingress
   

Related Commands

Command

Description

clear mac-accounting (Ethernet)

Clears MAC accounting statistics for an interface.  

show mac-accounting (Ethernet)

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

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

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

The following example shows how to set the MAC address of a Gigabit Ethernet interface located at 0/1/5/0:

RP/0/0/CPU0:router(config)# interface GigabitEthernet 0/1/5/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

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

The negotiation auto command is available on Gigabit Ethernet Fast Ethernet interfaces only.

Task ID

Task ID

Operations

interface

read, write

Examples

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

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

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

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

The following 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.

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.

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

EXEC (#)

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

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

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.

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

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

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.

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

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

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.

Task ID

Task ID

Operations

interface

read

Examples

The following example shows the output from the show mac-accounting command, which displays MAC accounting statistics on the specified interface:

RP/0/0/CPU0:routershow 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
   
Table 1 show mac-accounting Field Descriptions

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.

Related Commands

Command

Description

clear mac-accounting (Ethernet)

Clears MAC accounting statistics for an interface.  

mac-accounting

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

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.


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