-
Interface and Hardware Component Command Reference for the Cisco NCS 6000 Series Routers
-
Preface
-
Ethernet Interface Commands \n\t
-
Ethernet OAM Commands
-
Global Interface Commands
-
Link Bundling Commands
-
Management Ethernet Interface Commands
-
Null Interface Commands
-
Packet-over-SONET Interface Commands
-
PPP Commands
-
VLAN Subinterface Commands
-
10-Gigabit Ethernet\n\t WAN PHY Controller Commands
-
Index
-
Feedback
Contents
Ethernet Interface Commands
- carrier-delay
- clear mac-accounting (Ethernet)
- flow-control
- interface (Ethernet)
- loopback (Ethernet)
- mac-accounting
- mac-address (Ethernet)
- negotiation auto
- packet-gap non-standard
- show controllers (Ethernet)
- show mac-accounting (Ethernet)
carrier-delay
To delay the processing of hardware link down notifications, use the carrier-delay command in interface configuration mode.
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 History
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
Examples
This example shows how to delay the processing of hardware link down notifications:
RP/0/RP0/CPU0:router(config-if)# carrier-delay down 10The following example shows how to delay the processing of hardware link up and down notifications:
RP/0/RP0/CPU0:router(config-if)# carrier-delay up 100 down 100clear mac-accounting (Ethernet)
To clear Media Access Control (MAC) accounting statistics, use the clear mac-accounting command in EXEC mode.
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 History
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
Examples
This example shows how to clear all MAC accounting statistics for the TenGigE port at 1/0/0/1:
RP/0/RP0/CPU0:router# clear mac-accounting TenGigE 0/1/5/0 location 1/0/0/1flow-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 History
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
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/RP0/CPU0:router(config)# interface TenGigE 0/3/0/0 RP/0/RP0/CPU0:router(config-if)# flow-control ingressinterface (Ethernet)
To specify or create an Ethernet interface and enter interface configuration mode, use the interface (Ethernet) command in XR Configmode.
interface { GigabitEthernet | HundredGigE | TenGigE } interface-path-id
no interface { GigabitEthernet | HundredGigE | TenGigE } interface-path-id
Syntax Description
GigabitEthernet Specifies or creates a Gigabit Ethernet (1000 Mbps) interface.
HundredGigE Specifies or creates a Hundred Gigabit Ethernet (100 Gbps) 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 History
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:Task ID
Examples
This example shows how to enter interface configuration mode for a Gigabit Ethernet interface:
RP/0/RP0/CPU0:router(config)# interface GigabitEthernet 0/4/0/0 RP/0/RP0/CPU0:router(config-if)#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.
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 History
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
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.
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 History
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
Examples
This example shows how to enable MAC accounting for the source MAC address on the ingress direction:
RP/0/RP0/CPU0:routerconfigure RP/0/RP0/CPU0:routerinterface bundle-ether <bundle-id> RP/0/RP0/CPU0:router(config-if)# mac-accounting ingress
Note
In order to view the mac-accounting statistics for the configured bundle interface, use the show mac-accounting bundle-ether <bundle id> command.
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.
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 History
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
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.
Command History
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
Examples
This example shows how to enable link autonegotiation on an interface:
RP/0/RP0/CPU0:router(config)# interface gigabitethernet 0/0/2/0 RP/0/RP0/CPU0:router(config-if)# negotiation autoThis example shows how to disable link autonegotiation on an interface:
RP/0/RP0/CPU0:router(config)# interface gigabitethernet 0/0/2/0 RP/0/RP0/CPU0:router(config-if)# no negotiation autopacket-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.
Command Default
The interface uses the standard packet interval as defined by the IEEE 802.ae specification.
Command History
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
show controllers (Ethernet)
To display status and configuration information about the Ethernet interfaces on a specific node, use the show controllers command in XR EXEC mode.
show controllers { GigabitEthernet | HundredGigE | TenGigE } interface-path-id [ all | bert | internal | mac | phy | stats | xgxs ]
Syntax Description
{GigabitEthernet | HundredGigE | TenGigE}
Specifies the type of Ethernet interface whose status and configuration information you want to display. Enter GigabitEthernet, TenGigE, or HundredGigE.
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 History
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:
- If specifying a virtual interface, the number range varies, depending on interface type.
Task ID
show mac-accounting (Ethernet)
To display MAC accounting statistics for an interface, use the show mac-accounting command in XR EXECmode.
show mac-accounting { GigabitEthernet | TenGigE | Hundred GigE | bundle-ether | bundle-id } 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 History
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:
- If specifying a virtual interface, the number range varies, depending on interface type.
Task ID
Examples
These examples show the outputs from the show mac-accounting command, which displays MAC accounting statistics on any specified interface:
RP/0/RP0/CPU0:router# show mac-accounting TenGigE 0/2/0/4 location 0/1/CPU0 TenGigE0/2/0/4 Input (511 free) 000b.4558.caca: 4 packets, 456 bytes Total: 4 packets, 456 bytesRP/0/RP0/CPU0:router# show mac-accounting hundredGigE 0/1/0/0 HundredGigE0/1/0/0 Input (51 free) Total: 0 packets, 0 bytes
Table 1 show mac-accounting Field Descriptions Field
Description
Interface
The interface from which the statistics are generated.
Input
Heading for the ingress MAC accounting statistics. The number of MAC accounting entries still available is shown in parentheses.
Total
Total statistics for the traffic accounted for by MAC accounting. This excludes any traffic for which there is no MAC address entry, such as non-IP traffic from an unknown MAC source address. 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.
