Page is loading ...
HPE Networking Comware
5120v3 Switch
Series
LAN Switching Command Reference
Software
version: Release 6352P02 and later
Document version: 6W100-20230715
© Copyright 2023 Hewlett Packard Enterprise Development LP
The information contained herein is subject to change without notice. The only warranties for Hewlett Packard
Enterprise products and services are set forth in the express warranty statements accompanying such
products and services. Nothing herein should be construed as constituting an additional warranty. Hewlett
Packard Enterprise shall not be liable for technical or editorial errors or omissions contained herein.
Confidential computer software. Valid license from Hewlett Packard Enterprise required for possession, use, or
copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software
Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor’s
standard commercial license.
Links to third-party websites take you outside the Hewlett Packard Enterprise website. Hewlett Packard
Enterprise has no control over and is not responsible for information outside the Hewlett Packard Enterprise
website.
Acknowledgments
Intel®, Itanium®, Pentium®, Intel Inside®, and the Intel Inside logo are trademarks of Intel Corporation in the
United States and other countries.
Microsoft® and Windows® are either registered trademarks or trademarks of Microsoft Corporation in the
United States and/or other countries.
Adobe® and Acrobat® are trademarks of Adobe Systems Incorporated.
Java and Oracle are registered trademarks of Oracle and/or its affiliates.
UNIX® is a registered trademark of The Open Group.
i
Contents
Ethernet interface commands ········································································ 1
Common Ethernet interface commands············································································································· 1
bandwidth ··················································································································································· 1
broadcast-suppression ······························································································································· 1
combo enable ············································································································································· 3
dampening ················································································································································· 4
default ························································································································································ 5
description ·················································································································································· 5
display counters ········································································································································· 6
display counters rate ·································································································································· 7
display ethernet statistics ··························································································································· 8
display interface ······································································································································· 10
display interface link-info ·························································································································· 19
display link-flap protection ························································································································ 21
duplex ······················································································································································· 22
eee enable ··············································································································································· 22
flow-control ··············································································································································· 23
flow-control receive enable ······················································································································ 24
flow-interval ·············································································································································· 24
ifmonitor crc-error ····································································································································· 25
ifmonitor input-error ·································································································································· 26
ifmonitor output-error ································································································································ 27
interface ··················································································································································· 28
jumboframe enable ·································································································································· 29
link-delay ·················································································································································· 30
link-flap protect enable ············································································································· 31
loopback ··················································································································································· 31
loopback-test ············································································································································ 32
multicast-suppression ······························································································································ 33
port auto-power-down ······························································································································ 34
port ifmonitor crc-error ······························································································································ 35
port ifmonitor input-error ··························································································································· 36
port ifmonitor output-error ························································································································ 37
port link-flap protect enable ········································································································ 38
port up-mode ············································································································································ 39
reset counters interface ···························································································································· 40
reset ethernet statistics ···························································································································· 40
shutdown ·················································································································································· 41
snmp-agent trap enable ifmonitor ············································································································ 42
speed ······················································································································································· 42
speed auto downgrade····························································································································· 43
unicast-suppression ································································································································· 44
Layer 2 Ethernet interface commands ············································································································· 45
display storm-constrain ···························································································································· 45
display virtual-cable-test ··························································································································· 47
mdix-mode ··············································································································································· 48
port bridge enable ···································································································································· 49
reset interface virtual-cable-test ··············································································································· 50
speed auto ··············································································································································· 50
storm-constrain ········································································································································ 51
storm-constrain control ····························································································································· 53
storm-constrain enable log ······················································································································· 53
storm-constrain enable trap ····················································································································· 54
storm-constrain interval ···························································································································· 54
virtual-cable-test ······································································································································· 55
ii
Loopback, null, and inloopback interface commands ··································· 58
bandwidth ················································································································································· 58
default ······················································································································································ 58
description ················································································································································ 59
display interface inloopback ····················································································································· 60
display interface loopback ························································································································ 62
display interface null ································································································································· 64
interface loopback ···································································································································· 66
interface null ············································································································································· 66
reset counters interface loopback ············································································································ 67
reset counters interface null ····················································································································· 67
shutdown ·················································································································································· 68
Bulk interface configuration commands ······················································· 69
display interface range ····························································································································· 69
interface range ········································································································································· 69
interface range name ······························································································································· 71
MAC address table commands ···································································· 73
display mac-address ································································································································ 73
display mac-address aging-time ·············································································································· 74
display mac-address hash-bucket-size ···································································································· 75
display mac-address hash-conflict-record································································································ 75
display mac-address mac-learning ·········································································································· 76
display mac-address mac-move ·············································································································· 77
display mac-address statistics ················································································································· 78
mac-address (interface view) ··················································································································· 79
mac-address (system view) ····················································································································· 81
mac-address hash-bucket-size ················································································································ 83
mac-address hash-conflict-record enable ································································································ 83
mac-address mac-learning enable ··········································································································· 84
mac-address mac-move fast-update········································································································ 85
mac-address mac-roaming enable··········································································································· 86
mac-address max-mac-count ··················································································································· 87
mac-address max-mac-count enable-forwarding ····················································································· 87
mac-address multicast-source packet-filter ······························································································ 88
mac-address notification mac-move ········································································································ 89
mac-address notification mac-move suppression (interface view) ··························································· 90
mac-address notification mac-move suppression (system view) ····························································· 91
mac-address timer ··································································································································· 91
snmp-agent trap enable mac-address ····································································································· 92
MAC Information commands ······································································· 94
mac-address information enable (interface view) ···················································································· 94
mac-address information enable (system view) ······················································································· 94
mac-address information interval ············································································································· 95
mac-address information mode ················································································································ 95
mac-address information queue-length ···································································································· 96
Ethernet link aggregation commands ··························································· 98
bandwidth ················································································································································· 98
default ······················································································································································ 98
description ················································································································································ 99
display interface ······································································································································· 99
display lacp system-id ···························································································································· 102
display link-aggregation load-sharing mode··························································································· 103
display link-aggregation member-port ···································································································· 104
display link-aggregation summary ·········································································································· 107
display link-aggregation verbose············································································································ 108
interface bridge-aggregation ·················································································································· 111
jumboframe enable ································································································································ 112
iii
lacp default-selected-port disable ·········································································································· 112
lacp edge-port ········································································································································ 113
lacp mode ··············································································································································· 113
lacp period short ····································································································································· 114
lacp select speed ··································································································································· 114
lacp system-mac ···································································································································· 115
lacp system-number ······························································································································· 116
lacp system-priority ································································································································ 117
link-aggregation bfd ipv4 ························································································································ 117
link-aggregation global load-sharing mode ···························································································· 118
link-aggregation lacp traffic-redirect-notification enable ········································································· 119
link-aggregation load-sharing mode local-first ······················································································· 120
link-aggregation mode ···························································································································· 121
link-aggregation port-priority ·················································································································· 122
link-aggregation selected-port maximum ······························································································· 122
link-aggregation selected-port minimum ································································································ 123
link-delay ················································································································································ 124
port link-aggregation group ···················································································································· 125
port s-mlag group ··································································································································· 126
reset counters interface ·························································································································· 127
reset lacp statistics ································································································································· 127
shutdown ················································································································································ 128
Port isolation commands············································································ 129
display port-isolate group ······················································································································· 129
port-isolate enable ·································································································································· 130
port-isolate group ··································································································································· 130
Spanning tree commands ·········································································· 132
active region-configuration ····················································································································· 132
bpdu-drop any ········································································································································ 132
check region-configuration ····················································································································· 133
display stp ·············································································································································· 134
display stp abnormal-port ······················································································································· 141
display stp bpdu-statistics ······················································································································ 142
display stp down-port ····························································································································· 144
display stp history ··································································································································· 145
display stp region-configuration ············································································································· 147
display stp root ······································································································································· 148
display stp tc ·········································································································································· 148
instance ·················································································································································· 149
region-name ··········································································································································· 151
reset stp ················································································································································· 151
revision-level ·········································································································································· 152
snmp-agent trap enable stp ··················································································································· 153
stp bpdu-protection ································································································································ 154
stp bridge-diameter ································································································································ 154
stp compliance ······································································································································· 155
stp config-digest-snooping ····················································································································· 156
stp cost ··················································································································································· 157
stp dispute-protection ····························································································································· 158
stp edged-port ········································································································································ 159
stp enable ··············································································································································· 160
stp global config-digest-snooping··········································································································· 161
stp global enable ···································································································································· 161
stp global mcheck ·································································································································· 162
stp ignore-pvid-inconsistency ················································································································· 163
stp log enable tc ····································································································································· 164
stp loop-protection ·································································································································· 164
stp max-hops ·········································································································································· 165
stp mcheck ············································································································································· 165
stp mode ················································································································································ 166
iv
stp no-agreement-check ························································································································ 167
stp pathcost-standard ····························································································································· 168
stp point-to-point ···································································································································· 169
stp port bpdu-protection ························································································································· 170
stp port priority ······································································································································· 171
stp port shutdown permanent ················································································································· 172
stp port-log ············································································································································· 172
stp priority ··············································································································································· 173
stp pvst-bpdu-protection ························································································································· 174
stp region-configuration ·························································································································· 175
stp role-restriction ··································································································································· 175
stp root primary ······································································································································ 176
stp root secondary ·································································································································· 177
stp root-protection ·································································································································· 178
stp tc-protection ······································································································································ 179
stp tc-protection threshold ······················································································································ 179
stp tc-restriction ······································································································································ 180
stp tc-snooping ······································································································································· 180
stp timer forward-delay ··························································································································· 181
stp timer hello ········································································································································· 182
stp timer max-age ·································································································································· 183
stp timer-factor ······································································································································· 184
stp transmit-limit ····································································································································· 185
stp vlan enable ······································································································································· 186
vlan-mapping modulo ····························································································································· 186
Loop detection commands ········································································· 188
display loopback-detection ····················································································································· 188
loopback-detection action ······················································································································ 189
loopback-detection enable ····················································································································· 190
loopback-detection global action ············································································································ 190
loopback-detection global enable··········································································································· 191
loopback-detection interval-time ············································································································ 192
VLAN commands ······················································································· 193
Basic VLAN commands ································································································································· 193
bandwidth ··············································································································································· 193
default ···················································································································································· 193
description ·············································································································································· 194
display interface vlan-interface··············································································································· 195
display vlan ············································································································································ 197
display vlan brief ···································································································································· 198
interface vlan-interface ··························································································································· 199
mtu ························································································································································· 200
name ······················································································································································ 201
reset counters interface vlan-interface ··································································································· 202
shutdown ················································································································································ 202
vlan ························································································································································· 203
Port-based VLAN commands ························································································································ 204
display port ············································································································································· 204
port ························································································································································· 205
port access vlan ····································································································································· 206
port hybrid pvid ······································································································································· 206
port hybrid vlan ······································································································································· 207
port link-type ··········································································································································· 208
port trunk permit vlan ····························································································································· 209
port trunk pvid ········································································································································ 210
MAC-based VLAN commands ······················································································································· 210
display mac-vlan ···································································································································· 210
display mac-vlan interface ······················································································································ 212
mac-vlan enable ····································································································································· 212
mac-vlan mac-address ··························································································································· 213
v
mac-vlan trigger enable ·························································································································· 214
port pvid forbidden ································································································································· 214
vlan precedence ····································································································································· 215
IP subnet-based VLAN commands ················································································································ 216
display ip-subnet-vlan interface·············································································································· 216
display ip-subnet-vlan vlan ····················································································································· 217
ip-subnet-vlan ········································································································································· 218
port hybrid ip-subnet-vlan ······················································································································· 219
Protocol-based VLAN commands ·················································································································· 220
display protocol-vlan interface ················································································································ 220
display protocol-vlan vlan ······················································································································· 221
port hybrid protocol-vlan ························································································································· 222
protocol-vlan ··········································································································································· 223
VLAN group commands ································································································································· 225
display vlan-group ·································································································································· 225
vlan-group ·············································································································································· 226
vlan-list ··················································································································································· 226
Private VLAN commands ··········································································· 228
display private-vlan ································································································································ 228
port private-vlan host ······························································································································ 230
port private-vlan promiscuous ················································································································ 231
port private-vlan trunk promiscuous ······································································································· 234
port private-vlan trunk secondary ··········································································································· 236
private-vlan (VLAN interface view) ········································································································· 239
private-vlan (VLAN view) ························································································································ 241
private-vlan community ·························································································································· 242
private-vlan isolated ······························································································································· 243
private-vlan primary ································································································································ 245
Voice VLAN commands ············································································· 246
display voice-vlan mac-address ············································································································· 246
display voice-vlan state ·························································································································· 246
voice-vlan aging ····································································································································· 247
voice-vlan enable ··································································································································· 248
voice-vlan mac-address ························································································································· 249
voice-vlan mode auto ····························································································································· 250
voice-vlan security enable ······················································································································ 251
voice-vlan track lldp ································································································································ 251
MVRP commands ······················································································ 253
display mvrp running-status ··················································································································· 253
display mvrp state ·································································································································· 254
display mvrp statistics ···························································································································· 255
mrp timer join ········································································································································· 257
mrp timer leave ······································································································································ 258
mrp timer leaveall ··································································································································· 259
mrp timer periodic ·································································································································· 260
mvrp enable ··········································································································································· 261
mvrp global enable ································································································································· 261
mvrp gvrp-compliance enable ················································································································ 262
mvrp registration ···································································································································· 262
reset mvrp statistics ······························································································································· 263
QinQ commands ························································································ 265
display qinq ············································································································································ 265
qinq enable ············································································································································· 266
qinq ethernet-type (interface view) ········································································································· 266
qinq ethernet-type (system view) ··········································································································· 267
qinq transparent-vlan ····························································································································· 268
vi
VLAN mapping commands ········································································ 270
display vlan mapping ······························································································································ 270
vlan mapping ·········································································································································· 271
LLDP commands ······················································································· 274
cdp voice-vlan ········································································································································ 274
display lldp local-information ·················································································································· 274
display lldp neighbor-information ··········································································································· 279
display lldp statistics ······························································································································· 284
display lldp status ··································································································································· 286
display lldp tlv-config ······························································································································ 288
lldp admin-status ···································································································································· 291
lldp check-change-interval ····················································································································· 292
lldp compliance admin-status cdp ·········································································································· 293
lldp compliance cdp ································································································································ 294
lldp enable ·············································································································································· 295
lldp encapsulation snap·························································································································· 295
lldp fast-count ········································································································································· 296
lldp global enable ··································································································································· 297
lldp global tlv-config basic-tlv port-id ······································································································ 297
lldp global tlv-enable basic-tlv management-address-tlv ······································································· 298
lldp hold-multiplier ·································································································································· 300
lldp ignore-pvid-inconsistency ················································································································ 300
lldp local-information all-interface··········································································································· 301
lldp management-address ······················································································································ 302
lldp management-address-format string ································································································ 303
lldp max-credit ········································································································································ 304
lldp mode ················································································································································ 304
lldp notification med-topology-change enable ························································································ 305
lldp notification remote-change enable ·································································································· 305
lldp source-mac vlan ······························································································································ 306
lldp timer fast-interval ····························································································································· 307
lldp timer notification-interval ·················································································································· 308
lldp timer reinit-delay ······························································································································ 308
lldp timer tx-interval ································································································································ 309
lldp tlv-config basic-tlv port-id ················································································································· 309
lldp tlv-enable ········································································································································· 310
lldp tlv-enable private-tlv ························································································································ 315
reset lldp statistics ·································································································································· 316
L2PT commands ······················································································· 318
display l2protocol statistics ····················································································································· 318
l2protocol tunnel dot1q ··························································································································· 319
l2protocol tunnel-dmac ··························································································································· 321
l2protocol type tunnel-dmac ··················································································································· 321
reset l2protocol statistics ························································································································ 323
PPPoE relay commands ············································································ 324
PPPoE relay commands ································································································································ 324
display pppoe-relay client-information ···································································································· 324
display pppoe-relay statistics ················································································································· 325
pppoe-relay client-information format ····································································································· 326
pppoe-relay client-information strategy ·································································································· 328
pppoe-relay enable ································································································································ 329
pppoe-relay server-information vendor-specific strip ············································································· 330
pppoe-relay trust ···································································································································· 330
reset pppoe-relay statistics ···················································································································· 331
Document conventions and icons ······························································ 333
Conventions ··················································································································································· 333
Network topology icons ·································································································································· 334
vii
Support and other resources ····································································· 335
Accessing Hewlett Packard Enterprise Support····························································································· 335
Accessing updates ········································································································································· 335
Websites ················································································································································ 336
Customer self repair ······························································································································· 336
Remote support ······································································································································ 336
Documentation feedback ······················································································································· 336
Index ·········································································································· 338
1
Ethernet interface commands
Common Ethernet interface commands
bandwidth
Use bandwidth to set the expected bandwidth of an interface.
Use undo bandwidth to restore the default.
Syntax
bandwidth bandwidth-value
undo bandwidth
Default
The expected bandwidth (in kbps) is the interface baud rate divided by 1000.
Views
Ethernet interface view
Predefined user roles
network-admin
Parameters
bandwidth-value: Specifies the expected bandwidth in the range of 1 to 400000000 kbps.
Usage guidelines
The expected bandwidth is an informational parameter used only by higher-layer protocols for
calculation. You cannot adjust the actual bandwidth of an interface by using this command.
Examples
# Set the expected bandwidth of GigabitEthernet 1/0/1 to 1000 kbps.
<Sysname> system-view
[Sysname] interface gigabitethernet 1/0/1
[Sysname-GigabitEthernet1/0/1] bandwidth 1000
Related commands
speed
broadcast-suppression
Use broadcast-suppression to enable broadcast suppression and set the broadcast
suppression threshold.
Use undo broadcast-suppression to disable broadcast suppression.
Syntax
broadcast-suppression { ratio | pps max-pps | kbps max-kbps }
undo broadcast-suppression
2
Default
Ethernet interfaces do not suppress broadcast traffic.
Views
Ethernet interface view
Predefined user roles
network-admin
Parameters
ratio: Sets the broadcast suppression threshold as a percentage of the interface bandwidth. The
value range for this argument is 0 to 100. A smaller value means that less broadcast traffic is allowed
to pass through.
pps max-pps: Specifies the maximum number of broadcast packets that the interface can forward
per second. The value range for the max-pps argument (in pps) is 0 to 1.4881 × the interface
bandwidth.
kbps max-kbps: Specifies the maximum number of kilobits of broadcast traffic that the Ethernet
interface can forward per second. The value range for this argument (in kbps) is 0 to the interface
bandwidth.
Usage guidelines
The broadcast storm suppression features limits the size of broadcast traffic to a threshold on an
interface. When the broadcast traffic on the interface exceeds this threshold, the system drops
packets until the traffic drops below this threshold.
Both the storm-constrain command and the broadcast-suppression command can
suppress broadcast storms on a port. The broadcast-suppression command uses the chip to
physically suppress broadcast traffic. It has less influence on the device performance than the
storm-constrain command, which uses software to suppress broadcast traffic.
For the traffic suppression result to be determined, do not configure both the storm-constrain
broadcast command and the broadcast-suppression command on an interface.
When you configure the suppression threshold in kbps, the actual suppression threshold might be
different from the configured one as follows:
•
If the configured value is smaller than 64, the value of 64 takes effect.
•
If the configured value is greater than 64 but not an integer multiple of 64, the integer multiple of
64 that is greater than and closest to the configured value takes effect.
For the suppression threshold that takes effect, see the prompt on the device.
Examples
# Set the broadcast suppression threshold to 10000 kbps on GigabitEthernet 1/0/1.
<Sysname> system-view
[Sysname] interface gigabitethernet 1/0/1
[Sysname-GigabitEthernet1/0/1] broadcast-suppression kbps 10000
The actual value is 10048 on port GigabitEthernet1/0/1 currently.
The output shows that the value that takes effect is 10048 kbps (157 times of 64), because the chip
only supports step 64.
Related commands
multicast-suppression
unicast-suppression
3
combo enable
Use combo enable to activate the copper or fiber combo port of a combo interface.
Syntax
combo enable { auto | copper | fiber }
Default
The copper or fiber combo port is automatically activated depending on the medium inserted in the
combo interface.
Views
Ethernet interface view
Predefined user roles
network-admin
Parameters
auto: Automatically identifies the media inserted and activates the corresponding combo port.
copper: Activates the copper combo port. In this case, use twisted pairs to connect the port.
fiber: Activates the fiber combo port. In this case, use optical fibers to connect the port.
Usage guidelines
A combo interface is a logical interface that physically contains one fiber combo port and one copper
combo port on the device panel. The two ports share one forwarding interface. As a result, they
cannot work simultaneously. When you activate either port, the other port is automatically disabled.
You can select to activate the copper combo port or fiber combo port.
This command is available only on devices that support combo interfaces.
If you execute the combo enable auto command on a combo interface and the combo interface
is connected to cables or optical fibers, you can use the display interface command to display
the interface information.
•
If the display interface command output contains "Media type is twisted pair," the copper
combo port is activated.
•
Otherwise, the fiber combo port is activated.
Before using this command, perform the following tasks according to the marks on the device panel:
•
Determine the combo interfaces on your device.
•
Identify the two physical interfaces that belong to each combo interface.
Examples
# Activate the copper combo port of combo interface GigabitEthernet 1/0/1.
<Sysname> system-view
[Sysname] interface gigabitethernet 1/0/1
[Sysname-GigabitEthernet1/0/1] combo enable copper
# Activate the fiber combo port of combo interface GigabitEthernet 1/0/1.
<Sysname> system-view
[Sysname] interface gigabitethernet 1/0/1
[Sysname-GigabitEthernet1/0/1] combo enable fiber
4
dampening
Use dampening to enable the device to dampen an interface when the interface is flapping.
Use undo dampening to restore the default.
Syntax
dampening [ half-life reuse suppress max-suppress-time ]
undo dampening
Default
Interface dampening is disabled on Ethernet interfaces.
Views
Ethernet interface view
Predefined user roles
network-admin
Parameters
half-life: Specifies the amount of time after which a penalty is decreased, in the range of 1 to
120 seconds. The default value is 54 seconds.
reuse: Specifies the reuse threshold in the range of 200 to 20000. The default value is 750. The
reuse threshold must be less than the suppression threshold.
suppress: Specifies the suppression threshold in the range of 200 to 20000. The default value is
2000.
max-suppress-time: Specifies the maximum amount of time the interface can be dampened, in
the range of 1 to 255 seconds. The default value is 162 seconds (three times the half-life timer).
Usage guidelines
When configuring the dampening command, follow these rules to set the values mentioned above:
•
The ceiling is equal to 2 (Max-suppress-time/Decay) × reuse-limits. It is not user configurable.
•
The configured suppress limit is lower than or equal to the ceiling.
•
The ceiling is lower than or equal to the maximum suppress limit supported.
This command, the link-delay command, and the port link-flap protect enable
command are mutually exclusive on an interface.
This command does not take effect on the administratively down events. When you execute the
shutdown command, the penalty restores to 0, and the interface reports the down event to the
higher layer protocols.
After an interface in down state is dampened, the interface state displayed through the display
interface command is always down.
Examples
# Enable interface dampening on GigabitEthernet 1/0/1.
<Sysname> system-view
[Sysname] interface gigabitethernet 1/0/1
[Sysname-GigabitEthernet1/0/1] dampening
# Enable interface dampening on GigabitEthernet 1/0/1, and set the following parameters:
•
Half life time to 2 seconds.
•
Reuse value to 800.
5
•
Suppression threshold to 3000.
•
Maximum suppression interval to 5 seconds.
<Sysname> system-view
[Sysname] interface gigabitethernet 1/0/1
[Sysname-GigabitEthernet1/0/1] dampening 2 800 3000 5
Related commands
display interface
link-delay
port link-flap protect enable
default
Use default to restore the default settings for an interface.
Syntax
default
Views
Ethernet interface view
Predefined user roles
network-admin
Usage guidelines
CAUTION:
The
default command might interrupt ongoing network services. Make sure you are fully aware of
the impacts of this command when you use it in a live network.
This command might fail to restore the default settings for some commands because of command
dependencies or system restrictions. You can use the display this command in interface view to
identify these commands, and use their undo forms or follow the command reference to restore their
default settings. If your restoration attempt still fails, follow the error message instructions to solve
the problem.
Examples
# Restore the default settings for GigabitEthernet 1/0/1.
<Sysname> system-view
[Sysname] interface gigabitethernet 1/0/1
[Sysname-GigabitEthernet1/0/1] default
description
Use description to configure the description of an interface.
Use undo description to restore the default.
Syntax
description text
undo description
6
Default
The description of an interface is the interface name plus Interface (for example,
GigabitEthernet1/0/1 Interface).
Views
Ethernet interface view
Predefined user roles
network-admin
Parameters
text: Specifies the interface description, a case-sensitive string of 1 to 255 characters.
Examples
# Set the description of GigabitEthernet 1/0/1 to lan-interface.
<Sysname> system-view
[Sysname] interface gigabitethernet 1/0/1
[Sysname-GigabitEthernet1/0/1] description lan-interface
display counters
Use display counters to display interface traffic statistics.
Syntax
display counters { inbound | outbound } interface [ interface-type
[ interface-number ] ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
inbound: Displays inbound traffic statistics.
outbound: Displays outbound traffic statistics.
interface-type: Specifies an interface type.
interface-number: Specifies an interface number.
Usage guidelines
To clear the Ethernet interface traffic statistics, use the reset counters interface command.
If you do not specify an interface type, this command displays traffic statistics for all interfaces that
have traffic counters.
If you specify an interface type but do not specify an interface number, this command displays traffic
statistics for all interfaces of the specified type.
If you specify an interface type and number, this command displays traffic statistics for the specified
interface.
Examples
# Display inbound traffic statistics for all interfaces.
7
<Sysname> display counters inbound interface
Interface Total (pkts) Broadcast (pkts) Multicast (pkts) Err (pkts)
GE1/0/1 100 100 0 0
GE1/0/2 Overflow Overflow Overflow Overflow
Overflow: More than 14 digits (7 digits for column "Err").
--: Not supported.
Table 1 Command output
Field
Description
Interface Abbreviated interface name.
Total (pkts) Total number of packets received or sent through the interface.
Broadcast (pkts) Total number of broadcast packets received or sent through the interface.
Multicast (pkts) Total number of multicast packets received or sent through the interface.
Err (pkts) Total number of error packets received or sent through the interface.
Overflow: More than 14
digits (7 digits for column
"Err")
The command displays Overflow when any of the following conditions exist:
• The data length of an Err field value is greater than 7 decimal digits.
• The data length of a non-Err field value is greater than 14 decimal digits.
--: Not supported The statistical item is not supported.
Related commands
reset counters interface
display counters rate
Use display counters rate to display traffic rate statistics for interfaces in up state for the most
recent statistics polling interval.
Syntax
display counters rate { inbound | outbound } interface [ interface-type
[ interface-number ] ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
inbound: Displays inbound traffic rate statistics.
outbound: Displays outbound traffic rate statistics.
interface-type: Specifies an interface type.
interface-number: Specifies an interface number.
Usage guidelines
If you do not specify an interface type, this command displays traffic rate statistics for all up
interfaces that have traffic counters.
8
If you specify an interface type but do not specify an interface number, this command displays traffic
rate statistics for all up interfaces of the specified type.
If you specify an interface type and an interface, this command displays traffic rate statistics for the
specified interface.
If an interface that you specify is always down for the most recent statistics polling interval, the
system prompts that the interface does not support the command.
To set the statistics polling interval, use the flow-interval command.
Examples
# Display the inbound traffic rate statistics for all interfaces.
<Sysname> display counters rate inbound interface
Usage: Bandwidth utilization in percentage
Interface Usage (%) Total (pps) Broadcast (pps) Multicast (pps)
GE1/0/1 0 0 -- --
Overflow: More than 14 digits.
--: Not supported.
Table 2 Command output
Field
Description
Interface Abbreviated interface name.
Usage (%) Bandwidth usage (in percentage) of the interface for the last statistics polling
interval.
Total (pps) Average receiving or sending rate (in pps) for unicast packets for the last
statistics polling interval.
Broadcast (pps) Average receiving or sending rate (in pps) for broadcast packets for the last
statistics polling interval.
Multicast (pps) Average receiving or sending rate (in pps) for multicast packets for the last
statistics polling interval. .
Overflow: more than 14
decimal digits The command displays Overflow if the data length of a statistical item is
greater than 14 decimal digits.
--: not supported The statistical item is not supported.
Related commands
flow-interval
reset counters interface
display ethernet statistics
Use display ethernet statistics to display the Ethernet module statistics.
Syntax
display ethernet statistics slot slot-number
Views
Any view
Predefined user roles
network-admin
9
network-operator
Parameters
slot slot-number: Specifies an IRF member device by its member ID.
Examples
# Display the Ethernet module statistics for the specified slot.
<Sysname> display ethernet statistics slot 1
ETH receive packet statistics:
Totalnum : 10447 ETHIINum : 4459
SNAPNum : 0 RAWNum : 0
LLCNum : 0 UnknownNum : 0
ForwardNum : 4459 ARP : 0
MPLS : 0 ISIS : 0
ISIS2 : 0 IP : 0
IPV6 : 0
ETH receive error statistics:
NullPoint : 0 ErrIfindex : 0
ErrIfcb : 0 IfShut : 0
ErrAnalyse : 5988 ErrSrcMAC : 5988
ErrHdrLen : 0
ETH send packet statistics:
L3OutNum : 211 VLANOutNum : 0
FastOutNum : 155 L2OutNum : 0
ETH send error statistics:
MbufRelayNum : 0 NullMbuf : 0
ErrAdjFwd : 0 ErrPrepend : 0
ErrHdrLen : 0 ErrPad : 0
ErrQoSTrs : 0 ErrVLANTrs : 0
ErrEncap : 0 ErrTagVLAN : 0
IfShut : 0 IfErr : 0
Table 3 Output description
Field
Description
ETH receive packet
statistics
Statistics about the Ethernet packets received by the Ethernet module:
• Totalnum—Total number of received packets.
• ETHIINum—Number of packets encapsulated by using Ethernet II.
• SNAPNum—Number of packets encapsulated by using SNAP.
• RAWNum—Number of packets encapsulated by using RAW.
• ISISNum—Number of packets encapsulated by using ISIS. This field is
not supported in the current software version.
• LLCNum—Number of packets encapsulated by using LLC.
• UnknownNum—Number of packets encapsulated by using unknown
methods.
• ForwardNum—Number of packets forwarded at Layer 2 or sent to the
CPU.
• ARP—Number of ARP packets.
• MPLS—Number of MPLS packets. This field is not supported in the
current software version.
• ISIS—Number of IS-IS packets. This field is not supported in the current
10
Field
Description
software version.
• ISIS2—Number of large 802.3/802.2 frames encapsulated by using
IS-IS. This field is not supported in the current software version.
• IP—Number of IP packets.
• IPv6—Number of IPv6 packets.
ETH receive error statistics
Statistics about the error Ethernet packets in the inbound direction on the
Ethernet module. Errors might be included in packets or occur during the
receiving process. The items include:
• NullPoint—Number of packets that include null pointers.
• ErrIfindex—Number of packets that include incorrect interface indexes.
• ErrIfcb—Number of packets that include incorrect interface control
blocks.
• IfShut—
Number of packets that are being received when the interface is
shut down.
• ErrAnalyse—Number of packets that include packet parsing errors.
• ErrSrcMAC—Number of packets that include incorrect source MAC
addresses.
•
ErrHdrLen
—Number of packets that include header length errors.
ETH send packet statistics
Statistics about the Ethernet packets sent by the Ethernet module:
• L3OutNum—Number of packets sent out of Layer 3 Ethernet interfaces.
This field is not supported in the current software version.
• VLANOutNum—Number of packets sent out of VLAN interfaces.
• FastOutNum—Number of packets fast forwarded.
• L2OutNum—Number of packets sent out of Layer 2 Ethernet interfaces.
•
MbufRelayNum
—Number of packets transparently sent.
ETH send error statistics
Statistics about the error Ethernet packets in the outbound direction on the
Ethernet module:
• NullMbuf—Number of packets with null pointers.
• ErrAdjFwd—Number of packets with adjacency table errors.
• ErrPrepend—Number of packets with extension errors.
• ErrHdrLen—Number of packets with header length errors.
• ErrPad—Number of packets with padding errors.
• ErrQoSTrs—Number of packets that failed to be sent by QoS.
• ErrVLANTrs—Number of packets that failed to be sent in VLANs.
• ErrEncap—Number of packets that failed to be sent due to link header
encapsulation failures.
• ErrTagVLAN—
Number of packets that failed to be sent due to VLAN tag
encapsulation failures.
• IfShut—Number of packets that are being sent when the interface is shut
down.
• IfErr—Number of packets with incorrect outgoing interfaces.
Related commands
reset ethernet statistics
display interface
Use display interface to display interface information.
11
Syntax
display interface [ interface-type [ interface-number ] ] [ brief
[ description | down ] ]
Views
Any view
Predefined user roles
network-admin
network-operator
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.
description: Displays complete interface descriptions. If you do not specify this keyword, the
command displays only the first 27 characters of each interface description.
down: Displays information about interfaces in down state and the causes. If you do not specify this
keyword, the command displays information about interfaces in all states.
Usage guidelines
If you do not specify an interface type, this command displays information about all interfaces.
If you specify an interface type but do not specify an interface number, this command displays
information about all interfaces of the specified type.
Examples
# Display detailed information about Layer 2 interface GigabitEthernet 1/0/1.
<Sysname> display interface gigabitethernet 1/0/1
GigabitEthernet1/0/1
Current state: DOWN
Line protocol state: DOWN
IP packet frame type: Ethernet II, hardware address: 000c-2963-b767
Description: GigabitEthernet1/0/1 Interface
Bandwidth: 100000 kbps
Loopback is not set
Media type is twisted pair, port hardware type is 1000_BASE_T_AN_SFP
Unknown-speed mode, unknown-duplex mode
Link speed type is autonegotiation, link duplex type is autonegotiation
Flow-control is not enabled
Maximum frame length: 9216
Allow jumbo frame to pass
Broadcast max-ratio: 100%
Multicast max-ratio: 100%
Unicast max-ratio: 100%
PVID: 1
MDI type: Automdix
Port link-type: Access
Tagged VLANs: None
/