FlexFabric 5940 Switch Series Layer 2—LAN Switching

HPE FlexFabric 5940 Switch Series Layer 2—LAN Switching, JH395A, JH684A, JH685A, JH686A, JH691A, JH692A, JQ042A Reference guide

  • Hello! I am an AI chatbot trained to assist you with the HPE FlexFabric 5940 Switch Series Layer 2—LAN Switching Reference guide. I’ve already reviewed the document and can help you find the information you need or explain it in simple terms. Just ask your questions, and providing more details will help me assist you more effectively!
HPE FlexFabric 5940 Switch Series
Layer 2—LAN Switching Command Reference
Software version: Release 671x and later
Document version: 6W100-20230822
© 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
MAC address table commands ······································································ 1
display mac-address ·································································································································· 1
display mac-address aging-time ················································································································ 3
display mac-address mac-learning ············································································································ 3
display mac-address mac-move ················································································································ 4
display mac-address statistics ··················································································································· 5
mac-address (interface view) ····················································································································· 6
mac-address (system view) ······················································································································· 8
mac-address multiport vsi ························································································································ 10
mac-address mac-learning enable ··········································································································· 12
mac-address mac-learning pdu ················································································································ 13
mac-address mac-learning priority ··········································································································· 14
mac-address mac-move fast-update········································································································ 15
mac-address mac-roaming enable··········································································································· 15
mac-address max-mac-count ··················································································································· 16
mac-address max-mac-count enable-forwarding ····················································································· 17
mac-address notification mac-move ········································································································ 18
mac-address notification mac-move suppression (interface view) ··························································· 19
mac-address notification mac-move suppression (system view) ····························································· 19
mac-address static source-check enable ································································································· 20
mac-address timer ··································································································································· 21
snmp-agent trap enable mac-address ····································································································· 22
MAC Information commands ······································································· 23
mac-address information enable (interface view) ···················································································· 23
mac-address information enable (system view) ······················································································· 24
mac-address information interval ············································································································· 24
mac-address information mode ················································································································ 25
mac-address information queue-length ···································································································· 25
Bulk interface configuration commands ······················································· 27
display interface range ····························································································································· 27
interface range ········································································································································· 27
interface range name ······························································································································· 29
Ethernet interface commands ······································································ 31
Common Ethernet interface commands··········································································································· 31
bandwidth ················································································································································· 31
broadcast-suppression ····························································································································· 31
dampening ··············································································································································· 33
default ······················································································································································ 34
description ················································································································································ 35
display counters ······································································································································· 35
display counters rate ································································································································ 36
display ethernet statistics ························································································································· 38
display interface ······································································································································· 40
display interface link-info ·························································································································· 53
display interface main ······························································································································ 55
display link-flap protection ························································································································ 58
display link-state-change statistics interface ···························································································· 59
display packet-drop ·································································································································· 60
duplex ······················································································································································· 62
flow-control ··············································································································································· 62
flow-control receive enable ······················································································································ 63
flow-interval ·············································································································································· 64
ifmonitor crc-error ····································································································································· 64
ifmonitor input-error ·································································································································· 65
ii
ifmonitor input-usage ································································································································ 66
ifmonitor output-error ································································································································ 68
ifmonitor output-usage ····························································································································· 69
ifmonitor rx-pause ···································································································································· 70
ifmonitor tx-pause ····································································································································· 71
interface ··················································································································································· 72
jumboframe enable ·································································································································· 73
link-delay ·················································································································································· 73
link-fault-signal enable ····························································································································· 74
link-flap protect enable ············································································································· 75
loopback ··················································································································································· 76
multicast-suppression ······························································································································ 76
port fast-retrain enable ····························································································································· 78
port fec mode ··········································································································································· 78
port ifmonitor input-usage ························································································································ 79
port ifmonitor output-usage ······················································································································ 80
port ifmonitor rx-pause ····························································································································· 81
port ifmonitor tx-pause ····························································································································· 82
port link-flap protect enable ········································································································ 83
port link-mode ·········································································································································· 85
port up-mode ············································································································································ 85
reset counters interface ···························································································································· 86
reset ethernet statistics ···························································································································· 87
reset link-state-change statistics interface ······························································································· 87
reset packet-drop interface ······················································································································ 88
shutdown ·················································································································································· 88
shutdown all-physical-interface ················································································································ 89
speed ······················································································································································· 90
unicast-suppression ································································································································· 91
using fortygige ·········································································································································· 93
using hundredgige···································································································································· 93
using tengige ············································································································································ 94
Layer 2 Ethernet interface commands ············································································································· 95
display storm-constrain ···························································································································· 95
mdix-mode ··············································································································································· 96
port bridge enable ···································································································································· 97
port connection-distance ·························································································································· 98
port-type ··················································································································································· 98
storm-constrain ········································································································································ 99
storm-constrain control ··························································································································· 101
storm-constrain enable log ····················································································································· 102
storm-constrain enable trap ··················································································································· 102
storm-constrain interval ·························································································································· 103
virtual-cable-test ····································································································································· 103
Layer 3 Ethernet interface or subinterface commands ·················································································· 105
mac-address ·········································································································································· 105
mtu ························································································································································· 105
traffic-statistic enable ····························································································································· 106
Ethernet link aggregation commands ························································· 108
bandwidth ··············································································································································· 108
default ···················································································································································· 108
description ·············································································································································· 109
display interface ····································································································································· 110
display lacp system-id ···························································································································· 114
display link-aggregation load-sharing mode··························································································· 115
display link-aggregation load-sharing path····························································································· 118
display link-aggregation member-port ···································································································· 120
display link-aggregation summary ·········································································································· 123
display link-aggregation troubleshooting ································································································ 124
display link-aggregation verbose············································································································ 125
interface bridge-aggregation ·················································································································· 128
iii
interface route-aggregation ···················································································································· 129
interface schannel-bundle ······················································································································ 130
jumboframe enable ································································································································ 131
lacp default-selected-port disable ·········································································································· 131
lacp edge-port ········································································································································ 132
lacp mode ··············································································································································· 133
lacp period short ····································································································································· 133
lacp select speed ··································································································································· 134
lacp system-mac ···································································································································· 135
lacp system-number ······························································································································· 136
lacp system-priority ································································································································ 136
lacp transparent enable ·························································································································· 137
link-aggregation auto-aggregation enable ······························································································ 138
link-aggregation bfd ipv4 ························································································································ 139
link-aggregation global load-sharing algorithm ······················································································ 140
link-aggregation global load-sharing minm ···························································································· 141
link-aggregation global load-sharing mode ···························································································· 141
link-aggregation global load-sharing offset ···························································································· 143
link-aggregation global load-sharing seed ····························································································· 144
link-aggregation global load-sharing tunnel ··························································································· 145
link-aggregation ignore speed ················································································································ 145
link-aggregation ignore vlan ··················································································································· 146
link-aggregation lacp isolate ··················································································································· 147
link-aggregation lacp traffic-redirect-notification enable ········································································· 148
link-aggregation load-sharing ignore ······································································································ 149
link-aggregation load-sharing mode ······································································································· 150
link-aggregation load-sharing mode local-first ······················································································· 151
link-aggregation management-port ········································································································ 152
link-aggregation management-subnet ···································································································· 153
link-aggregation management-vlan ········································································································ 154
link-aggregation mode ···························································································································· 154
link-aggregation port-priority ·················································································································· 155
link-aggregation selected-port maximum ······························································································· 156
link-aggregation selected-port minimum ································································································ 157
link-delay ················································································································································ 158
mac-address ·········································································································································· 159
mtu ························································································································································· 160
port lacp system-mac ····························································································································· 160
port lacp system-priority ························································································································· 161
port bridge enable ·································································································································· 162
port link-aggregation group ···················································································································· 163
port s-mlag group ··································································································································· 164
reset counters interface ·························································································································· 165
reset lacp statistics ································································································································· 166
shutdown ················································································································································ 166
traffic-statistic enable ····························································································································· 167
DRNI commands ······················································································· 168
display drni consistency ························································································································· 168
display drni consistency-check status ···································································································· 175
display drni drcp statistics ······················································································································ 176
display drni keepalive ····························································································································· 178
display drni mad verbose ······················································································································· 179
display drni role ······································································································································ 181
display drni summary ····························································································································· 183
display drni system ································································································································· 185
display drni troubleshooting ··················································································································· 186
display drni verbose ······························································································································· 187
display drni virtual-ip ······························································································································ 190
drni authentication key ··························································································································· 190
drni auto-recovery reload-delay ············································································································· 191
drni consistency-check disable ·············································································································· 192
iv
drni consistency-check mode ················································································································· 193
drni drcp period short ····························································································································· 193
drni extra-vlan ········································································································································ 194
drni ipp mac-address hold ······················································································································ 195
drni keepalive { ip | ipv6 } ······················································································································· 196
drni keepalive hold-time ························································································································· 197
drni keepalive interval ···························································································································· 198
drni keepalive track ································································································································ 198
drni mad default-action ··························································································································· 199
drni mad exclude interface ····················································································································· 200
drni mad exclude logical-interfaces ········································································································ 202
drni mad include interface ······················································································································ 202
drni mad persistent ································································································································· 204
drni mad restore ····································································································································· 204
drni restore-delay ··································································································································· 205
drni role priority ······································································································································ 206
drni sequence enable ····························································································································· 206
drni standalone enable ··························································································································· 207
drni system-mac ····································································································································· 208
drni system-number ······························································································································· 209
drni system-priority ································································································································· 210
port drni group ········································································································································ 210
port drni intra-portal-port ························································································································ 212
port drni ipv6 virtual-ip ···························································································································· 213
port drni system-mac ······························································································································ 215
port drni system-priority ·························································································································· 216
port drni virtual-ip ··································································································································· 216
reset drni drcp statistics ························································································································· 218
reset drni troubleshooting history ··········································································································· 219
Port isolation commands············································································ 220
display port-isolate group ······················································································································· 220
port-isolate enable ·································································································································· 221
port-isolate group ··································································································································· 221
VLAN commands ······················································································· 223
Basic VLAN commands ································································································································· 223
bandwidth ··············································································································································· 223
block outbound ······································································································································· 223
control-packet dot1p ······························································································································· 224
default ···················································································································································· 224
description ·············································································································································· 225
display interface vlan-interface··············································································································· 226
display vlan ············································································································································ 228
display vlan brief ···································································································································· 230
interface vlan-interface ··························································································································· 231
mac-address ·········································································································································· 232
mtu ························································································································································· 232
name ······················································································································································ 233
port outbound-vlan-tag enable ··············································································································· 234
reset counters interface vlan-interface ··································································································· 234
service ···················································································································································· 235
shutdown ················································································································································ 236
vlan ························································································································································· 237
Port-based VLAN commands ························································································································ 237
display port ············································································································································· 237
port ························································································································································· 238
port access vlan ····································································································································· 239
port hybrid pvid ······································································································································· 240
port hybrid vlan ······································································································································· 241
port link-type ··········································································································································· 242
port trunk permit vlan ····························································································································· 242
v
port trunk pvid ········································································································································ 243
MAC-based VLAN commands ······················································································································· 244
display mac-vlan ···································································································································· 244
display mac-vlan interface ······················································································································ 245
mac-vlan enable ····································································································································· 246
mac-vlan mac-address ··························································································································· 246
mac-vlan trigger enable ·························································································································· 247
port pvid forbidden ································································································································· 248
vlan precedence ····································································································································· 249
IP subnet-based VLAN commands ················································································································ 250
display ip-subnet-vlan interface·············································································································· 250
display ip-subnet-vlan vlan ····················································································································· 251
ip-subnet-vlan ········································································································································· 252
port hybrid ip-subnet-vlan ······················································································································· 252
Protocol-based VLAN commands ·················································································································· 254
display protocol-vlan interface ················································································································ 254
display protocol-vlan vlan ······················································································································· 255
port hybrid protocol-vlan ························································································································· 256
protocol-vlan ··········································································································································· 257
VLAN group commands ································································································································· 259
display vlan-group ·································································································································· 259
vlan-group ·············································································································································· 259
vlan-list ··················································································································································· 260
Super VLAN commands ············································································ 262
display supervlan ··································································································································· 262
subvlan ··················································································································································· 264
supervlan ················································································································································ 265
Private VLAN commands ··········································································· 266
display private-vlan ································································································································ 266
port private-vlan host ······························································································································ 268
port private-vlan promiscuous ················································································································ 269
port private-vlan trunk promiscuous ······································································································· 272
port private-vlan trunk secondary ··········································································································· 274
private-vlan (VLAN interface view) ········································································································· 277
private-vlan (VLAN view) ························································································································ 279
private-vlan community ·························································································································· 280
private-vlan isolated ······························································································································· 281
private-vlan primary ································································································································ 283
Voice VLAN commands ············································································· 284
display voice-vlan mac-address ············································································································· 284
display voice-vlan state ·························································································································· 284
voice-vlan aging ····································································································································· 285
voice-vlan enable ··································································································································· 286
voice-vlan mac-address ························································································································· 287
voice-vlan mode auto ····························································································································· 288
voice-vlan qos ········································································································································ 289
voice-vlan qos trust ································································································································ 289
voice-vlan security enable ······················································································································ 290
voice-vlan track lldp ································································································································ 291
MVRP commands ······················································································ 292
display mvrp running-status ··················································································································· 292
display mvrp state ·································································································································· 293
display mvrp statistics ···························································································································· 294
mrp timer join ········································································································································· 296
mrp timer leave ······································································································································ 297
mrp timer leaveall ··································································································································· 298
mrp timer periodic ·································································································································· 299
mvrp enable ··········································································································································· 300
vi
mvrp global enable ································································································································· 300
mvrp gvrp-compliance enable ················································································································ 301
mvrp registration ···································································································································· 301
reset mvrp statistics ······························································································································· 302
Loopback, null, and inloopback interface commands ································· 304
bandwidth ··············································································································································· 304
default ···················································································································································· 304
description ·············································································································································· 305
display interface inloopback ··················································································································· 306
display interface loopback ······················································································································ 308
display interface null ······························································································································· 311
interface loopback ·································································································································· 312
interface null ··········································································································································· 312
reset counters interface loopback ·········································································································· 313
reset counters interface null ··················································································································· 314
shutdown ················································································································································ 314
QinQ commands ························································································ 316
display qinq ············································································································································ 316
qinq enable ············································································································································· 317
qinq ethernet-type (interface view) ········································································································· 317
qinq ethernet-type (system view) ··········································································································· 318
qinq transparent-vlan ····························································································································· 320
VLAN mapping commands ········································································ 321
display vlan mapping ······························································································································ 321
vlan mapping ·········································································································································· 322
vlan mapping egress ······························································································································ 325
PBB commands ························································································· 326
bvlan ······················································································································································· 326
display l2vpn minm connection ·············································································································· 326
display l2vpn minm forwarding ··············································································································· 327
display l2vpn vsi ····································································································································· 328
display pbb connection ··························································································································· 330
encapsulation ········································································································································· 331
l2vpn enable ··········································································································································· 332
pbb i-sid ·················································································································································· 332
pbb uplink ··············································································································································· 333
reset pbb connection ······························································································································ 334
vsi ··························································································································································· 335
Loop detection commands ········································································· 336
display loopback-detection ····················································································································· 336
loopback-detection action ······················································································································ 337
loopback-detection delay-timer ·············································································································· 338
loopback-detection enable ····················································································································· 339
loopback-detection global action ············································································································ 339
loopback-detection delay-timer ·············································································································· 340
loopback-detection global enable··········································································································· 341
loopback-detection interval-time ············································································································ 342
VXLAN loop detection commands ····························································· 343
display loopback-detection ····················································································································· 343
loopback-detection action ······················································································································ 344
loopback-detection enable ····················································································································· 344
loopback-detection enable s-vid c-vid ···································································································· 345
loopback-detection interval-time ············································································································ 346
loopback-detection priority ····················································································································· 347
vii
Spanning tree commands ·········································································· 349
active region-configuration ····················································································································· 349
bpdu-drop any ········································································································································ 349
check region-configuration ····················································································································· 350
display stp ·············································································································································· 351
display stp abnormal-port ······················································································································· 358
display stp bpdu-statistics ······················································································································ 359
display stp down-port ····························································································································· 362
display stp history ··································································································································· 362
display stp region-configuration ············································································································· 365
display stp root ······································································································································· 366
display stp tc ·········································································································································· 366
instance ·················································································································································· 368
region-name ··········································································································································· 369
reset stp ················································································································································· 370
revision-level ·········································································································································· 370
snmp-agent trap enable stp ··················································································································· 371
stp bpdu-filter ········································································································································· 372
stp bpdu-protection ································································································································ 372
stp bridge-diameter ································································································································ 373
stp compliance ······································································································································· 374
stp config-digest-snooping ····················································································································· 375
stp cost ··················································································································································· 376
stp dispute-protection ····························································································································· 377
stp edged-port ········································································································································ 378
stp enable ··············································································································································· 379
stp global config-digest-snooping··········································································································· 380
stp global enable ···································································································································· 380
stp global mcheck ·································································································································· 381
stp ignore-pvid-inconsistency ················································································································· 382
stp log enable tc ····································································································································· 382
stp loopback-protection ·························································································································· 383
stp loop-protection ·································································································································· 384
stp max-hops ·········································································································································· 384
stp mcheck ············································································································································· 385
stp mode ················································································································································ 386
stp no-agreement-check ························································································································ 387
stp pathcost-standard ····························································································································· 388
stp point-to-point ···································································································································· 388
stp port bpdu-filter ·································································································································· 389
stp port bpdu-protection ························································································································· 390
stp port priority ······································································································································· 391
stp port shutdown permanent ················································································································· 392
stp port-log ············································································································································· 393
stp priority ··············································································································································· 394
stp pvst-bpdu-protection ························································································································· 395
stp region-configuration ·························································································································· 395
stp role-restriction ··································································································································· 396
stp root primary ······································································································································ 397
stp root secondary ·································································································································· 398
stp root-protection ·································································································································· 398
stp tc-protection ······································································································································ 399
stp tc-protection threshold ······················································································································ 400
stp tc-restriction ······································································································································ 400
stp tc-snooping ······································································································································· 401
stp timer forward-delay ··························································································································· 402
stp timer hello ········································································································································· 403
stp timer max-age ·································································································································· 404
stp timer-factor ······································································································································· 405
stp transmit-limit ····································································································································· 405
stp transparent enable ··························································································································· 406
viii
stp vlan enable ······································································································································· 407
vlan-mapping modulo ····························································································································· 408
LLDP commands ······················································································· 409
cdp voice-vlan ········································································································································ 409
dcbx version ··········································································································································· 409
display lldp local-information ·················································································································· 410
display lldp neighbor-information ··········································································································· 416
display lldp statistics ······························································································································· 425
display lldp status ··································································································································· 427
display lldp tlv-config ······························································································································ 430
lldp admin-status ···································································································································· 433
lldp check-change-interval ····················································································································· 434
lldp compliance admin-status cdp ·········································································································· 435
lldp compliance cdp ································································································································ 436
lldp enable ·············································································································································· 437
lldp encapsulation snap·························································································································· 437
lldp fast-count ········································································································································· 438
lldp global enable ··································································································································· 439
lldp global tlv-enable basic-tlv management-address-tlv ······································································· 439
lldp hold-multiplier ·································································································································· 441
lldp ignore-pvid-inconsistency ················································································································ 442
lldp management-address ······················································································································ 442
lldp management-address-format string ································································································ 444
lldp max-credit ········································································································································ 445
lldp mode ················································································································································ 445
lldp neighbor-identity chassis-id ············································································································· 446
lldp neighbor-identity port-id ··················································································································· 447
lldp neighbor-protection aging ················································································································ 448
lldp neighbor-protection validation ········································································································· 449
lldp notification med-topology-change enable ························································································ 449
lldp notification remote-change enable ·································································································· 450
lldp source-mac vlan ······························································································································ 451
lldp timer fast-interval ····························································································································· 452
lldp timer notification-interval ·················································································································· 453
lldp timer reinit-delay ······························································································································ 454
lldp timer rx-timeout ································································································································ 454
lldp timer tx-interval ································································································································ 455
lldp tlv-config basic-tlv port-id ················································································································· 456
lldp tlv-enable ········································································································································· 457
reset lldp statistics ·································································································································· 463
L2PT commands ······················································································· 465
display l2protocol statistics ····················································································································· 465
l2protocol tunnel dot1q ··························································································································· 466
l2protocol tunnel-dmac ··························································································································· 468
l2protocol user-defined ··························································································································· 468
reset l2protocol statistics ························································································································ 470
Service loopback group commands ··························································· 471
display service-loopback group ·············································································································· 471
port service-loopback group ··················································································································· 472
service-loopback group ·························································································································· 472
Cut-through Layer 2 forwarding commands ··············································· 474
Cut-through Layer 2 forwarding commands ··································································································· 474
cut-through enable ································································································································· 474
Document conventions and icons ······························································ 475
Conventions ··················································································································································· 475
Network topology icons ·································································································································· 476
ix
Support and other resources ····································································· 477
Accessing Hewlett Packard Enterprise Support····························································································· 477
Accessing updates ········································································································································· 477
Websites ················································································································································ 478
Customer self repair ······························································································································· 478
Remote support ······································································································································ 478
Documentation feedback ······················································································································· 478
Index ·········································································································· 480
1
MAC address table commands
This document covers the configuration of unicast MAC address entries, including static, dynamic,
blackhole, and multiport unicast MAC address entries. For more information about configuring static
multicast MAC address entries, see IGMP snooping and IPv6 multicast routing and forwarding in IP
Multicast Configuration Guide. For more information about MAC address table configuration in VPLS,
see MPLS Configuration Guide.
display mac-address
Use display mac-address to display MAC address entries.
Syntax
display mac-address [ mac-address [ vlan vlan-id ] | [ [ dynamic | static ]
[ interface interface-type interface-number ] | blackhole | multiport ]
[ vlan vlan-id ] [ count ] | nickname nickname ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
mac-address: Specifies a MAC address in the format of H-H-H. When entering a MAC address,
you can omit the leading zeros in each H section. For example, enter f-e2-1 for 000f-00e2-0001.
vlan vlan-id: Specifies a VLAN by its ID in the range of 1 to 4094.
dynamic: Displays dynamic MAC address entries.
static: Displays static MAC address entries.
interface interface-type interface-number: Specifies an interface by its type and
number.
blackhole: Displays blackhole MAC address entries.
multiport: Displays multiport unicast MAC address entries.
count: Displays only the number of MAC address entries that match all entry attributes you specify
in the command. Detailed information about MAC address entries is not displayed. For example, you
can use the display mac-address vlan 20 dynamic count command to display the number
of dynamic entries for VLAN 20. If you do not specify an entry attribute, the command displays the
number of entries in the MAC address table. If you do not specify this keyword, the command
displays detailed information about the specified MAC address entries.
nickname nickname: Specifies an egress RB by its nickname. The value range for the
nickname argument is 1 to fffe in hexadecimal format.
Usage guidelines
A MAC address entry includes a destination MAC address, an outgoing interface, and a VLAN ID.
If you do not specify any parameters, the command displays all MAC address entries.
This command displays dynamic MAC address entries for an aggregate interface only when the
aggregate interface has a minimum of one Selected member port.
2
Multiport unicast MAC address entries have no impact on the MAC address learning. When
receiving a frame whose source MAC address matches a multiport unicast entry, the device can still
learn the MAC address of the frame and generate a dynamic entry. However, the generated dynamic
entry has lower priority. The device prefers to use the multiport unicast entry to forward frames
destined for the MAC address in the entry.
Examples
# Display MAC address entries for VLAN 100.
<Sysname> display mac-address vlan 100
MAC Address VLAN ID State Port/Nickname Aging
0001-0101-0101 100 Multiport XGE1/0/1 N
XGE1/0/2
0033-0033-0033 100 Blackhole N/A N
0000-0000-0002 100 Static XGE1/0/3 N
00e0-fc00-5829 100 Learned XGE1/0/4 Y
# Display the number of MAC address entries.
<Sysname> display mac-address count
1 mac address(es) found.
# Display the MAC address entries of the egress RB with the nickname 0x8c81.
<Sysname> display mac-address nickname 8c81
MAC Address VLAN ID State Port/Nickname Aging
0000-3300-0001 10 Learned 0x8c81 Y
0000-3300-0002 10 Learned 0x8c81 Y
0000-3300-0003 10 Learned 0x8c81 Y
Table 1 Command output
Field Description
VLAN ID ID of the VLAN to which the outgoing interface of the MAC address entry
belongs.
State
MAC address entry state:
• Static—Static MAC address entry.
• Learned—Dynamic MAC address entry. Dynamic entries can be
learned or manually configured.
• Blackhole—Blackhole MAC address entry.
• Multiport—Multiport unicast MAC address entry.
• OpenFlow—MAC address entry for an OpenFlow instance.
• Block—MAC address entry for a user who failed MAC authentication.
• Security—MAC address entry configured or learned by port security.
• DRNI—MAC address entry learned by a DR peer device and
synchronized to the local end.
Port/Nickname
When the field displays an interface name, the field indicates the outgoing
interface for packets that are destined for the MAC address. This field
displays N/A for a blackhole MAC address entry.
When the field displays a 16-bit number in hexadecimal format (for example,
0x12ab), it indicates the RB through which the packets leave the TRILL
network. For information about RBs and TRILL, see TRILL Configuration
Guide.
Aging Whether the entry can age out:
• Y—The entry can age out.
• N—The entry never ages out.
3
Field Description
mac address(es) found Number of matching MAC address entries.
Related commands
mac-address
mac-address timer
display mac-address aging-time
Use display mac-address aging-time to display the aging timer for dynamic MAC address
entries.
Syntax
display mac-address aging-time
Views
Any view
Predefined user roles
network-admin
network-operator
Examples
# Display the aging timer for dynamic MAC address entries.
<Sysname> display mac-address aging-time
MAC address aging time: 300s.
Related commands
mac-address timer
display mac-address mac-learning
Use display mac-address mac-learning to display the global MAC address learning status
and the MAC learning status of the specified interface or all interfaces.
Syntax
display mac-address mac-learning [ interface interface-type
interface-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
interface interface-type interface-number: Specifies an interface by its type and
number. If you do not specify an interface, the command displays the global MAC address learning
status and the MAC address learning status of all interfaces.
4
Examples
# Display the global MAC address learning status and the MAC learning status of all interfaces.
<Sysname> display mac-address mac-learning
Global MAC address learning status: Enabled.
Port Learning Status
XGE1/0/1 Enabled
XGE1/0/2 Enabled
Table 2 Command output
Field Description
Global MAC address learning status Global MAC address learning status:
• Enabled.
• Disabled.
Learning Status MAC address learning status of an interface:
• Enabled.
• Disabled.
Related commands
mac-address mac-learning enable
display mac-address mac-move
Use display mac-address mac-move to display the MAC address move records after the
device is started.
Syntax
display mac-address mac-move [ slot slot-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
slot slot-number: Specifies an IRF member device by its member ID. If you do not specify a
member device, the command displays MAC address move records for all IRF member devices.
Usage guidelines
When a MAC address frequently moves between the specified two interfaces, Layer 2 loops might
occur in the network. To discover and locate loops, you can view the MAC address move records.
In the MAC address move records, records with the same MAC address, VLAN, source port, and
current port are considered to be one record.
An IRF member device can generate a maximum of 200 MAC address move records.
Examples
# Display the MAC address move records for a slot.
<Sysname> display mac-address mac-move slot 1
5
MAC address VLAN Current port Source port Last time Times
0000-0001-002c 1 XGE1/0/1 XGE1/0/2 2013-05-20 13:40:52 1
0000-0001-002c 1 XGE1/0/2 XGE1/0/1 2013-05-20 13:41:30 1
--- 2 MAC address moving records found ---
# Display the MAC address move records for all slots.
<Sysname> display mac-address mac-move
MAC address VLAN Current port Source port Last time Times
0000-0001-002c 1 XGE1/0/1 XGE1/0/2 2013-05-20 13:40:52 20
0000-0001-002c 1 XGE1/0/2 XGE1/0/1 2013-05-20 13:41:32 20
0000-0094-0001 1 XGE1/0/3 XGE1/0/4 2013-05-20 13:42:22 13
0000-0094-0001 1 XGE1/0/4 XGE1/0/3 2013-05-20 13:42:21 12
--- 4 MAC address moving records found ---
Table 3 Command output
Field
Description
VLAN VLAN to which the outgoing interface of the MAC address entry
belongs.
Current port Interface to which the MAC address was moved.
Source port Interface from which the MAC address was moved.
Last time Last time when the MAC address was moved.
Times
Number of MAC address moves after the device is started. For a MAC
address record, the number of MAC address moves is increased by 1
when a new MAC address move has the same MAC address, VLAN,
Current Port, and Source Port fields as the MAC address record.
Related commands
mac-address notification mac-move
display mac-address statistics
Use display mac-address statistics to display MAC address table statistics.
Syntax
display mac-address statistics
Views
Any view
Predefined user roles
network-admin
network-operator
Usage guidelines
This command displays the number of MAC address entries per type and the maximum number of
MAC address entries allowed for each type.
Examples
# Display MAC address table statistics.
<Sysname> display mac-address statistics
MAC Address Count:
6
Dynamic Unicast Address (Learned) Count: 3
Dynamic Unicast Address (Security-service-defined) Count: 4
Static Unicast Address (User-defined) Count: 0
Static Unicast Address (System-defined) Count: 3
Total Unicast MAC Addresses In Use: 10
Total Unicast MAC Addresses Available: 32768
Multicast and Multiport MAC Address Count: 1
Static Multicast and Multiport MAC Address (User-defined) Count: 1
Total Multicast and Multiport MAC Addresses Available: 256
Table 4 Command output
Field
Description
Dynamic Unicast Address (Learned) Count Number of dynamic unicast MAC address entries
triggered by packets.
Dynamic Unicast Address
(Security-service-defined) Count Number of dynamic unicast MAC address entries
triggered by the security service.
Static Unicast Address (User-defined) Count Number of static unicast MAC address entries added
by users.
Static Unicast Address (System-defined) Count Number of static unicast MAC address entries added
by the system.
Total Unicast MAC Addresses In Use Number of unicast MAC address entries.
Total Unicast MAC Addresses Available
Maximum number of unicast MAC address entries
allowed. The value of this parameter varies by device
model. Values in the examples are for illustrative
purposes only.
Multicast and Multiport MAC Address Count Number of multicast and multiport unicast MAC
address entries.
Static Multicast and Multiport MAC Address
(User-defined) Count Number of static multicast and multiport unicast MAC
address entries added by users.
Total Multicast and Multiport MAC Addresses
Available
Maximum number of multicast and multiport unicast
MAC address entries allowed. The value of this
parameter varies by device model. Values in the
examples are for illustrative purposes only.
mac-address (interface view)
Use mac-address to add or modify a MAC address entry on an interface.
Use undo mac-address to delete a MAC address entry on an interface.
Syntax
Layer 2 Ethernet interface view and Layer 2 aggregate interface view:
mac-address { dynamic | multiport | static } mac-address vlan vlan-id
undo mac-address { dynamic | multiport | static } mac-address vlan vlan-id
S-channel interface view, S-channel aggregate interface view, and S-channel bundle interface view:
mac-address { dynamic | static } mac-address vlan vlan-id
undo mac-address { dynamic | static } mac-address vlan vlan-id
7
Default
An interface is not configured with MAC address entries.
Views
Layer 2 Ethernet interface view
Layer 2 aggregate interface view
S-channel interface view
S-channel aggregate interface view
S-channel bundle interface view
Predefined user roles
network-admin
Parameters
dynamic: Specifies dynamic MAC address entries.
static: Specifies static MAC address entries.
multiport: Specifies multiport unicast MAC address entries. A frame whose destination MAC
address matches a multiport unicast MAC address entry is sent out of multiple ports.
mac-address: Specifies a MAC address in the format of H-H-H, excluding multicast, all-zero, and
all-F MAC addresses. When entering a MAC address, you can omit the leading zeros in each H
section. For example, enter f-e2-1 for 000f-00e2-0001.
vlan vlan-id: Specifies an existing VLAN to which the specified interface belongs. The value
range for the vlan-id argument is 1 to 4094.
Usage guidelines
Typically, the device automatically builds the MAC address table by learning the source MAC
addresses of incoming frames on each interface. However, you can manually configure static MAC
address entries. For a MAC address, a manually configured static entry takes precedence over a
dynamically learned entry. To improve the security for the user device connected to an interface,
manually configure a static entry to bind the user device to the interface. Then, the frames destined
for the user device (for example, Host A) are always sent out of the interface. Other hosts using the
forged MAC address of Host A cannot obtain the frames destined for Host A.
The MAC address entry configuration cannot survive a reboot unless you save it. The dynamic MAC
address entries, however, are lost upon reboot whether or not you save the configuration.
Examples
# Add a static entry for MAC address 000f-e201-0101 on Ten-GigabitEthernet 1/0/1 that belongs to
VLAN 2.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 1/0/1
[Sysname-Ten-GigabitEthernet1/0/1] mac-address static 000f-e201-0101 vlan 2
# Add a static entry for MAC address 000f-e201-0101 on Bridge-Aggregation 1 that belongs to VLAN
1.
<Sysname> system-view
[Sysname] interface bridge-aggregation 1
[Sysname-Bridge-Aggregation1] mac-address static 000f-e201-0102 vlan 1
# Add a static entry for MAC address 000f-e201-0102 on S-Channel 1/0/1:10 that belongs to VLAN
1.
<Sysname> system-view
[Sysname] interface s-channel 1/0/1:10
8
[Sysname-S-Channel1/0/1:10] mac-address static 000f-e201-0102 vlan 1
# Add a static entry for MAC address 000f-e201-0102 on Schannel-Aggregation 1:2 that belongs to
VLAN 1.
<Sysname> system-view
[Sysname] interface schannel-aggregation 1:2
[Sysname-Schannel-Aggregation1:2] mac-address static 000f-e201-0102 vlan 1
# Add a multiport unicast MAC address entry for MAC address 0001-0001-0101 on
Ten-GigabitEthernet 1/0/1 and Ten-GigabitEthernet 1/0/2 that belong to VLAN 2.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 1/0/1
[Sysname-Ten-GigabitEthernet1/0/1] mac-address multiport 0001-0001-0101 vlan 2
[Sysname-Ten-GigabitEthernet1/0/1] quit
[Sysname] interface ten-gigabitethernet 1/0/2
[Sysname-Ten-GigabitEthernet1/0/2] mac-address multiport 0001-0001-0101 vlan 2
Related commands
display mac-address
mac-address (system view)
mac-address (system view)
Use mac-address to add or modify a MAC address entry.
Use undo mac-address to delete one or all MAC address entries.
Syntax
mac-address { dynamic | static } mac-address interface interface-type
interface-number vlan vlan-id
mac-address blackhole mac-address vlan vlan-id
mac-address multiport mac-address interface interface-list vlan vlan-id
undo mac-address [ [ dynamic | static ] mac-address interface interface-type
interface-number vlan vlan-id ]
undo mac-address [ blackhole | dynamic | static ] [ mac-address ] vlan vlan-id
undo mac-address [ dynamic | static ] interface interface-type
interface-number
undo mac-address multiport mac-address interface interface-list vlan
vlan-id
undo mac-address [ multiport ] [ [ mac-address ] vlan vlan-id ]
undo mac-address nickname nickname
undo mac-address mac-address nickname nickname vlan vlan-id
Default
The system is not configured with MAC address entries.
Views
System view
Predefined user roles
network-admin
9
Parameters
dynamic: Specifies dynamic MAC address entries.
static: Specifies static MAC address entries.
blackhole: Specifies blackhole MAC address entries. Packets whose source or destination MAC
addresses match blackhole MAC address entries are dropped.
multiport: Specifies multiport unicast MAC address entries. A frame whose destination MAC
address matches a multiport unicast MAC address entry is sent out of multiple ports.
mac-address: Specifies a MAC address in the format of H-H-H, excluding multicast, all-zero, and
all-F MAC addresses. When entering a MAC address, you can omit the leading zeros in each H
section. For example, enter f-e2-1 for 000f-00e2-0001.
vlan vlan-id: Specifies an existing VLAN to which the interface belongs. The value range for the
vlan-id argument is 1 to 4094.
interface interface-type interface-number: Specifies an outgoing interface by its type
and number.
interface interface-list: Specifies a list of up to four interface items. Each interface item
can be an individual interface in the format of interface-type interface-number or a range
of interfaces in the format of interface-type interface-number1 to interface-type
interface-number2. The interfaces can only be Layer 2 Ethernet interfaces or Layer 2
aggregate interfaces. The value for the interface-number2 argument cannot be lower than the
value for the interface-number1 argument.
nickname nickname: Specifies an RB (through which the packets leave the TRILL network) by its
nickname. The nickname is a hexadecimal number in the range of 1 to fffe.
Usage guidelines
You can use this command to configure the following types of MAC address entries:
•
Dynamic entries.
Dynamic entries include manually configured dynamic entries and automatically learned
dynamic entries.
•
Static entries.
For a MAC address, a manually configured static entry takes precedence over a dynamic entry.
To improve the security for the user device connected to an interface, manually configure a
static entry to bind the user device to the interface. Then, the frames destined for the user
device (for example, Host A) are always sent out of the interface. Other hosts using the forged
MAC address of Host A cannot obtain the frames destined for Host A.
•
Blackhole entries.
To drop frames with the specified source MAC addresses or destination MAC addresses, you
can configure blackhole entries.
•
Multiport unicast entries.
To send frames with a specific destination MAC address out of multiple ports, configure a
multiport unicast entry. When you execute this command for the first time, the command adds
an entry. When you execute the command again with the same MAC address and VLAN but
with different interfaces, this command adds the specified interfaces for this entry.
A static or blackhole entry can overwrite a dynamic entry, but not vice versa.
If you execute the undo mac-address command without specifying any parameters, this
command deletes all unicast MAC address entries and static multicast MAC address entries.
You can delete all the MAC address entries (including unicast and static multicast MAC address
entries) from the specified VLAN. You can also delete only one type (dynamic, static, blackhole, or
multiport unicast) of MAC address entries. You can single out an interface and delete the unicast
/