Table of Contents Table of Contents... 1-1 1.1 MAC Address Table Management... 1-1 1.1.1 display mac-address... 1-1 1.1.2 display mac-address aging-time... 1-2 1.1.3 mac-address (Ethernet port view)... 1-3 1.1.4 mac-address (System view)... 1-4 1.1.5 mac-address max-mac-count... 1-5 1.1.6 mac-address timer... 1-6 i
1.1 MAC Address Table Management Configuration Commands 1.1.1 display mac-address display mac-address blackhole [ vlan vlan-id ] [ count ] display mac-address [ mac-address [ vlan vlan-id ] [ dynamic static ] [ interface interface-type interface-number ] [ vlan vlan-id ] [ count ] ] Any view blackhole: Displays blackhole MAC address entries. These entries do not age but you can add or remove them. The packets whose destination MAC addresses match blackhole MAC address entries are dropped. vlan vlan-id: Displays MAC address entries of the specified VLAN, which is in the range 1 to 4094. count: Displays the total number of MAC addresses in the MAC address table. mac-address: Displays MAC address entries in a specified MAC address, in the format of H-H-H. dynamic: Displays dynamic MAC address entries. Aging time is set for these entries. static: Displays static MAC address entries. Similar to blackhole MAC address entries, these entries do not age but you can add or remove them. interface interface-type interface-number: Displays MAC address learning status of the specified interface. interface-type interface-number specifies an interface by its type and number. Use the display mac-address command to display information about the MAC address table. Related commands: mac-address (system view), mac-address (Ethernet interface view), mac-address timer. 1-1
# Display the MAC address table entry for MAC address 000f-e201-0101. <Sysname> display mac-address 000f-e201-0101 MAC ADDR VLAN ID STATE PORT INDEX AGING TIME(s) 000f-e201-0101 1 Learned GigabitEthernet1/0/1 AGING --- 1 mac address(es) found --- Table 1-1 on the fields of the display mac-address command Field MAC ADDR VLAN ID STATE PORT INDEX AGING TIME(s) MAC address ID of the VLAN to which the MAC address belongs State of a MAC address, which could be Config static, Config dynamic, Learned and Blackhole Port number (Displayed as N/A for a blackhole MAC address) Aging time, which could be: AGING, indicates that the entry is aging. NOAGED, indicates that the entry does not age. 1.1.2 display mac-address aging-time display mac-address aging-time Any view None Use the display mac-address aging-time command to display the aging time of dynamic entries in the MAC address table. Related commands: mac-address (system view), mac-address (Ethernet interface view), mac-address timer, display mac-address. # Display the aging time of dynamic entries in the MAC address table. 1-2
<Sysname> display mac-address aging-time Mac address aging time: 300s The above information indicates that the aging time of dynamic entries in the MAC address table is 300 seconds. 1.1.3 mac-address (Ethernet port view) mac-address { dynamic static } mac-address vlan vlan-id undo mac-address { dynamic static } mac-address vlan vlan-id Ethernet port view dynamic: Dynamic MAC address entries. Aging time is set for these entries. static: Static MAC address entries. Similar to blackhole MAC address entries, these entries do not age but you can add or remove them. mac-address: Specifies a MAC address in the format of H-H-H. vlan vlan-id: Specifies the VLAN to which the Ethernet port belongs., where vlan-id is the specified VLAN ID, in the range 1 to 4094. Use the mac-address command to add or modify a MAC address entry on the specified Ethernet port. Use the undo mac-address command to remove a MAC address entry on the Ethernet port. Note that: As your MAC address entries configuration cannot survive a reboot, save it after completing the configuration. The dynamic MAC address table entries however will be lost whether you save the configuration or not. You cannot configure a static or dynamic MAC address entry on an aggregation port. Related commands: display mac-address. # Add a static entry for MAC address 000f-e201-0101 on port GigabitEthernet 1/0/1 which belongs to VLAN 2. <Sysname> system-view 1-3
[Sysname] interface GigabitEthernet 1/0/1 [Sysname-GigabitEthernet1/0/1] mac-address static 000f-e201-0101 vlan 2 1.1.4 mac-address (System view) mac-address blackhole mac-address vlan vlan-id mac-address { dynamic static } mac-address interface interface-type interface-number 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 ] mac-address interface interface-type interface-number vlan vlan-id undo mac-address [ dynamic static ] interface interface-type interface-number System view blackhole: Blackhole MAC address entries. These entries do not age but you can add or remove them. The packets whose destination MAC addresses match blackhole MAC address entries are dropped. mac-address: Specifies a MAC address in the format of H-H-H. vlan vlan-id: Specifies the VLAN to which the Ethernet port belongs., where vlan-id is the specified VLAN ID, in the range 1 to 4094. dynamic: Dynamic MAC address entries. Aging time is set for these entries. static: Static MAC address entries. Similar to blackhole MAC address entries, these entries do not age but you can add or remove them. interface interface-type interface-number: Outbound port, with interface-type interface-number representing the port type and number. Use the mac-address command to add or modify a MAC address entry. Use the undo mac-address [ { blackhole dynamic static } mac-address interface interface-type interface-number vlan vlan-id ] command to remove one or all MAC address entries. 1-4
Use the undo mac-address [ blackhole dynamic static ] [ mac-address ] vlan vlan-id command to remove a MAC address entry, MAC address entries of a specified type, or all MAC address entries for a VLAN. Use the undo mac-address [ blackhole dynamic static ] interface interface-type interface-number command to remove a MAC address entry, MAC address entries of a specified type, or all MAC address entries for an Ethernet port. Use the undo mac-address [ blackhole dynamic static ] [ mac-address ] interface interface-type interface-number vlan vlan-id command to remove a MAC address entry or all MAC address entries for an Ethernet port. Note that you can change a dynamic entry to a static or blackhole entry but not vice versa. As your MAC address entries configuration cannot survive a reboot, save it after completing the configuration. The dynamic entries however will be lost whether you save the configuration or not. Related commands: display mac-address. # Add a static entry for MAC address 000f-e201-0101. All frames destined to this MAC address are sent out of port GigabitEthernet 1/0/1 which belongs to VLAN 2. <Sysname> system-view [Sysname] mac-address static 000f-e201-0101 interface GigabitEthernet 1/0/1 vlan 2 1.1.5 mac-address max-mac-count mac-address max-mac-count count undo mac-address max-mac-count Ethernet port view, port group view count: Maximum number of MAC addresses that can be learned on a port. When the argument takes 0, the VLAN is not allowed to learn MAC addresses. The value ranges from 0 to 4096. Use the mac-address max-mac-count count command to configure the maximum number of MAC addresses that can be learned on an Ethernet port. 1-5
Use the undo mac-address max-mac-count command to restore the default maximum number of MAC addresses that can be learned on an Ethernet port. The default maximum number of MAC addresses that can be learned on a port is not configured. Executed in Ethernet port view, the command takes effect on the current port only; executed in port group view, the command takes effect on all ports in the port group. Related commands: mac-address, mac-address timer. # Set the maximum number of MAC addresses that can be learned on port GigabitEthernet 1/0/1 to 600. <Sysname> system-view [Sysname] interface GigabitEthernet 1/0/1 [Sysname-GigabitEthernet1/0/1] mac-address max-mac-count 600 1.1.6 mac-address timer mac-address timer { aging seconds no-aging } undo mac-address timer aging System view aging seconds: Sets an aging timer in seconds for dynamic MAC address entries, in the range 10 to 1000000. no-aging: Sets dynamic MAC address entries not to age. Use the mac-address timer command to configure the aging timer for dynamic MAC address entries. Use the undo mac-address timer command to restore the default. By default the aging timer is 300 seconds. Set the aging timer appropriately: a long aging interval may cause the MAC address table to retain outdated entries and fail to accommodate latest network changes; a short interval may result in removal of valid entries and hence unnecessary broadcasts which may affect device performance. 1-6
# Set the aging timer for dynamic MAC address entries to 500 seconds. <Sysname> system-view [Sysname] mac-address timer aging 500 1-7