show fdb

show fdb {blackhole {netlogin [all | mac-based-vlans]} | netlogin [all | mac-based-vlans] | permanent {netlogin [all | mac-based-vlans]} | mac_addr {netlogin [all | mac-based-vlans]} | ports port_list {netlogin [all | mac-based-vlans]} | [ {vlan} vlan_name | vlan vlan_list] {netlogin [all | mac-based-vlans]} | {{vpls} {vpls_name} | vxlan { vni } | virtual-network vn_name}}

Description

Displays FDB (forwarding database) entries.

Syntax Description

blackhole Displays the blackhole entries. (All packets addressed to these entries are dropped.)
slot Specifies a slot in the switch.
num_entries Specifies the maximum number of hardware entries to display. The range is 1 to 25.
netlogin all Displays all FDBs created as a result of the netlogin process.
netlogin mac-based-vlans Displays all netlogin MAC-based VLAN (Virtual LAN) FDB entries.
permanent Displays all permanent entries, including the ingress and egress QoS (Quality of Service) profiles.
mac_addr Specifies a MAC address, using colon-separated bytes, for which FDB entries should be displayed.
port_list Displays the entries for one or more ports or ports and slots.
vlan_name Displays the entries for a specific VLAN.
vlan_list Displays a VLAN list of IDs.
vpls_name Specifies a specific VPLS for which to display entries.
vxlan MAC addresses reachable through VXLAN-encapsulated Tunnels.
vni MAC Addresses reachable through VXLAN tunnels encapsulated with the specified Virtual Network Identifier value.
virtual-network MAC addresses associated with a Virtual Overlay Network learning domain.
vn_name Alphanumeric string identifying the Virtual Network whose associated MAC addresses need to be displayed.

Default

All.

Usage Guidelines

The pulling of MAC addresses for display purposes is given a lower priority to the actual data path learning. Eventually all the MAC addresses are learned in a quiescent system.

The show fdb command output displays the following information:

Mac The MAC address that defines the entry.
Vlan The PVLAN or VLAN for the entry.
Age The age of the entry, in seconds (does not appear if the keyword permanent is specified).
Flags Flags that define the type of entry:
  • b - Ingress Blackhole
  • B - Egress Blackhole
  • D - Drop entry for an isolated subscriber VLAN
  • d - Dynamic
  • i - an entry also exists in the IP FDB
  • l - lockdown MAC
  • L - lockdown-timeout MAC
  • m - MAC
  • M - Mirror
  • n - NetLogin
  • o - IEEE 802.1ah backbone MAC
  • P - PVLAN created entry
  • p - Permanent
  • s - Static
  • v - NetLogin MAC-Based VLAN
  • x - an entry also exists in the IPX FDBs.
  • X - VXLAN
Port List The ports on which the MAC address has been learned.

Example

The following example shows how the FDB entries appear for all options except the hardware option:

# show fdb
Mac                     Vlan       Age  Flags       Port / Virtual Port List
-----------------------------------------------------------------------------
00:0c:29:4b:34:cf       v101(0101) 0041 d m       D  1:2
00:0c:29:4b:34:cf       v100(0100) 0041 d m       P  1:2
00:0c:29:d2:2d:48       v102(0102) 0045 d m          1:3
00:0c:29:d2:2d:48       v100(0100) 0045 d m       P  1:3
00:0c:29:f1:f2:f5       v100(0100) 0045 d m          1:1
00:0c:29:f1:f2:f5       v102(0102) 0045 d m       P  1:1
00:0c:29:f1:f2:f5       v101(0101) 0045 d m       P  1:1
Flags : d - Dynamic, s - Static, p - Permanent, n - NetLogin, m - MAC, i - IP,
x - IPX, l - lockdown MAC, L - lockdown-timeout MAC, M- Mirror, B - Egress
        Blackhole,
b - Ingress Blackhole, v - MAC-Based VLAN, P - Private VLAN, T - VLAN
        translation,
D - drop packet, h - Hardware Aging, o - IEEE 802.1ah Backbone MAC.
S - Software Controlled Deletion, r - MSRP
X - VXLAN, Z - OpenFlow
Total: 3 Static: 0  Perm: 0  Dyn: 3  Dropped: 0  Locked: 0  Locked with Timeout: 0
FDB Aging time: 300
FDB VPLS Aging time: 300 

The following example output shows where the port tag is displayed in parentheses:

# show fdb
Mac                     Vlan       Age  Flags       Port / Virtual Port List
-----------------------------------------------------------------------------
00:00:00:00:04:0a       test(0200) 0057 d m            3(0010)
00:00:00:00:04:0b       test(0200) 0300 d m            3(0011)
00:01:02:03:04:05       test(0200) 0000 spm            3(0010) 

Flags : d - Dynamic, s - Static, p - Permanent, n - NetLogin, m - MAC, i - IP,
        x - IPX, l - lockdown MAC, L - lockdown-timeout MAC, M- Mirror, B - Egress
        Blackhole,
        b - Ingress Blackhole, v - MAC-Based VLAN, P - Private VLAN, T – VLAN translation,
        D - drop packet, h - Hardware Aging, o - IEEE 802.1ah Backbone MAC.
        Total: 3 Static: 0  Perm: 0  Dyn: 3  Dropped: 0  Locked: 0  Locked with Timeout: 0
        FDB Aging time: 300
        FDB VPLS Aging time: 300
The following show fdb example includes VXLAN output:
* X670-G2-72x.1 # sh fdb vxlan
Mac                  Vlan Age Flags Port / Virtual Port List
------------------------------------------------------------------------------
00:00:00:00:00:21 vlan101 0000 s mX VR-Default:20.20.20.1
01:00:5E:00:00:01 vlan101 0000 s mX VR-Default:20.20.20.1
                               s mX VR-Default:30.30.30.1
FF:FF:FF:FF:FF:FF vlan101 0000 s mX VR-Default:20.20.20.1
                               s mX VR-Default:30.30.30.1
                               s mX VR-Default:40.40.40.1
Unknown-Unicast vlan101 0000   s mX VR-Default:20.20.20.1
                               s mX VR-Default:30.30.30.1
                               s mX VR-Default:40.40.40.1
00:00:00:00:00:22 vlan102 0000 s mX VR-Default:20.20.20.1
00:00:00:00:00:23 vlan103 0000 s mX VR-Default:20.20.20.1
00:00:00:00:00:24 vlan104 0000 s mX VR-Default:20.20.20.1
Flags : d - Dynamic, s - Static, p - Permanent, n - NetLogin, m - MAC, i - IP,
x - IPX, l - lockdown MAC, L - lockdown-timeout MAC, M- Mirror, B - Egress Blackhole,
b - Ingress Blackhole, v - MAC-Based VLAN, P - Private VLAN, T - VLAN translation,
D - drop packet, h - Hardware Aging, o - IEEE 802.1ah Backbone MAC,
S - Software Controlled Deletion, r - MSRP, X - VXLAN, Z - OpenFlow
Total: 7 Static: 7 Perm: 0 Dyn: 0 Dropped: 1 Locked: 0 Locked with Timeout: 0
FDB Aging time: 300

History

This command was first available in ExtremeXOS 10.1.

The stats and netlogin parameters were first available in ExtremeXOS 11.3.

The blackhole output under the b and B flags was first available for all platforms in ExtremeXOS 12.1.

The o flag was first available in ExtremeXOS 12.4.

The vlan_list variable was added in ExtremeXOS 16.1.

The command was enhanced to show the MAC to IP binding entries in ExtremeXOS 21.1. In addition to retrieving all FDB entries known to the switch, you can query the filtering database for all fdb entries learned within a virtual network (key: <vn_name>), all entries learnt on VXLAN tunnels (token: vxlan) and entries learned on VXLAN tunnels on a specific VNI (key:VNI).

Platform Availability

This command is available on the Summit X450-G2, X460-G2, X670-G2, X770, and ExtremeSwitching X440-G2, X620, X690, X870 series switches.