show mac

Use this command to display MAC addresses in the switch‘s filtering database.

Syntax

show mac [vxlan] [agetime] [max-entries] [address mac-address] [fid fid] [vlan-id vlan-id] [port-string port-string] [type {other | invalid | learned | self | mgmt}] [field-decode] [unicast-as-multicast] [-verbose]

Parameters

vxlan (Optional) If applicable, shows associated tunnel VNI, logical switch name, and remote VTEP IP with this entry.
agetime (Optional) Shows timeout period for aging learned entries.
max-entries (Optional) Shows maximum number of entries.
address mac-address (Optional) Displays a specific MAC address (if it is known by the device).
fid fid (Optional) Displays MAC addresses for a specific filter database identifier.
vlan-id vlan-id (Optional) Displays MAC addresses for a specific VLAN based on the VLAN ID, for static multicast entries only.
port-string port-string (Optional) Displays MAC addresses for a specific port or range of ports. For a detailed description of possible port-string values, refer to the S-, K-, and 7100 Series Configuration Guide.
type other | invalid | learned | self | mgmt (Optional) Display MAC addresses defined as other, invalid, learned, self or mgmt (management).
field-decode (Optional) Display the meanings of the fields in the show mac command.
unicast-as-
multicast (Optional) Display matches of unlearned destination MAC address against the static multicast MAC entries.
-verbose (Optional) Displays all MAC address information in detail.

Defaults

If no parameters are specified, all MAC addresses for the device will be displayed.

Mode

All command modes.

Usage

These are addresses learned on a port through the switching process or statically entered. To show port MAC addresses programmed into the device during manufacturing, use the show port mac command as described in show port mac.

Example

This example shows how to display MAC address information for port ge.1.1 with the meanings of field codes displayed:

System(rw)->show mac field-decode fid 1 port-string ge.1.1 -verbose
 Blank    = Not applicable
 Type:
  other   = Entry is other than below
  invalid = Entry is no longer valid, but has not been yet flushed-out
  learned = Entry has been learned and is currently used
  self    = Entry represents one of the device's address
  mgmt    = Entry represents a dot1qStaticUnicastAddress
  mcast   = Entry represents a dot1qStaticMulticastAddress
 Status:
  other   = Entry is other than below
  invalid = Entry shall be removed
  perm    = Entry is currently in use and shall remain so AFTER the next reset
            (permanent)
MAC Address       FID  Port          Type    Status
----------------- ---- ------------- ------- -------
00-00-5E-00-01-01 1    ge.1.1        learned
00-01-F4-00-70-1A 1    ge.1.1        learned
00-01-F4-2C-01-13 1    ge.1.1        learned
00-01-F4-5B-5F-A7 1    ge.1.1        learned
00-01-F4-5D-96-B4 1    ge.1.1        learned
00-03-47-93-7A-57 1    ge.1.1        learned
00-04-5A-79-40-73 1    ge.1.1        learned
00-06-1B-D9-2B-A9 1    ge.1.1        learned
.
.
.
00-E0-63-86-2B-BE 1    ge.1.1        learned
00-E0-63-86-3E-4D 1    ge.1.1        learned
System(rw)->
This example shows how to display MAC addresses learned over a VXLAN tunnel:
System(rw)->show mac vxlan

MAC Address       FID Port    Type   Status Keyword Logical Remote 
                                                    Switch  VTEP IP
----------------- --- ------- ------- ------ ------ ------- ----------
00-11-88-FE-63-F4 15  tbp.0.1 learned        777    switch1  66.66.66.1
00-1F-45-62-9A-68 15  tbp.0.1 learned        777    switch1  99.99.99.1
00-1F-45-F4-D5-40 15  tbp.0.1 learned        777    switch1  77.77.77.1
00-11-88-FE-63-F4 16  tbp.0.1 learned        888    switch2  66.66.66.1
00-1F-45-62-9A-68 16  tbp.0.1 learned        888    switch2  99.99.99.1
00-1F-45-F4-D5-40 16  tbp.0.1 learned        888    switch2  77.77.77.1
00-11-88-FE-63-F4 17  tbp.0.1 learned        999    switch3  66.66.66.1
00-1F-45-62-9A-68 17  tbp.0.1 learned        999    switch3  99.99.99.1
00-1F-45-F4-D5-40 17  tbp.0.1 learned        999    switch3  77.77.77.1

show mac Output Details provides an explanation of the command output.

Click to expand in new window

show mac Output Details

Output... What it displays...
MAC Address MAC addresses mapped to the port(s) shown.
FID Filter database identifier.
Port Port designation.
Type Address type. Valid types are:
  • other - entry is other than below
  • invalid - entry is no longer valid, but has not been yet flushed-out
  • learned - entry has been learned and is currently used
  • self - entry represents one of the device's address
  • mgmt - entry represents a dot1qStaticUnicastAddress (manually entered MAC address)
  • mcast - entry represents a dot1qStaticMulticastAddress
Status Address status. Valid types are:
  • other - entry is other than below
  • invalid - entry shall be removed
  • perm - entry is currently in use and shall remain so AFTER the next reset (permanent)