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

L Commands

l2-check-fix

It is possible for Layer 2 entries to go out of sync between what is present in the hardware and in software. This command checks the status of Layer 2 entries, logs the errors, and fixes them when possible.

Syntax l2-check-fix

mac mac-address	Specifies the virtual router ID from 0 to 15.
vnet vnet-name	Specifies the IP address of the entry.
l2-net l2-net name	Specifies the Layer 2 network.
vlan vlan-id	Specifies the VLAN ID.
public-vlan vlan-id	Specify the public VLAN assigned to the vPort.
vxlan vxlan-id	Specify if you want to check and fix out of synch VXLANs IDs of vPorts.
sw-port port-number	Specify the software port.
sw-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\|invalid-vlan\|owner-lost\|cluster-link-down\|vxlan-router	Specify the software state to check.
hw-port port-number	Specify the port number of the hardware.
hw-stateactive\|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\|invalid-vlan\|owner-lost\|cluster-link-down\| xlan-router	Specify the hardware state to check and fix.
fix-action none\|add-to-hardware\|removefrom-hardware\|fix-port-in-hardware\|fix-tunnel-in-hardware\|FAILED-add-to-hardware\|FAILED-remove-from-hardware\|FAILED-fix-port-in-hardware\|FAILED-fix-tunnel-in-hardware\|delete-port-mac\|mark-port-mac	Specifies the action used to fix the entry.

Defaults None

Access CLI

History

Version 2.4	Command introduced.
Version 2.4.1	The option, igmp-mac, user-flush, vxlan-loopback,router added to parameters sw-state and hw-state. The options, delete-port-mac and mark-port-mac added to the parameter fix-action. The parameter, public-vlan, also added.
Version 2.6.2	Additional parameters added to sw-state and hw-state.
Version 3.0.0	The parameter, l2-net, added.
Version 5.1.1	The options, invalid-vlan\|owner-lost\|cluster-link-down\|vxlan-router, added to the parameters, sw-state, and hw-state.

Usage Use this command to verify and fix Layer 2 entries that are out of sync in the Layer 2 table.

Examples Use the following syntax to fix out of sync Layer 2 table entries.

CLI network-admin@switch > l2-check-fix vlan 25

l2-check-show

It is possible for Layer 2 entries to go out of sync between what is present in the hardware and in software. This command displays the status of Layer 2 entries.

Syntax l2-check-show

mac mac-address	Displays if you want to check and fix out of synch MAC addresses of vPorts.
vnet vnet-name	Specify the name of the VNET.
vlan vlan-id	Displays if you want to check and fix out of synch VLANs addresses of vPorts.
l2-net l2-net name	Specifies the Layer 2 network.
public-vlan vlan-id	Specify the public VLAN assigned to the vPort
vxlan vxlan-id	Displays if you want to check and fix out of synch VXLANs addresses of vPorts.
sw-port port-number	Displays the port number of the software.
sw-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\|invalid-vlan\|owner-lost\|cluster-link-down\|vxlan-router	Displays the software state to check.
hw-port port-number	Displays the port number of the hardware.
hw-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\|invalid-vlan\|owner-lost\|cluster-link-down\|vxlan-router	Displays the hardware state to check and fix.
tunnel-name tunnel-name-string	Displays the tunnel name.
fix-action none\|add-to-hardware\|remove-from-hardware\|fix-port-in-hardware\|fix-tunnel-in-hardware\|FAILED-add-to-hardware\|FAILED-remove-from-hardware\| FAILED-fix-port-in-hardware\|FAILED-fix-tunnel-in-hardware	Displays the type of fix action.

Defaults None.

Access CLI

History

Version 2.4	Command introduced.
Version 2.4.1	The option, igmp-mac, user-flush, vxlan-loopback, router added to parameters sw-state and hw-state. The options, delete-port-mac and mark-port-mac added to the parameter fix-action. The parameter, public-vlan, added.
Version 2.6.2	Additional parameters added to sw-state and hw-state.
Version 3.0.0	The parameter, l2-net, added.
Version 5.1.1	The options, invalid-vlan\|owner-lost\|cluster-link-down\|vxlan-router, added to the parameters, sw-state, and hw-state.

Usage Use this command to display Layer 2 table entries.

Examples To display the Layer 2 entries and states, use the following command:

CLI network-admin@switch > l2-check-show vlan 25

l2-history-show

This command displays historical information about Layer 2 entries on the switch.

Syntax l2-history-show

time date/time: yyyy-mm-ddThh:mm:ss	Specifies a point in time for displaying historical information.
start-time date/time: yyyy-mm-ddThh:mm:ss	Specifies the start time for Layer 2 history collection.
end-time date/time: yyyy-mm-ddThh:mm:ss	Specifies the end time for Layer 2 history collection.
duration duration: #d#h#m#s	Specifies the duration to collect the Layer 2 history.
interval duration: #d#h#m#s	Specifies the intervals that data is collected Layer 2 history.
since-start	Specifies to display all of the Layer 2 history since collection began on the fabric.
older than duration: yyyy-mm-ddThh:mm:ss	Specifies a point in tjme for displaying historical information.
within-last duration: yyyy-mm-ddThh:mm:ss	Specifies the start time for Layer 2 history collection.
log-type l2-save\|l3-save\|restart \|l2-modify\|l2-delete\|l3-modify\|l3-delete	Filter output by the log type of each entry. The log-type column displays when a vPort is created, modified, saved, or deleted.
caller init\|config\|status\|switch-cb\| cluster\|gre\|ARP\|router\|flow-cb\| vdp\|vlag\|port\|inject\|evict\|vxlan\|stats\|vnm-vnic\|adjacency\|stp\| trunk\|intsw\|ttl1\|flood\|flush\| retire\|loop\|dhcp\|fabric\|table\| l3-age-out\|vlan\|l2-checker\|igmp\| l2-age-out\|port-mirror\| mac-move\|cluster-status\|cluster-status-delete\|vxlan-routing\|subnet\|ND	Specifies the feature making the change for this entry.
last-caller init\|config\|status\|switch-cb\|cluster\|gre\|ARP\|router\| flow-cb\|vdp\| vlag\|port\|inject\|evict\|vxlan\|stats\|vnm-vnic\| adjacency\|stp\|trunk\|intsw\| ttl1\|flood\|flush\|retire\|loop\|dhcp\|fabric\|table\|l3-age-out\|vlan\|l2-checker\|igmp\|l2-age-out\|port-mirror\|mac-move\|cluster-status\|cluster-status-delete\|vxlan-routing\|subnet\|ND	Specifies the most recent caller for this entry.
reason activate\|deactivate\|port-move\|ip-move\|ip-remove\|batch-move\|retire\| break-loop\|break-loop-timeout\|create\|modify\|delete\|policy\|owner-status\| remove-node\|port-flags\|check-owner\| trunk-port-add\|trunk-port-remove\| move-router-if\|age-out\|hw-remove\| restart\|undo\|flush\|update-vxlan-vlan\|needs-peer-status\|owner-lost\| owner-change\|update-peer-only\| user-delete\|done\|vm-metadata\|ND	Specifies the reason for history entry.
last-reason activate\|deactivate\| port-move\|ip-move\|ip-remove\| batch-move\|retire\|break-loop\| break-loop-timeout\|create\|modify\| delete\|policy\|owner-status\| remove-node\|port-flags\|check-owner\|trunk-port-add\|trunk-port-remove\|move-router-if\|age-out\| hw-remove\|restart\| undo\|flush\|update-vxlan-vlan\|needs-peer-status\|owner-lost\|owner-change\|update-peer-only\| user-delete\|done\|vm-metadata\|ND	Specifies the most recent reason for this entry.
changes owner\|mac\|ip\|num-ips\|config-intf\|intf\|ports\|state\|local-intf\|local-ports\|local-state\|hostname\|hypervisor\|vm-id\|vm-name\|vm-flavor\|vm-status \|memory\|cpus\|disk\|os\|config\| blocked-port\|rem-switch\|rem-intf\| rem-ports\|peer-intf\|peer-state\|status\|tunnel\|create-time\|last-seen\| vxlan-lru\|hit\|migrate\|drops\|hw-index\|rt-if\|hw-flags\|ND	Specifies what changed in this entry.
count count-number	Filter output by the number of entries summed using the sum-by argument.
owner node name
mac mac-address	Filter output by the Filter output by MAC address.
vnet vnet-name	Filter output by VNET name.
l2-net l2-net name	Specifies the Layer 2 network.
vlan vlan-id	Filter output by the VLAN ID.
public-vlan vlan-id	Filter output by public VLAN.
vxlan vxlan-id	Filter output by the VXLAN ID.
ip ip-address	Filter output by the IP address.
num-ips num-ips-number	Specify the number of IP addresses for the Layer 2 entry.
config-intf config-intf-number	Filter output by the configured interface of the Layer 2 entry.
intf intf-number	Filter output by the interface number. This is the port or trunk number of the Layer 2 entry.
ports port-list	Filter output by the list of ports.
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\|pdate-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	Filter output by the state of the Layer 2 entry.
svc-name svc-name-string	Filter output by service name.
hostname hostname-string	Filter output by the host name.
entity entity-string	Filter output by the VM or VM Kernel device name.
power none\|powered-off\|powered-on\|standby\|suspended\|unknown	Filter by the vPort power status.
portgroup portgroup-string	Filter by the port group.
pg-vlans vlan-list	Filter by port group VLANs.
vswitch vswitch-string	Filter output by vSwitch name associated with VM MAC address.
vs-type none\|host-vs\|distributed-vs\|unknown	Filter output by vSwitch type.
vnic-type untagged\|tagged\|trunked\|vm-mgmt\|vm-kernel\|vMotion\|vSAN\|FTL\| rep\|p-NFC\|r-NFC\|mgmt\|unknown	Filter output by VNIC type.
memory memory-number	Filter output by the amount of memory assigned to the VM.
cpus cpus-number	Filter output by the number of CPUs assigned to the VM.
disk disk-number	Filter output by the disk number where the VM is installed.
os os-string	Filter output by the OS installed on the VM.
config none\|owner\|ip\|port\|hostname\| hypervisor\|vm-id\|vm-name\| vm-flavor\| memory\|cpus\|disk\|os	Filter output by the configuration of the VM.
rem-switch node name	Filter output by the remote switch name.
rem-intf rem-intf-number	Filter output by the remote interface number.
rem-ports port-list	Filter output by the remote ports.
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	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	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\|vm-kernel\|vm\|pnic\|vle-wait\|phy-down\|down\|enabled\|err-disabled\|err-bpdu-guard\|mac-violation\| stp-bpdu-guard\|stp-root-guard	Filter output by the status of the Layer 2 entry.
vtep-ip ip-address	Specifies the IP address of the remote VTEP.
tunnel tunnel-string	Filter output by the tunnel name.
create-time date/time: yyyy-mm-ddTHH:mm:ss	Filter output by the time that the vPort was created.
last-seen date/time: yyyy-mm-ddTHH:mm:ss	Filter output by the time that the vPort was last seen on the fabric.
vxlan-lru date/time: yyyy-mm-ddTHH:mm:ss	Filter output by the number of received hits.
hit hit-number	Filter output by the number of times that the vPort migrated on the fabric.
migrate migrate-number	Filter output by the number of drops on the fabric.
drops drops-number	Filter output by the time that the vPort was created.
hw-index hw-index-number	Filter output by the hardware index number.
rt-if rt-if-string	Filter by the router interface.
hw-flags invalid-vlan\|invalid-port	Filter by hardware flags.
mc-index mc-index-number	Specifies the multicast group index in hardware.

Defaults None

Access CLI

History

Version 2.3.2	Command introduced.
Version 2.4	The parameters, peer-, hw-index, and rf-if added.
Version 2.6.2	New parameters added. Some parameters removed, vm-id, hypervisor, vm-name, vm-flavor, and vm-status.
Version 3.1.0	The parameters, ND and vtep-ip, added.

Usage Use this command to display history of Layer 2 entries.

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

CLI network-admin@switch > l2-history-show

time: 09:02:33

log-type: l2-modify

caller: router

reason: activate,create

owner: pleaides24

mac: 66:0e:94:f4:ec:6e

vlan: 1

ip: 192.168.16.24

ports: 65

state: active,static

hostname: pleiades-tib

status: host

l2-net-port-add (deprecated)

l2-net-port-remove (deprecated)

l2-net-port-show (deprecated)

l2-setting-modify

This command modifies the Layer 2 settings in the configuration.

Syntax l2-setting-modify

aging-time seconds	Configures the aging time in Layer 2. You can configure a value from 1 to 2000000. The default value is 300 seconds.
software-aging\| no-software-aging	Specify if you want to enable software aging or not. This is ON by default. This parameter controls how the aging of the L2 table entries is performed by Netvisor. When OFF, the aging is performed by the Ethernet switch ASIC. It is not recommended to change this setting.
l2-max-count l2-max-count-number	Specify the maximum count for Layer 2 entries.
l2-checker\|no-l2-checker	Specify if you want to enable Layer 2 checker.
l2-checker-interval duration: #d#h#m#	Specify the interval between Layer 2 checks.
l3-arp-max-count l3-arp-max-count-number	Specify the number of maximum ARPs for Layer 3 entries.

Defaults None.

Access CLI

History

Version 1.2	Command introduced.
Version 2.4	The parameters, software-aging, l2-checker and l2-checker-interval added.
Version 5.1.1	The parameter, l2-max-count, added.

Usage Use this command to modify the Layer 2 aging time in seconds.

Examples To modify the aging time to 360 seconds, use the following command:

CLI network-admin@switch > l2-setting-modify aging-time 360

l2-setting-show

This commands displays the Layer 2 settings in the configuration.

Syntax l2-setting-show

Defaults None.

Access CLI

History Command introduced in nvOS Version 1.2.1.

Usage Use this command to display information about Layer 2 settings.

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

CLI network-admin@switch > l2-setting-show

switch: Pleiades24

aging-time(s): 300

l2-max-count: 1300000

l2-cur-count: 36

l2-active-count: 13

l2-max-mem: 1.81G

l2-cur-mem: 32.6K

l3-arp-max-count: 1300000

l3-arp-cur-count: 7

l3-arp-max-mem: 624M

l3-arp-cur-mem: 2.13K

switch: Pleiades25

aging-time(s): 300

l2-max-count: 1300000

l2-cur-count: 36

l2-active-count: 14

l2-max-mem: 1.81G

l2-cur-mem: 32.6K

l3-arp-max-count: 1300000

l3-arp-cur-count: 7

l3-arp-max-mem: 624M

l3-arp-cur-mem: 2.13K

l2-static-multicast-group-create

This command is used to create a Layer 2 static multicast group. Hosts join multicast groups either by sending an unsolicited IGMP join message or by sending an IGMP join message in response to a general query from a multicast router (the switch forwards general queries from multicast routers to all ports in a VLAN). When you specify group membership for a multicast group address statically, the static setting supersedes any IGMP snooping learning. Multicast group membership lists can consist of both static and IGMP snooping-learned settings.

Syntax l2-static-multicast-group-create

group-mac mac-address	Specify a MAC address for the multicast group.
vlan vlan-id	Specify a VLAN ID for the multicast group.
ports port-list	Specify a list of ports for the multicast group.

Defaults None

Access network-admin

History Command introduced in Version 2.3.

Usage Use this command to create a Layer 2 static multicast group.

Examples To create a L2 static multicast group on MAC address, 0050.3e8d.6400, VLAN 25, and ports 10-12, use the following syntax:

CLI network-admin@switch > l2-static-multicast-group-create group-mac 0050.3e8d.6400 vlan 25 ports 10-12

l2-static-multicast-group-delete

This command is used to delete a Layer 2 static multicast group. Hosts join multicast groups either by sending an unsolicited IGMP join message or by sending an IGMP join message in response to a general query from a multicast router (the switch forwards general queries from multicast routers to all ports in a VLAN). When you specify group membership for a multicast group address statically, the static setting supersedes any IGMP snooping learning. Multicast group membership lists can consist of both static and IGMP snooping-learned settings.

Syntax l2-static-multicast-group-create group-mac mac-address vlan vlan-id

group-mac mac-address	Specify a MAC address for the multicast group.
vnet vnet-name	Specifies the IP address of the entry.
l2-net l2-net name	Specifies the Layer 2 network.
vlan vlan-id	Specify a VLAN ID for the multicast group.

Defaults None

Access network-admin

History

Version 2.3	Command introduced.
Version 3.0.0	The parameters, vnet and l2-net, added.

Usage Use this command to delete a Layer 2 static multicast group.

Examples To delete a L2 static multicast group on MAC address, 0050.3e8d.6400 and VLAN 25, use the following syntax:

CLI network-admin@switch > l2-static-multicast-group-delete group-mac 0050.3e8d.6400 vlan 25 ports 10-12

l2-static-multicast-group-show

This command is used to display information about a Layer 2 static multicast group. Hosts join multicast groups either by sending an unsolicited IGMP join message or by sending an IGMP join message in response to a general query from a multicast router (the switch forwards general queries from multicast routers to all ports in a VLAN). When you specify group membership for a multicast group address statically, the static setting supersedes any IGMP snooping learning. Multicast group membership lists can consist of both static and IGMP snooping-learned settings.

Syntax l2-static-multicast-group-show

group-mac mac-address	Specify a MAC address for the multicast group.
vnet	Specifies VNETs.
l2-net l2-net name	Specifies the Layer 2 network.
vlan vlan-id	Specify a VLAN ID for the multicast group.
ports port-list	Specify a list of ports for the multicast group.

Defaults None

Access network-admin

History

Version 2.3	Command introduced.
Version 3.0.0	The parameters, vnet and l2-net, added.

Usage Use this command to display a Layer 2 static multicast group.

Examples To display a L2 static multicast group on MAC address, 0050.3e8d.6400, VLAN 25, and ports 10-12, use the following syntax:

CLI network-admin@switch > l2-static-multicast-group-show group-mac 0050.3e8d.6400 vlan 25 ports 10-12

l2-table-flush

This command is used to clear information about the Layer 2 settings.

Syntax l2-table-flush [vlan vlan-id] [port port-list]

Specify either zero or both options:
mac mac-address	Specifies the MAC address.
vlan vlan-id	Specifies the VLAN identifier.
ports port-list	Specifies the port list.

Defaults None

Access CLI

History Command introduced in nvOS Version 1.2.1.

Usage Used to flush the Layer 2 information.

Examples To flush the Layer 2 table information from VLAN 25, use the following command:

CLI network-admin@switch > l2-table-flush vlan 25

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\|hsrp\|nvalid-vlan\|owner-lost\|cluster-link-down\|vxlan-router	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\|\|nvalid-vlan\|owner-lost\|cluster-link-down\|vxlan-router	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\|invalid-vlan\|owner-lost\|cluster-link-down\|vxlan-router	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\|\|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

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