Table of Contents

Related Documents

01-Ethernet Interface Commands

Title	Size	Download
01-Ethernet Interface Commands	164.44 KB

Ethernet interface configuration commands

General Ethernet interface configuration commands

default

Syntax

default

View

Ethernet interface view

Default level

2: System level

Parameters

None

Description

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

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

Syntax

description text

undo description

View

Ethernet interface view

Default 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 mark(!), at sign (@), number sign (#), dollar sign ($), percent (%), caret (^), ampersand (&), asterisk(*), brackets({ }, ( ),[ ], < >), hyphen (-), underscore(_), plus (+), equal sign (=), vertical bar (|), backslash (\), colon (:), semicolon (;) prime ("), apostrophe('),comma (,), period (.), slash (/), spaces, and other Unicode characters and symbols.

NOTE:

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

· To use a type of 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 this 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 into two. As a result, garbled characters may be displayed at the end of a line.

Description

Use description to change the description of the current interface.

Use undo description to restore the default.

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

Related commands: display interface.

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

display interface

Syntax

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

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

View

Any view

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

Description

Use display interface to display Ethernet interface information.

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

Related commands: interface.

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: 0000-000f-0007

Description: GigabitEthernet1/0/1 Interface

Loopback is not set

Media type is twisted pair, port hardware type is 100_BASE_TX

100Mbps-speed mode, half-duplex mode

Link speed type is autonegotiation, link duplex type is autonegotiation

Flow-control is not enabled

The Maximum Frame Length is 1536

Broadcast MAX-ratio: 100%

Unicast MAX-ratio: 100%

Multicast MAX-ratio: 100%

Allow jumbo frame to pass

PVID: 999

Mdi type: auto

Port link-type: access

Tagged VLAN ID : none

Untagged VLAN ID : 999

Port priority: 0

Last clearing of counters: Never

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

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

Input (total): 21322 packets, 1748554 bytes

- unicasts, - broadcasts, - multicasts, - pauses

Input (normal): 21322 packets, - bytes

1268 unicasts, 7560 broadcasts, 12494 multicasts, 0 pauses

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

0 CRC, - frame, - overruns, - aborts

- ignored, - parity errors

Output (total): 1502 packets, 138924 bytes

- unicasts, 2 broadcasts, 406 multicasts, 0 pauses

Output (normal): - packets, - bytes

1094 unicasts, - broadcasts, - multicasts, - pauses

Output: 3 output errors, - underruns, - buffer failures

- aborts, 1 deferred, 2 collisions, 0 late collisions

- lost carrier, - 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.
Description	Description of the interface.
Loopback	Loopback testing status of the interface.
100Mbps-speed mode, half-duplex mode	The interface operates at 100 Mbps and in half 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	The maximum Ethernet frame length allowed on the interface.
Broadcast MAX-ratio	Broadcast suppression threshold as a percentage of the interface transmission capability. When the threshold is exceeded, the interface drops broadcast packets.
Unicast MAX-ratio	Unknown unicast suppression threshold as a percentage of the interface transmission capability. When the threshold is exceeded, the interface drops unknown unicast packets.
Multicast MAX-ratio	Multicast suppression threshold as a percentage of the interface transmission capability. 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, and 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 counts interface command was last used to clear statistics on the interface. Never indicates that the reset counts 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.
Input (total): 21322 packets, 1748554 bytes - unicasts, - broadcasts, - 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): 21322 packets, - bytes 1268 unicasts, 7560 broadcasts, 12494 multicasts, 0 pauses	Inbound normal traffic (including unicast, broadcast, and multicast) and pause frame statistics (in packets and bytes) for the interface.
input errors	Inbound packets with errors.
runts	Inbound frames shorter than 64 bytes, in correct format, and containing 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 the maximum length of Ethernet frames that are allowed to pass through.
- throttles	The number of times that the port shut down due to 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 packet drops 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 integral or non-integral value. · Jabber frames—CRC error frames greater than the maximum frame length supported on the Ethernet interface (the frame length may or may not be integers). 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 length 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 bytes to 1500 bytes).
ignored	Number of inbound frames dropped because the receive buffer of the port ran low.
- parity errors	Total number of frames with parity errors.
Output (total): 1502 packets, 138924 bytes - unicasts, 2 broadcasts, 406 multicasts, 0 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): - packets, - bytes 1094 unicasts, - broadcasts, - multicasts, - pauses	Outbound normal traffic (including unicast, broadcast, and multicast) and pause frame statistics (in packets and bytes) for the interface.
output errors	Outbound packets with errors.
- underruns	Number of packet drops 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 reason: 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 ( OAM connection failure )	The interface is physically down because an OAM connection fails to be established on it or the current OAM connection is disconnected.
DOWN ( DLDP connection failure )	The interface is physically down because a DLDP connection fails to be established on it or the current DLDP connection is disconnected.
DOWN ( Loopback detection-protected )	The interface is shut down because a loop is detected on it.
DOWN ( BPDU-protected )	The interface is shut down by the BPDU guard function.
DOWN ( Monitor-Link uplink down )	The interface is physically down because the uplink of the monitor link group to which it belongs is down.

# 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

M-E1/0/0 DOWN DOWN --

NULL0 UP UP(s) --

Vlan1 UP UP 192.168.0.50

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

GE1/0/1 DOWN auto A A 1

GE1/0/2 DOWN auto A A 1

GE1/0/3 DOWN auto A A 1

GE1/0/4 UP 100M(a) F(a) A 1

XGE1/0/5 DOWN auto F 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.0.50

When you use the begin keyword to filter the output, the system only searches the Layer 2 interface list. # 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.0.50

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

GE1/0/4 UP 100M(a) F(a) A 1

# Display the brief information about all but GigabitEthernet 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

M-E1/0/0 DOWN DOWN --

NULL0 UP UP(s) --

Vlan1 UP UP 192.168.0.50

# Display information about interfaces in 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

M-E1/0/0 DOWN Not connected

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

Link: ADM - administratively down; Stby - standby

Interface Link Cause

GE1/0/1 DOWN Not connected

GE1/0/2 DOWN Not connected

GE1/0/3 DOWN Not connected

XGE1/0/5 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, perform 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 (an s in parentheses). This attribute is typical of interface Null 0 and the 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, perform 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).
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 of the interface.
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 current interface belongs was shut down with the shutdown command.
OAM connection failure	OAM connection fails (possibly because the connection fails to be established or the current connection is disconnected).
DLDP connection failure	DLDP connection fails (possibly because the connection fails to be established or the current connection is disconnected).
Loopback detection-protected	The interface is shut down because a loop is detected on it.
BPDU-protected	The interface is shut down by the BPDU guard function.
Monitor-Link uplink down	The uplink of the current monitor link group to which the current interface belongs is down.

duplex

Syntax

duplex { auto | full | half }

undo duplex

View

Ethernet interface view

Default 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. This keyword is not available for the optical ports of Combo interfaces and 10-GE interfaces.

Description

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

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

By default, Ethernet interfaces operate in auto-negotiation mode.

Related commands: speed.

NOTE:

Support for this command varies with your device models. For more information, see About the WX Series Access Controllers Command References.

Examples

# Configure the 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

Syntax

flow-control

undo flow-control

View

Ethernet interface view

Default level

2: System level

Parameters

None

Description

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.

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

By default, generic flow control on an Ethernet interface is disabled.

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 the peer, the interface slows down sending packets.

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

NOTE:

Support for this command varies with your device models. For more information, see About the WX Series Access Controllers Command References.

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

interface

Syntax

interface interface-type interface-number

View

System view

Default level

2: System level

Parameters

interface-type: Specifies an interface type.

interface-number: Specifies an interface number.

Description

Use interface to enter interface view.

Examples

# Enter GigabitEthernet 1/0/1 interface view.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1]

loopback

Syntax

loopback { external | internal }

undo loopback

View

Ethernet interface view

Default level

2: System level

Parameters

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

internal: Enables internal loopback testing to test the hardware of Ethernet interfaces.

Description

Use loopback to enable loopback testing on an Ethernet interface.

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

By default, loopback testing is disabled on Ethernet interfaces.

NOTE:

· Support for the parameters of this command varies with your device models. For more information, see About the WX Series Access Controllers Command References.

· 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, 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

reset counters interface

Syntax

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

View

User view

Default level

2: System level

Parameters

interface-type: Specifies an interface type.

interface-number: Specifies an interface number.

Description

Use reset counters interface to clear the Ethernet interface statistics.

Before collecting traffic statistics for a specific period of time on an interface, clear the old statistics first.

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

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

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

Examples

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

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

shutdown

Syntax

shutdown

undo shutdown

View

Ethernet interface view, port group view

Default level

2: System level

Parameters

None

Description

Use shutdown to shut down an Ethernet interface.

Use undo shutdown to bring up an Ethernet interface.

By default, Ethernet interfaces are in up state.

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

NOTE:

Support for this command varies with your device models. For more information, see About the WX Series Access Controllers Command References.

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

Syntax

speed { 10 | 100 | 1000 | auto }

undo speed

View

Ethernet interface view

Default 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 1,000 Mbps.

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

Description

Use speed to set the speed of an Ethernet interface.

Use undo speed to restore the default.

By default, an Ethernet interface negotiates a speed with its peer.

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

For an optical port, use the speed command to set its speed to match the rate of a pluggable optical transceiver.

Related commands: duplex.

NOTE:

Support for this command varies with your device models. For more information, see About the WX Series Access Controllers Command References.

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

Layer 2 Ethernet interface configuration commands

broadcast-suppression

Syntax

broadcast-suppression { ratio | pps max-pps }

undo broadcast-suppression

View

Layer 2 Ethernet interface view, port group view

Default level

2: System level

Parameters

ratio: Sets the broadcast suppression threshold as a percentage of the transmission capability of an Ethernet interface. The smaller the percentage, the less broadcast traffic is allowed to pass through.

· For devices that support linear suppression mode, this argument ranges from 1 to 100. The system default is 100.

· For devices that do not support linear suppression mode, this argument ranges from 5 to 100. The system default is 100.

pps max-pps: Specifies the maximum number of broadcast packets that the Ethernet interface can forward per second, ranging from 1 to 148810 in pps.

Description

Use broadcast-suppression to set the broadcast suppression threshold on one or multiple Ethernet interfaces.

Use undo broadcast-suppression to restore the default.

By default, Ethernet interfaces do not suppress broadcast traffic.

If you execute this command in Ethernet interface view, the configuration takes effect only on the interface. If you execute this command in port group view, the configuration takes effect on all ports in the port group.

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

NOTE:

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

display loopback-detection

Syntax

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

View

Any view

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

Description

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

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

NOTE:

Support for this command varies with your device models. For more information, see About the WX Series Access Controllers Command References.

Examples

# Display information about loopback detection.

<Sysname> display loopback-detection

Loopback detection is running.

Loopback detection is in multi-port mode.

Detection interval is 30 seconds.

No port is detected with loopback.

Table 5 Command output

Field	Description
Loopback-detection is in multi-port mode.	Multi-port loopback detection is enabled. This field is displayed for only a device supporting the loopback-detection multi-port-mode enable command.
Detection interval time is 30 seconds.	Loopback detection interval is 30 seconds.
No port is detected with loopback.	No loops are detected on ports.

display port-group manual

Syntax

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

View

Any view

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

Description

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

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 specify neither the all keyword nor a 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 GigabitEthernet1/0/3

GigabitEthernet1/0/4

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 GigabitEthernet1/0/3

GigabitEthernet1/0/4

flow-interval

Syntax

flow-interval interval

undo flow-interval

View

Layer 2 Ethernet interface view

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

Description

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

Use undo flow-interval to restore the default interval.

By default, the interface statistics polling interval is 300 seconds.

Examples

# Set the statistics polling interval to 100 seconds on GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] flow-interval 100

group-member

Syntax

group-member interface-list

undo group-member interface-list

View

Port group view

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

Description

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

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

By default, a port group does not contain any member ports.

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

jumboframe enable

Syntax

jumboframe enable [ value ]

undo jumboframe enable

View

Layer 2 Ethernet interface view, port group view

Default level

2: System level

Parameters

value: Sets the maximum length of Ethernet frames that are allowed to pass through. Support for this argument, and the valid value range and default setting of this argument vary with device models. For more information, see About the WX Series Access Controllers Command References.

Description

Use jumboframe enable to allow jumbo frames within the specified length to pass through one or multiple Ethernet interfaces.

Use undo jumboframe enable to prevent jumbo frames from passing through one or multiple Ethernet interfaces.

By default, the device allows jumbo frames within a specified length to pass through Layer 2 Ethernet interfaces. The length of jumbo frames that are allowed to pass varies with device models. For more information, see About the WX Series Access Controllers Command References.

Configuration of this command in Ethernet interface view applies only to the Ethernet interface.

Configuration of this command in port group view applies to all ports in the port group.

NOTE:

If you set the value argument multiple times in Ethernet interface view or port group view for a port in a port group, the latest configuration takes effect.

Examples

# Enable jumbo frames to pass through all Ethernet interfaces in port group group1.

<Sysname> system-view

[Sysname] port-group manual group1

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

[Sysname-port-group-manual-group1] jumboframe enable

# Enable jumbo frames to pass through GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] jumboframe enable

loopback-detection control enable

Syntax

loopback-detection control enable

undo loopback-detection control enable

View

Layer 2 Ethernet interface view, port group view

Default level

2: System level

Parameters

None

Description

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.

By default, loopback detection control is disabled on trunk and hybrid ports.

When a hybrid or trunk port detects a loop condition, it sends traps, and if loopback detection control is enabled, it shuts down the port and deletes all MAC address entries of the port. However, only after loopback detection control is enabled will the port perform the protective action configured with the loopback-detection action command.

This command is not applicable to access ports.

NOTE:

Support for this command varies with your device models. For more information, see About the WX Series Access Controllers Command References.

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

Syntax

loopback-detection enable

undo loopback-detection enable

View

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

Default level

2: System level

Parameters

None

Description

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.

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

By default, loopback detection is disabled on all Ethernet interfaces.

If an interface receives a packet that it sent out, a loop has occurred. Loops may 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 (shut down the port, for example) to take on the interface when a loop is detected.

The device takes the actions in Table 6 to alleviate the impact of the loop condition.

Table 6 Actions to take upon detection of a loop condition

Port type	Actions
Access port	· Place the receiving interface in block mode to disable it from forwarding packets. · Shut down the interface. · Generate traps. · Delete all MAC address entries of the interface.
Hybrid or trunk port	· Generate traps. · If loopback detection control is enabled, place the receiving interface in block mode to disable it from forwarding packets. · Delete all MAC address entries of the interface.

Port type

Actions

Access port

· Place the receiving interface in block mode to disable it from forwarding packets.

· Shut down the interface.

· Generate traps.

· Delete all MAC address entries of the interface.

Hybrid or trunk port

· Generate traps.

· If loopback detection control is enabled, place the receiving interface in block mode to disable it from forwarding packets.

· Delete all MAC address entries of the interface.

Related commands: loopback-detection control enable.

NOTE:

Support for this command varies with your device models. For more information, see About the WX Series Access Controllers Command References.

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

loopback-detection interval-time

Syntax

loopback-detection interval-time time

undo loopback-detection interval-time

View

System view

Default level

2: System level

Parameters

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

Description

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

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

The default loopback detection interval is 30 seconds.

Related commands: display loopback-detection.

NOTE:

Support for this command varies with your device models. For more information, see About the WX Series Access Controllers Command References.

Examples

# Set the loopback detection interval to 10 seconds.

<Sysname> system-view

[Sysname] loopback-detection interval-time 10

loopback-detection per-vlan enable

Syntax

loopback-detection per-vlan enable

undo loopback-detection per-vlan enable

View

Layer 2 Ethernet interface view, port group view

Default level

2: System level

Parameters

None

Description

Use loopback-detection per-vlan enable to enable loopback detection in each VLAN on trunk or hybrid ports.

Use undo loopback-detection per-vlan enable to disable loopback detection in all but the PVID on trunk or hybrid ports.

By default, a trunk port or hybrid port performs loopback detection only in its PVID.

The loopback-detection per-vlan enable command is not applicable to access ports.

Examples

# Enable loopback detection in all VLANs on hybrid port GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] loopback-detection enable

[Sysname] interface gigabitethernet 1/0/1

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

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

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

multicast-suppression

Syntax

multicast-suppression { ratio | pps max-pps }

undo multicast-suppression

View

Layer 2 Ethernet interface view, port group view

Default level

2: System level

Parameters

ratio: Sets the multicast suppression threshold as a percentage of the transmission capability of an Ethernet interface, ranging from 1 to 100. The smaller the percentage, the less multicast traffic is allowed to pass through.

pps max-pps: Specifies the maximum number of multicast packets that the interface can forward per second. The max-pps argument ranges from 1 to 148,810 pps.

Description

Use multicast-suppression to set the multicast suppression threshold on one or multiple Ethernet interfaces.

Use undo multicast-suppression to restore the default.

By default, Ethernet interfaces do not suppress multicast traffic.

If you execute this command in Ethernet interface view, the configurations take effect only on the interface. If you execute this command in port group view, the configurations take effect on all ports in the port group.

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

NOTE:

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

Syntax

port-group manual port-group-name

undo port-group manual port-group-name

View

System view

Default level

2: System level

Parameters

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

Description

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

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

By default, no port group exists.

Examples

# Create port group group1.

<Sysname> system-view

[Sysname] port-group manual group1

[Sysname-port-group-manual-group1]

unicast-suppression

Syntax

unicast-suppression { ratio | pps max-pps }

undo unicast-suppression

View

Layer 2 Ethernet interface view, port group view

Default level

2: System level

Parameters

ratio: Sets the unknown unicast suppression threshold as a percentage of the transmission capability of the Ethernet interface, ranging from 1 to 100. The smaller the percentage, the less unknown unicast traffic is allowed through.

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

Description

Use unicast-suppression to set the unknown unicast suppression threshold on one or multiple Ethernet interfaces.

Use undo unicast-suppression to restore the default.

By default, Ethernet interfaces do not suppress unknown unicast traffic.

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

NOTE:

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

display interface

interface

loopback

reset counters interface

shutdown

speed

broadcast-suppression

display loopback-detection

display port-group manual

loopback-detection control enable

multicast-suppression

port-group manual

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