Cisco Catalyst SD-WAN Command Reference

Overview of Command Filters for CLI Operational Commands
append	Append the command output to a file.
begin	Display the command output beginning with the line that contains the specified string. The string is case-sensitive.
best-effort	Display the command output or continue loading a file even if some kind of failure has occurred that might interfere with the process.
context-match	Display the upper hierarchy in which a command or string appears in the configuration.
count	Count the number of lines in the command output. The count of lines includes the line on which you type the command.
de-select	Do not display a field in the command output.
details	Display the default values for commands in the running configuration.
display xml	Render the command output as XML.
exclude	Exclude the lines that contain the string defined by the regular expression from the command output.
include	Include only the lines that contain the string defined by the regular expression in the command output.
linnum	Number the lines in the command output. This command effectively counts the numbers of lines in the output.
match-all	Display the command output that matches all command-output filters.
match-any	Display the command output that matches any one of the command-output filters.
more	Paginate the command output. This is the default behavior.
nomore	Do not paginate command output.
notab	Display tabular command output in a list rather than in a table.
repeat	Redisplay the output of a show command periodically.
save	Save the command output to a file.
select	Display fields to display in the command output.
sort-by	Arrange the command output based on the values in a particular field.
tab	Display tabular command output in table even if the table is wider than the width of the screen.
until	Display the command output, ending with the line that contains the specified string. The string is case-sensitive.

Overview of Command Filters for CLI Operational Commands

This section describes the command filters you can use with CLI operational commands to modify operational command output or redirect the output to a file. To enter the filters, type a pipe (|) at the end of the command and then type the filter. You can include multiple filters after a command. Precede each filter with a pipe symbol.

The CLI filter commands are:

append
begin
best-effort
context-match
count
de-select
details
display xml
exclude
include
match-all
match-any
more
nomore
notab
repeat
save
select
sort-by
tab
until

Note that not all filters are available with all commands.

append

Append the command output to a file.

append filename

Syntax Description


`filename`	Name of File: Append the command output to the specified filename.

Command History


Release	Modification
14.1	Command introduced.

Example

Example 1

vedge1# show interface | append interface-file
vedge1# file list
interface-file
vedge1

begin

Display the command output beginning with the line that contains the specified string. The string is case-sensitive.

begin string

Syntax Description


`string`	String to Match: Text string to find to start displaying command output. The string is case-sensitive.

Command History


Release	Modification
14.1	Command introduced.

Example

Example 1

vedge# show ip route 
Codes Protocol:                         <-- These 11 lines explain the values in the output.
  C -> connected, S -> static               
  O -> ospf, B -> bgp
  M -> omp
Codes Proto-sub-type:
  IA -> ospf-inter-area
  E1 -> ospf-external1, E2 -> ospf-external2
  N1 -> ospf-nssa-external1, N2 -> ospf-nssa-external2
  e -> bgp-external, i -> bgp-internal
Codes Rstatus flags:
  F -> fib, S -> selected
                                PROTOCOL  NEXTHOP  NEXTHOP                                    
VPN  ROUTE            PROTOCOL  SUB TYPE  IFNAME   ADDR       TLOC IP  COLOR  ENCAP  RSTATUS  
----------------------------------------------------------------------------------------------
0    0.0.0.0/0        S         -         ge0/0    10.0.11.3  -        -      -      F,S      
0    10.0.11.0/24     C         -         ge0/0    -          -        -      -      F,S      
0    10.0.100.0/24    C         -         ge0/7    -          -        -      -      F,S      
0    172.16.255.1/32  C         -         system   -          -        -      -      F,S      

vedge# show ip route | begin PROTOCOL     <-- Display only the IP routes, without the key.
                                             
                                PROTOCOL  NEXTHOP  NEXTHOP                                    
VPN  ROUTE            PROTOCOL  SUB TYPE  IFNAME   ADDR       TLOC IP  COLOR  ENCAP  RSTATUS  
----------------------------------------------------------------------------------------------
0    0.0.0.0/0        S         -         ge0/0    10.0.11.3  -        -      -      F,S      
0    10.0.11.0/24     C         -         ge0/0    -          -        -      -      F,S      
0    10.0.100.0/24    C         -         ge0/7    -          -        -      -      F,S      
0    172.16.255.1/32  C         -         system   -          -        -      -      F,S

best-effort

Display the command output or continue loading a file even if some kind of failure has occurred that might interfere with the process.

best-effort

Syntax Description

None

Command History


Release	Modification
14.1	Command introduced.

context-match

Display the upper hierarchy in which a command or string appears in the configuration.

context-match string

Syntax Description


`string`	String To Match: Characters from the output to match.

Command History


Release	Modification
14.2	Command introduced.

Example

Example 1

vm5# show running-config | context-match ospf
vpn 1
  ospf

count

Count the number of lines in the command output. The count of lines includes the line on which you type the command.

count

Syntax Description

None

Command History


Release	Modification
14.1	Command introduced.

Example

Example 1

hw-vedge# show ip routes vpn 0
Codes Proto-sub-type:
  IA -> ospf-inter-area,
  E1 -> ospf-external1, E2 -> ospf-external2,
  N1 -> ospf-nssa-external1, N2 -> ospf-nssa-external2,
  e -> bgp-external, i -> bgp-internal
Codes Status flags:
  F -> fib, S -> selected, I -> inactive,
  B -> blackhole, R -> recursive

                        PATH             PROTOCOL          NEXTHOP                                                
VPN  PREFIX             ID    PROTOCOL   SUB TYPE  METRIC  IFNAME   NEXTHOP ADDR    TLOC IP  COLOR  ENCAP  STATUS 
-------------------------------------------------------------------------------------------------------------------
0    0.0.0.0/0          0     Static     -         0       ge0/0    50.197.173.190  -        -      -      F,S    
0    1.1.1.254/32       1     Connected  -         1       system   -               -        -      -      F,S    
0    50.197.173.184/29  2     Connected  -         1       ge0/0    -               -        -      -      F,S

hw-vedge# show ip routes vpn 0 | begin 0 | count
Count: 4 lines

de-select

Do not display a field in the command output.

de-select field

Syntax Description


`field`	Column Not To Display: Field not to display in the command output. Use the de-select ? command to determine the possible completions for each command.

Command History


Release	Modification
14.1	Command introduced.

Example

Example 1

hw-vedge# show ospf neighbor            
DBsmL -> Database Summary List
RqstL -> Link State Request List
RXmtl -> Link State Retransmission List
                   IF     IF                                DEAD                       
VPN  ADDRESS       INDEX  NAME   NEIGHBOR ID    STATE  PRI  TIME  DBsmL  RqstL  RXmtL  
---------------------------------------------------------------------------------------
1    10.10.10.2    0      ge0/3  11.11.11.1     full   1    38    0      0      0      

hw-vedge# show ospf neighbor | de-select ?
Description: List of neighbors
Possible completions:
  area                          Area
  area-type                     Area Type
  backup-designated-router-id   Backup designated Router ID
  db-summary-list               Database summary list
  dead-interval-timer           Dead interval timer(Secs)
  designated-router-id          Designated Router ID
  if-address                    Interface address
  if-name                       Interface Name
  interface-state               Interface state
  link-state-req-list           Link state request list
  link-state-retrans-list       Link state retransmission list
  neighbor-state                Neighbor state
  options                       ospf neighbor options : O|DN|DC|E|EA|MC|T|NP
  priority                      Priority
  progressive-change-time       Progressive change time(Secs)
  regressive-change-reason      Regressive change reason
  regressive-change-time        Regressive change time(Secs)
  router-id                     Neighbor ID
  state-changes                 Number of state changes
  
hw-vedge# show ospf neighbor | de-select db-summary-list 
DBsmL -> Database Summary List
RqstL -> Link State Request List
RXmtl -> Link State Retransmission List
                   IF     IF                                DEAD                
VPN  ADDRESS       INDEX  NAME   NEIGHBOR ID    STATE  PRI  TIME  RqstL  RXmtL  
--------------------------------------------------------------------------------
1    10.10.10.2    0      ge0/3  11.11.11.1     full   1    35    0      0

details

Display the default values for commands in the running configuration.

details

Syntax Description

None

Command History


Release	Modification
14.2	Command introduced.

Examples

Example 1

vm5# show running-config system logging
system
 logging
  disk
   enable
  !
 !
!
vm5# show running-config system logging | details
system
 logging
  disk
   enable
   file size 10
   file rotate 10
   priority information
  !
 !
!

Example 2

vm5# show running-config vpn 1 
vpn 1
 name ospf_and_bgp_configs
 router
  ospf
   router-id 172.16.255.15
   timers spf 200 1000 10000
   redistribute static
   redistribute omp
   area 0
    interface ge0/4
    exit
   exit
  !
  pim
   interface ge0/5
   exit
  exit
 !
 interface ge0/4
  ip address 10.20.24.15/24
  no shutdown
 !
 interface ge0/5
  ip address 56.0.1.15/24
  no shutdown
 !
!
vm5# show running-config vpn 1 | details 
vpn 1
 name ospf_and_bgp_configs
 no ecmp-hash-key layer4
 router
  ospf
   router-id 172.16.255.15
   auto-cost reference-bandwidth 100
   compatible rfc1583
   distance external 0
   distance inter-area 0
   distance intra-area 0
   timers spf 200 1000 10000
   redistribute static
   redistribute omp
   area 0
    interface ge0/4
     hello-interval      10
     dead-interval       40
     retransmit-interval 5
     priority            1
     network             broadcast
    exit
   exit
  !
  pim
   no shutdown
   no auto-rp
   interface ge0/5
    hello-interval      30
    join-prune-interval 60
   exit
  exit
 !
 interface ge0/4
  ip address 10.20.24.15/24
  flow-control        autoneg
  no clear-dont-fragment
  no pmtu
  mtu                 1500
  no shutdown
  arp-timeout         1200
 !
 interface ge0/5
  ip address 56.0.1.15/24
  flow-control        autoneg
  no clear-dont-fragment
  no pmtu
  mtu                 1500
  no shutdown
  arp-timeout         1200
 !
!

display xml

Render the command output as XML.

display xml

Syntax Description

None

Command History


Release	Modification
14.1	Command introduced.

Example

Example 1

vedge1# show control local-properties | display xml
<config xmlns="http://tail-f.com/ns/config/1.0">
  <control xmlns="http://viptela.com/security">
  <local-properties>
    <device-type>vedge</device-type>
    <organization-name></organization-name>
    <certificate-status>Not-Installed</certificate-status>
    <root-ca-chain-status>Not-Installed</root-ca-chain-status>
    <dns-name>10.0.14.4</dns-name>
    <site-id>1</site-id>
    <domain-id>1</domain-id>
    <system-ip>172.16.255.1</system-ip>
    <keygen-interval>0:01:00:00</keygen-interval>
    <number-vbond-peers>0</number-vbond-peers>
    <number-active-wan-interfaces>1</number-active-wan-interfaces>
    <wan-interface-list>
      <index>0</index>
      <public-ip>0.0.0.0</public-ip>
      <public-port>0</public-port>
      <private-ip>10.0.11.1</private-ip>
      <private-port>12346</private-port>
      <num-vsmarts>0</num-vsmarts>
      <weight>1</weight>
      <color>default</color>
      <preference>0</preference>
      <admin-state>unknown</admin-state>
      <operation-state>unknown</operation-state>
    </wan-interface-list>
  </local-properties>
  </control>
</config>

exclude

Exclude the lines that contain the string defined by the regular expression from the command output.

exclude regular-expression

Syntax Description


`regular-expression`	String to Match: String to match when excluding lines from the command output.

Command History


Release	Modification
14.1	Command introduced.

Example

Example 1

hw-vedge# show interface vpn 0                                         
                                 IF      IF                                                                                                 
                                 ADMIN   OPER    ENCAP                                      SPEED                       RX        TX        
VPN  INTERFACE  IP ADDRESS       STATUS  STATUS  TYPE   PORT TYPE  MTU   HWADDR             MBPS   DUPLEX  UPTIME       PACKETS   PACKETS   
--------------------------------------------------------------------------------------------------------------------------------------------
0    ge0/0      10.0.0.1/24      Up      Up      null   transport  1500  00:0c:bd:05:df:b7  100    full    11:04:15:07  14549495  12435677  
0    ge0/1      -                Down    Down    null   service    1500  00:0c:bd:05:df:b8  -      -       -            0         0         
0    ge0/2      -                Down    Down    null   service    1500  00:0c:bd:05:df:b5  -      -       -            0         0         
0    ge0/4      -                Down    Down    null   service    1500  00:0c:bd:05:df:bb  -      -       -            0         0         
0    ge0/5      -                Down    Down    null   service    1500  00:0c:bd:05:df:bc  -      -       -            0         0         
0    ge0/6      -                Down    Down    null   service    1500  00:0c:bd:05:df:b9  -      -       -            0         0         
0    ge0/7      -                Down    Down    null   service    1500  00:0c:bd:05:df:ba  -      -       -            0         0         
0    system     1.1.1.3/32       Up      Up      null   loopback   1500  00:00:00:00:00:00  10     full    11:04:15:17  0         0              

hw-vedge# show interface vpn 0 | exclude IF | exclude ADMIN | exclude VPN | exclude ---
0    ge0/0      10.0.0.1/24   Up      Up      null   transport  1500  00:0c:bd:05:df:b7  100    full    11:04:15:31  14549857  12435986  
0    ge0/1      -             Down    Down    null   service    1500  00:0c:bd:05:df:b8  -      -       -            0         0         
0    ge0/2      -             Down    Down    null   service    1500  00:0c:bd:05:df:b5  -      -       -            0         0         
0    ge0/4      -             Down    Down    null   service    1500  00:0c:bd:05:df:bb  -      -       -            0         0         
0    ge0/5      -             Down    Down    null   service    1500  00:0c:bd:05:df:bc  -      -       -            0         0         
0    ge0/6      -             Down    Down    null   service    1500  00:0c:bd:05:df:b9  -      -       -            0         0         
0    ge0/7      -             Down    Down    null   service    1500  00:0c:bd:05:df:ba  -      -       -            0         0         
0    system     1.1.1.3/32    Up      Up      null   loopback   1500  00:00:00:00:00:00  10     full    11:04:15:41  0         0

include

Include only the lines that contain the string defined by the regular expression in the command output.

include regular-expression

Syntax Description


`regular-expression`	String to Match: String to match when including lines from the command output.

Command History


Release	Modification
14.1	Command introduced.

Example

Example 1

hw-vedge# show interface vpn 0 | include 10.1.1.8/24
0    ge0/0      10.0.0.1/24   Up      Up      null   transport  1500  00:0c:bd:05:df:b7  100    full    11:04:20:18  14554291  12439750

linnum

Number the lines in the command output. This command effectively counts the numbers of lines in the output.

linnum

Syntax Description

None

Command History


Release	Modification
14.1	Command introduced.

Example

Example 1

hw-vedge# show interface vpn 0 | linnum1: 
2:                               IF      IF                                                                                                 
3:                               ADMIN   OPER    ENCAP                                      SPEED                       RX        TX        
4: VPN  INTERFACE  IP ADDRESS    STATUS  STATUS  TYPE   PORT TYPE  MTU   HWADDR             MBPS   DUPLEX  UPTIME       PACKETS   PACKETS   
5: -----------------------------------------------------------------------------------------------------------------------------------------
6: 0    ge0/0      10.0.0.1/24   Up      Up      null   transport  1500  00:0c:bd:05:df:b7  100    full    11:04:22:04  14555968  12441172  
7: 0    ge0/1      -             Down    Down    null   service    1500  00:0c:bd:05:df:b8  -      -       -            0         0         
8: 0    ge0/2      -             Down    Down    null   service    1500  00:0c:bd:05:df:b5  -      -       -            0         0         
9: 0    ge0/4      -             Down    Down    null   service    1500  00:0c:bd:05:df:bb  -      -       -            0         0         
10: 0    ge0/5      -             Down    Down    null   service    1500  00:0c:bd:05:df:bc  -      -       -            0         0         
11: 0    ge0/6      -             Down    Down    null   service    1500  00:0c:bd:05:df:b9  -      -       -            0         0         
12: 0    ge0/7      -             Down    Down    null   service    1500  00:0c:bd:05:df:ba  -      -       -            0         0         
13: 0    system     1.1.1.3/32    Up      Up      null   loopback   1500  00:00:00:00:00:00  10     full    11:04:22:14  0

match-all

Display the command output that matches all command-output filters.

match-all

Syntax Description

None

Command History


Release	Modification
14.1	Command introduced.

Example

Example 1

vm9# show control connections
                                                                   PEER                      PEER                                                    
PEER     PEER             SITE        DOMAIN      PEER             PRIVATE  PEER             PUBLIC                                                  
TYPE     SYSTEM IP        ID          ID          PRIVATE IP       PORT     PUBLIC IP        PORT    REMOTE COLOR     STATE           UPTIME         
-----------------------------------------------------------------------------------------------------------------------------------------------------
vedge    172.16.255.11    100         1           10.0.5.11        12346    10.0.5.11        12346   lte              up              0:02:31:49     
vedge    172.16.255.21    100         1           10.0.5.21        12346    10.0.5.21        12346   lte              up              0:02:31:49     
vedge    172.16.255.14    400         1           10.1.14.14       12350    10.1.14.14       12350   lte              up              0:02:31:52     
vedge    172.16.255.15    500         1           10.1.15.15       12346    10.1.15.15       12346   lte              up              0:02:31:51     
vedge    172.16.255.16    600         1           10.1.16.16       12346    10.1.16.16       12346   lte              up              0:02:31:50     
vsmart   172.16.255.20    200         1           10.0.12.20       12346    10.0.12.20       12346   default          up              0:02:31:40     
vbond    -                0           0           10.1.14.14       12346    10.1.14.14       12346   default          up              0:02:31:54

vm9# show control connections | select remote-color default | match-all
                                                                   PEER                      PEER                                                    
PEER     PEER             SITE        DOMAIN      PEER             PRIVATE  PEER             PUBLIC                                                  
TYPE     SYSTEM IP        ID          ID          PRIVATE IP       PORT     PUBLIC IP        PORT    REMOTE COLOR     STATE           UPTIME         
-----------------------------------------------------------------------------------------------------------------------------------------------------
vsmart   172.16.255.20    200         1           10.0.12.20       12346    10.0.12.20       12346   default          up              0:02:33:42     
vbond    -                0           0           10.1.14.14       12346    10.1.14.14       12346   default          up              0:02:33:56

match-any

Display the command output that matches any one of the command-output filters. Matching any is the default behavior when matching command output.

match-any

Syntax Description

None

Command History


Release	Modification
14.1	Command introduced.

Example

Example 1

vm9# show control connections
                                                                   PEER                      PEER                                                    
PEER     PEER             SITE        DOMAIN      PEER             PRIVATE  PEER             PUBLIC                                                  
TYPE     SYSTEM IP        ID          ID          PRIVATE IP       PORT     PUBLIC IP        PORT    REMOTE COLOR     STATE           UPTIME         
-----------------------------------------------------------------------------------------------------------------------------------------------------
vedge    172.16.255.11    100         1           10.0.5.11        12346    10.0.5.11        12346   lte              up              0:02:31:49     
vedge    172.16.255.21    100         1           10.0.5.21        12346    10.0.5.21        12346   lte              up              0:02:31:49     
vedge    172.16.255.14    400         1           10.1.14.14       12350    10.1.14.14       12350   lte              up              0:02:31:52     
vedge    172.16.255.15    500         1           10.1.15.15       12346    10.1.15.15       12346   lte              up              0:02:31:51     
vedge    172.16.255.16    600         1           10.1.16.16       12346    10.1.16.16       12346   lte              up              0:02:31:50     
vsmart   172.16.255.20    200         1           10.0.12.20       12346    10.0.12.20       12346   default          up              0:02:31:40     
vbond    -                0           0           10.1.14.14       12346    10.1.14.14       12346   default          up              0:02:31:54

vm9# show control connections | select remote-color default | match-any    
                                                                   PEER                      PEER                                                    
PEER     PEER             SITE        DOMAIN      PEER             PRIVATE  PEER             PUBLIC                                                  
TYPE     SYSTEM IP        ID          ID          PRIVATE IP       PORT     PUBLIC IP        PORT    REMOTE COLOR     STATE           UPTIME         
-----------------------------------------------------------------------------------------------------------------------------------------------------
vsmart   172.16.255.20    200         1           10.0.12.20       12346    10.0.12.20       12346   default          up              0:02:33:38     
vbond    -                0           0           10.1.14.14       12346    10.1.14.14       12346   default          up

more

Paginate the command output. This is the default behavior.

more

Syntax Description

None

Command History


Release	Modification
14.1	Command introduced.

Example

Example 1

hw-vedge# show interface | more                                 IF      IF                                                                                                 
                                 ADMIN   OPER    ENCAP                                      SPEED                       RX        TX        
VPN  INTERFACE  IP ADDRESS       STATUS  STATUS  TYPE   PORT TYPE  MTU   HWADDR             MBPS   DUPLEX  UPTIME       PACKETS   PACKETS   
--------------------------------------------------------------------------------------------------------------------------------------------
0    ge0/0      10.0.0.1/24      Up      Up      null   transport  1500  00:0c:bd:05:df:b7  100    full    11:04:33:54  14566836  12450259  
0    ge0/1      -                Down    Down    null   service    1500  00:0c:bd:05:df:b8  -      -       -            0         0         
0    ge0/2      -                Down    Down    null   service    1500  00:0c:bd:05:df:b5  -      -       -            0         0         
0    ge0/4      -                Down    Down    null   service    1500  00:0c:bd:05:df:bb  -      -       -            0         0         
0    ge0/5      -                Down    Down    null   service    1500  00:0c:bd:05:df:bc  -      -       -            0         0         
0    ge0/6      -                Down    Down    null   service    1500  00:0c:bd:05:df:b9  -      -       -            0         0         
0    ge0/7      -                Down    Down    null   service    1500  00:0c:bd:05:df:ba  -      -       -            0         0         
0    system     1.1.1.3/32       Up      Up      null   loopback   1500  00:00:00:00:00:00  10     full    11:04:34:05  0         0         
1    ge0/3      10.1.1.1/24      Up      Up      null   service    1500  00:0c:bd:05:df:b6  1000   full    11:04:33:52  277881    231784    
--More--

nomore

Do not paginate command output.

nomore

Syntax Description

None

Command History


Release	Modification
14.1	Command introduced.

Example

Example 1

hw-vedge# show interface | nomore
                                 IF      IF                                                                                                 
                                 ADMIN   OPER    ENCAP                                      SPEED                       RX        TX        
VPN  INTERFACE  IP ADDRESS       STATUS  STATUS  TYPE   PORT TYPE  MTU   HWADDR             MBPS   DUPLEX  UPTIME       PACKETS   PACKETS   
--------------------------------------------------------------------------------------------------------------------------------------------
0    ge0/0      10.0.0.1/24      Up      Up      null   transport  1500  00:0c:bd:05:df:b7  100    full    11:04:33:54  14566836  12450259  
0    ge0/1      -                Down    Down    null   service    1500  00:0c:bd:05:df:b8  -      -       -            0         0         
0    ge0/2      -                Down    Down    null   service    1500  00:0c:bd:05:df:b5  -      -       -            0         0         
0    ge0/4      -                Down    Down    null   service    1500  00:0c:bd:05:df:bb  -      -       -            0         0         
0    ge0/5      -                Down    Down    null   service    1500  00:0c:bd:05:df:bc  -      -       -            0         0         
0    ge0/6      -                Down    Down    null   service    1500  00:0c:bd:05:df:b9  -      -       -            0         0         
0    ge0/7      -                Down    Down    null   service    1500  00:0c:bd:05:df:ba  -      -       -            0         0         
0    system     1.1.1.3/32       Up      Up      null   loopback   1500  00:00:00:00:00:00  10     full    11:04:34:05  0         0         
1    ge0/3      10.1.1.1/24      Up      Up      null   service    1500  00:0c:bd:05:df:b6  1000   full    11:04:33:52  277881    231784    
hw-vedge#

notab

Display tabular command output in a list rather than in a table. Note that if tabular command output is wider that the screen width, the output is automatically displayed in a list. Use the tab filter to override this display behavior. Use the screen-width command to set the screen width, or simply drag the terminal window to the desired size. Changing the screen size by dragging the window overrides the width set by the screen-width command.

notab

Syntax Description

None

Command History


Release	Modification
14.1	Command introduced.

Example

Example 1

hw-vedge# show interface vpn 0 | notab
interface vpn 0 interface ge0/0
 ip-address      10.0.0.1/24
 if-admin-status Up
 if-oper-status  Up
 encap-type      null
 port-type       transport
 mtu             1500
 hwaddr          00:0c:bd:05:df:b7
 speed-mbps      100
 duplex          full
 uptime          11:04:40:13
 rx-packets      14572308
 tx-packets      12455087
interface vpn 0 interface ge0/1
 ip-address      -
 if-admin-status Down
 if-oper-status  Down
 encap-type      null
 port-type       service
 mtu             1500
 hwaddr          00:0c:bd:05:df:b8
 rx-packets      0
--More--

repeat

Redisplay the output of a show command periodically.

repeat seconds

Syntax Description


`seconds`	Repeat Time: How often to repeat the command, in seconds. Type Control-C to terminate the display.

Command History


Release	Modification
14.1	Command introduced.

save

Save the command output to a file.

save filename [overwrite]

Syntax Description


`filename`	Name of File: Save the command output in the specified filename.
overwrite	Overwrite the File Contents: Overwrite the contents of an existing file.

Command History


Release	Modification
14.1	Command introduced.

Example

Example 1

vedge1# show interface | save interface-file
vedge1# file list
interface-file
vedge1#

select

Display fields to display in the command output.

select field

Syntax Description


`field`	Field To Add: Field to display in the command output. Use the select ? command to determine the available fields for each command.

Command History


Release	Modification
14.1	Command introduced.

Example

Example 1

vm9# show control connections | select ? Description: Display control connections information
Possible completions:
  local-color           Local Color
  private-ip            Private ip
  private-port          Private port
  remote-color          Remote Color
  rx_challenge          Rx Challenge
  rx_challenge_ack      Rx Challenge Ack
  rx_challenge_resp     Rx Challenge Response
  rx_connects           Rx Connects
  rx_hello              Rx Hello
  rx_register_replies   Rx Register Replies
  rx_registers          Rx Registers
  rx_teardown           Rx Teardown
  state                 State
  system-ip             System IP address
  tx_challenge          Tx Challenge
  tx_challenge_ack      Tx Challenge Ack
  tx_challenge_resp     Tx Challenge Response
  tx_connects           Tx Connects
  tx_hello              Tx Hello
  tx_register_replies   Tx Register Replies
  tx_registers          Tx Registers
  tx_teardown           Tx Teardown
  tx_teardown_all       Tx Teardown all connections
  uptime                Uptime
vm9# show control connections | select state   
                                                                   PEER                      PEER                                                    
PEER     PEER             SITE        DOMAIN      PEER             PRIVATE  PEER             PUBLIC                                                  
TYPE     SYSTEM IP        ID          ID          PRIVATE IP       PORT     PUBLIC IP        PORT    REMOTE COLOR     STATE           UPTIME         
-----------------------------------------------------------------------------------------------------------------------------------------------------
vedge    172.16.255.11    100         1           10.0.5.11        12346    10.0.5.11        12346   lte              up              0:02:32:46     
vedge    172.16.255.21    100         1           10.0.5.21        12346    10.0.5.21        12346   lte              up              0:02:32:46     
vedge    172.16.255.14    400         1           10.1.14.14       12350    10.1.14.14       12350   lte              up              0:02:32:49     
vedge    172.16.255.15    500         1           10.1.15.15       12346    10.1.15.15       12346   lte              up              0:02:32:48     
vedge    172.16.255.16    600         1           10.1.16.16       12346    10.1.16.16       12346   lte              up              0:02:32:47     
vsmart   172.16.255.20    200         1           10.0.12.20       12346    10.0.12.20       12346   default          up              0:02:32:37     
vbond    -                0           0           10.1.14.14       12346    10.1.14.14       12346   default          up              0:02:32:51

sort-by

Arrange the command output based on the values in a particular field.

sort-by field

Syntax Description


`field`	Column Not To Display: Field by which to arrange the command output. Use the sort-by ? command to determine the possible completions for each command.

Command History


Release	Modification
14.1	Command introduced.

Example

Example 1

vm9# show control connections
                                                                   PEER                      PEER                                                    
PEER     PEER             SITE        DOMAIN      PEER             PRIVATE  PEER             PUBLIC                                                  
TYPE     SYSTEM IP        ID          ID          PRIVATE IP       PORT     PUBLIC IP        PORT    REMOTE COLOR     STATE           UPTIME         
-----------------------------------------------------------------------------------------------------------------------------------------------------
vedge    172.16.255.11    100         1           10.0.5.11        12346    10.0.5.11        12346   lte              up              0:01:13:09     
vedge    172.16.255.21    100         1           10.0.5.21        12346    10.0.5.21        12346   lte              up              0:01:13:09     
vedge    172.16.255.14    400         1           10.1.14.14       12350    10.1.14.14       12350   lte              up              0:01:13:07     
vedge    172.16.255.15    500         1           10.1.15.15       12346    10.1.15.15       12346   lte              up              0:01:13:09     
vedge    172.16.255.16    600         1           10.1.16.16       12346    10.1.16.16       12346   lte              up              0:01:13:07     
vsmart   172.16.255.20    200         1           10.0.12.20       12346    10.0.12.20       12346   default          up              0:01:13:21     
vbond    -                0           0           10.1.14.14       12346    10.1.14.14       12346   default          up              0:01:13:23

vm9# show control connections | sort-by site-id
                                                                   PEER                      PEER                                                    
PEER     PEER             SITE        DOMAIN      PEER             PRIVATE  PEER             PUBLIC                                                  
TYPE     SYSTEM IP        ID          ID          PRIVATE IP       PORT     PUBLIC IP        PORT    REMOTE COLOR     STATE           UPTIME         
-----------------------------------------------------------------------------------------------------------------------------------------------------
vbond    -                0           0           10.1.14.14       12346    10.1.14.14       12346   default          up              0:01:23:51     
vedge    172.16.255.11    100         1           10.0.5.11        12346    10.0.5.11        12346   lte              up              0:01:23:37     
vedge    172.16.255.21    100         1           10.0.5.21        12346    10.0.5.21        12346   lte              up              0:01:23:37     
vsmart   172.16.255.20    200         1           10.0.12.20       12346    10.0.12.20       12346   default          up              0:01:23:50     
vedge    172.16.255.14    400         1           10.1.14.14       12350    10.1.14.14       12350   lte              up              0:01:23:35     
vedge    172.16.255.15    500         1           10.1.15.15       12346    10.1.15.15       12346   lte              up              0:01:23:37     
vedge    172.16.255.16    600         1           10.1.16.16       12346    10.1.16.16       12346   lte              up              0:01:23:35

tab

Display tabular command output in table even if the table is wider than the width of the screen. If the command output is wider that the screen width, it wraps onto two or more lines. Use the screen-width command to set the screen width, or simply drag the terminal window to the desired size. Changing the screen size by dragging the window overrides the width set by the cli screen-width command.

tab

Syntax Description

None

Command History


Release	Modification
14.1	Command introduced.

Example

Example 1

vm1# show interface ge0/1
interface vpn 0 interface ge0/1
 ip-address      10.0.26.11/24
 if-admin-status Up
 if-oper-status  Up
 encap-type      null
 port-type       service
 mtu             1500
 hwaddr          00:0c:29:ab:b7:62
 speed-mbps      10
 duplex          full
 uptime          0:00:49:33
 rx-packets      3
 tx-packets      2
vm1# show interface ge0/1 | tab
                               IF      IF                                                                                            
                               ADMIN   OPER    ENCAP  PORT                              SPEED                      RX       TX       
VPN  INTERFACE  IP ADDRESS     STATUS  STATUS  TYPE   TYPE     MTU   HWADDR             MBPS   DUPLEX  UPTIME      PACKETS  PACKETS  
-------------------------------------------------------------------------------------------------------------------------------------
0    ge0/1      10.0.26.11/24  Up      Up      null   service  1500  00:0c:29:ab:b7:62  10     full    0:00:49:46  3        2

until

Display the command output, ending with the line that contains the specified string. The string is case-sensitive.

until string

Syntax Description


`string`	String to Match: Text string to find to start displaying command output. The string is case-sensitive.

Command History


Release	Modification
14.1	Command introduced.

Example

Example 1

hw-vedge# show interface | until 10.0.0.1
                                 IF      IF                                                                                                 
                                 ADMIN   OPER    ENCAP                                      SPEED                       RX        TX        
VPN  INTERFACE  IP ADDRESS       STATUS  STATUS  TYPE   PORT TYPE  MTU   HWADDR             MBPS   DUPLEX  UPTIME       PACKETS   PACKETS   
--------------------------------------------------------------------------------------------------------------------------------------------
0    ge0/0      10.0.0.1/24      Up      Up      null   transport  1500  00:0c:bd:05:df:b7  100    full    11:05:10:21  14598208  1247744

Bias-Free Language

Results

Chapter: Command Filters for CLI Operational Commands

Command Filters for CLI Operational Commands

Overview of Command Filters for CLI Operational Commands

append

Syntax Description

Command History

Example

Example 1

begin

Syntax Description

Command History

Example

Example 1

best-effort

Syntax Description

Command History

context-match

Syntax Description

Command History

Example

Example 1

count

Syntax Description

Command History

Example

Example 1

de-select

Syntax Description

Command History

Example

Example 1

details

Syntax Description

Command History

Examples

Example 1

Example 2

display xml

Syntax Description

Command History

Example

Example 1

exclude

Syntax Description

Command History

Example

Example 1

include

Syntax Description

Command History

Example

Example 1

linnum

Syntax Description

Command History

Example

Example 1

match-all

Syntax Description

Command History

Example

Example 1

match-any

Syntax Description

Command History

Example

Example 1

more

Syntax Description

Command History

Example

Example 1

nomore

Syntax Description

Command History

Example

Example 1