This command is used to display the list of tunnels on the switch.

Syntax   tunnel-show



Displays the ID assigned to the tunnel.

scope local

Displays the scope for the tunnel. Only local scopes are supported.

name name-string

Displays the name of the tunnel.

type ip-in-ip|vxlan|nvgre

Displays the type of tunnel.

vnet vnet-name

Displays the name of the VNET.

vrouter-name vrouter-name

Displays the name of the vRouter service.

peer-vrouter-name vrouter- name

Displays the name of the vRouter service on the cluster peer.

local-ip ip-address

Displays the local IP address.

remote-ip ip-address

Displays the remote IP address.

vrouter-hw-if name 

Displays the router interface.

tunnel-if-name tunnel-if-name-string

Displays the router interface VNIC name.

next-hop ip-address

Displays the next hop IP address.

next-hop mac-address

Displays the next hop MAC address.

next-hop-vlan vlan-id

Displays the next hop VLAN ID.

remote-switch fabric-node-name 

Displays the remote switch for the tunnel.

vrid vrid-number

Displays the vRouter hardware ID.

tunnelID tunnelID-number

Displays the tunnel ID.


Displays the MAC address of the tunnel interface.

interface-vnet vnet name

Displays the VNET name.

bd bridge-domain name

Displays the bridge domain name.

interface-vlan vlan-id

Displays the interface VLAN.

active yes|no

Displays the status of the tunnel.

state init|ok|error

Displays the state of the tunnel.


Displays if BFD is configured.

bfd-state unknown|admin-down|down|init|up|

Displays the state of the BFD session.D

peer-bfd-state unknown|admin-down|down|init|up|no-session|                  not-replicator-vtep

Displays the peer BFD session state.

error error-string 

Displays tunnel errors.

route-info route-info-string

Displays route information.

ecmp-group ecmp-group-number

Displays ECMP group information.

using-vxlan-loopback yes|no

Displays using VXLAN loopback.

ports port-list

Displays the port list.


Displays the nexthop port egress ID.

auto-tunnel auto|static

Displays if the tunnel is automatic or static.


Filter single or multiple route entries per nexthops.

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.2.2

The parameter, type, added.

Version 2.2.3

The parameter router-if replaced name-string with vrouter-hw-if name option.

Version 2.3.1

The parameter, active, added.

Version 2.4

The option, cluster, added to scope. The parameters, vrouter-name and peer-vrouter-name, state, error, route-info, and ecmp-group added.

Version 2.5

The parameter, vnet, added.

Version 3.0.0

The parameter, vrouter-if, deprecated. The parameter, bfd, added.

Usage   Tunnels are used to encapsulate unsupported protocols on a network. Use this command to display a list of tunnels on a fabric.

Examples  To display a list of all tunnels on a switch, use the following command:

CLI network-admin@switch > tunnel-show

See Also