Tip

This is the documentation for the 23.11 version. Looking for the documentation of the latest version? Have a look here.

Viewing Status Information

Status information can be viewed using the show command from either basic or configuration mode.

For a full list of possible show commands, enter show ?:

tnsr# show ?
  acl                    Access Control Lists
  acl-based-forwarding   ACL Based Forwarding (ABF)
  bfd                    Bidirectional Forwarding Detection
  cli                    State of per-session CLI options
  clock                  Show the current system date and time
  configuration          Config DB configuration state
  dataplane              Dataplane
  documentation          Documentation URLs
  gre                    GRE tunnels
  history-config         Show history configuration
  host                   Host information
  interface              Interface details
  ip                     Internet protocol
  ipsec                  IPsec
  kea                    Kea/DHCP
  macip                  MACIP Access Control Lists
  map                    MAP-E/MAP-T
  nacm                   NACM data
  nat                    Network Address Translation
  neighbor               Neighbors (ARP/NDP)
  ntp                    NTP
  packet-counters        Packet statistic and error counters
  prometheus
  radius                 Radius
  route                  Show routing information
  running-configuration  Running DB CLI configuration state
  span                   SPAN mirrors
  sysctl                 Sysctl parameters
  system                 System information
  trace                  Packet trace
  tunnel                 VPN Tunnel
  unbound                Unbound DNS
  version                Show version of system components
  vxlan                  VXLAN tunnels
  wireguard              Wireguard

Example:

tnsr# show version

Version: tnsr-v21.03-2
Build timestamp: Thu Mar  4 10:24:34 2021 CST

The behavior of each show command is covered in relevant sections of the documentation.

Output Modifiers

show commands support a limited set of output modifiers which are invoked by adding a pipe character (|) after the command followed by one of the supported modifiers and its arguments. These include:

  • | match <pattern>

  • | exclude <pattern>

  • | tail <num>

  • | count

Warning

When using output modifiers there must be a space before and after the pipe character (|). For example, a | b is valid, but a|b is invalid.

Match

The | match <pattern> modifier filters the output to lines matching the given pattern. The pattern supports some regular expression conventions such as using . to match any single character, .* to match any string, and | between multiple patters to match any of the given patterns.

Tip

Some pattern components may need a leading backslash, such as \. to match a literal period character. The \ must be typed twice as the first press escapes the second.

Example:

tnsr# show route table ipv4-VRF:0 | match 10\.30\.
10.30.0.1/24       via                    LAN weight 1 preference 0
10.30.0.1/32       via 10.30.0.1          local LAN weight 1 preference 0
10.30.1.1/24       via                    DMZ weight 1 preference 0
10.30.1.1/32       via 10.30.1.1          local DMZ weight 1 preference 0

Exclude

The | exclude <pattern> modifier filters the output such that it excludes lines matching the given pattern.

Example:

tnsr# show route table ipv4-VRF:0 | exclude 10\.30\.

Route Table ipv4-VRF:0  AF: ipv4  ID: 0
-----------------------------------------
0.0.0.0/0          via 203.0.113.1        WAN weight 1 preference 0
10.15.30.2/24      via                    FIBER weight 1 preference 0
10.15.30.2/32      via 10.15.30.2         local FIBER weight 1 preference 0
203.0.113.30/24    via                    WAN weight 1 preference 0
203.0.113.30/32    via 203.0.113.30       local WAN weight 1 preference 0

Tail

The | tail <num> modifier filters the output so only the last <num> lines of the output are returned.

Example:

tnsr# show route table ipv4-VRF:0 | tail 2
203.0.113.30/24    via                    WAN weight 1 preference 0
203.0.113.30/32    via 203.0.113.30       local WAN weight 1 preference 0

Count

The | count modifier does not print any of the output, instead it prints a count indicating the number of lines in the output.

Example:

tnsr# show route table ipv4-VRF:0 | count
12

Note

The count also includes any leading or trailing blank lines in the output.