set mac

Use this command to set the timeout period for aging learned MAC entries, to define what ports a multicast address can be dynamically learned on or flooded to, and to make a static entry into the filtering database(s).

Syntax

set mac [agetime time] | [multicast mac-address vlan-id [port-string] {append | clear}] | [unicast mac-address fid receive-port [ageable]] [unicast-as-multicast {enable | disable}] [max-entries {64K | 128K}]

Parameters

agetime time Specifies the timeout period in seconds for aging learned MAC addresses. Valid values are 10 to 65535. Default: 300 seconds.
multicast mac-address vlan-id [port-string] {append | clear}] This command allows you to limit specific layer two multicast addresses (mac-address) to specific ports (port-string) within a VLAN (vlan-id). You can later come back and append or clear ports from the list of ports the multicast MAC address is allowed to be dynamically learned on or flooded to.
unicast mac-address fid receive-port [ageable] This command allows you to statically enter a unicast MAC address (mac-address) into a filtering database (fid) for a single port (receive-port). This entry will be either permanent or ageable where it will age out same as a dynamically learned MAC address.
unicast-as-
multicast {enable | disable} (Optional) enable - Enables treating static unicast MAC address as a multicast address by extending the search phase of layer 2 lookup to match the unlearned destination MAC address against the static Multicast MAC entries.

disable - Treats static unicast MAC addresses as unicast addresses.

max-entries {64K | 128K} (Optional) Specifies the maximum number of MAC entries for the device. Valid values are 64K (up to 65536) or 128K (up to 131072). The default value is 64K (S-Series).

Defaults

  • If port-string is not defined with the set mac multicast command, then it will apply to all ports.
  • If the set mac unicast command is used without the ageable parameter, the entry will be permanent.
  • The maximum number of MAC entries defaults to 65536 (S-Series).

Mode

All command modes.

Usage

The max-entries option is supported on the S-Series.

A warning displays if a unicast MAC address is entered as part of a multicast command:

System(rw)->set mac multicast 00-02-ca-bb-cc-dd 2 ge.1.5
Warning: Unicast address converted to multicast 01-02-CA-BB-CC-DD

On the 7100-Series platform, due to resource sharing conflicts, SMON statistics will not increment and a VTAP mirror will not mirror for traffic with the MAC address set using the set mac multicast command. The MAC multicast setting is hard set as the higher priority. For example: if you

  • Set the MAC multicast address 01-01-F4-56-78-90 on VLAN 100 for a set of ports
  • Start SMON VLAN-related statistics counting on port tg.1.10

SMON counters will not increment for traffic ingressing port tg.1.10 for MAC address 01-01-F4-56-78-90.

Examples

This example shows how to set the MAC timeout period to 600 seconds:

System(rw)->set mac agetime 600

This example shows how to enable the MAC for unicast-as-multicast:

System(rw)->set mac unicast-as-multicast enable