Table of Contents

Related Documents

01-Ethernet Interface Commands

Title	Size	Download
01-Ethernet Interface Commands	145.44 KB

Ethernet interface configuration commands

broadcast-suppression

Use broadcast-suppression to set the broadcast suppression threshold on an Ethernet interface or a group of Ethernet interfaces.

Use undo broadcast-suppression to restore the default broadcast suppression threshold.

Syntax

broadcast-suppression { ratio | pps max-pps }

undo broadcast-suppression

Default

Ethernet interfaces do not suppress broadcast traffic.

Views

Layer 2 Ethernet interface view, port group view

Default command level

2: System level

Parameters

ratio: Sets the broadcast suppression threshold as a percentage of the maximum interface rate. The smaller the percentage, the less broadcast traffic is allowed to be received. This argument ranges from 1 to 100.

pps max-pps: Specifies the maximum number of broadcast packets that the Ethernet interface can receive per second. The max-pps argument ranges from 1 to 1488100 pps.

· When the pps keyword is specified, and a suppression granularity larger than 1 is specified on the device, the value of the pps keyword must be no smaller than, and an integer multiple of, the granularity. The broadcast suppression threshold value configured through this keyword on an Ethernet interface may not be the one that actually takes effect. To display the actual broadcast suppression threshold value on an Ethernet interface, use the display interface command.

· When the pps keyword is not specified, or the suppression granularity is set to 1, the value of the pps keyword must be no smaller than 1, and the broadcast suppression threshold value is the one that actually takes effect on the Ethernet interface.

Usage guidelines

In Ethernet interface view, the configuration takes effect only on the interface. In port group view, the configuration takes effect on all the ports in the port group.

When the received broadcast traffic exceeds the broadcast suppression threshold, the interface discards broadcast packets until broadcast traffic drops below the threshold.

If you set different broadcast suppression thresholds in Ethernet interface view or port group view multiple times, the one configured last takes effect.

Examples

# Set the broadcast suppression threshold to 20% on GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface GigabitEthernet 1/0/1

[Sysname-GigabitEthernet1/0/1] broadcast-suppression 20

# Set the broadcast suppression threshold to 20% on all ports in the manual port group named group1.

<Sysname> system-view

[Sysname] port-group manual group1

[Sysname-port-group-manual-group1] group-member GigabitEthernet 1/0/1

[Sysname-port-group-manual-group1] group-member GigabitEthernet 1/0/2

[Sysname-port-group-manual-group1] broadcast-suppression 20

default

Use default to restore the default settings for an Ethernet interface.

Syntax

default

Views

Ethernet interface view

Default command level

2: System level

Usage guidelines

CAUTION:

The default command might interrupt ongoing network services. Make sure you are fully aware of the impacts of this command when you use it in a live network.

This command might fail to restore the default settings for some commands for reasons such as command dependencies and system restrictions. You can identify these commands by using the display this command in interface view, and then use their undo forms or follow the command reference to individually restore their default settings. If your restoration attempt still fails, follow the error message to resolve the problem.

Examples

# Restore the default settings for interface GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface GigabitEthernet 1/0/1

[Sysname-GigabitEthernet1/0/1] default

This command will restore the default settings. Continue? [Y/N]:y

description

Use description to change the description of the interface.

Use undo description to restore the default.

Syntax

description text

undo description

Default

The default description of an interface is the interface name plus Interface. For example, GigabitEthernet1/0/1 Interface.

Views

Ethernet interface view

Default command level

2: System level

Parameters

text: Specifies the interface description, a string of 1 to 80 characters. The string can include case-sensitive letters, digits, special characters such as tilde (~), exclamation point (!), at sign (@), pound sign (#), dollar sign ($), percent sign (%), caret (^), ampersand sign (&), asterisk (*), left brace({), right brace (}), left parenthesis ((), right parenthesis ()), left bracket ([), right bracket (]), left angle bracket (<), right angle bracket (>), hyphen (-), underscore(_), plus sign (+), equal sign (=), vertical bar (|), back slash (\), colon (:), semi-colon (;) quotation marks ("), apostrophe ('), comma (,), dot (.), and slash (/), spaces, and other Unicode characters and symbols.

When you specify a description, follow these guidelines:

· Each Unicode character takes the space of two regular characters.

· To use Unicode characters or symbols in an interface description, install the specific input method editor and log in to the device through remote login software that supports the character type.

· When the length of a description string reaches or exceeds the maximum line width on the terminal software, the software starts a new line, possibly breaking a Unicode character in half. This might result in garbled characters at the end of a line.

Examples

# Change the description of interface GigabitEthernet 1/0/1 to lanswitch-interface.

<Sysname> system-view

[Sysname] interface GigabitEthernet 1/0/1

[Sysname-GigabitEthernet1/0/1] description lanswitch-interface

Related commands

display interface

Use display interface to display Ethernet interface information.

Syntax

display interface [ interface-type ] [ brief [ down ] ] [ | { begin | exclude | include } regular-expression ]

display interface interface-type interface-number [ brief ] [ | { begin | exclude | include } regular-expression ]

Views

Any view

Default command level

1: Monitor level

Parameters

interface-type: Specifies an interface type.

interface-number: Specifies an interface number.

brief: Displays brief interface information. If you do not specify this keyword, the command displays detailed interface information.

down: Displays information about interfaces in the down state and the causes. If you do not specify this keyword, this command displays information about interfaces in all states.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Usage guidelines

If no interface type is specified, this command displays information about all interfaces.

If an interface type is specified but no interface number is specified, this command displays information about all interfaces of the specified type.

Examples

# Display detailed information about Layer 2 interface GigabitEthernet 1/0/1.

<Sysname> display interface GigabitEthernet 1/0/1

GigabitEthernet1/0/1 current state: UP

IP Packet Frame Type: PKTFMT_ETHNT_2, Hardware Address: 006a-07dd-9600

Description: lanswitch-interface

Loopback is not set

Media type is twisted pair, promiscuous mode set

100Mbps-speed mode, full-duplex mode

Link speed type is autonegotiation, link duplex type is autonegotiation

Flow-control is not enabled

The Maximum Frame Length is 1600

Broadcast MAX-ratio: 100%

Unicast MAX-ratio: 100%

Multicast MAX-ratio: 100%

PVID: 1

Port link-type: access

Tagged VLAN ID : none

Untagged VLAN ID : 1

Port priority: 0

Last clearing of counters: Never

Last 300 seconds input: 0 packets/sec 0 bytes/sec -%

Last 300 seconds output: 0 packets/sec 0 bytes/sec -%

Input (total): 1945 packets, 247903 bytes

1156 unicasts, 688 broadcasts, 101 multicasts, - pauses

Input (normal): 1945 packets, 247903 bytes

1156 unicasts, 688 broadcasts, 101 multicasts, - pauses

Input: 0 input errors, 0 runts, 0 giants, - throttles

0 CRC, 0 frame, 0 overruns, 0 aborts

0 ignored, - parity errors

Output (total): 1116 packets, 76088 bytes

975 unicasts, 141 broadcasts, 0 multicasts, - pauses

Output (normal): 1116 packets, 76088 bytes

975 unicasts, 141 broadcasts, 0 multicasts, - pauses

Output: 0 output errors, 0 underruns, 0 buffer failures

0 aborts, 0 deferred, 0 collisions, 0 late collisions

- lost carrier, 0 no carrier

Table 1 Command output

Field	Description
GigabitEthernet1/0/1 current state	Physical state of the Ethernet interface. For more information, see Table 2.
IP Packet Frame Type	Ethernet framing format on the interface.
Loopback	Loopback testing status of the interface.
100Mbps-speed mode	The interface is operating at 100 Mbps. This field displays Unknown-speed mode when the interface is disconnected from the peer that it will automatically negotiate a port speed with.
full-duplex mode	The interface is operating in full-duplex mode.
Link speed type is autonegotiation	The interface will negotiate a speed with its peer.
link duplex type is autonegotiation	The interface will negotiate a duplex mode with its peer.
The Maximum Frame Length	Maximum Ethernet frame length allowed on the interface.
Broadcast MAX-ratio	Broadcast suppression threshold as a percentage of the maximum interface rate. When the threshold is exceeded, the interface drops broadcast packets.
Unicast MAX-ratio	Unknown unicast suppression threshold as a percentage of the maximum interface rate. When the threshold is exceeded, the interface drops unknown unicast packets.
Multicast MAX-ratio	Multicast suppression threshold as a percentage of the maximum interface rate. When the threshold is exceeded, the interface drops multicast packets.
PVID	Port VLAN ID.
Port link-type	Link type of the interface, which can be access, trunk, or hybrid.
Tagged VLAN ID	VLANs for which the interface sends packets without removing VLAN tags.
Untagged VLAN ID	VLANs for which the interface sends packets after removing VLAN tags.
Last clearing of counters: Never	Time when the reset counters interface command was last used to clear statistics on the interface. Never indicates that the reset counters interface command was never used since the device was started.
Last 300 seconds input: 0 packets/sec 0 bytes/sec Last 300 seconds output: 0 packets/sec 0 bytes/sec	Average rate of input and output traffic in the last 300 seconds, in pps and Bps. The statistics polling interval, 300 seconds in this example, can be configured by using the flow-interval command.
Input (total): 1945 packets, 247903 bytes 1156 unicasts, 688 broadcasts, 101 multicasts, - pauses	Inbound traffic statistics (in packets and bytes) for the interface. All inbound normal and abnormal packets (including unicast, broadcast, and multicast), and pause frames were counted.
Input (normal): 1945 packets, 247903 bytes 1156 unicasts, 688 broadcasts, 101 multicasts, - pauses	Inbound normal traffic (including unicast, broadcast, and multicast) and pause frame statistics (in packets and bytes) for the interface.
Input: 0 input errors, 0 runts, 0 giants, - throttles 0 CRC, 0 frame, 0 overruns, 0 aborts 0 ignored, - parity errors	Inbound packets with errors.
runts	Inbound frames that are shorter than 64 bytes, that are in correct format, and that contain valid CRCs.
giants	Inbound frames larger than the maximum frame length supported on the interface. · For an Ethernet interface that does not permit jumbo frames, giants refer to frames larger than 1536 bytes (without VLAN tags) or 1540 bytes (with VLAN tags). · For an Ethernet interface that permits jumbo frames, giants refer to frames larger than 9212 bytes (without VLAN tags) or 9216 bytes (with VLAN tags).
- throttles	Number of times that the port shut down because of buffer or CPU overload.
CRC	Total number of inbound frames that had a normal length, but contained checksum errors.
frame	Total number of inbound frames that contained checksum errors and a non-integer number of bytes.
- overruns	Number of packets dropped because the input rate of the port exceeded the queuing capability.
aborts	Total number of illegal inbound packets: · Fragment frames—CRC error frames shorter than 64 bytes. The length can be an integer or non-integer value. · Jabber frames—CRC error frames greater than the maximum frame length supported on the Ethernet interface (with an integer or non-integer length). For an Ethernet interface that does not permit jumbo frames, jabber frames refer to CRC error frames greater than 1518 bytes (without VLAN tags) or 1522 bytes (with VLAN tags). For an Ethernet interface that permits jumbo frames, jabber frames refer to CRC error frames greater than the maximum size of Ethernet frames that are allowed to pass through the interface (which is configured when you configure jumbo frame support on the interface). · Symbol error frames—Frames that contained at least one undefined symbol. · Unknown operation code frames—Non-pause MAC control frames. · Length error frames—Frames whose 802.3 length fields did not accord with the actual frame length (46 to 1500 bytes).
ignored	Number of inbound frames dropped because the receiving buffer of the port ran low.
- parity errors	Total number of frames with parity errors.
Output (total): 1116 packets, 76088 bytes 975 unicasts, 141 broadcasts, 0 multicasts, - pauses	Outbound traffic statistics (in packets and bytes) for the port. All outbound normal and abnormal packets (including unicast, broadcast, and multicast), and pause frames were counted.
Output (normal): 1116 packets, 76088 bytes 975 unicasts, 141 broadcasts, 0 multicasts, - pauses	Outbound normal traffic (including unicast, broadcast, and multicast) and pause frame statistics (in packets and bytes) for the interface.
Output: 0 output errors, 0 underruns, 0 buffer failures 0 aborts, 0 deferred, 0 collisions, 0 late collisions - lost carrier, 0 no carrier	Outbound packets with errors.
- underruns	Number of packets dropped because the output rate of the interface exceeded the output queuing capability. This is a low-probability hardware anomaly.
- buffer failures	Number of packets dropped because the transmit buffer of the interface ran low.
aborts	Number of packets that failed to be transmitted, for example, because of Ethernet collisions.
deferred	Number of frames that the interface deferred to transmit because of detected collisions.
collisions	Number of frames that the interface stopped transmitting because Ethernet collisions were detected during transmission.
late collisions	Number of frames that the interface deferred to transmit after transmitting their first 512 bits, because of detected collisions.
lost carrier	Number of carrier losses during transmission. This counter applies to serial WAN interfaces.
- no carrier	Number of times that the port failed to detect the carrier when attempting to send frames. This counter applies to serial WAN interfaces.

NOTE:

If an output field is not available, a hyphen (-) is displayed.

Table 2 Description on the possible physical states of a Layer 2 Ethernet interface

Field	Description
UP	The interface is physically up.
DOWN	The interface is physically down, because no physical connection exists (possibly because the network cable is disconnected or faulty).
DOWN ( Administratively )	The interface is physically down because it was shut down with the shutdown command. To restore its physical state, use the undo shutdown command.
DOWN ( Link-Aggregation interface down )	The interface is physically down, because the aggregate interface corresponding to the aggregation group to which it belongs was shut down with the shutdown command.
DOWN ( Loopback detection-protected )	The interface is shut down because a loop is detected on it.

# Display brief information about all interfaces.

<Sysname> display interface brief

The brief information of interface(s) under route mode:

Link: ADM - administratively down; Stby - standby

Protocol: (s) - spoofing

Interface Link Protocol Main IP Description

NULL0 UP UP(s) --

Vlan1 UP UP 192.168.100.134

Vlan2 DOWN DOWN --

WLAN-Radio1/0/1 ADM DOWN --

WLAN-Radio1/0/2 ADM DOWN --

The brief information of interface(s) under bridge mode:

Link: ADM - administratively down; Stby - standby

Speed or Duplex: (a)/A - auto; H - half; F - full

Type: A - access; T - trunk; H - hybrid

Interface Link Speed Duplex Type PVID Description

BAGG1 UP 1G(a) F(a) A 1 connect to the lab

GE1/0/1 DOWN auto A A 1 lanswitch-interface

GE1/0/2 UP 1G(a) F(a) A 1

WLAN-BSS2 DOWN -- -- A 1

WLAN-BSS32 DOWN -- -- H 1

WLAN-BSS33 DOWN -- -- H 1

WLAN-BSS34 DOWN -- -- A 1

# Filter the brief interface information to display the line starting with the (s) string and all subsequent lines.

<Sysname> display interface brief | begin (s)

The brief information of interface(s) under route mode:

Link: ADM - administratively down; Stby - standby

Protocol: (s) - spoofing

Interface Link Protocol Main IP Description

NULL0 UP UP(s) --

Vlan1 UP UP 192.168.100.134

Vlan2 DOWN DOWN --

WLAN-Radio1/0/1 ADM DOWN --

WLAN-Radio1/0/2 ADM DOWN --

The brief information of interface(s) under bridge mode:

Link: ADM - administratively down; Stby - standby

Speed or Duplex: (a)/A - auto; H - half; F - full

Type: A - access; T - trunk; H - hybrid

Interface Link Speed Duplex Type PVID Description

BAGG1 UP 1G(a) F(a) A 1 connect to the lab

GE1/0/1 DOWN auto A A 1 lanswitch-interface

GE1/0/2 UP 1G(a) F(a) A 1

WLAN-BSS2 DOWN -- -- A 1

WLAN-BSS32 DOWN -- -- H 1

WLAN-BSS33 DOWN -- -- H 1

WLAN-BSS34 DOWN -- -- A 1

# Display brief information about all UP interfaces.

<Sysname> display interface brief | include UP

The brief information of interface(s) under route mode:

Link: ADM - administratively down; Stby - standby

Protocol: (s) - spoofing

Interface Link Protocol Main IP Description

NULL0 UP UP(s) --

Vlan1 UP UP 192.168.100.134

The brief information of interface(s) under bridge mode:

Link: ADM - administratively down; Stby - standby

Speed or Duplex: (a)/A - auto; H - half; F - full

Type: A - access; T - trunk; H - hybrid

Interface Link Speed Duplex Type PVID Description

BAGG1 UP 1G(a) F(a) A 1 connect to the lab

GE1/0/2 UP 1G(a) F(a) A 1

# Display the brief information about all but Ethernet interfaces.

<Sysname> display interface brief | exclude GE

The brief information of interface(s) under route mode:

Link: ADM - administratively down; Stby - standby

Protocol: (s) - spoofing

Interface Link Protocol Main IP Description

NULL0 UP UP(s) --

Vlan1 UP UP 192.168.100.134

Vlan2 DOWN DOWN --

WLAN-Radio1/0/1 ADM DOWN --

WLAN-Radio1/0/2 ADM DOWN --

The brief information of interface(s) under bridge mode:

Link: ADM - administratively down; Stby - standby

Speed or Duplex: (a)/A - auto; H - half; F - full

Type: A - access; T - trunk; H - hybrid

Interface Link Speed Duplex Type PVID Description

BAGG1 UP 1G(a) F(a) A 1 connect to the lab

WLAN-BSS2 DOWN -- -- A 1

WLAN-BSS32 DOWN -- -- H 1

WLAN-BSS33 DOWN -- -- H 1

WLAN-BSS34 DOWN -- -- A 1

# Display information about interfaces in the down state and the relevant causes.

<Sysname> display interface brief down

The brief information of interface(s) under route mode:

Link: ADM - administratively down; Stby - standby

Interface Link Cause

Vlan2 DOWN Not connected

WLAN-Radio1/0/1 ADM Administratively

WLAN-Radio1/0/2 ADM Administratively

The brief information of interface(s) under bridge mode:

Link: ADM - administratively down; Stby - standby

Interface Link Cause

GE1/0/1 DOWN Not connected

WLAN-BSS2 DOWN Not connected

WLAN-BSS32 DOWN Not connected

WLAN-BSS33 DOWN Not connected

WLAN-BSS34 DOWN Not connected

Table 3 Command output

Field	Description
The brief information of interface(s) under route mode:	The command displays brief information about Layer 3 interfaces.
Link: ADM - administratively down; Stby - standby	Link layer state of the interface: · ADM—The interface has been shut down by the network administrator. To recover its physical layer state, use the undo shutdown command. · Stby—The interface is a standby interface. You can use the display standby state command to check the corresponding primary interface.
Protocol: (s) - spoofing	If the network layer protocol state of an interface is shown as UP, but its link is an on-demand link or not present at all, its protocol attribute includes the spoofing flag, (a letter "s" in parentheses). This attribute is typical of interface Null 0 and loopback interfaces.
Interface	Interface name.
Link	Physical link state of the interface: · UP—The link is up. · DOWN—The link is physically down. · ADM—The link has been administratively shut down. To recover its physical state, use the undo shutdown command. · Stby—The interface is a standby interface.
Protocol	Protocol connection state of the interface, which can be UP, DOWN, or UP(s).
Description	Interface description. Information displayed in this field is restricted by space. To view the complete interface description, use the display interface command without specifying the brief keyword.
The brief information of interface(s) under bridge mode:	Brief information about Layer 2 interfaces.
Speed or Duplex: (a)/A - auto; H - half; F - full	If the speed of an interface is automatically negotiated, its speed attribute includes the auto negotiation flag, letter a in parentheses. If the duplex mode of an interface is automatically negotiated, its duplex mode attribute includes the following options: · (a)/A—Auto negotiation. · H—Half negotiation. · F—Full negotiation.
Type: A - access; T - trunk; H - hybrid	Link type options for Ethernet interfaces.
Speed	Interface rate, in bps.
Duplex	Duplex mode of the interface: · A—Auto negotiation. · F—Full duplex. · F(a)—Auto-negotiated full duplex. · H—Half duplex. · H(a)—Auto-negotiated half duplex.
Type	Link type of the interface: · A—Access. · H—Hybrid. · T—Trunk.
PVID	Port VLAN ID.
Cause	Causes for the physical state of an interface to be DOWN. For more information, see Table 4.

Table 4 Causes for the physical state of an interface to be DOWN

Field	Description
Not connected	No physical connection exists (possibly because the network cable is disconnected or faulty).
Administratively	The port was shut down with the shutdown command. To restore the physical state of the interface, use the undo shutdown command.
Link-Aggregation interface down	The aggregate interface corresponding to the aggregation group to which the interface belongs was shut down with the shutdown command.

Related commands

interface

display loopback-detection

Use display loopback-detection to display the status of the loopback detection function.

Syntax

display loopback-detection [ | { begin | exclude | include } regular-expression ]

Views

Any view

Default command level

1: Monitor level

Parameters

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Usage guidelines

If loopback detection is enabled, this command also displays the detection interval and all ports in a loop condition.

Examples

# Display information about loopback detection.

<Sysname> display loopback-detection

Loopback detection is running.

Detection interval is 30 seconds.

No port is detected with loopback.

Table 5 Command output

Field	Description
Detection interval time is 30 seconds.	Loopback detection interval is 30 seconds.
No port is detected with loopback.	No loops are detected on any port.

display port-group manual

Use display port-group manual to display information about port groups.

Syntax

display port-group manual [ all | name port-group-name ] [ | { begin | exclude | include } regular-expression ]

Views

Any view

Default command level

2: System level

Parameters

all: Displays information about all port groups.

name port-group-name: Specifies the name of a port group, a string of 1 to 32 characters.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Usage guidelines

If the all keyword is specified, this command displays the name and member Ethernet interfaces of each port group on the device.

If a port group is specified, this command displays its name and member Ethernet interfaces.

If you do not specify the all keyword or any port group name, the command displays the name of each port group on the device.

Examples

# Display the names of all port groups.

<Sysname> display port-group manual

The following manual port group exist(s):

group1 group2

# Display detailed information about all port groups.

<Sysname> display port-group manual all

Member of group1:

GigabitEthernet1/0/1 GigabitEthernet1/0/2

Member of group2:

None

# Display detailed information about the port group named group1.

<Sysname> display port-group manual name group1

Member of group1:

GigabitEthernet1/0/1 GigabitEthernet1/0/2

duplex

Use duplex to set the duplex mode for an Ethernet interface.

Use undo duplex to restore the default duplex mode of the Ethernet interface.

Syntax

duplex { auto | full | half }

undo duplex

Default

An Ethernet interfaces operate in auto negotiation mode.

Views

Ethernet interface view

Default command level

2: System level

Parameters

auto: Sets the interface to operate in auto negotiation mode.

full: Sets the interface to operate in full duplex mode.

half: Sets the interface to operate in half-duplex mode.

Examples

# Configure interface GigabitEthernet 1/0/1 to operate in full duplex mode.

<Sysname> system-view

[Sysname] interface GigabitEthernet 1/0/1

[Sysname-GigabitEthernet1/0/1] duplex full

flow-control

Use flow-control to enable TxRx mode generic flow control on an Ethernet interface.

Use undo flow-control to disable generic flow control on the Ethernet interface.

Syntax

flow-control

undo flow-control

Default

Generic flow control on an Ethernet interface is disabled.

Views

Ethernet interface view

Default command level

2: System level

Usage guidelines

TxRx mode flow control allows an Ethernet interface to receive common pause frames from its peer, and send common pause frames to notify its peer of congestion.

With the flow-control command configured, an interface can both send and receive flow control frames:

· When congested, the interface sends a flow control frame to its peer.

· Upon receiving a flow control frame from its peer, the interface suspends sending packets.

To implement flow control on a link, enable the generic flow control function at both ends of the link.

Examples

# Enable TxRx mode generic flow control on the interface GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface GigabitEthernet 1/0/1

[Sysname-GigabitEthernet1/0/1] flow-control

flow-interval

Use flow-interval to set the interface statistics polling interval.

Use undo flow-interval to restore the default interval.

Syntax

flow-interval interval

undo flow-interval

Default

The interface statistics polling interval is 300 seconds.

Views

System view

Default command level

2: System level

Parameters

interval: Sets the statistics polling interval, in seconds. It ranges from 5 to 300 and must be a multiple of 5.

Examples

# Set the statistics polling interval to 100 seconds for all Ethernet interfaces.

<Sysname> system-view

[Sysname] flow-interval 100

group-member

Use group-member to assign Ethernet interfaces to a port group.

Use undo group-member to remove Ethernet interfaces from the port group.

Syntax

group-member interface-list

undo group-member interface-list

Default

A port group does not contain any member ports.

Views

Port group view

Default command level

2: System level

Parameters

interface-list: Specifies an Ethernet interface list, in the form of interface-type interface-number [ to interface-type interface-number ] &<1-10>, where &<1-10> indicates that you can specify up to 10 interfaces or interface ranges.

Usage guidelines

If you use the group-member interface-type interface-start-number to interface-type interface-end-number command to add multiple ports in batch to the specified port group, make sure all these ports are of the same type and on the same interface card, and the interface-end-number argument must be greater than the interface-start-number argument.

Examples

# Assign GigabitEthernet 1/0/1 to the port group named group1.

<Sysname> system-view

[Sysname] port-group manual group1

[Sysname-port-group-manual-group1] group-member GigabitEthernet 1/0/1

interface

Use interface to enter interface view.

Syntax

interface interface-type interface-number

Views

System view

Default command level

2: System level

Parameters

interface-type: Specifies an interface type.

interface-number: Specifies an interface number.

Examples

# Enter the view of the interface GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface GigabitEthernet 1/0/1

[Sysname-GigabitEthernet1/0/1]

loopback

Use loopback to enable loopback testing on an Ethernet interface.

Use undo loopback to disable loopback testing on an Ethernet interface.

Syntax

loopback { external | internal }

undo loopback

Default

Loopback testing is disabled on Ethernet interfaces.

Views

Ethernet interface view

Default command level

2: System level

Parameters

external: Enables external loopback testing for all on-chip functions related to Ethernet interfaces.

internal: Enables internal loopback testing for the hardware of Ethernet interfaces.

Usage guidelines

Enable loopback testing for troubleshooting purposes, such as identifying an Ethernet problem.

You cannot perform internal or external loopback testing on an administratively down (ADM DOWN) port. On a physically down (DOWN) port, you can perform only internal loopback testing.

During loopback testing, the speed, duplex, mdi, and shutdown commands are not available. In addition, the port is operating in full duplex mode, regardless of its duplex configuration. After loopback testing is disabled, the duplex configuration of the port is restored.

Examples

# Enable internal loopback testing on GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface GigabitEthernet 1/0/1

[Sysname-GigabitEthernet1/0/1] loopback internal

loopback-detection control enable

Use loopback-detection control enable to enable loopback detection control on trunk or hybrid ports.

Use undo loopback-detection control enable to restore the default.

Syntax

loopback-detection control enable

undo loopback-detection control enable

Default

Loopback detection control is disabled on trunk and hybrid ports.

Views

Layer 2 Ethernet interface view, port group view

Default command level

2: System level

Usage guidelines

When a hybrid or trunk port detects a loop condition, it sends traps, whether loopback detection control is enabled or not. However, the port performs the protective action that you configure with the loopback-detection action command only after loopback detection control is enabled.

This command is not applicable to access ports.

Examples

# Enable loopback detection control on the trunk port GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] loopback-detection enable

[Sysname] interface GigabitEthernet 1/0/1

[Sysname-GigabitEthernet1/0/1] port link-type trunk

[Sysname-GigabitEthernet1/0/1] loopback-detection enable

[Sysname-GigabitEthernet1/0/1] loopback-detection control enable

loopback-detection enable

Use loopback-detection enable to enable loopback detection globally in system view or on interfaces in Ethernet interface or port group view. To use loopback detection on an Ethernet interface, you must enable the function both globally and on the port.

Use undo loopback-detection enable to disable loopback detection globally or on Ethernet interfaces.

Syntax

loopback-detection enable

undo loopback-detection enable

Default

Loopback detection is disabled on all Ethernet interfaces.

Views

System view, Layer 2 Ethernet interface view, port group view

Default command level

2: System level

Usage guidelines

The undo loopback-detection enable command in system view disables loopback detection on all interfaces.

If an interface receives a packet that it sent out, a loop has occurred. Loops might cause broadcast storms, which degrade network performance. You can enable loopback detection to detect loops on an interface and, if the interface supports the loopback-detection action command, configure the protective action to take (for example, shut down the port) when a loop is detected.

In addition to the configured protective action, the device also performs other actions to alleviate the impact of the loops. For more information, see Table 6.

Table 6 Actions to take upon detection of a loop condition

Port type	Actions
Access port	· Place the interface in controlled mode. The interface discards all incoming packets, but still forwards outgoing traffic. · Generate traps. · Delete all MAC address entries of the interface.
Hybrid or trunk port	· Generate traps. · If loopback detection control is enabled, set the interface to controlled mode. The interface discards all incoming packets, but still forwards outgoing packets. · Delete all MAC address entries of the interface.

Port type

Actions

Access port

· Place the interface in controlled mode. The interface discards all incoming packets, but still forwards outgoing traffic.

· Generate traps.

· Delete all MAC address entries of the interface.

Hybrid or trunk port

· Generate traps.

· If loopback detection control is enabled, set the interface to controlled mode. The interface discards all incoming packets, but still forwards outgoing packets.

· Delete all MAC address entries of the interface.

Examples

# Enable loopback detection on GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] loopback-detection enable

[Sysname] interface GigabitEthernet 1/0/1

[Sysname-GigabitEthernet1/0/1] loopback-detection enable

Related commands

loopback-detection control enable

loopback-detection interval-time

Use loopback-detection interval-time to set the loopback detection interval.

Use undo loopback-detection interval-time to restore the default loopback detection interval.

Syntax

loopback-detection interval-time time

undo loopback-detection interval-time

Default

The loopback detection interval is 30 seconds.

Views

System view

Default command level

2: System level

Parameters

time: Specifies the loopback detection interval, ranging from 5 to 300 seconds.

Examples

# Set the loopback detection interval to 10 seconds.

<Sysname> system-view

[Sysname] loopback-detection interval-time 10

Related commands

display loopback-detection

multicast-suppression

Use multicast-suppression to set the multicast suppression threshold on an Ethernet interface or a group of Ethernet interfaces.

Use undo multicast-suppression to restore the default multicast suppression threshold.

Syntax

multicast-suppression { ratio | pps max-pps }

undo multicast-suppression

Default

Ethernet interfaces do not suppress multicast traffic.

Views

Layer 2 Ethernet interface view, port group view

Default command level

2: System level

Parameters

ratio: Sets the multicast suppression threshold as a percentage of the maximum interface rate, ranging from 1 to 100. The smaller the percentage, the less multicast traffic is allowed to be received.

pps max-pps: Specifies the maximum number of multicast packets that the Ethernet interface can receive per second. The max-pps argument ranges from 1 to 1488100 pps.

· When the pps keyword is specified, and a suppression granularity larger than 1 is specified on the device, the value of the pps keyword must be no smaller than, and an integer multiple of, the granularity. The multicast suppression threshold value configured through this keyword on an Ethernet interface may not be the one that actually takes effect. To display the actual multicast suppression threshold value on an Ethernet interface, use the display interface command.

· When the pps keyword is not specified, or the suppression granularity is set to 1, the value of the pps keyword must be no smaller than 1, and the multicast suppression threshold value is the one that actually takes effect on the Ethernet interface.

Usage guidelines

In Ethernet interface view, the configurations take effect only on the interface. In port group view, the configurations take effect on all ports in the port group.

When the received multicast traffic exceeds the threshold, the system discards multicast packets until multicast traffic drops below the threshold.

If you set different multicast suppression thresholds in Ethernet interface view or port group view multiple times, the one configured last takes effect.

Examples

# Set the multicast threshold to 20% on GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface GigabitEthernet 1/0/1

[Sysname-GigabitEthernet1/0/1] multicast-suppression 20

# Set the multicast threshold to 20% on all ports in the port group named group1.

<Sysname> system-view

[Sysname] port-group manual group1

[Sysname-port-group-manual-group1] group-member GigabitEthernet 1/0/1

[Sysname-port-group-manual-group1] group-member GigabitEthernet 1/0/2

[Sysname-port-group-manual-group1] multicast-suppression 20

port-group manual

Use port-group manual to create a port group and enter port group view.

Use undo port-group manual to remove a port group.

Syntax

port-group manual port-group-name

undo port-group manual port-group-name

Default

No port groups exist.

Views

System view

Default command level

2: System level

Parameters

port-group-name: Sets the port group name, a string of 1 to 32 characters.

Examples

# Create port group group1.

<Sysname> system-view

[Sysname] port-group manual group1

[Sysname-port-group-manual-group1]

reset counters interface

Use reset counters interface to clear the Ethernet interface statistics.

Syntax

reset counters interface [ interface-type [ interface-number ] ]

Views

User view

Default command level

2: System level

Parameters

interface-type: Specifies an interface type.

interface-number: Specifies an interface number.

Usage guidelines

Clear old statistics on the interface before collecting new traffic statistics for a specific period of time.

· If no interface type is specified, this command clears statistics for all interfaces on the device.

· If only the interface type is specified, this command clears statistics for all interfaces of the specified type.

· If both the interface type and number are specified, this command only clears statistics for the specified interface.

Examples

# Clear the statistics of GigabitEthernet 1/0/1.

<Sysname> reset counters interface GigabitEthernet 1/0/1

shutdown

Use shutdown to shut down an Ethernet interface.

Use undo shutdown to bring up an Ethernet interface.

Syntax

shutdown

undo shutdown

Default

Ethernet interfaces are up.

Views

Ethernet interface view, port group view

Default command level

2: System level

Usage guidelines

You may need to shut down and then bring up an Ethernet interface to activate configuration changes such as speed or duplex mode changes.

Examples

# Shut down and then bring up GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface GigabitEthernet 1/0/1

[Sysname-GigabitEthernet1/0/1] shutdown

[Sysname-GigabitEthernet1/0/1] undo shutdown

# Shut down all member ports in the port group named group1.

<Sysname> system-view

[Sysname] port-group manual group1

[Sysname-port-group-manual-group1] shutdown

speed

Use speed to set the speed of an Ethernet interface.

Use undo speed to restore the default.

Syntax

speed { 10 | 100 | 1000 | auto }

undo speed

Views

Ethernet interface view

Default

An Ethernet interface automatically negotiates a speed with its peer port.

Default command level

2: System level

Parameters

10: Sets the interface speed to 10 Mbps.

100: Sets the interface speed to 100 Mbps.

1000: Sets the interface speed to 1000 Mbps.

auto: Enables the interface to negotiate a speed with its peer.

Usage guidelines

For an Ethernet copper port, use the speed command to set its speed to match the speed of the peer interface.

Examples

# Configure GigabitEthernet 1/0/1 to operate at 100 Mbps.

<Sysname> system-view

[Sysname] interface GigabitEthernet 1/0/1

[Sysname-GigabitEthernet1/0/1] speed 100

unicast-suppression

Use unicast-suppression to set the unknown unicast suppression threshold on an Ethernet interface or a group of Ethernet interfaces.

Use undo unicast-suppression to restore the default.

Syntax

unicast-suppression { ratio | pps max-pps }

undo unicast-suppression

Default

Ethernet interfaces do not suppress unknown unicast traffic.

Views

Layer 2 Ethernet interface view, port group view

Default command level

2: System level

Parameters

ratio: Sets the unknown unicast suppression threshold as a percentage of the maximum interface rate, ranging from 1 to 100. The smaller the percentage, the less unknown unicast traffic is allowed to be received.

pps max-pps: Specifies the maximum number of unknown unicast packets that the Ethernet interface can receive per second. The max-pps argument ranges from 1 to 1488100 pps.

· When the pps keyword is specified, and a suppression granularity larger than 1 is specified on the device, the value of the pps keyword must be no smaller than, and an integer multiple of, the granularity. The unknown unicast suppression threshold value configured through this keyword on an Ethernet interface may not be the one that actually takes effect. To display the actual unknown unicast suppression threshold value on an Ethernet interface, use the display interface command.

· When the pps keyword is not specified, or the suppression granularity is set to 1, the value of the pps keyword must be no smaller than 1, and the unknown unicast suppression threshold value is the one that actually takes effect on the Ethernet interface.

Usage guidelines

In Ethernet interface view, the configuration will take effect only on the interface. In port group view, the configuration will take effect on all ports in the port group.

When the received unknown unicast traffic exceeds the threshold, the system discards unknown unicast packets until unknown unicast traffic drops below the threshold.

If you set different unknown unicast suppression thresholds in Ethernet interface view or port group view multiple times, the one configured last takes effect.

Examples

# Set the unknown unicast threshold to 20% on GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface GigabitEthernet 1/0/1

[Sysname-GigabitEthernet1/0/1] unicast-suppression 20

# Set the unknown unicast threshold to 20% on all ports of port group group1.

<Sysname> system-view

[Sysname] port-group manual group1

[Sysname-port-group-manual-group1] group-member GigabitEthernet 1/0/1

[Sysname-port-group-manual-group1] group-member GigabitEthernet 1/0/2

[Sysname-port-group-manual-group1] unicast-suppression 20

03-Layer 2 Command Reference

flow-interval

loopback

loopback-detection control enable

shutdown

speed

unicast-suppression

Intelligent Terminal Products

Product Support Services

Technical Service Solutions

Resource Center

Policy

Online Help

Become a Partner

Partner Policy & Program

Global Learning

Partner Sales Resources

Service Business

News & Events

Contact Us