Title | Size | Downloads |
---|---|---|
01-Ethernet Port Commands.pdf | 195.82 KB |
- Table of Contents
- Related Documents
-
Title | Size | Download |
---|---|---|
01-Ethernet Port Commands | 195.82 KB |
Table of Contents
1 Ethernet Interface Configuration Commands
General Ethernet Interface Configuration Commands
Layer 2 Ethernet Port Configuration Commands
loopback-detection control enable
loopback-detection interval-time
General Ethernet Interface Configuration Commands
The configuration commands described in this chapter apply to Layer 2 and Layer 3 Ethernet interfaces.
description
Syntax
description text
undo description
View
Ethernet interface view
Default Level
2: System level
Parameters
text: Description of an Ethernet interface, a string of 1 to 80 characters. Currently, the device supports the following types of characters or symbols: standard English characters (numbers and case-sensitive letters), special English characters, spaces, and other characters or symbols that conform to the Unicode standard.
l A port description can be the mixture of English characters and other Unicode characters. The mixed description cannot exceed the specified length.
l To use a type of Unicode characters or symbols in a port description, you need to install the corresponding Input Method Editor (IME) and log in to the device through remote login software that supports this character type.
l Each Unicode character or symbol (non-English characters) takes the space of two regular characters. 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 the description command to set the description string of the current interface.
Use the undo description command to restore the default.
By default, the description of an interface is the interface name followed by the “interface” string, Ethernet1/0/1 Interface for example.
Related commands: display interface.
Examples
# Configure the description string of interface Ethernet 1/0/1 as lanswitch-interface.
<Sysname> system-view
[Sysname] interface ethernet 1/0/1
[Sysname-Ethernet1/0/1] description lanswitch-interface
display brief interface
Syntax
display brief interface [ interface-type [ interface-number ] ] [ | { begin | exclude | include } regular-expression ]
View
Any view
Default Level
1: Monitor level
Parameters
interface-type: Type of a specified interface.
interface-number: Number of a specified interface.
|: Uses a regular expression to filter output information. For detailed description on regular expression, refer to Basic System Configuration in the System Volume.
begin: Displays the line that matches the regular expression and all the subsequent lines.
exclude: Displays the lines that do not match the regular expression.
include: Displays the lines that match the regular expression.
regular-expression: Regular expression, a string of 1 to 256 characters. Note that this argument is case-sensitive.
Description
Use the display brief interface command to display brief interface information.
l If neither interface type nor interface number is specified, all interface information will be displayed.
l If only interface type is specified, then only information of this particular type of interface will be displayed.
l If both interface type and interface number are specified, then only information of the specified interface will be displayed.
Related commands: interface.
Examples
# Display the brief information of interfaces.
<Sysname> display brief interface
The brief information of interface(s) under route mode:
Interface Link Protocol-link Protocol type Main IP
Aux0 DOWN DOWN -- --
Eth1/0/1 DOWN DOWN ETHERNET 3.3.3.2
Eth1/0/2 DOWN DOWN ETHERNET 10.2.2.1
Eth1/0/2 DOWN DOWN ETHERNET 12.12.12.40
Loop0 UP UP(spoofing) LOOP 5.5.5.5
NULL0 UP UP(spoofing) NULL --
Vlan999 UP UP ETHERNET 10.10.1.1
The brief information of interface(s) under bridge mode:
Interface Link Speed Duplex Link-type PVID
Eth1/0/2 DOWN auto auto hybrid 200
Eth1/0/3 DOWN auto auto access 19
Eth1/0/4 DOWN auto auto access 1
Eth1/0/5 DOWN auto auto access 19
Eth1/0/6 DOWN auto auto access 600
Eth1/0/7 UP 100M(a) full(a) trunk 303
Eth1/0/8 DOWN auto auto access 1
Eth1/0/9 UP 100M(a) full(a) access 999
# Display the information of interfaces beginning with the string “spoof”.
<Sysname> display brief interface | begin spoof
The brief information of interface(s) under route mode:
Interface Link Protocol-link Protocol type Main IP
Loop0 UP UP(spoofing) LOOP 5.5.5.5
NULL0 UP UP(spoofing) NULL --
Vlan999 UP UP ETHERNET 10.1.1.1
# Display the brief information of all UP interfaces.
<Sysname> display brief interface | include UP
The brief information of interface(s) under route mode:
Interface Link Protocol-link Protocol type Main IP
Loop0 UP UP(spoofing) LOOP 5.5.5.5
NULL0 UP UP(spoofing) NULL --
Vlan999 UP UP ETHERNET 10.1.1.1
The brief information of interface(s) under bridge mode:
Interface Link Speed Duplex Link-type PVID
Eth1/0/7 UP 100M(a) full(a) trunk 303
Eth1/0/9 UP 100M(a) full(a) access 999
# Display the brief information of all interfaces excluding Ethernet interfaces.
<Sysname> display brief interface | exclude Eth
The brief information of interface(s) under route mode:
Interface Link Protocol-link Protocol type Main IP
Aux0 DOWN DOWN -- --
Loop0 UP UP(spoofing) LOOP 5.5.5.5
NULL0 UP UP(spoofing) NULL --
Vlan999 UP UP ETHERNET 10.1.1.1
Table 1-1 display brief interface command output description
Field |
Description |
Interface |
Abbreviated interface name |
Link |
Interface physical link state, which can be up or down |
Protocol-link |
Interface protocol link state, which can be up or down |
Protocol type |
Interface protocol type |
Speed |
Interface rate, in bps |
Duplex |
Duplex mode, which can be half (half duplex), full (full duplex), or auto (auto-negotiation). |
PVID |
Default VLAN ID |
display interface
Syntax
display interface [ interface-type [ interface-number] ]
View
Any view
Default Level
1: Monitor level
Parameters
interface-type: Type of a specified interface.
interface-number: Number of a specified interface.
Description
Use the display interface command to display the current state of a specified interface and related information.
l If neither interface type nor interface number is specified, all interface information will be displayed.
l If only interface type is specified, then only information of this particular type of interface will be displayed.
l If both interface type and interface number are specified, then only information of the specified interface will be displayed.
Related commands: interface.
Examples
# Display the current state of Layer 3 interface Ethernet 1/0/1 and related information.
<Sysname> display interface ethernet 1/0/1
Ethernet1/0/1 current state: DOWN
Line protocol current state: DOWN
Description: Ethernet1/0/1 Interface
The Maximum Transmit Unit is 1500, Hold timer is 10(sec)
Link delay is 0(sec)
Internet protocol processing : disabled
IP Packet Frame Type: PKTFMT_ETHNT_2, Hardware Address: 00e0-fc00-3901
IPv6 Packet Frame Type: PKTFMT_ETHNT_2, Hardware Address: 00e0-fc00-3901
Media type is twisted pair, Port hardware type is 100_BASE_TX
Port priority: 0
Last 300 seconds input: 0 packets/sec 0 bytes/sec -%
Last 300 seconds output: 0 packets/sec 0 bytes/sec -%
Input (total): - packets, - bytes
unicasts, - broadcasts, - multicasts
Input (normal): 0 packets, 0 bytes
unicasts, 0 broadcasts, 0 multicasts
Input: 0 input errors, 0 runts, 0 giants, - throttles
0 CRC, 0 frame, 0 overruns, 0 aborts
- ignored, - parity errors
Output (total): - packets, - bytes
unicasts, - broadcasts, - multicasts, - pauses
Output (normal): 0 packets, 0 bytes
unicasts, 0 broadcasts, 0 multicasts, 0 pauses
Output: 0 output errors, - underruns, - buffer failures
0 aborts, 0 deferred, 0 collisions, 0 late collisions
- lost carrier, - no carrier
Table 1-2 display interface (in route mode) command output description
Field |
Description |
Ethernet1/0/1 current state |
Interface physical link state, which can be up or down |
Line protocol current state |
Interface protocol link state |
Description |
The description of an Ethernet interface |
Hold timer is |
Link state hold time in seconds |
Internet protocol processing |
IP packet processing: disabled indicates that IP packets cannot be processed. For an interface configured with an IP address, this field changes into Internet Address is. |
Media type |
Cable type |
Port hardware type is |
Hardware transmission type |
Last 300 seconds input rate |
Average input rate over the last 300 seconds: bytes/sec, bits/sec, packets/sec |
Last 300 seconds output rate |
Average output rate over the last 300 seconds: bytes/sec, bits/sec, packets/sec |
Input |
Input packets |
Output |
Output packets |
# Display the current state of Layer 2 interface Ethernet 1/0/1 and related information.
<Sysname> display interface ethernet 1/0/1
Ethernet1/0/2 current state: DOWN
IP Packet Frame Type: PKTFMT_ETHNT_2, Hardware Address: 00e0-fc00-3900
Description: Ethernet1/0/2 Interface
Loopback is not set
Media type is twisted pair, Port hardware type is 100_BASE_TX
Unknown-speed mode, unknown-duplex mode
Link speed type is autonegotiation, link duplex type is autonegotiation
Flow-control is not enabled
The Maximum Frame Length is 1552
Broadcast MAX-ratio: 100%
Unicast MAX-ratio: 100%
Multicast MAX-ratio: 100%
PVID: 1
Mdi type: auto
Link delay is 0(sec)
Port link-type: access
Tagged VLAN ID : none
Untagged VLAN ID : 1
Port priority: 0
Last 300 seconds input: 0 packets/sec 0 bytes/sec -%
Last 300 seconds output: 0 packets/sec 0 bytes/sec -%
Input (total): - packets, - bytes
- broadcasts, - multicasts
Input (normal): 0 packets, 0 bytes
0 broadcasts, 0 multicasts
Input: 0 input errors, 0 runts, 0 giants, - throttles
0 CRC, 0 frame, 0 overruns, 0 aborts
- ignored, - parity errors
Output (total): - packets, - bytes
- broadcasts, - multicasts, - pauses
Output (normal): 0 packets, 0 bytes
0 broadcasts, 0 multicasts, 0 pauses
Output: 0 output errors, - underruns, - buffer failures
0 aborts, 0 deferred, 0 collisions, 0 late collisions
- lost carrier, - no carrier
Table 1-3 display interface command (in bridge mode) output description
Field |
Description |
Ethernet1/0/1 current state |
Current physical link state of the Ethernet interface |
IP Packet Frame Type |
Frame type of the Ethernet interface |
Description |
Description of the interface |
Unknown-speed mode |
Unknown-speed mode, in which mode speed is negotiated between the current host and the peer. |
unknown-duplex mode |
Unknown-duplex mode, in which mode speed is negotiated between the current host and the peer. |
The Maximum Frame Length |
The maximum frame length allowed on an interface |
Broadcast MAX-ratio |
Broadcast storm suppression ratio (the maximum ratio of allowed number of broadcast packets to overall traffic through an interface) |
Unicast MAX-ratio |
Unicast storm suppression ratio (the maximum ratio of allowed number of unknown unicast packets to overall traffic over an interface) |
Multicast MAX-ratio |
Multicast storm suppression ratio (the maximum ratio of allowed number of multicast packets to overall traffic through an interface) |
PVID |
Default VLAN ID |
Mdi type |
Cable type |
Port link-type |
Interface link type, which could be access, trunk, and hybrid. |
Tagged VLAN ID |
VLANs whose packets are sent through the port with VLAN tag kept |
Untagged VLAN ID |
VLANs whose packets are sent through the port with VLAN tag stripped off |
Peak value of input |
Peak value of inbound traffic, in bytes/sec. |
Peak time of input |
Time of peak inbound traffic |
Peak value of output |
Peak value of outbound traffic, in bytes/sec. |
Peak time of output |
Time of peak outbound traffic |
Last 300 seconds input: |
Average input rate over the last 300 seconds, among which: l packets/sec indicates the average input rate in terms of the average number of the packets received per second. l bytes/sec indicates the average input rate in terms of the average number of bytes received per second. l x% indicates the percentage of the average input rate to the total bandwidth, where - indicates that the rate is greater than the maximum value that can be displayed. |
Last 300 seconds output: |
Average output rate over the last 300 seconds, among which: l packets/sec indicates the average output rate in terms of the average number of the packets output per second. l bytes/sec indicates the average output rate in terms of the average number of bytes output per second. l x% indicates the percentage of the average output rate to the total bandwidth, where “-“ indicates that the rate is greater than the maximum value that can be displayed. |
Input (total): 0 packets, 0 bytes - unicasts, 0 broadcasts, 0 multicasts Input (normal): 0 packets, - bytes 0 unicasts, 0 broadcasts, 0 multicasts Input: 0 input errors, 0 runts, 0 giants, 0 throttles 0 CRC, 0 frame, - overruns, 0 aborts - ignored, - parity errors |
Error and packet statistics on the inbound and outbound directions of the interface, where “-“ indicates that the corresponding entry is not supported. The statistics entries include: l Input errors: Input packets with errors l Runts: Packets that are discarded because they are smaller than the medium's minimum packet size. l Giants: Packets that are discarded because they exceed the medium’s maximum packet size. l Throttles: Corrupt or incomplete packets l CRC: Packets that contain corrupted data (checksum error) l Frame: Framing errors l Overruns: Packets that were dropped because the network interface card was overwhelmed. l Aborts: Packets that were dropped due to incorrect descriptors l Output errors: Output packets with errors l Underruns: Packets that were dropped because the network interface card failed to receive packets fast enough l Buffer failures l Aborts: Packet that were dropped l Deferred: Delayed packets l Collisions: Packets retransmitted due to Ethernet collisions l Late collisions: Collisions that were detected late in the transmission of packets Lost carrier: Number of times the carrier signal was lost during transmission |
Output (total): 0 packets, 0 bytes - unicasts, 0 broadcasts, 0 multicasts, 0 pauses Output (normal): 0 packets, - bytes 0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses Output: 0 output errors, - underruns, 0 buffer failures 0 aborts, 0 deferred, 0 collisions, 0 late collisions 0 lost carrier, - no carrier |
display port combo
Syntax
display port combo
View
Any view
Default Level
1: Monitor level
Parameters
None
Description
Use the display port combo command to display the Combo ports of a device and the corresponding optical ports and electrical ports.
Only S3610-52M, S5510-24F, and S5510-24P support command currently..
Examples
# Display the Combo ports of the device and the corresponding optical ports and electrical ports.
<Sysname> display port combo
Combo-group Active Inactive
1 GigabitEthernet1/7/1 GigabitEthernet1/7/5
2 GigabitEthernet1/7/2 GigabitEthernet1/7/6
3 GigabitEthernet1/7/3 GigabitEthernet1/7/7
4 GigabitEthernet1/7/4 GigabitEthernet1/7/8
Table 1-4 display port combo command output description
Field |
Description |
Combo-group |
Combo ports of the device, represented by Combo port number, which is generated by the system. |
Active |
Ports of the Combo ports that are active |
Inactive |
Ports of the Combo ports that are inactive |
As for the optical port and the electrical port of a Combo port, the one with the smaller port number is active by default. The port number varies with device models. You can determine whether a port is an optical port or an electrical port by checking the “Media type is” field of the display interface command.
duplex
Syntax
duplex { auto | full | half }
undo duplex
View
Ethernet interface view
Default Level
2: System level
Parameters
auto: Indicates that the interface is in auto-negotiation state.
full: Indicates that the interface is in full-duplex state.
half: Indicates that the interface is in half-duplex state. The optical interface of a Combo port does not support the half keyword.
Description
Use the duplex command to configure the duplex mode for an Ethernet interface.
Use the undo duplex command to restore the duplex mode for an Ethernet interface to the default.
By default, the duplex mode for an Ethernet interface is auto.
Related commands: speed.
For a small form-factor pluggable (SFP) port that uses a 100-Mbps module, the duplex mode can only be configured as full; for a SFP port that uses a 1000-Mbps module, the duplex mode can only be configured as auto or full.
Examples
# Configure the interface Ethernet 1/0/1 to work in full-duplex mode.
<Sysname> system-view
[Sysname] interface ethernet 1/0/1
[Sysname-Ethernet1/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 the flow-control command to enable flow control on an Ethernet interface.
Use the undo flow-control command to disable flow control on an Ethernet interface.
By default, flow control on an Ethernet interface is disabled.
The flow control function takes effect on the local Ethernet interface only when it is enabled on both the local and peer devices.
Examples
# Enable flow control on interface Ethernet 1/0/1.
<Sysname> system-view
[Sysname] interface ethernet 1/0/1
[Sysname-Ethernet1/0/1] flow-control
interface
Syntax
interface interface-type interface-number
View
System view
Default Level
2: System level
Parameters
interface-type interface-number: Interface type and interface number.
Description
Use the interface command to enter interface view.
Examples
# Enter Ethernet 1/0/1 interface view.
<Sysname> system-view
[Sysname] interface ethernet 1/0/1
[Sysname-Ethernet1/0/1]
link-delay
Syntax
link-delay delay-time
undo link-delay
View
Ethernet interface view
Default Level
2: System level
Parameters
delay-time: Up/down suppression time for the physical connection of an Ethernet interface (in seconds). The value range varies with devices.
Description
Use the link-delay command to configure the suppression time of physical-link-state changes on an Ethernet Interface.
Use the undo link-delay command to restore the default suppression time.
The default suppression time of physical-link-state changes on an Ethernet Interface varies with device models.
Examples
# Set the up/down suppression time of the physical connection of an Ethernet interface to 8 seconds.
<Sysname> system-view
[Sysname] interface ethernet 1/0/1
[Sysname-Ethernet1/0/1] link-delay 8
loopback
Syntax
loopback { external | internal }
undo loopback
View
Ethernet interface view
Default Level
2: System level
Parameters
external: Enables external loopback testing on an Ethernet interface. Support for this keyword varies with device models.
internal: Enables internal loopback testing on an Ethernet interface. Support for this keyword varies with device models.
Description
Use the loopback command to enable Ethernet interface loopback testing.
Use the undo loopback command to disable Ethernet interface loopback testing.
By default, Ethernet interface loopback testing is disabled.
l Ethernet interface loopback testing should be enabled while testing certain functionalities, such as during the initial identification of any network failure.
l While enabled, Ethernet interface loopback testing will work in full-duplex mode. The interface will return to its original state upon completion of the loopback testing.
Examples
# Enable loopback testing on Ethernet 1/0/1.
<Sysname> system-view
[Sysname] interface ethernet 1/0/1
[Sysname-Ethernet1/0/1] loopback internal
port link-mode
Syntax
port link-mode { bridge | route }
undo port link-mode
View
Ethernet interface view
Default Level
2: System level
Parameters
bridge: Specifies the Layer 2 mode.
route: Specifies the Layer 3 mode.
Description
Use the port link-mode command to change the working mode of the Ethernet interface.
Use the undo port link-mode command to restore the original working mode.
By default, an Ethernet interface operates in bridge mode.
l In bridge mode, an Ethernet interface forwards traffic based on destination MAC addresses only. It forwards a packet to the corresponding egress port by looking up the MAC address table for a matched entry or submits a packet to the corresponding VLAN interface for Layer 3 forwarding. An Ethernet interface operating in bridge mode supports Layer 2 functions such as VLAN.
l In route mode, an Ethernet interface forwards traffic based on destination IP addresses only. It forwards a packet to the corresponding egress port by looking up the IP routing table for a matched entry. An Ethernet interface operating in route mode supports Layer 3 functions such as IP address configuration.
l After the working mode is changed, all parameters of the Ethernet interface will be restored to the defaults in the current working mode.
l Combo ports on the S3610-52M, S5510-24F, and S5510-24P switches do not support the route mode.
Examples
# Configure Ethernet 1/0/1 to operate in Layer 2 mode.
<Sysname> system-view
[Sysname] interface ethernet 1/0/1
[Sysname-Ethernet1/0/1] display this
#
interface Ethernet1/0/1
port link-mode route
#
return
[Sysname-Ethernet1/0/1] port link-mode bridge
[Sysname-Ethernet1/0/1] display this
#
interface Ethernet1/0/1
port link-mode bridge
#
return
The display this command displays the current configuration.
reset counters interface
Syntax
reset counters interface [ interface-type [ interface-number ] ]
View
User view
Default Level
2: System level
Parameters
interface-type: Interface type.
interface-number: Interface number.
Description
Use the reset counters interface command to clear the statistics of an interface.
Before sampling network traffic within a specific period of time on an interface, you need to clear the existing statistics.
l If neither interface type nor interface number is specified, this command clears the statistics of all the interfaces.
l If only the interface type is specified, this command clears the statistics of the interfaces that are of the interface type specified.
l If both the interface type and interface number are specified, this command clears the statistics of the specified interface.
Examples
# Clear the statistics of Ethernet 1/0/1.
<Sysname> reset counters interface ethernet 1/0/1
shutdown
Syntax
shutdown
undo shutdown
View
Ethernet interface view
Default Level
2: System level
Parameters
None
Description
Use the shutdown command to shut down an Ethernet interface.
Use the undo shutdown command to bring up an Ethernet interface.
By default, an Ethernet interface is in the up state.
In certain circumstances, modification to the interface parameters does not immediately take effect, and therefore, you need to shut down the relative interface to make the modification work.
Note that in case of a double Combo port, only one interface (either the optical port or the electrical port) is active at a time. That is, once the optical port is active (after you execute the undo shutdown command), the electrical port will be inactive automatically, and vice versa.
Examples
# Shut down interface Ethernet 1/0/1.
<Sysname> system-view
[Sysname] interface ethernet 1/0/1
[Sysname-Ethernet1/0/1] shutdown
speed
Syntax
speed { 10 | 100 | 1000 | auto }
undo speed
View
Ethernet interface view
Default Level
2: System level
Parameters
10: Specifies the interface rate as 10 Mbps.
100: Specifies the interface rate as 100 Mbps.
1000: Specifies the interface rate as 1,000 Mbps. This parameter is available only in GigabitEthernet interface view
auto: Specifies to determine the interface rate through auto-negotiation.
Description
Use the speed command to configure Ethernet interface data rate.
Use the undo speed command to restore Ethernet interface data rate.
The default value of this command varies with the interface board models.
By default, the rate of an Ethernet interface is determined through auto-negotiation. The default rate of a small form-factor pluggable (SFP) port using a 100-Mbps module is 100 Mbps, while that of an SFP port using a 1000-Mbps module is 1000 Mbps.
Related commands: duplex.
For an SFP port that uses a 100-Mbps module, the port rate can only be 100 Mbps; for a SFP port that uses a 1000-Mbps module, the port rate can be determined through auto negotiation or be 1000 Mbps, but not 10 or 100 Mbps.
Examples
# Configure the interface rate as 100 Mbps for interface Ethernet 1/0/1.
<Sysname> system-view
[Sysname] interface ethernet 1/0/1
[Sysname-Ethernet1/0/1] speed 100
Layer 2 Ethernet Port Configuration Commands
broadcast-suppression
Syntax
broadcast-suppression ratio
undo broadcast-suppression
View
Layer 2 Ethernet port view, port group view
Default Level
2: System level
Parameters
ratio: Maximum percentage of broadcast traffic to the total transmission capability of an Layer 2 Ethernet port. The smaller the ratio, the less broadcast traffic is allowed to pass through the interface.This argument ranges from 1 to 100. The system default is 100.
Description
Use the broadcast-suppression command to set a broadcast traffic threshold on one or multiple Ethernet ports.
Use the undo broadcast-suppression command to restore the default.
By default, broadcast traffic is not suppressed.
If you execute this command in Layer 2 Ethernet port view, the configuration takes effect only on the current interface. If you execute this command in port-group view, the configuration takes effect on all the ports in the port group.
When broadcast traffic exceeds the broadcast traffic threshold, the system begins to discard broadcast packets until the broadcast traffic drops below the threshold to ensure operation of network services.
For an Ethernet interface whose physical rate is 1000 Mbps, if its rate is manually configured or auto-negotiated as 100 Mbps, the broadcast suppression ratio configured on the interface using the broadcast-suppression command should be based on a 100-Mbps rate
l If a suppression ratio is set in global configuration mode or in interface configuration mode, the suppression ratio which first satisfies the condition takes effect.
l If you set different suppression ratios in Layer 2 Ethernet port view or port-group view for multiple times, the latest configuration takes effect.
l Do not use the broadcast-suppression command along with the storm-constrain command. Otherwise, the broadcast storm suppression ratio configured may get invalid.
Examples
# For Layer 2 Ethernet port Ethernet 1/0/1, allow broadcast traffic equivalent to 20% of the total transmission capability of Ethernet 1/0/1 to pass.
<Sysname> system-view
[Sysname] interface ethernet 1/0/1
[Sysname-Ethernet1/0/1] broadcast-suppression 20
# For all the ports of the manual port group named group1, allow broadcast traffic equivalent to 20% of the total transmission capability of each port to pass and suppress excessive broadcast packets.
<Sysname> system-view
[Sysname] port-group manual group1
[Sysname-port-group manual group1] group-member ethernet 1/0/1
[Sysname-port-group manual group1] group-member ethernet 1/0/2
[Sysname-port-group manual group1] broadcast-suppression 20
display loopback-detection
Syntax
display loopback-detection
View
Any view
Default Level
1: Monitor level
Parameters
None
Description
Use the display loopback-detection command to display loopback detection information on a port.
If loopback detection is already enabled, this command will also display the detection interval and information on the ports currently detected with a loopback.
Examples
# Display loopback detection information on a port.
<Sysname> display loopback-detection
Loopback-detection is running
Detection interval time is 30 seconds
No port is detected with loopback
display port-group manual
Syntax
display port-group manual [ all | name port-group-name ]
View
Any view
Default Level
2: System level
Parameters
all: Specifies all the manual port groups.
name port-group-name: Specifies the name of a manual port group, a string of 1 to 32 characters.
Description
Use the display port-group manual command to display the information about a manual port group or all the manual port groups.
l If you provide the port-group-name argument, this command displays the details for a specified manual port group, including its name and the Ethernet ports included.
l If you provide the all keyword, this command displays the details for all manual port groups, including their names and the Ethernet ports included.
l Absence of parameters indicates that the names of all the port groups will be displayed.
Examples
# Display the names of all the port groups.
<Sysname> display port-group manual
The following manual port group exist(s):
group1 group2
# Display details of all the manual port groups.
<Sysname> display port-group manual all
Member of 1:
Ethernet1/0/4 Ethernet1/0/5 Ethernet1/0/6
Ethernet1/0/7 Ethernet1/0/8 Ethernet1/0/9
Ethernet1/0/10
Member of 2:
None
# Display details of the port group named group1.
<Sysname> display port-group manual name group1
Member of group1:
Ethernet1/0/4 Ethernet1/0/5 Ethernet1/0/6
Ethernet1/0/7 Ethernet1/0/8 Ethernet1/0/9
Ethernet1/0/10
Table 1-5 display port-group manual command output description
Field |
Description |
Member of group |
Member of the manual port group |
display storm-constrain
Syntax
display storm-constrain [ broadcast | multicast | unicast ] [ interface interface-type interface-number ]
View
Any view
Default Level
1: Monitor level
Parameters
broadcast: Displays the information about storm constrain for broadcast packets.
multicast: Displays the information about storm constrain for multicast packets.
unicast: Displays the information about storm constrain for unicast packets.
interface interface-type interface-number: Specifies an interface by its type and number.
Description
Use the display storm-constrain command to display the information about storm constrain.
If you provide no argument or keyword, this command displays the information about storm constrain for all types of packets on all the interfaces.
Examples
# Display the information about storm constrain for all types of packets on all the interfaces.
<Sysname> display storm-constrain
Abbreviation: BC - broadcast; MC - multicast; UC - unicast
Flow Statistic Interval: 5(second)
PortName Type LowerLimit UpperLimit CtrMode Status Trap Log SwiNum Unit
--------------------------------------------------------------------------
Eth1/0/1 broadcast 12345 23456 block normal on off 0
Eth1/0/1 multicast 43 100 block control on off 1
Table 1-6 display storm-constrain command output description
Field |
Description |
Flow Statistic Interval |
Interval for generating storm constrain statistics |
PortName |
Abbreviated port name |
StormType |
Type of the packets for which storm constrain function is enabled, which can be broadcast (for broadcast packets), multicast (for multicast packets), and unicast (for unicast packets). |
LowerLimit |
Lower threshold (in pps, kbps or percentage) |
UpperLimit |
Upper threshold (in pps, kbps or percentage) |
Ctr-mode |
Action to be taken when the upper threshold is reached, which can be block, shutdown, and N/A. |
Status |
Interface state, which can be normal (indicating the interface operates properly), control (indicating the interface is blocked or shut down). |
Trap |
State of trap messages sending. “on” indicates trap message sending is enabled; “off” indicates trap message sending is disabled. |
Log |
State of log sending. “on” indicates log sending is enabled; “off” indicates log sending is disabled. |
Swi-num |
Number of the forwarding state switching. This field is numbered modulo 65,535. |
flow-interval
Syntax
flow-interval interval
undo flow-interval
View
Layer 2 Ethernet port view
Default Level
2: System level
Parameters
interval: Interval at which the interface collects statistics. It ranges from 5 to 300 seconds and must be a multiple of 5. The default value is 300 seconds.
Description
Use the flow-interval command to configure the time interval for collecting interface statistics.
Use the undo flow-interval command to restore the default interval.
Examples
# Set the time interval for collecting interface statistics to 100 seconds.
<Sysname> system-view
[Sysname] interface ethernet 1/0/1
[Sysname-Ethernet1/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: Layer 2 Ethernet port 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 port or port ranges.
Description
Use the group-member command to assign an Layer 2 Ethernet port or a list of Layer 2 Ethernet ports to the manual port group.
Use the undo group-member command to remove an Layer 2 Ethernet port or a list of Layer 2 Ethernet ports from the manual port group.
By default, there is no Layer 2 Ethernet port in a manual port group.
Examples
# Add interface Ethernet 1/0/1 to the manual port group named group1.
<Sysname> system-view
[Sysname] port-group manual group1
[Sysname-port-group-manual-group1] group-member ethernet 1/0/1
jumboframe enable
Syntax
jumboframe enable
undo jumboframe enable
View
System view
Default Level
2: System level
Parameters
None
Description
Use the jumboframe enable command to allow jumbo frames with the specified length to pass through an Layer 2 Ethernet port.
Use the undo jumboframe enable command to prevent jumbo frames from passing through a Layer 2 Ethernet port.
By default, the device allows jumbo frames to pass through Layer 2 Ethernet ports.
Examples
# Enable jumbo frames to pass through all the Layer 2 Ethernet ports.
<Sysname> system-view
[Sysname] jumboframe enable
loopback-detection control enable
Syntax
loopback-detection control enable
undo loopback-detection control enable
View
Layer 2 Ethernet port view
Default Level
2: System level
Parameters
None
Description
Use the loopback-detection control enable command to enable loopback detection for a Trunk port or Hybrid port.
Use the undo loopback-detection control enable command to restore the default.
By default, loopback detection for a Trunk port or Hybrid port is disabled.
l When the loopback detection is enabled, if a port has been detected with loopback, it will be shut down. A Trap message will be sent to the terminal and the corresponding MAC address forwarding entries will be deleted.
l When the loopback detection is disabled, if a port has been detected with loopback, a Trap message will be sent to the terminal. The port is still working properly.
Note that this command is inapplicable to an Access port as its loopback detection is enabled by default.
Examples
# Enable loopback detection for the trunk port Ethernet 1/0/1.
<Sysname> system-view
[Sysname] loopback-detection enable
[Sysname] interface ethernet 1/0/1
[Sysname-Ethernet1/0/1] port link-type trunk
[Sysname-Ethernet1/0/1] loopback-detection enable
[Sysname-Ethernet1/0/1] loopback-detection control enable
loopback-detection enable
Syntax
loopback-detection enable
undo loopback-detection enable
View
System view, Layer 2 Ethernet port view
Default Level
2: System level
Parameters
None
Description
Use the loopback-detection enable command to enable loopback detection globally or on a specified port.
Use the undo loopback-detection enable command to disable loopback detection globally or on a specified port.
By default, loopback detection is disabled for an Access, Trunk, or Hybrid port.
l If an Access port has been detected with loopback, it will be shut down. A Trap message will be sent to the terminal and the corresponding MAC address.
l If a Trunk port or Hybrid port has been detected with loopback, a Trunk message will be sent to the terminal. They will be shut down if the loopback testing function is enabled on them. In addition, a Trap message will be sent to the terminal and the corresponding MAC address forwarding entries will be deleted.
Related commands: loopback-detection control enable.
l Loopback detection on a given port is enabled only after the loopback-detection enable command has been configured in both system view and interface view of the port.
l Loopback detection on all ports will be disabled after the configuration of the undo loopback-detection enable command in system view.
Examples
# Enable loopback detection on the interface Ethernet 1/0/1.
<Sysname> system-view
[Sysname] loopback-detection enable
[Sysname] interface ethernet 1/0/1
[Sysname-Ethernet1/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: Time interval for performing port loopback detection, in the range 5 to 300 (in seconds).
Description
Use the loopback-detection interval-time command to configure time interval for performing port loopback detection.
Use the undo loopback-detection interval-time command to restore the default time interval for port loopback detection, which is 30 seconds.
Related commands: display loopback-detection.
Examples
# Set the time interval for performing port loopback detection 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 port view
Default Level
2: System level
Parameters
None
Description
Use the loopback-detection per-vlan enable command to enable loopback detection in all VLANs with Trunk ports or Hybrid ports.
Use the undo loopback-detection per-vlan enable command to enable loopback detection in the default VLAN with Trunk ports or Hybrid ports.
By default, loopback detection is only enabled in the default VLAN(s) with Trunk ports or Hybrid ports.
Note that the loopback-detection per-vlan enable command is not applicable to Access ports.
Examples
# Enable loopback detection in all the VLANs to which the Hybrid port Ethernet 1/0/1 belongs.
<Sysname> system-view
[Sysname] loopback-detection enable
[Sysname] interface ethernet 1/0/1
[Sysname-Ethernet1/0/1] loopback-detection enable
[Sysname-Ethernet1/0/1] port link-type trunk
[Sysname-Ethernet1/0/1] loopback-detection per-vlan enable
mac-address
Syntax
mac-address mac-address
undo mac-address
View
Layer 2 Ethernet port view, Layer 2 aggregate interface view
Default Level
2: System level
Parameters
mac-address: MAC address, which cannot be a multicast address, broadcast address, or all-zero MAC address.
Description
Use the mac-address command to assign a MAC address to a Layer 2 Ethernet or aggregate interface.
Use the undo mac-address command to restore the default.
The default MAC address of a Layer 2 Ethernet port or aggregate interface depends on your device model.
Examples
# Assign MAC address 000f-e200-1234 to Layer 2 Ethernet port Ethernet 1/0/1.
<Sysname> system-view
[Sysname] interface ethernet 1/0/1
[Sysname-Ethernet1/0/1] mac address 000f-e200-1234
mdi
Syntax
mdi { across | auto | normal }
undo mdi
View
Layer 2 Ethernet port view
Default Level
2: System level
Parameters
across: Specifies the MDI mode as across.
auto: Specifies the MDI mode as auto.
normal: Specifies the MDI mode as normal.
Description
Use the mdi command to configure the MDI mode for an Ethernet port.
Use the undo mdi command to restore the system default.
By default, the MDI mode of an Ethernet port is auto, that is, the Ethernet port determines the physical pin roles (transmit or receive) through negotiation.
The command is not applicable to Combo ports operating as optical ports.
Examples
# Set the MDI mode of Ethernet 1/0/1 to across.
<Sysname> system-view
[Sysname] interface ethernet 1/0/1
[Sysname-Ethernet1/0/1] mdi across
multicast-suppression
Syntax
multicast-suppression ratio
undo multicast-suppression
View
Layer 2 Ethernet port view, port group view
Default Level
2: System level
Parameters
ratio: Maximum percentage of multicast traffic to the total transmission capability of a Layer 2 Ethernet port, in the range 1 to 100. The smaller the ratio is, the less multicast traffic is allowed to pass through the interface.
Description
Use the multicast-suppression command to configure multicast storm suppression ratio on an interface.
Use the undo multicast-suppression command to restore the default multicast suppression ratio.
By default, multicast traffic is not suppressed.
If you execute this command in Layer 2 Ethernet port view, the configurations take effect only on the current interface. If you execute this command in port-group view, the configurations take effect on all ports in the port group.
Note that when multicast traffic exceeds the maximum value configured, the system will discard the extra packets so that the multicast traffic ratio can drop below the limit to ensure that the network functions properly.
For an Ethernet interface whose physical rate is 1000 Mbps, if its rate is manually configured or auto-negotiated as 100 Mbps, the multicast suppression ratio configured on the interface using the multicast-suppression command should be based on a 100-Mbps rate.
l If a suppression ratio is set in global configuration mode or in interface configuration mode, the suppression ratio which first satisfies the condition takes effect.
l If you set different suppression ratios in Layer 2 Ethernet port view or port-group view for multiple times, the latest configuration takes effect.
l Do not use the multicast-suppression command along with the storm-constrain command. Otherwise, the multicast storm suppression ratio configured may get invalid.
Examples
# For Ethernet port Ethernet 1/0/1, allow multicast traffic equivalent to 20% of the total transmission capability of Ethernet 1/0/1 to pass.
<Sysname> system-view
[Sysname] interface ethernet 1/0/1
[Sysname-Ethernet1/0/1] multicast-suppression 20
# For all the ports of the manual port group group1, allow multicast traffic equivalent to 20% of the total transmission capability of each port to pass.
<Sysname> system-view
[Sysname] port-group manual group1
[Sysname-port-group manual group1] group-member ethernet 1/0/1
[Sysname-port-group manual group1] group-member ethernet 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: Specifies name of a manual port group, a string of 1 to 32 characters. Support for the argument varies with device models.
Description
Use the port-group manual command to create a manual port group and enter manual port group view.
Use the undo port-group manual command to remove a manual port group.
By default, no manual port group is created.
Examples
# Create a manual port group named group1.
<Sysname> system-view
[Sysname] port-group manual group1
[Sysname-port-group-manual-group1]
storm-constrain
Syntax
storm-constrain { broadcast | multicast | unicast } { pps max-pps-values min-pps-values | kbps max-bps-values min-bps-values | ratio max-ratio min-ratio }
undo storm-constrain { all | broadcast | multicast | unicast }
View
Layer 2 Ethernet port view
Default Level
2: System level
Parameters
all: Disables the storm constrain function for all types of packets (that is, unicast packets, multicast packets, and broadcast packets).
broadcast: Enables/Disables the storm constrain function for broadcast packets.
multicast: Enables/Disables the storm constrain function for multicast packets.
unicast: Enables/Disables the storm constrain function for unicast packets.
pps: Specifies the storm constrain threshold in packets.
kbps: Specifies the storm constrain threshold in kilobits per second (kbps).
ratio: Specifies the storm constrain threshold in percentage of the received packets to the whole transmission capacity.
max-pps-values: Upper threshold for traffic on the interface, in pps.
l For a 100-Mbps interface, the value range of this argument is 1 to 148810;
l For a 1000-Mbps interface, the value range of this argument is 1 to 1488100;
min-pps-values: Lower threshold for traffic on the interface, in pps. The value range of this argument is 1 to max-pps-values.
kbps: Specifies the storm constrain threshold in kilobits per second (kbps).
max-bps-values: Upper threshold for traffic on the interface, in kbps.
l For a 100-Mbps interface, the value range of this argument is 1 to 100000;
l For a 1000-Mbps interface, the value range of this argument is 1 to 1000000;
min-bps-values: Lower threshold for traffic on the interface, in kbps. The value range of this argument is 1 to max-bps-values.
ratio: Specifies the storm constrain threshold in percentage of the received packets to the whole transmission capacity.
max-ratio: Upper threshold for traffic on the interface, in percentage. The value range of this argument is 1 to 100. The smaller this value, the less traffic allowed to pass through.
min-ratio: Lower threshold for traffic on the interface, in percentage. The value range of this argument is 1 to max-ratio.
Description
Use the storm-constrain command to enable the storm constrain function for specific type of packets and set the upper and lower thresholds.
Use the undo storm-constrain command to disable the storm constrain function for specific type of packets.
By default, the storm constrain function is not enabled.
l Do not use the storm-constrain command along with the unicast-suppression command, the multicast-suppression command, or the broadcast-suppression command. Otherwise, traffics may be suppressed in an unpredictable way.
l An upper threshold cannot be less than the corresponding lower threshold. Besides, do not configure the two thresholds as the same value.
l In kbps mode, the system does not count in preambles and frame interleaves when collecting traffic statistics
Examples
# Enable the storm constrain function for unicast packets on Ethernet 1/0/1, setting the upper and lower threshold to 200 pps and 150 pps.
<Sysname> system-view
[Sysname] interface ethernet 1/0/1
[Sysname-Ethernet1/0/1] storm-constrain unicast pps 200 150
# Enable the storm constrain function for broadcast packets on Ethernet 1/0/2, setting the upper and lower threshold to 2000 kbps and 1500 kbps.
<Sysname> system-view
[Sysname] interface ethernet 1/0/1
[Sysname-Ethernet1/0/1] storm-constrain broadcast kbps 2000 1500
# Enable the storm constrain function for multicast packets on Ethernet 1/0/2 in percentage of the received multicast packets to the port’s total transmission capacity, setting the upper and lower threshold to 80% and 15%.
<Sysname> system-view
[Sysname] interface ethernet 1/0/1
[Sysname-Ethernet1/0/1] storm-constrain multicast bps 80 15
storm-constrain control
Syntax
storm-constrain control { block | shutdown }
undo storm-constrain control
View
Layer 2 Ethernet port view
Default Level
2: System level
Parameters
block: Blocks the traffic of a specific type on a port when the traffic detected exceeds the upper threshold.
shutdown: Shuts down a port when a type of traffic exceeds the corresponding upper threshold. A port shut down by the storm constrain function stops forwarding all types of packets.
Description
Use the storm-constrain control command to set the action to be taken when a type of traffic exceeds the corresponding upper threshold.
Use the undo storm-constrain control command to restore the default.
By default, no action is taken when a type of traffic exceeds the corresponding threshold.
You are recommended to use the shutdown keyword when configuring the storm-constrain control command on a RRPP-enabled port, thus ensuring the normal running of the RRPP protocol.
Examples
# Configure to block interface Ethernet 1/0/1 when a type of traffic reaching it exceeds the corresponding upper threshold.
<Sysname> system-view
[Sysname] interface ethernet 1/0/1
[Sysname-Ethernet1/0/1] storm-constrain control block
storm-constrain enable log
Syntax
storm-constrain enable log
undo storm-constrain enable log
View
Layer 2 Ethernet port view
Default Level
2: System level
Parameters
None
Description
Use the storm-constrain enable log command to enable log sending. With log sending enabled, the system sends log when traffic reaching a port exceeds the corresponding threshold or the traffic drops down below the lower threshold after exceeding the upper threshold.
Use the undo storm-constrain enable log command to disable log sending.
By default, log sending is enabled.
Examples
# Disable log sending for Ethernet 1/0/1.
<Sysname> system-view
[Sysname] interface ethernet 1/0/1
[Sysname-Ethernet1/0/1] undo storm-constrain enable log
storm-constrain enable trap
Syntax
storm-constrain enable trap
undo storm-constrain enable trap
View
Layer 2 Ethernet port view
Default Level
2: System level
Parameters
None
Description
Use the storm-constrain enable trap command to enable trap message sending. With trap message sending enabled, the system sends trap messages when traffic reaching a port exceeds the corresponding threshold or the traffic drops down below the lower threshold after exceeding the upper threshold.
Use the undo storm-constrain enable trap command to disable trap message sending.
By default, trap message sending is enabled.
Examples
# Disable trap message sending for Ethernet 1/0/1.
<Sysname> system-view
[Sysname] interface ethernet 1/0/1
[Sysname-Ethernet1/0/1] undo storm-constrain enable trap
storm-constrain interval
Syntax
storm-constrain interval seconds
undo storm-constrain interval
View
System view
Default Level
2: System level
Parameters
seconds: Interval for generating traffic statistics, in the range 1 to 300 (in seconds).
Description
Use the storm-constrain interval command to set the interval for generating traffic statistics.
Use the undo storm-constrain interval command to restore the default.
By default, the interval for generating traffic statistics is 10 seconds.
l The interval set by the storm-constrain interval command is specifically for the storm constrain function. It is different form that set by the flow-interval command.
l For network stability consideration, configure the interval for generating traffic statistics to a value that is not shorter than the default.
Examples
# Set the interval for generating traffic statistics to 60 seconds.
<Sysname> system-view
[Sysname] storm-constrain interval 60
unicast-suppression
Syntax
unicast-suppression ratio
undo unicast-suppression
View
Layer 2 Ethernet port view, port group view
Default Level
2: System level
Parameters
ratio: Maximum percentage of unicast traffic to the total transmission capability of a Layer 2 Ethernet port, in the range of 1 to 100. The smaller the ratio is, the less unicast traffic is allowed through the interface.
Description
Use the unicast-suppression command to configure a unicast storm suppression ratio.
Use the undo unicast-suppression command to restore the default unicast suppression ratio.
By default, unicast traffic is not suppressed.
If you execute this command in Layer 2 Ethernet port view, the configurations take effect only on the current interface. If you execute this command in port-group view, the configurations take effect on all ports in the port group
Note that when unicast traffic exceeds the maximum value configured, the system will discard the extra packets so that the unknown unicast traffic ratio can drop below the limit to ensure that the network functions properly.
For an Ethernet interface whose physical rate is 1000 Mbps, if its rate is manually configured or auto-negotiated as 100 Mbps, the unicast suppression ratio configured on the interface using the unicast-suppression command should be based on a 100-Mbps rate.
l If a suppression ratio is set in global configuration mode or in interface configuration mode, the suppression ratio which first satisfies the condition takes effect.
l If you set different suppression ratios in Layer 2 Ethernet port view or port-group view repeatedly, the latest configuration takes effect.
l Do not use the unicast-suppression command along with the storm-constrain command. Otherwise, the unicast storm suppression ratio configured may get invalid.
Examples
# For Ethernet port Ethernet 1/0/1, allow unknown unicast traffic equivalent to 20% of the total transmission capability of the interface to pass and suppress the excessive unknown unicast packets.
<Sysname> system-view
[Sysname] interface ethernet 1/0/1
[Sysname-Ethernet1/0/1] unicast-suppression 20
# For all the ports of the manual port group group1, allow unknown unicast traffic equivalent to 20% of the total transmission capability of each port to pass and suppress excessive unknown unicast packets.
<Sysname> system-view
[Sysname] port-group manual group1
[Sysname-port-group manual group1] group-member ethernet 1/0/1
[Sysname-port-group manual group1] group-member ethernet 1/0/2
[Sysname-port-group manual group1] unicast-suppression 20
virtual-cable-test
Syntax
virtual-cable-test
View
Layer 2 Ethernet port view
Default Level
2: System level
Parameters
None
Description
Use the virtual-cable-test command to test the cable connected to the Layer 2 Ethernet port once and to display the testing result. The tested items include:
l Cable status: normal, abnormal, abnormal-open, abnormal-short, failure;
l Pair length;
l Pair Impedance mismatch;
l Pair skew;
l Pair polarity;
l Insertion loss;
l Return loss;
l Near-end crosstalk.
Note that:
l When the cable is functioning properly, the cable length in the test result represents the total cable length;
l When the cable is not functioning properly, the cable length in the test result represents the length from the current interface to the failed position.
l The optical interface of a Combo port does not support this command.
l A link in the up state goes down and then up automatically if you execute this command on one of the Layer 2 Ethernet ports forming the link.
l The test result is for your information only. The maximum error in the tested cable length is 5 m. A hyphen “-” indicates that the corresponding test item is not supported.
Examples
# Enable the virtual cable test for the interface Ethernet 1/0/1.
<Sysname> system-view
[Sysname] interface ethernet 1/0/1
[Sysname-Ethernet1/0/1] virtual-cable-test
Cable status: normal, 1 metres
Pair Impedance mismatch: -
Pair skew: - ns
Pair swap: -
Pair polarity: -
Insertion loss: - db
Return loss: - db
Near-end crosstalk: - db