Interface and Hardware Component Command Reference, Cisco IOS XE Release 3SE (Catalyst 3850 Switches)
D through E
Downloads: This chapterpdf (PDF - 1.32MB) The complete bookPDF (PDF - 3.37MB) | Feedback

D through E

D through E

define interface-range

To create an interface-range macro, use the define interface-range command in global configuration mode. To remove an interface-range macro, use the no form of this command.

define interface-range macro-name interface-range

Syntax Description

macro-name

Name of the interface-range macro.

interface-range

Type of interface range.

  • For a list of valid values, see the “Usage Guidelines” section.

Command Default

Interface-range macro is not configured.

Command Modes

Global configuration (config)

Command History

Release

Modification

12.2(14)SX

This command was introduced.

12.2(17d)SXB

This command was integrated into Cisco IOS XE Release 12.2(17d)SXB.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

15.1(2)SNG

This command was implemented on the Cisco ASR 901 Series Aggregation Services Routers.

Usage Guidelines

  • The define interface-range command applies a particular configuration on multiple interfaces and creates multiple logical, and sub interfaces.
  • An interface range macro name can comprise up to 32 characters.
  • An interface range for a macro can accept a maximum of five ranges. However, the subinterface range for a macro accepts only one range.
  • An interface range cannot span slots.
  • Use the interface-type slot/first-interface last-interface format to enter the interface range.
  • Valid values for the interface-type argument are as follows:
    • atm —Supported on Cisco 7600 series routers that are configured with a Supervisor Engine 2
    • ethernet
    • fastethernet
    • ge-wan —Supported on Cisco 7600 series routers that are configured with a Supervisor Engine 2
    • gigabitethernet
    • loopback
    • port-channel interface-number —Valid values are from 1 to 256
    • pos —Supported on Cisco 7600 series routers that are configured with a Supervisor Engine 2
    • tengigabitethernet
    • tunnel
    • vlan vlan-id —Valid values are from 1 to 4094

Examples

The following example shows how to create a multiple-interface macro:

Device(config)# define interface-range macro1 ethernet 1/2 - 5, fastethernet 5/5 - 10
The following example shows how to create multiple loopback interfaces:
Device(config)# define interface-range loopback1-10

Related Commands

Command

Description

interface range

Executes a command on multiple ports at the same time.

duplex

To configure the duplex operation on an interface, use the duplex command in interface configuration mode. To return to the default configuration, use the no form of this command.

duplex { full | half | auto }

no duplex

Syntax Description

full

Specifies full-duplex operation.

half

Specifies half-duplex operation.

auto

Enables autonegotiation. The interface automatically operates at half-duplex or full-duplex mode depending on environmental factors, such as the type of media and the transmission speeds for the peer routers, hubs, and switches used in the network configuration.

Command Default

Half-duplex mode is enabled.

For the 4-port 10/100 Fast Ethernet Shared Port Adapter (SPA) and the 2-port 10/100/1000 Gigabit Ethernet SPA on the Cisco 7304 router, autonegotiation is enabled. The command is set to auto.

Command Modes

Interface configuration (config-if)

Command History

Release

Modification

11.2(10)P

This command was introduced.

12.2S

This command was integrated into Cisco IOS Release 12.2S.

12.2(14)SX

This command was implemented on the Supervisor Engine 720.

12.2(17d)SXB

This command was integrated into Cisco IOS Release 12.2 SXB.

12.2(20)S2

This command was implemented on the 4-port 10/100 Fast Ethernet SPA and the 2-port 10/100/1000 Gigabit Ethernet SPA on the Cisco 7304 router.

Cisco IOS XE Release 3.9S

This command was integrated into Cisco IOS XE Release 3.9S.

15.2(02)SA

This command was implemented on the Cisco ME 2600X Series Ethernet Access Switches.

Usage Guidelines

To use the autonegotiation capability (that is, to automatically detect speed and duplex modes), you must set both the speed command and the duplex command to auto.

Cisco Cloud Services Router 1000V Series

Cisco Cloud Services Router 1000V Series does not support the duplex command.

Duplex Options and Interfaces

The table below lists the supported command options by interface type.

Table 1 Supported Duplex Command Options

Interface Type

Supported Syntax

Default Setting

Usage Guidelines

10/100-Mbps module

duplex [half | full]

See the “Usage Guidelines” column.

Run the no duplex auto command to set the speed to auto.

If the speed is set to 10 or 100, without configuring the duplex setting, the duplex is set to half.

100-Mbps fiber modules

duplex [half | full]

half

Gigabit Ethernet interfaces

duplex full

full

10-Mbps ports

duplex [half | full]

half

If the transmission speed on a 16-port RJ-45 Gigabit Ethernet port is set to 1000, the duplex mode is set to full. If the transmission speed is changed to 10 or 100, the duplex mode stays at half duplex. You must configure the correct duplex mode when the transmission speed is changed to 10 or 100 from 1000.

Gigabit Ethernet is full duplex only. You cannot change the mode on Gigabit Ethernet ports.

When manually configuring the interface speed to either 10 or 100-Mbps, you should also configure the duplex mode on the interface.


Caution


Changing the interface speed and duplex mode configuration might shut down and reenable the interface during reconfiguration.


4-Port 10/100 Fast Ethernet SPA and 2-Port 10/100/1000 Gigabit Ethernet SPA on the Cisco 7304 Router

The duplex command is applied to the SPA interfaces that use the RJ-45 media. Gigabit Ethernet interfaces using fiber media support full-duplex mode only and use the negotiation command to enable and disable autonegotiation.

To enable the autonegotiation capability on an RJ-45 interface, you must set either the speed command or the duplex command to auto. The default configuration is that both commands are set to auto.


Note


For the Cisco AS5300, the duplex {full | half | auto} command syntax replaces the duplex commands—half-duplex and full-duplex. Cisco 7600 series routers can automatically negotiate the interface speed and the duplex mode only if one of the connected interfaces are configured to auto.


The table below describes the interface behavior for different combinations of the duplex and speed command settings. The specified duplex command configured with the specified speed command produces the resulting system action.

If you specify both duplex and speed settings other than auto on an RJ-45 interface, autonegotiation is disabled for the interface.


Note


If you need to force an interface port to operate with certain settings and, therefore, need to disable autonegotiation, you must be sure that the remote link is configured with compatible link settings for proper transmission including the support of flow control on the link.



Note


Every interface on a 4-port 10/100 Fast Ethernet SPA supports transmission of pause frames to stop packet flow when the Modular Services Card (MSC) is full. You cannot disable flow control for an interface on the 4-port 10/100 Fast Ethernet SPA. Hence, the flow control support is not configurable, but it is advertised during autonegotiation. If you disable autonegotiation, you must be sure that the remote device is configured to support flow control because flow control is automatically enabled for all interfaces on the 4-port 10/100 Fast Ethernet SPA.


Table 2 Relationship Between duplex and speed Commands

duplex Command

speed Command

Resulting System Action

duplex auto

speed auto

Autonegotiates both speed and duplex modes. The interface advertises the capability for the following link settings:

  • 10 Mbps and half duplex
  • 10 Mbps and full duplex
  • 100 Mbps and half duplex
  • 100 Mbps and full duplex
  • 1000 Mbps and half duplex
  • 1000 Mbps and full duplex

duplex auto

speed 10 or speed 100 or speed 1000

Autonegotiates the duplex mode. The interface advertises the capability for the configured speed with the capability for both half-duplex or full-duplex mode.

For example, if the speed 100 command is configured with duplex auto, then the interface advertises the following capability:

  • 100 Mbps and half duplex
  • 100 Mbps and full duplex

duplex half or duplex full

speed auto

Autonegotiates the speed. The interface advertises the capability for duplex mode for Fast Ethernet interfaces at a speed of 10-Mbps and 100-Mbps, and Gigabit interfaces at 10-Mbps, 100-Mbps, and 1000-Mbps.

For example, if the duplex full command is configured with the speed auto command, then the interface advertises the following capability:

  • 10 Mbps and full duplex
  • 100 Mbps and full duplex
  • 1000 Mbps and full duplex (Gigabit Ethernet interfaces only)

duplex half

speed 10

Forces 10-Mbps speed and the half-duplex operation, and disables autonegotiation on the interface.

duplex full

speed 10

Forces a speed of 10-Mbps and the full-duplex operation, and disables autonegotiation on the interface.

duplex half

speed 100

Forces a speed of 100-Mbps and the half-duplex operation, and disables autonegotiation on the interface.

duplex full

speed 100

Forces a speed of 100-Mbps and the full-duplex operation, and disables autonegotiation on the interface.

duplex half

speed 1000

Forces a speed of 1000-Mbps and the half-duplex operation, and disables autonegotiation on the interface (Gigabit Ethernet only).

duplex full

speed 1000

Forces a speed of 1000-Mbps and the full-duplex operation, and disables autonegotiation on the interface (Gigabit Ethernet only).

Examples

The following example shows how to configure a full-duplex operation on a Cisco AS5300 router:

Device(config)# interface fastethernet 0
Device(config-if)# duplex full

The following example shows how to specify the advertisement of only half-duplex support and either 10-Mbps or 100-Mbps capability during autonegotiation for the second interface (port 1) on the SPA located in the bottom subslot (1) of the MSC that is installed in slot 2 of the Cisco 7304 router:

Device# configure terminal
Device(config)# interface fastethernet 2/1/1
Device(config-if)# duplex half
Device(config-if)# speed auto

With this configuration, the interface advertises the following capabilities during autonegotiation:

  • 10 Mbps and half duplex
  • 100 Mbps and half duplex

Note


Flow control support is always advertised when autonegotiation is enabled.


Related Commands

Command

Description

interface

Configures an interface and enters interface configuration mode.

interface fastethernet

Selects a particular Fast Ethernet interface for configuration.

interface gigabitethernet

Selects a particular Gigabit Ethernet interface for configuration.

show controllers

Displays information that is specific to the hardware on a module.

show controllers fastethernet

Displays Fast Ethernet interface information, transmission statistics, and errors, and the applicable MAC destination address and VLAN filtering tables.

show controllers gigabitethernet

Displays Gigabit Ethernet interface information, transmission statistics, and errors, and the applicable MAC destination address and VLAN filtering tables.

show interfaces

Displays traffic that is seen by a specific interface.

show interfaces fastethernet

Displays information about Fast Ethernet interfaces.

show interfaces gigabitethernet

Displays information about Gigabit Ethernet interfaces.

speed

Sets the port speed for a Fast Ethernet interface.

errdisable recovery

To configure recovery mechanism variables, use the errdisable recovery command in global configuration mode. To return to the default state, use the no form of this command.

errdisable recovery { cause { all | arp-inspection | bpduguard | channel-misconfig | dhcp-rate-limit | dtp-flap | gbic-invalid | l2ptguard | link-flap | pagp-flap | psecure-violation | security-violation | rootguard | udld | unicast-flood } | interval seconds }

no errdisable recovery { cause { all | arp-inspection | bpduguard | channel-misconfig | dhcp-rate-limit | dtp-flap | gbic-invalid | l2ptguard | link-flap | pagp-flap | psecure-violation | security-violation | rootguard | udld | unicast-flood } | interval seconds }

Syntax Description

cause

Enables error-disable recovery from a specific cause.

all

Enables the recovery timers for all error-disable causes.

arp-inspection

Enables error-disable recovery from an Address Resolution Protocol (ARP) inspection cause.

bpduguard

Enables the recovery timer for the Bridge Protocol Data Unit (BPDU)-guard error-disable cause.

channel-misconfig

Enables the recovery timer for the channel-misconfig error-disable cause.

dhcp-rate-limit

Enables the recovery timer for the Dynamic Host Configuration Protocol (DHCP)-rate-limit error-disable cause.

dtp-flap

Enables the recovery timer for the Dynamic Trunking Protocol (DTP)-flap error-disable cause.

gbic-invalid

Enables the recovery timer for the Gigabit Interface Converter (GBIC)-invalid error-disable cause.

l2ptguard

Enables the recovery timer for the Layer 2 Protocol Tunneling (L2PT) error-disable cause.

link-flap

Enables the recovery timer for the link-flap error-disable cause.

pagp-flap

Enables the recovery timer for the Port Aggregation Protocol (PAgP)-flap error-disable cause.

psecure-violation

Enables the recovery timer for the psecure-violation error-disable cause.

security-violation

Enables the automatic recovery of ports that were disabled because of 802.1X security violations.

rootguard

Enables the recovery timer for the root-guard error-disable cause.

udld

Enables the recovery timer for the Unidirectional Link Detection (UDLD) error-disable cause.

unicast-flood

Enables the recovery timer for the unicast-flood error-disable cause.

interval seconds

Specifies the time, in seconds, to recover from a specified error-disable cause. The range is from 30 to 86400. The default interval is 300.

Command Default

The recovery mechanisms are disabled.

Command Modes

Global configuration (config)

Command History

Release

Modification

15.0(1)M

This command was introduced in a release earlier than Cisco IOS Release 15.0(1)M.

12.2(14)SX

This command was modified. This command was implemented on the Supervisor Engine 720.

12.2(17d)SXB

This command was modified. This command was implemented on the Supervisor Engine 2.

12.2(18)SXD

This command was modified. The arp-inspection keyword was added.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

Usage Guidelines

A cause (bpduguard, channel-misconfig, dhcp-rate-limit, dtp-flap, l2ptguard, link-flap, pagp-flap, psecure-violation, security-violation, rootguard, udld, or unicast-flood) is defined as the reason why the error-disable state occurred. When a cause is detected on an interface, the interface is placed in an error-disable state (an operational state that is similar to the link-down state). If you do not enable error-disable recovery for the cause, the interface stays in the error-disable state until a shutdown and no shutdown occur. If you enable recovery for a cause, the interface is brought out of the error-disable state and allowed to retry operation once all the causes have timed out.

You must enter the shutdown command and then the no shutdown command to manually recover an interface from the error-disable state.


Note


A separate line is required each time you want to enter the errdisable recovery cause command to add a new reason for recovery; each new reason does not get appended to the original single line. This means you must enter each new reason separately.


Examples

This example shows how to enable the recovery timer for the BPDU-guard error-disable cause:

Router(config)#
 errdisable recovery cause bpduguard

This example shows how to set the recovery timer to 300 seconds:

Router(config)#
 errdisable recovery interval 300

Related Commands

Command

Description

show errdisable recovery

Displays the information about the error-disable recovery timer.

show interfaces status

Displays the interface status or a list of interfaces in an error-disabled state on LAN ports only.

shutdown

Disables an interface.