l2-table-show

Glossary		Print Page		Document Feedback		Support & Services		Pluribus Networks		Pluribus Blog		LinkedIn		Facebook		Twitter

l2-table-show

To display Layer 2 flows in the forwarding table of the switch datapath, use this command.

Syntax l2-table-show

owner node name	Specifies the node name for the L2 table.
mac mac-address	Specifies the source MAC address for the flow.
ip ip-address	Specifies the source IP address for the flow.
vnet vnet-name	Specifies the VNET name.
bd bridge-domain name	Specify the bridge domain name assigned to vport.
l2-net l2-net name	Specifies the Layer 2 network.
vlan vlan-id	Specifies the VLAN identifier for the flow.
public-vlan vlan-id	Specifies the public VLAN.
vxlan vxlan-id	Specifies the ID for the VXLAN.
ip ip-address	Specifies the IP address.
num-ips num-ips-number	Specifies the number of IP addresses.
config-intf config-intf-number	Specifies a configured interface number.
intf intf-number	Specifies the interface number.
ports port-list	Specifies the source port number for the flow.
state active\|static\|vrrp\|tunnel\|software\|needs-peer-status\|port-mac\|hit\|ageout-check\|moving\|loop-probe\|local-tunnel\|igmp-mac\|user-flush\|vxlan-loopback\|router\|update-peer-only\|active-state-mismatch\|peer-port-missing\|peer-port-not-vlag\|peer-port-not-orphaned\|peer-port-not-cluster-link\|sw-active\|anycast\|hsrp\|invalid-vlan\|owner-lost\|cluster-link-down\|vxlan-router\|peer-force-resync\|excess-mac-move-detected\|excess-ip-move-detected\|retry\|evpn\|evpn-wo-bgp\|evpn-def-gw\|evpn-delete	Specifies the state of the vPort.
svc-name svc-name-string	Specifies the service name.
hostname hostname-string	Specifies a hostname.
entity entity-string	Specifies the VM or VM Kernel device name.
power none\|powered-off\|powered-on\|standby\|suspended\|unknown	Specifies the power status.
cpus cpus-number	Specifies the number of CPUs assigned to the VM.
disk disk-number	Specifies the number of disks assigned to the VM.
os os-string	Specifies the name of the operating system (OS) running on the VM.
portgroup portgroup-string	Specifies the port group associated with the VM MAC Address.
pg-vlans vlan-list	Specifies the VLANs associated with the port group.
vswitch vswitch-string	Specifies the vSwitch associated with the NIC.
vs-type none\|host-vs\|distributed-vs\|unknown	Specifies the vSwitch type.
vnic-type untagged\|tagged\|trunked\|vm-mgmt\|vm-kernel\|vMotion\|vSAN\|FTL\| rep\|p-NFC\|r-NFC\|mgmt\| unknown	Specifies the vNIC type.
config none\|switch\|ip\|port\| hostname\|hypervisor\| vm-id\|vm-name\|vm-flavor\|memory\|cpus\|disk\|os	Displays the configuration on the host.
rem-switch node-name]	Specifies a remote switch.
rem-intf rem-intf-number	Specifies a remote switch interface.
rem-ports port-list	Specifies a remote switch port list.
peer-intf peer-intf-number	Filter output by vPort peer interface.
peer-state active\|static\|vrrp\|tunnel\|software\|needs-peer-status\|port-mac\|hit\|ageout-check\|moving\|loop-probe\|local-tunnel\|igmp-mac\|user-flush\|vxlan-loopback\|router\|update-peer-only\| active-state-mismatch\|peer-port-missing\|peer-port-not-vlag\|peer-port-not-orphaned\|peer-port-not-cluster-link\|sw-active\|anycast\|hsrp\|invalid-vlan\|owner-lost\|cluster-link-down\|vxlan-router\|peer-force-resync\|excess-mac-move-detected\|excess-ip-move-detected\|retry\|evpn\|evpn-wo-bgp\|evpn-def-gw\|evpn-delete	Filter by the vPort peer state.
peer-owner-state active\|static\|vrrp\|tunnel\|software\|needs-peer-status\|port-mac\|hit\|ageout-check\|moving\|loop-probe\|local-tunnel\|igmp-mac\|user-flush\|vxlan-loopback\|router\|update-peer-only\|active-state-mismatch\|peer-port-missing\|peer-port-not-vlag\|peer-port-not-orphaned\|peer-port-not-cluster-link\|sw-active\|anycast\|hsrp\|invalid-vlan\| owner-lost\|cluster-link-down\|vxlan-router\|peer-force-resync\|excess-mac-move-detected\|excess-ip-move-detected\|retry\|evpn\|evpn-wo-bgp\|evpn-def-gw\|evpn-delete	Filter by the vPort peer owner state.
status phy-up\|up\|disabled\|hw-nat-loop\|mirror-loop\| mirror-to\|inuse\| PN-switch\|PN-fabric\|PN-other\|PN-cluster\|PN-internal\| PN-hypervisor\|PN-guest\|snmp-host\|host\|uplink\|drop-pkts\|no-pktin\|no-fwd\|no-flood\| STP-BPDUs\|LLDP\|trunk\|l3-port\|remote-l3-port\|vdp\|dhcp\|dhcpsvr\|blocked\|no-BPDU\|LACP-PDUs\|vlag-active\| vlag-blocked\|stp-edge-port\|LACP-wait\|LACP-fallback\| adjacency-wait\|adjacency-check\|vlag-wait\|multicast-router\|loop\|congested\|vxlan-loopback\|vlan-up\|vle\|vle-wait\|phy-down\|down\| enabled\|err-disabled\|err-bpdu-guard\|mac-violation\| stp-bpdu-guard\|stp-root-guard\|\|defer-bringup-wait	Specifies the status of the entry.
vtep-ip ip-address	Specifies the IP address of the remote VTEP.
tunnel tunnel-string	Specifies a tunnel name if configured.
create-time date/time: yyyy-mm-ddThh:mm:ss	Specifies the date and time that the flow was inserted into the Layer 2 table.
last-time date/time: yyyy-mm-ddThh:mm:ss	Specifies the most recent date and time that a packet matched the flow.
vxlan-lru date/time: yyyy-mm-ddThh:mm:ss	Specifies the last received update time for a VXLAN.
hit number-of-hits	Specifies the number of packets that matched the flow.
migrate number-of-migrates	Specifies the number of different ports that received packets matching the flow.
drops number-of-drops	Specifies the number of packets matching the flow that were dropped.
hw-index hw-index-number	Specifies the hardware index number.
rt-if rt-if-string	Specifies the router interface.
hw-flags invalid-vlan\|invalid-port	Specifies any vPort hardware flags.
mc-index mc-index-number	Specifies the Layer 2 multicast group index in hardware.

Defaults None

Access CLI

History

Version 1.2	Command introduced.
Version 2.1	The parameter state added.
Version 2.2.4	The parameters config-intf, rem-switch, rem-intf, and rem-ports added.
Version 2.2.5	The parameters vlag-active, vlag-blocked, stp-edge-port, deprecated. The parameters, l3-port and remote-l3-port added.
Version 2.3	The parameters vlag-active, vlag-blocked, stp-edge-port, added. The parameters vm-status, tunnel, and vxlan-lru added.
Version 2.4	The parameters peer-, hw-index, and rf-if added.
Version 2.6.2	The parameters ip, num-ip, svc-name, entity, power, portgroup, pg-vlans, vswitch, vs-type, vnic-type, and hw-flags added. The parameters, hypervisor, vm-id, vm-name, vm-flavor, vm-status, memory, and blocked-port deprecated.
Version 3.1.0	The parameters ND and vtep-ip added.
Version 5.2.0	The parameter bd added.
Version 6.1.0	The options evpn, evpn-wo-bgp,evpn-def-gw,evpn-delete added to the state parameter.

Usage Each switch has automatic safeguards to avoid forwarding loops in Layer 2 multipathing. This feature operates independently of Spanning Tree Protocol (STP) if STP is enabled. This command lists the Layer 2 flows in the forwarding table of the switch datapath. If there are ports in the blocked state may indicate the presence of loops in Layer 2 multipathing.

Examples To display the Layer 2 table, use the following command:

CLI network-admin@switch > l2-table-show format all layout vertical

switch: pubdev02

mac: 02:08:20:38:00:c6

vlan: 4094

hostname: pubdev02

create-time: 04-22,08:17:16

last-seen: 04-22,08:17:16

switch: pubdev01

mac: 02:08:20:72:2d:ff

vlan: 4094

intf: 128

ports: 26,47-48

state: active,static

hostname: pubdev02

status: PN-internal

last-seen: 05-19,15:10:12

switch: pubdev02

mac: 02:08:20:72:2d:ff

vlan: 4094

intf: 65

ports: 65

state: active

hostname: pubdev02

status: PN-internal

create-time: 04-22,08:53:08

last-seen: 05-19,15:03:08

switch: pubdev03

mac: 02:08:20:72:2d:ff

vlan: 4094

intf: 128

ports: 45-48

state: active,static

hostname: pubdev02

status: PN-internal

last-seen: 05-19,14:32:30

switch: pubdev02

mac: 06:a0:00:03:00:1a

vlan: 1

intf: 26

ports: 26

state: active

hostname: pubdev01

status: PN-switch,PN-fabric,PN-cluster

create-time: 04-22,08:42:19

last-seen: 11:17:47

switch: pubdev03

mac: 06:a0:00:03:00:2d

vlan: 1

intf: 45

ports: 45

state: active

hostname: pubdev01

status: PN-switch,PN-fabric

create-time: 04-22,07:49:03

last-seen: 05-19,15:10:29

migrate: 10