MAC-notification events

Note: MAC-notifications for LAG should be enabled on the LAG interface.

When enabled, each MAC address addition or deletion is logged as an event in a buffer-queue. Each event is 11 bytes long and contains information about the following:

Value Description
MAC address The MAC address added or deleted on the device.
VLAN The VLAN to which the MAC address is associated. The valid range is 1 to 4094.
Interface The interface on which the MAC address is added or deleted.
Action The event that occurred.

The following table lists the various events that can occur, along with the VLAN interface values and their interpretation for each event:

MAC address notification events and values

Event Action Value Description Expected action by management software VLAN and port values
ADD-MAC 1

This event is generated when a new MAC address is learnt.

Management software should add the MAC address to its forwarding table. (VLAN, Port)
REMOVE-MAC 2

This event is generated when the MAC address ages out.

Management software should delete the MAC address from its forwarding table. (VLAN, Port)
REMOVE-ALL-MAC-ON-SYSTEM 3

This event is generated when all the MAC addresses on the system are flushed, for example, by using the clear mac-address command.

Management software should clear all the MAC addresses from its forwarding table. (0, 0)
REMOVE-ALL-MAC-ON-PORT 4

This event is generated when all the MAC addresses on a particular port are flushed, for example, when the link goes down.

Management software should clear all the MAC addresses learnt on this particular port from its forwarding table.

(0, Port)
REMOVE-ALL-MAC-ON-VLAN 5

This event is generated when the MAC addresses learnt on all ports, in a particular VLAN are flushed, for example, by using the no vlan command.

Management software should clear all the MAC addresses learnt on this particular VLAN from its forwarding table. (VLAN, 0)
REMOVE-ALL-MAC-ON-VLAN-PORT 6

This event is generated when the MAC addresses, are flushed for a particular port in a particular VLAN, for example by a protocol flush event.

Management software should clear all the MAC addresses learnt on this particular VLAN and port from its forwarding table. (VLAN, Port)
MAC-MOVE 7

This event is generated when the MAC address moves from an old port to a new port in the same VLAN.

Management software should move the MAC address from the old port to the specified new port learnt in its forwarding table. (VLAN, new port)

Working with MAC-notification events

  • Each event stored in the buffer queue is in the order in which the event occurred in the system.
  • The number of events that can be stored in the buffer queue is by default 4000. This value is configurable up to 16000 through the command line interface.

  • An out-of-band buffer full event trap is sent to the management software in the event of a buffer full. The system then flushes the existing buffer queue.
  • You can configure a periodic interval at which point a MAC-notification trap should be sent to the management software. The interval can range from 1 to 3600 seconds. The default is 3 seconds.
  • Each trap message sent on the notification interval can have one or more MAC-notification events taken from the buffer queue in the first-in first-out order.
  • One or more SNMP trap messages can be sent on the expiry of a MAC-notification interval. However, the maximum number of trap messages that can be sent is limited to 5.