| Parameter | Description | Value |
|---|---|---|
| vsi vsi-name | Specifies the name of the VSI on which the operation is performed. | The value is a string of 1 to 31 case-sensitive characters, spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string. |
| mac mac-address | Specifies the MAC address for the diagnostic test, expressed in the format of H-H-H. | The value is in H-H-H format. The values are as follows:
|
| packet-num num | Specifies the number of packets to be sent. | The value is a decimal integer that ranges from 1 to 5. The default value is 3. |
| register | Specifies the MAC address reserved for the OAM test. NOTE:
If the preceding command contains register, an OAM MAC address is populated into the local device or the peer device to make the device discard received packets corresponding to the OAM MAC address. |
- |
| flood | Indicates that the OAM MAC address is flooded throughout the VSI. | - |
Usage Scenario
To rectify a Layer 2 communication fault on the device, you can run the mac-purge command to clear OAM MAC addresses populated into the device.
Prerequisites
The diagnostic test on the MAC address learning capacity has been enabled using the mac-diagnose enable command.
Precautions
If vsi-name in the mac-purge command for purging an OAM MAC address is not identical with vsi-name in the mac-purge command that is previously used in populating the OAM MAC address, the OAM MAC address cannot be cleared.
A maximum of 100 OAM MAC addresses of populate and register+populate types can be populated into a device.
The mac-purge command does not support BGP AD VPLS.
Using the mac-purge command, you can purge the populated OAM MAC address that is specialized for the test or register an OAM MAC address to a device to make the device discard the received packets corresponding to the OAM MAC address.