Cisco ASR 9000 Series Aggregation Services Router Interface and Hardware Component Command Reference, Release 5.1.x
Ethernet Interface Commandson the Cisco ASR 9000 Series Router
Downloads: This chapterpdf (PDF - 1.53MB) The complete bookPDF (PDF - 8.11MB) | Feedback

Ethernet Interface Commandson the Cisco ASR 9000 Series Router

Ethernet Interface Commandson the Cisco ASR 9000 Series Router

This module provides command line interface (CLI) commands for configuring Ethernet interfaces on the Cisco ASR 9000 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.7.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.

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/RSP0/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/RSP0/CPU0:router(config-if)# carrier-delay up 100 down 100
  

Related Commands

Command

Description

dampening

Turns on event dampening.  

clear lldp

To reset Link Layer Discovery Protocol (LLDP) traffic counters or LLDP neighbor information, use the clear lldp command in EXEC configuration mode.

clear lldp { counters | table }

Syntax Description

counters

Specifies that LLDP traffic counters are cleared.

table

Specifies that LLDP information in the neighbor table is cleared.

Command Default

LLDP traffic counters are not reset, and LLDP neighbor information is not cleared.

Command Modes

EXEC (#)

Command History

Release Modification

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

To reset counters from the show lldp traffic command, use the clear lldp counters command. To clear neighbor information displayed by the show lldp neighbors command, use the clear lldp table command.

Task ID

Task ID Operation

ethernet-services

read, write

Examples

The following example shows how to clear the LLDP counters and display LLDP traffic. The output from the show lldp traffic command shows that all the traffic counters have been reset to zero.

RP/0/RSP0/CPU0:router# clear lldp counters
RP/0/RSP0/CPU0:router# show lldp traffic
LLDP traffic statistics:
        Total frames out: 0
        Total entries aged: 0
        Total frames in: 0
        Total frames received in error: 0
        Total frames discarded: 0
        Total TLVs discarded: 0
        Total TLVs unrecognized: 0

The following example shows how to clear the LLDP table. The output of the show lldp neighbors command shows that all information has been deleted from the table.

RP/0/RSP0/CPU0:router# clear lldp table
RP/0/RSP0/CPU0:router# show lldp neighbors
Capability codes:
    (R) Router, (B) Bridge, (T) Telephone, (C) DOCSIS Cable Device
    (W) WLAN Access Point, (P) Repeater, (S) Station, (O) Other

Device ID           Local Intf     Hold-time  Capability      Port ID

Related Commands

Command

Description

show lldp neighbors

Displays information about LLDP neighbors.  

show lldp traffic

Displays statistics for LLDP traffic.  

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 } interface-path-id [ location node-id ]

Syntax Description

{GigabitEthernet | TenGigE}

Type of Ethernet interface whose MAC accounting statistics you want to clear. Enter GigabitEthernet, 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.

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 4.1.1

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

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

RP/0/RSP0/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.  

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

This command was first introduced.

Release 4.2.3

This command was supported on 1 Gigabit Ethernet optical and copper SFPs.

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 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/RSP0/CPU0:router(config)# interface TenGigE 0/3/0/0
RP/0/RSP0/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 { GigabitEthernet | TenGigE } interface-path-id

no interface { GigabitEthernet | TenGigE } interface-path-id

Syntax Description

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

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

This example shows how to enter interface configuration mode for a Ten Gigabit Ethernet interface:

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

Related Commands

Command

Description

show interfaces

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

lldp

To enable the Link Layer Discovery Protocol (LLDP) globally for both transmit and receive operation on the system, use the lldp command in global configuration mode. To disable LLDP, use the no form of this command.

lldp

no lldp

Syntax Description

This command has no keywords or arguments.

Command Default

LLDP is disabled.

Command Modes

Global configuration (config)

Command History

Release Modification

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

When you enable LLDP globally using the lldp command, all supported interfaces are enabled for both transmit and receive operation. You can disable either transmit or receive operation for a particular interface using the lldp (interface) command.

Task ID

Task ID Operation

ethernet-services

read, write

Examples

This example shows how to enable LLDP globally on the router:

RP/0/RSP0/CPU0:router(config)# lldp

Related Commands

Command

Description

show lldp

Displays the global LLDP operational characteristics on the system.  

lldp (interface)

To enter LLDP configuration mode, use the lldp (interface) command.

lldp

Syntax Description

This command has no keywords or arguments.

Command Default

None

Command Modes

Interface configuration (config-if)

Command History

Release Modification

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

Task ID

Task ID Operation

ethernet-services

read, write

interface

read, write

Examples

This example shows how to enter LLDP configuration mode from Ethernet interface configuration mode:

RP/0/RSP0/CPU0:router(config)# interface GigabitEthernet 0/1/0/0
RP/0/RSP0/CPU0:router(config-if)# lldp
RP/0/RSP0/CPU0:router(config-lldp)#

Related Commands

Command

Description

interface (Ethernet)

Specifies or creates an Ethernet interface and enters interface configuration mode.  

lldp

Enables LLDP globally for both transmit and receive operation on the system.  

lldp holdtime

To specify the length of time that information from a Link Layer Discovery Protocol (LLDP) packet should be held by the receiving device before aging and removing it, use the lldp holdtime command in global configuration mode. To return to the default, use the no form of this command.

lldp holdtime seconds

no lldp holdtime seconds

Syntax Description

seconds

Number from 0 to 65535 that specifies the amount of time (in seconds) to hold the packet information. The default is 120.

Command Default

The packet hold time is 120 seconds (2 minutes).

Command Modes

Global configuration (config)

Command History

Release Modification

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

Task ID

Task ID Operation

ethernet-services

read, write

Examples

This example shows how to change the default hold time to 1 minute:

RP/0/RSP0/CPU0:router(config)# lldp holdtime 60

Related Commands

Command

Description

lldp

Enables LLDP globally for both transmit and receive operation on the system.  

show lldp

Displays the global LLDP operational characteristics on the system.  

lldp reinit

To specify the length of time to delay initialization of the Link Layer Discovery Protocol (LLDP) on an interface, use the lldp reinit command in global configuration mode. To return to the default, use the no form of this command.

lldp reinit seconds

no lldp reinit seconds

Syntax Description

seconds

Number from 2 to 5 that specifies the length of time (in seconds) that LLDP should delay initialization. The default is 2.

Command Default

Initialization of LLDP is delayed for 2 seconds on an interface.

Command Modes

Global configuration (config)

Command History

Release Modification

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

Task ID

Task ID Operation

ethernet-services

read, write

Examples

The following example shows how to change the default initialization delay from 2 to 4 seconds:

RP/0/RSP0/CPU0:router(config)# lldp reinit 4

Related Commands

Command

Description

lldp

Enables LLDP globally for both transmit and receive operation on the system.  

show lldp

Displays the global LLDP operational characteristics on the system.  

lldp timer

To specify the Link Layer Discovery Protocol (LLDP) packet rate, use the lldp timer command in global configuration mode. To return to the default, use the no form of this command.

lldp timer seconds

no lldp timer seconds

Syntax Description

seconds

Number from 5 to 65534 that specifies the rate (in seconds) at which to send LLDP packets. The default is 30.

Command Default

LLDP packets are sent every 30 seconds.

Command Modes

Global configuration (config)

Command History

Release Modification

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

Task ID

Task ID Operation

ethernet-services

read, write

Examples

The following example shows how to change the default LLDP packet rate from 30 seconds to 1 minute:

RP/0/RSP0/CPU0:router(config)# lldp timer 60

Related Commands

Command

Description

lldp

Enables LLDP globally for both transmit and receive operation on the system.  

show lldp

Displays the global LLDP operational characteristics on the system.  

lldp tlv-select disable

To disable transmission of the selected Type Length Value (TLV) in Link Layer Discovery Protocol (LLDP) packets, use the lld tlv-select disable command in global configuration mode. To return to the default, use the no form of this command.

lldp tlv-select tlv-name disable

no lldp tlv-select tlv-name disable

Syntax Description

tlv-name
Name of the TLV to be suppressed from LLDP packets. The tlv-name can be one of the following LLDP TLV types:
  • management-address
  • port-description
  • system-capabilities
  • system-description
  • system-name

Command Default

All TLVs are sent in LLDP packets.

Command Modes

Global configuration (config)

Command History

Release Modification

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

Certain TLVs are classified as mandatory in LLDP packets, such as the Chassis ID, Port ID, and Time to Live (TTL) TLVs. These TLVs must be present in every LLDP packet. You can use the lldp tlv-select disable command to suppress transmission of certain other optional TLVs in LLDP packets.

Task ID

Task ID Operation

ethernet-services

read, write

Examples

The following example shows how to disable transmission of the System Capabilities TLV from LLDP packets:

RP/0/RSP0/CPU0:router(config)# lldp tlv-select system-capabilities disable

Related Commands

Command

Description

 

 

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

This command was first 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).

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/RSP0/CPU0:router(config)# interface TenGigE 0/3/0/0
RP/0/RSP0/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 4.1.1

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

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

RP/0/RSP0/CPU0:routerconfigure
RP/0/RSP0/CPU0:routerinterface bundle-ether <bundle-id>
RP/0/RSP0/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/RSP0/CPU0:routerconfigure
RP/0/RSP0/CPU0:routerinterface bundle-ether <bundle-id>
RP/0/RSP0/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

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

This command was first 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) 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/RSP0/CPU0:router(config)# interface TenGigE 0/1/0/0 
RP/0/RSP0/CPU0:router(config-if)# mac-address 0001.2468.ABCD
   

negotiation auto

To enable link autonegotiation on Gigabit 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.7.2

This command was first introduced.

Release 4.2.3

The negotiation auto command was supported on 1 Gigabit Ethernet interfaces.

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 interfaces only.

Task ID

Task ID

Operations

interface

read, write

Examples

This example shows how to enable link autonegotiation on an interface:

RP/0/RSP0/CPU0:router(config)# interface gigabitethernet 0/0/2/0
RP/0/RSP0/CPU0:router(config-if)# negotiation auto
   

This example shows how to disable link autonegotiation on an interface:

RP/0/RSP0/CPU0:router(config)# interface gigabitethernet 0/0/2/0
RP/0/RSP0/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.7.2

This command was first 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

This example shows how to change the packet interval for traffic on an interface from standard to nonstandard:

RP/0/RSP0/CPU0:router(config)# interface TenGigE 0/3/0/0
RP/0/RSP0/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 { GigabitEthernet | TenGigE } interface-path-id [ all | bert | internal | mac | phy | stats | xgxs ]

Syntax Description

{GigabitEthernet | TenGigE}

Specifies the type of Ethernet interface whose status and configuration information you want to display. Enter 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.7.2

This command was first 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

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 lldp

To display the global Link Layer Discovery Protocol (LLDP) operational characteristics on the system, use the show lldp command in EXEC configuration mode.

show lldp

Syntax Description

This command has no keywords or arguments.

Command Default

None

Command Modes

EXEC (#)

Command History

Release Modification

Release 4.1.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 show lldp command displays the LLDP operational characteristics when LLDP is enabled globally on the system using the lldp command. The settings for the following commands are displayed:
  • lldp timer
  • lldp holdtime
  • lldp reinit

Task ID

Task ID Operation

ethernet-services

read

Examples

The following example shows the default LLDP operational characteristics when LLDP is enabled globally on the system:

RP/0/RSP0/CPU0:router# show lldp
Wed Apr 13 06:16:45.510 DST
Global LLDP information:
        Status: ACTIVE
        LLDP advertisements are sent every 30 seconds
        LLDP hold time advertised is 120 seconds
        LLDP interface reinitialisation delay is 2 seconds

The following example shows the output when LLDP is not enabled globally on the system:

RP/0/RSP0/CPU0:router# show lldp
Wed Apr 13 06:42:48.221 DST
% LLDP is not enabled

Related Commands

Command

Description

lldp

Enables LLDP globally for both transmit and receive operation on the system.  

lldp timer

Specifies the LLDP packet rate.  

lldp holdtime

Specifies the length of time that information from an LLDP packet should be held by the receiving device before aging and removing it.  

lldp reinit

Specifies the length of time to delay initialization of LLDP on an interface.  

show lldp entry

To display detailed information about LLDP neighbors, use the show lldp entry command in EXEC configuration mode.

show lldp entry { * | name }

Syntax Description

*

Displays detailed information about all LLDP neighbors.

name

Name of a specific LLDP neighbor for which detailed information is displayed.

Syntax Description

This command has no keywords or arguments.

Command Modes

EXEC (#)

Command History

Release Modification

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

Task ID

Task ID Operation

ethernet-services

read

Examples

The following example shows sample output for all LLDP neighbor table entries on the system:

RP/0/RSP0/CPU0:router# show lldp entry *
Wed Apr 13 10:29:40.342 UTC
Capability codes:
        (R) Router, (B) Bridge, (T) Telephone, (C) DOCSIS Cable Device
        (W) WLAN Access Point, (P) Repeater, (S) Station, (O) Other

------------------------------------------------
Local Interface: GigabitEthernet0/0/0/8
Chassis id: 0026.9815.c3e6
Port id: Gi0/0/0/8
Port Description: GigabitEthernet0/0/0/8
System Name: asr9k-5

System Description: 
Cisco IOS XR Software, Version 4.1.0.32I[Default]
Copyright (c) 2011 by Cisco Systems, Inc.

Time remaining: 102 seconds
Hold Time: 120 seconds
System Capabilities: R
Enabled Capabilities: R
Management Addresses:
  IPv4 address: 10.5.173.110



------------------------------------------------
Local Interface: GigabitEthernet0/0/0/8
Chassis id: 0026.9815.c3e6
Port id: Gi0/0/0/8.1
Port Description: GigabitEthernet0/0/0/8.1
System Name: asr9k-5

System Description: 
Cisco IOS XR Software, Version 4.1.0.32I[Default]
Copyright (c) 2011 by Cisco Systems, Inc.

Time remaining: 96 seconds
Hold Time: 120 seconds
System Capabilities: R
Enabled Capabilities: R
Management Addresses:
  IPv4 address: 10.5.173.110



Total entries displayed: 2

Related Commands

Command

Description

lldp

Enables LLDP globally for both transmit and receive operation on the system.  

show lldp errors

To display Link Layer Discovery Protocol (LLDP) error and overflow statistics, use the show lldp errors command in EXEC configuration mode.

show lldp errors [ location location ]

Syntax Description

location location

(Optional) Displays information about LLDP neighbors for the specified location. The location argument is entered in the rack/slot/module notation.

Command Default

Totals of LLDP error and overflow statistics for the system are displayed.

Command Modes

EXEC (#)

Command History

Release Modification

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

Task ID

Task ID Operation

ethernet-services

read

Examples

The following example shows sample output for the show lldp errors command:

RP/0/RSP0/CPU0:router# show lldp errors
Wed Apr 13 06:17:08.321 DST

LLDP errors/overflows:
        Total memory allocation failures: 0
        Total encapsulation failures: 0
        Total input queue overflows: 0
        Total table overflows: 0

Related Commands

Command

Description

lldp

Enables LLDP globally for both transmit and receive operation on the system.  

show lldp traffic

Displays statistics for LLDP traffic.  

show lldp interface

To display Link Layer Discovery Protocol (LLDP) configuration and status information on an interface, use the show lldp interface command in EXEC configuration mode.

show lldp interface [ type interface-path-id | location location ]

Syntax Description

type

(Optional) Interface type. For more information, use the question mark (?) online help function.

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 location

(Optional) Displays information about LLDP neighbors for the specified location. The location argument is entered in the rack/slot/module notation.

Command Default

LLDP configuration and status information for all interfaces is displayed.

Command Modes

EXEC (#)

Command History

Release Modification

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

When LLDP is enabled globally on the system, all supported interfaces are automatically enabled for both LLDP receive and transmit operations. You can individually disable interfaces for either LLDP receive or transmit operations using the receive disable command or transmit disable command in LLDP configuration mode under the interface.

Task ID

Task ID Operation

ethernet-services

read

Examples

The following example shows sample output for the show lldp interface command for the Gigabit Ethernet interface at 0/1/0/7:

RP/0/RSP0/CPU0:router# show lldp interface gigabitethernet 0/1/0/7
Wed Apr 13 13:22:30.501 DST


GigabitEthernet0/1/0/7:
        Tx: enabled
        Rx: enabled
        Tx state: IDLE
        Rx state: WAIT FOR FRAME
Table 1 show lldp interface Field Descriptions
Field Description

Tx:

Configuration status of the interface to transmit LLDP advertisements.

Rx:

Configuration status of the interface to receive LLDP advertisements.

Tx state:

Status of the LLDP transmit process on the interface.

Rx state:

Status of the LLDP receive process on the interface.

Related Commands

Command

Description

lldp

Enables LLDP globally for both transmit and receive operation on the system.  

lldp (interface)

Enters LLDP configuration mode.  

receive disable

Disables LLDP receive operations on the interface.  

transmit disable

Disables LLDP transmit operations on the interface.  

show lldp neighbors

To display information about Link Layer Discovery Protocol (LLDP) neighbors, use the show lldp neighbors command in EXEC configuration mode.

show lldp neighbors [ type interface-path-id | location location ] [detail]

Syntax Description

type

(Optional) Interface type. For more information, use the question mark (?) online help function.

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 location

(Optional) Displays information about LLDP neighbors for the specified location. The location argument is entered in the rack/slot/module notation.

detail

(Optional) Displays all available information about LLDP neighbors.

Command Default

Basic device information for LLDP neighbors is displayed.

Command Modes

EXEC (#)

Command History

Release Modification

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

To clear the neighbor information displayed by the show lldp neighbors command, use the clear lldp table command.

Task ID

Task ID Operation

ethernet-services

read

Examples

The following example show sample output for the show lldp neighbors command:

RP/0/RSP0/CPU0:router# show lldp neighbors
Capability codes:
    (R) Router, (B) Bridge, (T) Telephone, (C) DOCSIS Cable Device
    (W) WLAN Access Point, (P) Repeater, (S) Station, (O) Other

Device ID           Local Intf     Hold-time  Capability      Port ID
R1                  Et1/0          150        R               Et1/0

Total entries displayed: 1
Table 2 show lldp neighbors Field Descriptions
Field Description

Device ID

Name of the neighbor device.

Note   

If the device ID has more than 20 characters, the ID will be truncated to 20 characters in command output because of display constraints.

Local Intf

Local interface through which this neighbor is connected.

Hold-time

Amount of time (in seconds) that the local device will hold the LLDP advertisement from a sending device before discarding it.

Capability

The device type of the neighbor, whose values correspond to the characters and definition displayed in the "Capability codes" section.

Port ID

Interface and port number of the neighboring device.

The following example shows sample output for the show lldp neighbors detail command:

RP/0/RSP0/CPU0:router# show lldp neighbors detail
Wed Apr 13 10:29:40.342 UTC
Capability codes:
        (R) Router, (B) Bridge, (T) Telephone, (C) DOCSIS Cable Device
        (W) WLAN Access Point, (P) Repeater, (S) Station, (O) Other

------------------------------------------------
Local Interface: GigabitEthernet0/0/0/8
Chassis id: 0026.9815.c3e6
Port id: Gi0/0/0/8
Port Description: GigabitEthernet0/0/0/8
System Name: asr9k-5

System Description: 
Cisco IOS XR Software, Version 4.1.0.32I[Default]
Copyright (c) 2011 by Cisco Systems, Inc.

Time remaining: 102 seconds
Hold Time: 120 seconds
System Capabilities: R
Enabled Capabilities: R
Management Addresses:
  IPv4 address: 10.5.173.110



------------------------------------------------
Local Interface: GigabitEthernet0/0/0/8
Chassis id: 0026.9815.c3e6
Port id: Gi0/0/0/8.1
Port Description: GigabitEthernet0/0/0/8.1
System Name: asr9k-5

System Description: 
Cisco IOS XR Software, Version 4.1.0.32I[Default]
Copyright (c) 2011 by Cisco Systems, Inc.

Time remaining: 96 seconds
Hold Time: 120 seconds
System Capabilities: R
Enabled Capabilities: R
Management Addresses:
  IPv4 address: 10.5.173.110



Total entries displayed: 2

Related Commands

Command

Description

lldp

Enables LLDP globally for both transmit and receive operation on the system.  

clear lldp

Resets LLDP traffic counters or LLDP neighbor information.  

show lldp traffic

To display statistics for Link Layer Discovery Protocol (LLDP) traffic, use the show lldp traffic command in EXEC configuration mode.

show lldp traffic [ location location ]

Syntax Description

location location

(Optional) Displays LLDP statistics for traffic at the specified location. The location argument is entered in the rack/slot/module notation.

Command Default

Totals of LLDP statistics for the system are displayed.

Command Modes

EXEC (#)

Command History

Release Modification

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

To reset the counters displayed by the show lldp traffic command, use the clear lldp counters command.

Task ID

Task ID Operation

ethernet-services

read

Examples

The following example shows sample output for statistics for all LLDP traffic on the system:

RP/0/RSP0/CPU0:router# show lldp traffic
LLDP traffic statistics:
    Total frames out: 277
    Total entries aged: 0
    Total frames in: 328
    Total frames received in error: 0
    Total frames discarded: 0
    Total TLVs discarded: 0
    Total TLVs unrecognized: 0
Table 3 show lldp traffic Field Descriptions
Field Description

Total frames out:

Number of LLDP advertisements sent from the device.

Total entries aged:

Number of LLDP neighbor entries removed due to expiration of the hold time.

Total frames in:

Number of LLDP advertisements received by the device.

Total frames received in error:

Number of times the LLDP advertisements contained errors of any type.

Total frames discarded:

Number of times the LLDP process discarded an incoming advertisement.

Total TLVs discarded:

Number of times the LLDP process discarded a Type Length Value (TLV) from an LLDP frame.

Total TLVs unrecognized:

Number of TLVs that could not be processed because the content of the TLV was not recognized by the device or the contents of the TLV were incorrectly specified.

Related Commands

Command

Description

lldp

Enables LLDP globally for both transmit and receive operation on the system.  

clear lldp

Resets LLDP traffic counters or LLDP neighbor information.  

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 } interface-path-id [ location node-id ]

Syntax Description

{GigabitEthernet | TenGigEHundred GigEbundle-ether }

Indicates the type of Ethernet interface whose MAC accounting statistics you want to display. Enter GigabitEthernet, 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.

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 4.1.1

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

These examples show the outputs from the show mac-accounting command, which displays MAC accounting statistics on any specified interface:

RP/0/RSP0/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 4 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. 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

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.  

small-frame-padding

To enable small frame padding on physical interfaces, use the small-frame-padding command in the interface configuration mode. To disable small frame padding, use the no form of this command.

small-frame-padding interface-path-id

no small-frame-padding

Syntax Description

interface-path-id

Physical interface type.

Command Default

None

Command Modes

Interface Configuration mode

Command History

Release Modification

Release 4.3.1

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


This command is applicable for all physical interfaces on all types of Cisco ASR 9000 Series Router line cards except Cisco ASR 9000 Ethernet line cards.


Task ID

Task ID Operation

interface

read, write

Examples

This example shows how to use the small-frame-padding command:

RP/0/RSP0/CPU0:router(config)# interface GigabitEthernet 0/4/0/0
RP/0/RSP0/CPU0:router(config-if)# small-frame-padding

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 4.2.3

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.



Note


The speed configuration is supported for 1 Gigabit Ethernet copper SFPs and not supported for 1 Gigabit Ethernet optical SFPs.


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/RSP0/CPU0:router(config)# interface FastEthernet 0/0/2/0
RP/0/RSP0/CPU0:router(config-if)# speed 1000