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.

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|
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| 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-
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|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|
stp-root-guard

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.

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.

sort-asc

Display output in ascending order.

sort-desc

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.

show-headers|
no-show-headers

Display column headers or not.

limit-output number

Limit the display output to a specific number of entries.

count-output

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

unscaled

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

raw-int-values

Display integer values instead of mapped values

sum-by

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

History   

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.

Version 3.1.0

The parameters, ND and vtep-ip, added.

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   

l2-history-show

l2-setting-modify

l2-setting-show

l2-table-flush