Cisco ASR 9000 Series Aggregation Services Router Interface and Hardware Component Command Reference
Ethernet Interface Commands on the Cisco ASR 9000 Series Router
Downloads: This chapterpdf (PDF - 911.0KB) The complete bookPDF (PDF - 7.98MB) | Feedback

Ethernet Interface Commands on the Cisco ASR 9000 Series Router

Contents

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

The following 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 frequency synchronization esmc statistics

To clear the ESMC (Ethernet Synchronization Messaging Channel) statistics, use the clear frequency synchronization esmc statistics command in configuration mode.

clear frequency synchronization esmc statistics interface { interface | all | summary location { node-id | all } }

Syntax Description

interface

The command can be restricted to clear the ESMC (Ethernet Synchronization Messaging Channel) statistics for a particular interface by specifying the interface.

node-id

The output can be restricted to clear the ESMC (Ethernet Synchronization Messaging Channel) statistics for a particular node by specifying the location. The node-id argument is entered in the rack/slot/module notation.

Command Default

No default behavior or values

Command Modes

Configuration

Command History

Release

Modification

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

Operations

ethernet-services

execute

sonet-sdh

execute

Examples

The following example shows how to clear the ESMC (Ethernet Synchronization Messaging Channel) statistics:

RP/0/RSP0/CPU0:router# clear frequency synchronization esmc statistics interface gigabitethenet 0/1/0/1 
   

clear frequency synchronization wait-to-restore

To clear the frequency synchronization wait-to-restore timer, use the clear frequency synchronization wait-to-restore command in configuration mode.

clear frequency synchronization esmc wait-to-restore { interface { interface | all } | clock-interface { sync port-num location node-id | all } }

Syntax Description

interface

The output can be restricted to a particular interface by specifying the interface.

port-num

The output can be restricted to a particular clock-interface sync port by specifying the port number.

node-id

The output can be restricted to a particular node by specifying the location. The node-id argument is entered in the rack/slot/module notation.

Command Default

No default behavior or values

Command Modes

Configuration

Command History

Release

Modification

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

Operations

ethernet-services

execute

sonet-sdh

execute

Examples

The following example shows how to clear the frequency synchronization wait-to-restore timer:

RP/0/RP0/CPU0:router# clear frequency synchronization wait-to-restore interface gigabitethenet 0/1/0/1 

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

Example 1

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

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

clock-interface

To configure the timing-mode for the clock-interfaces on the router, use the clock-interface command in configuration mode. To remove the timing-mode, use the no form of this command.

{ clock-interface timing-mode independent | system }

{ no clock-interface timing-mode independent | system }

Syntax Description

timing-mode

Specifies the timing mode for the clock-interfaces on the router:

  • independent—the output of the clock-interfaces is driven only by line-interfaces (Ethernet and SONET). Each clock-interface port on the router is completely independent. The same timing source cannot be used on more than one port and no loopbacks are allowed between clock-interface ports.
  • system—the output of the clock-interfaces is driven by the system-selected timing source, which can be either the line-interface or the clock-interface.

Command Default

No default behavior or values

Command Modes

Configuration

Command History

Release

Modification

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

Operations

ethernet-services

execute

sonet-sdh

execute

Examples

The following examples show how to configure the timing-mode for the clock-interfaces on the router:

RP/0/RSP0/CPU0:router# config 
RP/0/RSP0/CPU0:router(config)# frequency synchronization 
RP/0/RSP0/CPU0:router(config-freqsync)#clock-interface independent 

RP/0/RSP0/CPU0:router# config 
RP/0/RSP0/CPU0:router(config)# frequency synchronization 
RP/0/RSP0/CPU0:router(config-freqsync)#clock-interface system 
   

clock-interface sync

To configure a clock interface for frequency synchronization on a specific node, use the clock-interface sync command in configuration mode. To remove the clock interface from a node, use the no form of this command.

clock-interface sync port-id location node-id

no clock-interface sync port-id location node-id

Syntax Description

port-id

Clock interface port number.

location node-id

Specifies the node for clock interface frequency synchronization. The node-id argument is entered in the rack/slot/module notation.

Command Default

No default behavior or values

Command Modes

Configuration

Command History

Release

Modification

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

Operations

ethernet-services

execute

sonet-sdh

execute

Examples

The following example shows configure a clock interface for frequency synchronization on a specific node:

RP/0/RSP0/CPU0:router# config
RP/0/RSP0/CPU0:router(config)# clock-interface sync 0 location 0/1/cpu0 
RP/0/RSP0/CPU0:router(config-clock-if)# frequency synchronization 
RP/0/RSP0/CPU0:router(config-clk-freqsync)# 
   

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.

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

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

frequency synchronization

To enable frequency synchronization globally on the router and to configure frequency synchronization options for a controller or interface, use the frequency synchronization command in global configuration mode and SONET, interface, or clock-interface configuration modes. To disable frequency synchronization, use the no form of this command.

frequency synchronization

no frequency synchronization

Syntax Description

This command has no keywords or arguments.

Command Default

Disabled

Command Modes

Global configuration (config)

SONET configuration (config-sonet)

Interface configuration (config-interface)

Clock interface configuration (config-clock-if)

Command History

Release

Modification

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

Configuration of frequency synchronization on the router involves enabling it both in global configuration, and at the SONET, interface, or clock-interface, where you can configure additional commands.

When you configure frequency synchronization in global configuration mode, the default clocking is configured for line timing mode.

Task ID

Task ID

Operations

ethernet-services

execute

sonet-sdh

execute

Examples

Example 1: Global Configuration

The following example shows how to enable Frequency Synchronization in global configuration:

RP/0/RSP0/CPU0:router# config
RP/0/RSP0/CPU0:router(config)# frequency synchronization
RP/0/RSP0/CPU0:router(config-freqsync)# commit
   

The following example shows how to enable Frequency Synchronization on a SONET controller:

RP/0/RSP0/CPU0:router# config
RP/0/RSP0/CPU0:router(config)# controller sonet 0/4/1/0 
RP/0/RSP0/CPU0:router(config-sonet)# frequency synchronization
RP/0/RSP0/CPU0:router(config-sonet-freqsync)#
   

The following example shows how to enable Frequency Synchronization on an Ethernet interface:

RP/0/RSP0/CPU0:router# config
RP/0/RSP0/CPU0:router(config)# interface gigabitEthernet 0/5/0/0
RP/0/RSP0/CPU0:router(config-if)# frequency synchronization
RP/0/RSP0/CPU0:router(config-if-freqsync)#
   

The following example shows how to enable Frequency Synchronization on a clock interface:

RP/0/RSP0/CPU0:router# config
RP/0/RSP0/CPU0:router(config)# clock-interface sync 0 location 0/1/cpu0 
RP/0/RSP0/CPU0:router(config-clock-if)# frequency synchronization
RP/0/RSP0/CPU0:router(config-clk-freqsync)# 
   

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

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

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

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

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

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

 

 

log selection

To enable logging of changes or errors to frequency synchronization, use the log selection command in global frequency synchronization mode. To disable logging, use the no form of this command.

{ log selection changes | errors }

{ no log selection changes | errors }

Syntax Description

changes

Logs selection changes.

errors

Logs selection errors.

Command Default

No default behavior or values

Command Modes

Global frequency synchronization

Command History

Release

Modification

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

Operations

ethernet-services

execute

sonet-sdh

execute

Examples

The following example shows how to enable logging of changes to frequency synchronization:

RP/0/RSP0/CPU0:router# config 
RP/0/RSP0/CPU0:router(config)# frequency synchronization 
RP/0/RSP0/CPU0:router(config-freqsync)# log selection changes 
   

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 }

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

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

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

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

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

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

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

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

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

priority (frequency synchronization)

To configure the priority of the frequency source on a controller or an interface, use the priority command in frequency synchronization configuration mode. To return the priority to the default value, use the no form of this command.

priority priority-value

no priority priority-value

Syntax Description

priority-value

Priority of the frequency source. The priority is used to select between sources with the same Quality Level (QL). The range is 1 (highest priority) to 254 (lowest priority).

Command Default

100

Command Modes

Frequency synchronization configuration

Command History

Release

Modification

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

Operations

ethernet-services

execute

sonet-sdh

execute

Examples

The following example shows how to configure the frequency synchronization priority on a SONET controller:

RP/0/RSP0/CPU0:router# config 
RP/0/RSP0/CPU0:router(config)# controller sonet 0/1/0/1
RP/0/RSP0/CPU0:router(config-sonet)# frequency synchronization
RP/0/RSP0/CPU0:router(config-sonet-freqsync)# priority 150
RP/0/RSP0/CPU0:router(config-sonet-freqsync)# commit
   

The following example shows how to configure thefrequency synchronization priority on interface:

RP/0/RSP0/CPU0:router# config 
RP/0/RSP0/CPU0:router(config)# interface gigabitethernet 0/1/0/1
RP/0/RSP0/CPU0:router(config-if)# frequency synchronization
RP/0/RSP0/CPU0:router(config-if-freqsync)# priority 150
RP/0/RSP0/CPU0:router(config-if-freqsync)# commit   

quality itu-t

To configure the ITU-T QL options, use the quality itu-t command in global configuration mode. To return to the default levels, use the no form of this command.

quality itu-t option

no quality itu-t option

Syntax Description

option

Valid options are:

  • 1 ITU-T QL option 1
  • 2 ITU-T QL option 2

Command Default

Enabled

Command Modes

Global configuration mode

Command History

Release

Modification

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

Operations

ethernet-services

execute

sonet-sdh

execute

Examples

The following example shows how to configure the ITU-T QL options:

RP/0/RSP0/CPU0:router# config 
RP/0/RSP0/CPU0:router(config)# frequency synchronization 
RP/0/RSP0/CPU0:router(config-sonet-freqsync)# quality itu-t option 1 
   

quality receive

To configure all the Synchronization Status Message (SSM) quality levels for the frequency source from the receive interface, use the quality receive command in SONET controller frequency synchonization mode. To return to the default levels, use the no form of this command.

quality receive { lowest ql option ql [ highest ql ] | highest ql option ql | exact ql option ql }

no quality receive { lowest ql option ql [ highest ql ] | highest ql option ql | exact ql option ql }

Syntax Description

ql option

Quality Level (QL) ITU-T options.

Valid values are:

  • Option 1
  • Option 2 Generation 1
  • Option 2 Generation 2

ql

Quality Level (QL) value.

For line interfaces and clock-interface with SSM support, any of the following combinations of QL values may be specified to modify the QL value received via SSM:

  • QL-exact: If this is specified and the received or default QL is not DNU, then this value is used (rather than the received/default QL).
  • QL-min: If this is specified and the received QL is a lower quality than this, then the received QL value is ignored and DNU is used instead.
  • QL-max: If this is specified and the received QL is higher quality than this, then the received QL value is ignored and this value is used instead.
  • QL-min and QL-max: The behavior is as above; QL-max must be at least as high quality as QL-min.
Note   

For clock-interfaces that don't support SSM only, QL-exact may be specified to override the default QL for the source which is set by the platform.

 

Valid QL values for ITU-T Option 1 are:

  • PRC
  • SSU-A
  • SSU-B
  • SEC
  • DNU
 

Valid QL values for ITU-T Option 2 Generation 1 are:

 

Valid QL values for ITU-T Option 2 Generation 2 are:

Command Default

ITU-T Option I

Command Modes

SONET controller frequency synchonization

Command History

Release

Modification

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


Note


If SSM is disabled, only the exact ql option is available.


Task ID

Task ID

Operations

ethernet-services

execute

sonet-sdh

execute

Examples

The following example shows how to configure all the SSM quality levels for the frequency source from the receive interface:

RP/0/RSP0/CPU0:router# config 
RP/0/RSP0/CPU0:router(config)# controller sonet 0/1/0/1
RP/0/RSP0/CPU0:router(config-sonet)# frequency synchronization
RP/0/RSP0/CPU0:router(config-sonet-freqsync)# quality receive itu-t option 2 generation 2 ST3 
   

quality transmit

To configure all the Synchronization Status Message (SSM) quality levels for the frequency source from the transmit interface, use the quality transmit command in SONET controller frequency synchonization mode. To return to the default levels, use the no form of this command.

quality transmit { lowest ql option ql [ highest ql ] | highest ql option ql | exact ql option ql }

no quality transmit { lowest ql option ql [ highest ql ] | highest ql option ql | exact ql option ql }

Syntax Description

ql option

Quality Level (QL) ITU-T options.

Valid values are:

  • Option 1
  • Option 2 Generation 1
  • Option 2 Generation 2

ql

Quality Level (QL) value.

For line interfaces and clock-interface with SSM support, any of the following combinations of QL values may be specified to modify the QL value received via SSM:

  • QL-exact: If this is specified and the received or default QL is not DNU, then this value is used (rather than the received/default QL).
  • QL-min: If this is specified and the received QL is a lower quality than this, then the received QL value is ignored and DNU is used instead.
  • QL-max: If this is specified and the received QL is higher quality than this, then the received QL value is ignored and this value is used instead.
  • QL-min and QL-max: The behavior is as above; QL-max must be at least as high quality as QL-min.
Note   

For clock-interfaces that don't support SSM only, QL-exact may be specified to override the default QL for the source which is set by the platform.

 

Valid QL values for ITU-T Option 1 are:

  • PRC
  • SSU-A
  • SSU-B
  • SEC
  • DNU
 

Valid QL values for ITU-T Option 2 Generation 1 are:

 

Valid QL values for ITU-T Option 2 Generation 2 are:

Command Default

ITU-T Option I

Command Modes

SONET controller frequency synchonization

Command History

Release

Modification

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


Note


If SSM is disabled, only the exact ql option is available.


Task ID

Task ID

Operations

ethernet-services

execute

sonet-sdh

execute

Examples

The following example show how to configure all the SSM quality levels for the frequency source from the transmit interface:

RP/0/RSP0/CPU0:router(config)#controller sonet 0/1/0/1
RP/0/RSP0/CPU0:router(config-sonet)#frequency synchronization
RP/0/RSP0/CPU0:router(config-sonet-freqsync)quality transmit itu-t option 2 generation 2
RP/0/RSP0/CPU0:router(config-sonet-freqsync)#commit
   

selection input

To configure an interface so that it is available as a timing source for selection by the system, use the selection input command in interface frequency synchronization configuration mode. To remove the interface as an available timing source, use the no form of this command.

selection input

no selection input

Syntax Description

This command has no keywords or arguments.

Command Default

Disabled

Command Modes

Interface frequency synchronization configuration

Command History

Release

Modification

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

Operations

ethernet-services

execute

sonet-sdh

execute

Examples

The following example shows how to configure an interface so that it is available as a timing source for selection by the system:

RP/0/RSP0/CPU0:router# config 
RP/0/RSP0/CPU0:router(config)# interface gigabitethernet 0/1/0/1 
RP/0/RSP0/CPU0:router(config-if)# frequency synchronization 
RP/0/RSP0/CPU0:router(config-if-freqsync)# selection input 
RP/0/RSP0/CPU0:router(config-if-freqsync)# commit 
  

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 frequency synchronization clock-interfaces

To display the frequency synchronization information for all clock-interfaces or for a specific node, use the show frequency synchronization clock-interfaces command in EXEC mode.

show frequency synchronization clock-interfaces [brief] [ location node-id ]

Syntax Description

location node-id

The output can be restricted to a particular node by specifying the location. 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.9.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

Operations

ethernet-services

execute

sonet-sdh

execute

Examples

The following example shows the output for the show frequency synchronization clock-interfaces command:

RP/0/RSP0/CPU0:router# show frequency synchronization clock-interfaces

Node 0/0/CPU0:
==============
  Clock interface Sync0 (Up):
    Assigned as input for selection
    SSM supported and enabled
    Input:
      Going down in 00:00:20
      Last received QL: OPT-II,1/PRC
      Effective QL: OPT-II,1/PRC, Priority: 200
    Output:
      Selected source: GigabitEthernet0/0/0/3
      Selected source QL: OPT-II,1/PRC
      Effective QL: DNU
  Next selection points: RP_SELECTOR

  Clock interface Sync1 (Down: mode is not configured):
    Assigned as input for selection
    SSM supported and enabled
    Input:
      Restore in 00:02:00
      Last received QL: Opt-II,2/ST3
      Effective QL: Opt-II,2/ST3, Priority: 100
    Output:
      Selected source: GigabitEthernet0/0/0/3
      Selected source QL: Opt-II,2/PRC
      Effective QL: DNU
  Next selection points: RP_SYSTEM

  Clock interface Internal0 (Up):
    Input:
      Default QL: OPT-II,2/ST3
      Effective QL: OPT-II,2/ST3, Priority 255
  Next selection points: RP_SELECTOR
  

Note


The last received QL and effective output QL are only shown if SSM is supported and enabled on the clock.


The output in brief mode is as follows:

RP/0/RSP0/CPU0:router# show frequency synchronization clock-interfaces brief 

Flags:  > - Up                D - Down              S - Assigned for selection
        d - SSM Disabled      s - Output squelched  L - Looped back
Node 0/0/CPU0:
==============
  Fl    Clock Interface     QLrcv  QLuse  Pri QLsnd  Source
  ===== =================== ====== ====== === ====== ========================
  >S    Sync0               PRC     PRC   100 DNU    GigabitEthernet0/0/0/3
  DS    Sync1               FAILED  DNU   100 n/a    GigabitEthernet0/0/0/3
  >S    Internal0           ST3     ST3   255 n/a
   

show frequency synchronization configuration-errors

To display information about any configuration inconsistencies that are detected, but that are not rejected by verification, use the show frequency synchronization configuration-errors command in EXEC mode.

show frequency synchronization configuration-errors [ location node-id ]

Syntax Description

location

Location of the card, specified by node-id.

node-id

The output can be restricted to a particular node by specifying the location. The node-id argument is entered in the rack/slot/module notation.

Command Default

No default behavior or values

Command Modes

Configuration

Command History

Release

Modification

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

Operations

ethernet-services

execute

sonet-sdh

execute

Examples

The following example shows the normal output for the show frequency synchronization configuration-errors command:

RP/0/RSP0/CPU0:router# show frequency synchronization configuration-errors 

Node 0/0/CPU0:
==============
  interface GigabitEthernet0/0/0/0 frequency synchronization

* Frequency synchronization is enabled on this interface, but isn't enabled globally.
clock-interface Sync 0 location 0/0/CPU0 frequency synchronization quality transmit exact itu-t option 1 PRC

* The QL that is configured is from a different QL option set than is configured globally.
   

show frequency synchronization interfaces

To show the frequency synchronization information for all interfaces or for a specific interface, use the show frequency synchronization interfaces command in EXEC mode.

{ show frequency synchronization interfaces [brief] | [summary] [ location node-id ] | [interface] }

Syntax Description

node-id

The output can be restricted to a particular node by specifying the location. 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.9.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

Operations

ethernet-services

execute

sonet-sdh

execute

Examples

The following example shows the display output for the show frequency synchronization interfaces command:

RP/0/RSP0/CPU0:router# show frequency synchronization interfaces 

Interface GigabitEthernet0/0/0/0 (Up)
  Assigned as input for selection
  SSM Enabled
    Peer Up for 00:01:30, last SSM received 0.345s ago
    Peer has come up 4 times and timed out 3 times
    ESMC SSMs        Total  Information     Event        DNU
      Sent:          98765        98665       100         50
      Received:      54321        54320         1      54300
    13 malformed packets received
    11 received packets were not handled
  Input:
    Restore in 00:03:30
    Last received QL: Opt-II,2/PRC
    Effective QL: DNU, Priority 100
  Output:
    Selected source: Sync0 [0/0/CPU0]
    Selected source QL: OPT-II,2/SEC
    Effective QL: OPT-II,2/SEC
    Output is squelched
  Next selection points: LC_INGRESS

Interface SONET0/2/0/0 (Up)
  Assigned as input for selection
  SSM Enabled
  Input:
    Restore in 00:03:30
    Last received QL: Opt-II,2/PRC
    Effective QL: DNU, Priority 100
  Output:
    Selected source: Sync0 [0/0/CPU0]
    Selected source QL: OPT-II,2/SEC
    Effective QL: OPT-II,2/SEC
    Output is squelched
  Next selection points: LC_INGRESS
   

The output in brief mode is as follows:

Flags:  > - Up                D - Down              S - Assigned for selection
        d - SSM Disabled      x - Peer timed out    i - Init state
        s - Output squelched
Fl   Interface                QLrcv QLuse Pri QLsnd Source
==== ======================== ===== ===== === ===== ========================
>S   GigabitEthernet0/0/0/0   ST2   ST3   100 PRC   Sync0 [0/0/CPU0]
>S   GigabitEthernet0/0/0/1   PROV  DNU   100 PRC   Sync0 [0/0/CPU0]
DdS  GigabitEthernet0/1/0/0   n/a   ST3   50        Sync0 [0/0/CPU0]
D    SONET0/1/0/0             n/a   n/a   100 DNU   Sync0 [0/0/CPU0]
>    GigabitEthernet0/12/0/13 PRC   n/a   200 DNU   Sync0 [0/0/CPU0]
   

The output in summary mode is as follows, for each node:

Node 0/0/CPU0:
  34 Ethernet interfaces in Synchronous mode, 10 assigned for selection, 23 with SSM enabled
  ESMC SSMs        Total  Information    Event        DNU
    Sent:         198765       189665     9100        650
    Received:     654321       654320       91      54321

  12 SONET interfaces in Synchronous mode, 5 assigned for selection, 11 with SSM enabled
   

show frequency synchronization selection

To display the frequency synchronization selection information for all selection points or for a specific node, use the show frequency synchronization selection command in EXEC mode.

show frequency synchronization selection [ summary | location node-id ]

Syntax Description

node-id

The output can be restricted to a particular node by specifying the location. The node-id argument is entered in the rack/slot/module notation.

Command Default

No default behavior or values

Command Modes

Configuration

Command History

Release

Modification

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

Operations

ethernet-services

execute

sonet-sdh

execute

Examples

The following example shows the normal output for the show frequency synchronization selection command:

RP/0/RSP0/CPU0:router# show frequency synchronization selection 

Node 0/0/CPU0:
==============
Selection point: LC_INGRESS (4 inputs, 2 selected)
  Last programmed 00:01:30 ago, and selection made 00:01:29 ago
  Next selection points:
    SPA scoped    : None
    Node scoped   : None
    Chassis scoped: None
    Router scoped : RP_SELECTOR RP_CLOCK_INTF_SELECTOR    
  S  Input                     Last Selection Point         QL  Pri  Status
  == ========================  ========================  =====  ===  ===========
  1  GigabitEthernet0/0/0/3    n/a                         PRC  100  Unmonitored
  2  GigabitEthernet0/0/0/0    n/a                         PRC  200  Down
     GigabitEthernet0/0/0/1    n/a                         ST2   50  Unmonitored
     GigabitEthernet0/0/0/2    n/a                         ST3  100  Unmonitored

Selection point: LC_EGRESS (2 inputs, 1 selected)
  Last programmed 00:25:42 ago, and selection made 00:00:15 ago
  Next selection points:
    SPA scoped    : None
    Node scoped   : None
    Chassis scoped: None
    Router scoped : None
  Used for local line interface output
  Used for local clock-interface output
  S  Input                     Last Selection Point         QL  Pri  Status
  == ========================  ========================  =====  ===  ===========
  1  GigabitEthernet0/0/0/3    0/1/CPU0 RP_SELECTOR 1      PRC  100  Ok
     GigabitEthernet0/0/0/3    0/2/CPU0 RP_SELECTOR 1      PRC  100  Ok

Node 0/1/CPU0:
==============
Selection point: RP_SELECTOR (5 inputs, 1 selected)
  Last programmed 00:01:32 ago, and selection made 00:01:28 ago
  Next selection points:
    SPA scoped    : None
    Node scoped   : None
    Chassis scoped: None
    Router scoped : LC_EGRESS
  S  Input                     Last Selection Point         QL  Pri  Status
  == ========================  ========================  =====  ===  ===========
  1  GigabitEthernet0/0/0/3    0/0/CPU0 LC_INGRESS 1       PRC  100  Ok
     Sync0 [0/1/CPU0]          n/a                         PRC   50  LOS
     GigabitEthernet0/0/0/3    0/2/CPU0 RP_SELECTOR 1      PRC  100  Ok
     GigabitEthernet0/0/0/0    0/0/CPU0 LC_INGRESS 2       PRC  200  Ok
     Internal0 [0/1/CPU0]      n/a                         ST3  255  Ok

Selection point: RP_CLOCK_INTF_SELECTOR (4 inputs, 1 selected)
  Last programmed 00:01:32 ago, and selection made 00:01:28 ago
  Next selection points:
    SPA scoped    : None
    Node scoped   : None
    Chassis scoped: None
    Router scoped : None
  Used for local clock-interface output
  S  Input                     Last Selection Point         QL  Pri  Status
  == ========================  ========================  =====  ===  ===========
  1  GigabitEthernet0/0/0/3    0/0/CPU0 LC_INGRESS 1       PRC  100  Ok
     GigabitEthernet0/0/0/3    0/2/CPU0 RP_SELECTOR 1      PRC  100  Ok
     GigabitEthernet0/0/0/0    0/0/CPU0 LC_INGRESS 2       PRC  200  Ok
     Internal0 [0/1/CPU0]      n/a                         ST3  255  Ok

Node 0/2/CPU0:
==============
Selection point: RP_SELECTOR (4 inputs, 1 selected)
  Last programmed 00:28:55 ago, and selection made 00:00:20 ago
  Next selection points:
    SPA scoped    : None
    Node scoped   : None
    Chassis scoped: None
    Router scoped : LC_EGRESS
  S  Input                     Last Selection Point         QL  Pri  Status
  == ========================  ========================  =====  ===  ===========
  1  GigabitEthernet0/0/0/3    0/1/CPU0 RP_SELECTOR 1      PRC  100  Ok
     GigabitEthernet0/0/0/3    0/0/CPU0 LC_INGRESS 1       PRC  100  Ok
     GigabitEthernet0/0/0/0    0/0/CPU0 LC_INGRESS 2       PRC  200  Ok
     Internal0 [0/2/CPU0]      n/a                         ST3  255  Ok

Selection point: RP_CLOCK_INTF_SELECTOR (4 inputs, 1 selected)
  Last programmed 00:28:55 ago, and selection made 00:00:20 ago
  Next selection points:
    SPA scoped    : None
    Node scoped   : None
    Router scoped : None
    Chassis scoped: None
  Used for local clock-interface output
  S  Input                     Last Selection Point         QL  Pri  Status
  == ========================  ========================  =====  ===  ===========
  1  GigabitEthernet0/0/0/3    0/1/CPU0 RP_SELECTOR 1      PRC  100  Ok
     GigabitEthernet0/0/0/3    0/0/CPU0 LC_INGRESS 1       PRC  100  Ok
     GigabitEthernet0/0/0/0    0/0/CPU0 LC_INGRESS 2       PRC  200  Ok
     Internal0 [0/2/CPU0]      n/a                         ST3  255  Ok
   

The output in summary mode is as follows, showing the timing sources which are selected in the system, and are clocking 1 or more outputs:

GigabitEthernet0/0/0/3 is selected for 2 outputs
Sync0 [0/0/CPU0] is selected for 25 outputs
   

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

Example 1

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

Example 1

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

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

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.  

ssm disable

To disable Synchronization Status Messaging (SSM) on an interface, use the ssm disable command in interface frequency synchronization configuration mode. To return SSM to the default value of enabled, use the no form of this command.

ssm disable

no ssm disable

Command Default

Enabled

Command Modes

Interface frequency synchronization configuration

Command History

Release

Modification

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

Operations

ethernet-services

execute

sonet-sdh

execute

Examples

The following example shows how to disable SSM on an interface:

RP/0/RSP0/CPU0:router# config 
RP/0/RSP0/CPU0:router(config)# interface gigabitethernet 0/1/0/1 
RP/0/RSP0/CPU0:router(config-if)# frequency synchronization 
RP/0/RSP0/CPU0:router(config-if-freqsync)# ssm disable 
RP/0/RSP0/CPU0:router(config-if-freqsync)# commit 
  

transport-mode

To specify the transport mode for a 10-Gigabit Ethernet interface, use the transport-mode command in interface configuration mode. To return to the default mode, use the no form of this command.

transport-mode { wan | otn bit-transparent { opu1e | opu2e } }

no transport-mode { wan | otn bit-transparent { opu1e | opu2e } }

Syntax Description

wan

Configures the interface for 10GBASE-W WAN SONET/SDH (9.95328Gb/s) transport.

otn bit-transparent

Configures the interface for 10-Gigabit Ethernet over Optical Transport Network (ITU-T G.709) with 10GBASE-R transparently mapped into OTU-2.

opu1e

Configures the interface for 10GBASE-R over OPU1e without fixed stuffing (11.0491Gb/s).

opu2e

Configures the interface for 10GBASE-R over OPU2e with fixed stuffing (11.0957Gb/s)

Command Default

The interface is in LAN mode. Neither WAN mode or OTN mode is configured.

Command Modes

Interface configuration

Command History

Release

Modification

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

Three modes are supported for a 10-Gigabit Ethernet interface: LAN, WAN, or OTN on the following Ethernet line cards:

  • 2-Port 10-Gigabit Ethernet, 20-Port Gigabit Ethernet Combination line card (A9K-2T20GE-B and A9K-2T20GE-L)
  • 8-Port 10-Gigabit Ethernet line card (A9K-8T-L, -B, or -E)
  • 16-Port 10-Gigabit Ethernet SFP+ line card (A9K-16T/8-B and A9K-16T/8-B+AIP)

If you want to configure the interface for DWDM support, configure the 10-Gigabit Ethernet interface for OTN transport mode.

Task ID

Task ID

Operations

interface

read, write

Examples

The following example shows how to configure the interface for WAN PHY mode:

RP/0/RSP0/CPU0:router# config
RP/0/RSP0/CPU0:router(config)# interface 10gigabitethernet 0/1/0/1
RP/0/RSP0/CPU0:router(config-if)# transport-mode wan 
RP/0/RSP0/CPU0:router(config-if)# commit
   

The following example shows how to configure a DWDM interface using OTN transport:

RP/0/RSP0/CPU0:router# config 
RP/0/RSP0/CPU0:router(config)# interface 10gigabitethernet 0/1/0/1 
RP/0/RSP0/CPU0:router(config-if)# transport-mode otn bit-transparent opu1e
RP/0/RSP0/CPU0:router(config-if)# commit 
   

The following example shows how to return the interface configuration to its default LAN mode from OTN or WAN PHY mode:

RP/0/RSP0/CPU0:router# config
RP/0/RSP0/CPU0:router(config)# interface 10gigabitethernet 0/1/0/1
RP/0/RSP0/CPU0:router(config-if)# no transport-mode 
RP/0/RSP0/CPU0:router(config-if)# commit
   

Related Commands

Command

Description

controller wanphy

Enters WAN physical controller configuration mode in which you can configure a 10-Gigabit Ethernet WAN PHY controller.  

wait-to-restore

To configure the wait-to-restore time for frequency synchronization on an interface, use the wait-to-restore command in interface frequency synchronization configuration mode. To return the wait-to-restore time to the default value, use the no form of this command.

wait-to-restore minutes

no wait-to-restore minutes

Syntax Description

minutes

The delay time (in minutes) between when an interface comes up and when it is used for synchronization. The range is 0 to 12.

Command Default

There is a 5-minute delay for frequency synchronization after an interface comes up.

Command Modes

Interface frequency synchronization (config-if-freqsync)

Command History

Release

Modification

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

Operations

ethernet-services

execute

sonet-sdh

execute

Examples

The following example shows how to configure the wait-to-restore time for frequency synchronization on an interface:

RP/0/RSP0/CPU0:router# config 
RP/0/RSP0/CPU0:router(config)# interface gigabitethernet 0/1/0/1
RP/0/RSP0/CPU0:router(config-if)# frequency synchronization
RP/0/RSP0/CPU0:router(config-if-freqsync)# wait-to-restore 0
RP/0/RSP0/CPU0:router(config-if-freqsync)# selection input
RP/0/RSP0/CPU0:router(config-sonet-freqsync)# commit