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.

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|hsrp

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 theVM 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|

Specifies the vNIC type.

config none|switch|ip|port|

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| update-peer-only|active-state-mismatch|peer-port-missing|peer-port-not-vlag|peer-port-not-orphaned| peer-port-not-cluster-link|sw-active|hsrp

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|update-peer-only|active-state-mismatch|peer-port-missing|peer-port-not-vlag|peer-port-not-orphaned| peer-port-not-cluster-link|sw-active|hsrp

Filter by the vPort peer owner state.

status phy-up|up|disabled|hw-
mirror-to|inuse| PN-switch|PN-fabric|PN-other|PN-cluster|PN-internal| PN-hypervisor|PN-guest|
vlag-blocked|stp-edge-port|LACP-wait|LACP-fallback| adjacency-wait
|adjacency-check|vlag-wait|multicast-router|host-disabled|loop| congested|vxlan-loopback|vlan-up|vle|vle-wait|phy-down|down|    enabled|err-disabled|err-bpdu-guard|mac-violation| stp-bpdu-guard|

Specifies the status of the entry.

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.

Formatting Options

format fields-to-display

Display output using a specific parameter. Use all to display all possible output.

parsable-delim character

Display output formatted for machine parsing using a specified delimiter.


Display output in ascending order.


Display output in descending order.

show dups

Display duplicate entries in the output.

layout vertical|horizontal

Format the output in a vertical or horizontal layout.

show-interval seconds-interval

Repeat the show command at a specified interval.


Display column headers or not.

limit-output number

Limit the display output to a specific number of entries.


Display the number of entries in the output. This is useful with vRouter show commands.


Display full values in the output instead of scaled approximate values.


Display integer values instead of mapped values


Aggregate output by specific parameters. If sum-by fields are specified, records that have the same value in sum-by fields are combined and displayed as one aggregate record. NOTE: This option is only available for show commands that collect statistics such as connection-stats-show.

Defaults   None

Access   CLI


Version 1.2

Command introduced.

Version 2.1

The parameter, state, added.

Version 2.2

The parameters, switch-id, hostname, hypervisor, vm-id, vm-name, vm-flavor, memory, disk, os, and config added. The options, phy-up, up, disabled, hw-nat-loop, mirror-loop, mirror-to, linuse, 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, vdp, dhcp, dhcpsvr, blocked, no-BPDU, LACP-PDUs, vlag-active, vlag-blocked, stp-edge-p added to the parameter state. The options, active, retired, pending, recorded, aged-out-port-down, static, and software deprecated. The parameters, resolved-arp, and rt-if deprecated.

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.

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

hit:          1

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

hit:          1

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

hit:          4045

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

hit:          2

migrate:      10

See Also