Contents

Basic CLI commands· 1

display [ | [ by-linenum ] { begin | exclude | include } ] 1

display | no-more· 2

display >· 3

display >>· 4

display history-command· 5

display history-command all 6

display hotkey· 7

hotkey· 8

quit 10

repeat 10

return· 12

screen-length disable· 12

system-view· 13

 

Basic CLI commands

display [ | [ by-linenum ] { begin | exclude | include } ]

Use display [ | [ by-linenum ] { begin | exclude | include } to filter the output from a display command with a regular expression.

Syntax

display command [ | { count | [ by-linenum ] { begin | exclude | include } regular-expression &<1-128> } ]&<1-128>

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

command: Specifies the keywords and arguments of a display command. To display available keywords and arguments, enter display ?.

count: Displays the number of all lines in the output from a display command.

by-linenum: Numbers the output lines. You need to specify this keyword in only one filter condition.

begin: Displays the first line matching the specified regular expression and all subsequent lines.

exclude: Displays all lines not matching the specified regular expression.

include: Displays all lines matching the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

&<1-128>: Specifies a maximum of 128 filter conditions.

Usage guidelines

To quickly locate certain lines in the output from a display command, you can use regular expressions to filter the output, and display a number before each output line. For more information about regular expressions, see Fundamentals Configuration Guide.

If you specify multiple filter conditions, the system displays the output lines that meet all the conditions.

A line number is a 5-character string and is typically followed by a colon (:). If you specify both the by-linenum and begin regular-expression options, a line number might be followed by a colon or a hyphen (-).

·     Colon—The line matches the regular expression.

·     Hyphen—The line does not match the regular expression.

Examples

# Display the lines that contain vlan in the running configuration.

<Sysname> display current-configuration | include vlan

vlan 1

vlan 999

 port access vlan 999

# Display log entries in the log buffer that contain both SHELL and VTY.

<Sysname> display logbuffer | include SEHLL | include VTY

%Feb  6 10:38:12:320 2020 Sysname SHELL/5/SHELL_LOGIN: VTY logged in from 169.254.100.171.

%Feb  6 10:52:32:576 2020 Sysname SHELL/5/SHELL_LOGOUT: VTY logged out from 169.254.100.171.

%Feb  6 16:03:27:100 2020 Sysname SHELL/5/SHELL_LOGIN: VTY logged in from 169.254.100.171.

%Feb  6 16:44:18:113 2020 Sysname SHELL/5/SHELL_LOGOUT: VTY logged out from 169.254.100.171.

# Display the running configuration, starting from the first line that contains user-group and numbering the output lines.

<Sysname> display current-configuration | by-linenum begin user-group

  114:  user-group system

  115-  #

  116-  return

# Count the number of lines in the running configuration.

<Sysname> display current-configuration | count

Total lines: 353

display | no-more

Use display | no-more to configure the output from the display command to be displayed in one screen.

Syntax

display command | no-more

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

command: Specifies a command by its keyword. To obtain the value for this argument, enter ?.

Usage guidelines

When you use the display command to display information, you execute this command to configure the output from the display command to be displayed in one screen.

This command is mutually exclusive with the display > and display >> commands.

Only R5212P01 and later versions support this command.

Examples

# Display brief information for all VLANs created on the device and the configure the output to be displayed in one screen.

<Sysname> display vlan brief | no-more

Brief information about all VLANs:

Supported Minimum VLAN ID: 1

Supported Maximum VLAN ID: 4094

Default VLAN ID: 1

VLAN ID   Name                             Port

1         VLAN 0001                        BAGG1  BAGG77

2         VLAN 0002

3         VLAN 0003

4         VLAN 0004

5         VLAN 0005

6         VLAN 0006

7         VLAN 0007

8         VLAN 0008

9         VLAN 0009

10        VLAN 0010

11        VLAN 0011

12        VLAN 0012

13        VLAN 0013

14        VLAN 0014

15        VLAN 0015

16        VLAN 0016

17        VLAN 0017

18        VLAN 0018

19        VLAN 0019

20        VLAN 0020

21        VLAN 0021

22        VLAN 0022

23        VLAN 0023

display >

Use display > to save the output from a display command to a separate file.

Syntax

display command > filename

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

command: Specifies the keywords and arguments of a display command. To display available keywords and arguments, enter display ?.

filename: Specifies the name of the file that is used to save the output, a string of 1 to 63 characters.

Usage guidelines

The display commands show the configuration, statistics, and states of the device. You can use the display > command to save the output to a file.

If the specified file does not exist, the system creates the file and saves the output to the file. If the file already exists, the system overwrites the file.

Examples

# Save VLAN 1 settings to a separate file named vlan.txt.

<Sysname> display vlan 1 > vlan.txt

# Check the content of the vlan.txt file.

<Sysname> more vlan.txt

VLAN ID: 1

 VLAN type: Static

 Route interface: Not configured

 Description: VLAN 0001

 Name: VLAN 0001

 Tagged ports:   None

 Untagged ports:

    HundredGigE1/0/2

display >>

Use display >> to append the output from a display command to the end of a file.

Syntax

display command >> filename

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

command: Specifies the keywords and arguments of a display command. To display available keywords and arguments, enter display ?.

filename: Specifies the name of the file that is used to save the output, a string of 1 to 63 characters.

Usage guidelines

The display commands show the configuration, statistics, and states of the device. You can use display >> to save the output to a file.

If the specified file does not exist, the system creates the file and saves the output to the file. If the file already exists, the system appends the output to the end of the file.

Examples

# Append the VLAN 999 settings to the end of the vlan.txt file.

<Sysname> display vlan 999 >> vlan.txt

<Sysname>

# Check the content of the vlan.txt file.

<Sysname> more vlan.txt

VLAN ID: 1

 VLAN type: Static

 Route interface: Not configured

 Description: VLAN 0001

 Name: VLAN 0001

 Tagged ports:   None

 Untagged ports:

    HundredGigE1/0/2

 

 VLAN ID: 999

 VLAN type: Static

 Route interface: Configured

 IPv4 address: 192.168.2.1

 IPv4 subnet mask: 255.255.255.0

 Description: For LAN Access

 Name: VLAN 0999

 Tagged ports:   None

 Untagged ports:

    HundredGigE1/0/2

display history-command

Use display history-command to display all commands that are saved in the command history buffer for the current CLI session.

Syntax

display history-command

Views

Any view

Predefined user roles

network-admin

network-operator

Usage guidelines

The system automatically saves commands you have successfully executed to the command history buffer for the current CLI session. You can view them and execute them again.

By default, the system can save up to 10 commands in the buffer. You can use the history-command max-size command to change the buffer size. To buffer a new command when the buffer is full, the system deletes the oldest command entry in the buffer.

All commands in the command history buffer for the current CLI session will be cleared when you log out.

If the command history buffer contains password configuration commands, the passwords are displayed as asterisks (******) for security purposes.

Examples

# Display all commands saved in the command history buffer for the current CLI session.

<Sysname> display history-command

  system-view

  vlan 2

  quit

Related commands

history-command max-size

display history-command all

Use display history-command all to display all commands that are saved in the command history buffer for all CLI sessions.

Syntax

display history-command all

Views

Any view

Predefined user roles

network-admin

Usage guidelines

The system automatically saves commands successfully executed by users to the command history buffer for all CLI sessions. Users can view them but cannot recall them from the buffer.

Up to 1024 commands can be saved in the command history buffer. To buffer a new command when the buffer is full, the system deletes the oldest command entry in the buffer.

A user logout does not cause the system to delete commands from the history buffer for all CLI sessions.

If the command history buffer contains password configuration commands, the passwords are displayed as asterisks (******) for security purposes.

Examples

# Display all commands saved in the command history buffer for all CLI sessions.

<Sysname> display history-command all

  Date       Time     Terminal   Ip              User

  02/16/2020 20:03:33 vty0       192.168.1.26    **

  Cmd:dis his all

 

  02/16/2020 20:03:29 vty0       192.168.1.26    **

  Cmd:sys

Table 1 Command output

Field	Description
Date	Date when the command was executed.
Time	Time when the command was executed.
Terminal	User line used by the user.
Ip	IP address of the terminal used by the user.
User	Username used by the user if the user login authentication mode is scheme. If the login authentication mode is none or password, this field displays **.
Cmd	Command string entered by the user.

‌

Related commands

display history-command

display hotkey

Use display hotkey to display hotkey information.

Syntax

display hotkey

Views

Any view

Predefined user roles

network-admin

network-operator

Examples

# Display hotkey information.

<Sysname> display hotkey

----------------- Hotkeys -----------------

 

           -Defined function hotkeys-

CTRL_A  Move the cursor to the beginning of the line.

CTRL_B  Move the cursor one character to the left.

CTRL_C  Stop the current command.

CTRL_D  Erase the character at the cursor.

CTRL_E  Move the cursor to the end of the line.

CTRL_F  Move the cursor one character to the right.

CTRL_H  Erase the character to the left of the cursor.

CTRL_K  Abort the connection request.

CTRL_N  Display the next command in the history buffer.

CTRL_P  Display the previous command in the history buffer.

CTRL_R  Redisplay the current line.

CTRL_V  Paste text from the clipboard.

CTRL_W  Delete the word to the left of the cursor.

CTRL_X  Delete all characters from the beginning of the line to the cursor.

CTRL_Y  Delete all characters from the cursor to the end of the line.

CTRL_Z  Return to the User View.

CTRL_]  Kill incoming connection or redirect connection.

ESC_B   Move the cursor back one word.

ESC_D   Delete all characters from the cursor to the end of the word.

ESC_F   Move the cursor forward one word.

ESC_N   Move the cursor down a line.

ESC_P   Move the cursor up a line.

ESC_<   Move the cursor to the beginning of the clipboard.

ESC_>   Move the cursor to the end of the clipboard.

 

           -Defined command hotkeys-

CTRL_G  display current-configuration

CTRL_L  display ip routing-table

CTRL_O  undo debugging all

 

           -Undefined hotkeys-

CTRL_T  NULL

CTRL_U  NULL

Related commands

hotkey

hotkey

Use hotkey to configure a hotkey.

Use undo hotkey to restore the default.

Syntax

hotkey hotkey { command | function function | none }

undo hotkey hotkey

Default

Table 2 shows the default definitions for hotkeys.

Table 2 Default definitions for hotkeys

Hotkey	Function or command
Ctrl+A	move_the_cursor_to_the_beginning_of_the_line: Moves the cursor to the beginning of a line.
Ctrl+B	move_the_cursor_one_character_to_the_left: Moves the cursor one character to the left.
Ctrl+C	stop_the_current_command: Stops the current command.
Ctrl+D	erase_the_character_at_the_cursor: Deletes the character at the cursor.
Ctrl+E	move_the_cursor_to_the_end_of_the_line: Moves the cursor to the end of a line.
Ctrl+F	move_the_cursor_one_character_to_the_right: Moves the cursor one character to the right.
Ctrl+G	display current-configuration: Displays the running configuration.
Ctrl+H	erase_the_character_to_the_left_of_the_cursor: Deletes the character to the left of the cursor.
Ctrl+K	abort_the_connection_request: Aborts the connection request.
Ctrl+L	display ip routing-table: Displays the IPv4 routing table information.
Ctrl+N	display_the_next_command_in_the_history_buffer: Displays the next command in the history buffer. The password configuration commands will be skipped.
Ctrl+O	undo debugging all: Displays all debugging functions.
Ctrl+P	display_the_previous_command_in_the_history_buffer: Displays the previous command in the history buffer. The password configuration commands will be skipped.
Ctrl+R	redisplay_the_current_line: Redisplays the current line.
Ctrl+T	N/A
Ctrl+U	N/A
Ctrl+V	paste_text_from_the_clipboard: Pastes text from the clipboard.
Ctrl+W	delete_the_word_to_the_left_of_the_cursor: Deletes the word to the left of the cursor.
Ctrl+X	delete_all_characters_from_the_beginning_of_the_line_to_the_cursor: Deletes all characters to the left of the cursor.
Ctrl+Y	delete_all_characters_from_the_cursor_to_the_end_of_the_line: Deletes all characters from the cursor to the end of the line.
Ctrl+Z	return_to_the_User_View: Returns to user view.
Ctrl+]	kill_incoming_connection_or_redirect_connection: Terminates the current connection.
Esc+B	move_the_cursor_back_one_word: Moves the cursor back one word.
Esc+D	delete_all_characters_from_the_cursor_to_the_end_of_the_word: Deletes all characters from the cursor to the end of the word.
Esc+F	move_the_cursor_forward_one_word: Moves the cursor forward one word.
ESC_N	move_the_cursor_down_a_line: Moves the cursor down a line. This hotkey is effective before you press Enter.
ESC_P	move_the_cursor_up_a_line: Moves the cursor up a line. This hotkey is effective before you press Enter.
ESC_<	move_the_cursor_to_the_beginning_of_the_clipboard: Moves the cursor to the beginning of the clipboard.
ESC_>	move_the_cursor_to_the_end_of_the_clipboard: Moves the cursor to the end of the clipboard.

‌

Views

System view

Predefined user roles

network-admin

Parameters

hotkey: Specifies a hotkey. To display the supported hotkeys, enter hotkey ? or see Table 2.

command: Specifies the command to be assigned to the hotkey.

function function: Specifies the function to be assigned to the hotkey. To display the supported functions, enter hotkey hotkey function ? or see Table 2.

none: Removes the command or function assignment for the hotkey. After you remove the assignment for a hotkey, pressing the hotkey does not execute any command or function.

Usage guidelines

The device supports a set of hotkeys. Pressing a hotkey executes the command or function assigned to the hotkey. You can configure all the hotkeys except Ctrl+].

A hotkey can correspond to only one command or function. If you assign multiple commands or functions to the same hotkey, the most recently assigned command or function takes effect.

A command or function can be assigned to multiple hotkeys. You can use any of those hotkeys to execute the command or function.

If a hotkey is also defined by the terminal software you are using to interact with the device, the terminal software definition takes effect.

Examples

# Assign move_the_cursor_to_the_beginning_of_the_line function to hotkey Ctrl+U.

<Sysname> system-view

[Sysname] hotkey ctrl_u function move_the_cursor_to_the_beginning_of_the_line

# Disable the configurable command or function assigned to hotkey Ctrl+A.

<Sysname> system-view

[Sysname] hotkey ctrl_a none

Related commands

display hotkey

quit

Use quit to return to the upper-level view.

Syntax

quit

Views

Any view

Predefined user roles

network-admin

network-operator

Usage guidelines

Executing this command in user view disconnects you from the device.

Examples

# Return from HundredGigE 1/0/1 interface view to system view and then to user view.

[Sysname-HundredGigE1/0/1] quit

[Sysname] quit

<Sysname>

repeat

Use repeat to repeat commands in the command history buffer for the current CLI session.

Syntax

repeat [ number ] [ count times ] [ delay seconds ]

Views

Any view

Predefined user roles

network-admin

Parameters

number: Specifies the number of the most recently executed commands in the command history buffer for the current CLI session that you want to execute. The value range is 1 to 256. The default is 1.

count times: Specifies the number of times that you want to execute the commands. The value range is 0 to 4294967295. The default is 0. If you do not specify this option, the system keeps executing the commands until you press the escape key to terminate the execution.

delay seconds: Specifies the time (in seconds) for the system to wait before executing the commands again. The value range is 0 to 4294967295. The default is 1.

Usage guidelines

To repeat a command, first enter the view for the command. To repeat multiple commands, first enter the view for the first command.

The repeat command executes commands in the order they were executed.

The system waits for your interaction when it repeats an interactive command.

The system does not repeat but skips password configuration commands.

The number of commands to be repeated in the command history buffer is determined by the minimum value of the following:

·     Number of the most recently executed commands in the command history buffer specified by the repeat command.

·     Size of the command history buffer specified by the history-command max-size command.

·     Number of the commands in the command history buffer.

Examples

# Configure the system to execute the two most recently executed commands (display cpu-usage and display clock) three times at an interval of 10 seconds.

<Sysname> repeat 2 count 3 delay 10

<Sysname> display cpu-usage

Slot 1 CPU 0 CPU usage:

      33% in last 5 seconds

      32% in last 1 minute

      33% in last 5 minutes

                                                                               

<Sysname> display clock

07:02:18.230 UTC Thu 02/19/2020

<Sysname> display cpu-usage

Slot 1 CPU 0 CPU usage:

      33% in last 5 seconds

      32% in last 1 minute

      33% in last 5 minutes

                                                                               

<Sysname> display clock

07:02:28.263 UTC Thu 02/19/2020

<Sysname> display cpu-usage

Slot 1 CPU 0 CPU usage:

      33% in last 5 seconds

      32% in last 1 minute

      33% in last 5 minutes

                                                                               

<Sysname> display clock

07:02:38.293 UTC Thu 02/19/2020

Related commands

display history-command

escape-key

history-command max-size

return

Use return to return to user view from any other view except Tcl configuration view and the Python shell.

Syntax

return

Views

Any view except user view, Tcl configuration view, and the Python shell

Predefined user roles

network-admin

network-operator

Usage guidelines

In any view except user view, Tcl configuration view, and the Python shell, pressing Ctrl+Z has the same effect as the return command.

To return to user view from Tcl configuration view, use the tclquit command.

To return to user view from the Python shell, use the exit() command.

Examples

# Return to user view from HundredGigE 1/0/1 interface view.

[Sysname-HundredGigE1/0/1] return

<Sysname>

screen-length disable

Use screen-length disable to disable pausing between screens of output for the current CLI session.

Use undo screen-length disable to enable pausing between screens of output for the current CLI session.

Syntax

screen-length disable

undo screen-length disable

Default

The default depends on the configuration of the screen-length command in user line view.

The following are the default settings for the screen-length command:

·     Pausing between screens of output.

·     Displaying up to 24 lines on a screen.

Views

User view

Predefined user roles

network-admin

Usage guidelines

If you disable pausing between screens of output, all output is displayed. The screen is refreshed continuously until the final screen is displayed. As a best practice, disable pausing between screens of output when you collect information and enable pausing between screens of output when you view information.

This command takes effect only for the current CLI session. When you are logged out, the default is restored.

Examples

# Disable pausing between screens of output for the current CLI session.

<Sysname> screen-length disable

Related commands

screen-length

system-view

Use system-view to enter system view from user view.

Syntax

system-view [ exclusive | immediate | private ]

Views

User view

Predefined user roles

network-admin

network-operator

Parameters

exclusive: Specifies exclusive-mode system view.

immediate: Specifies real-time-mode system view.

private: Specifies private-mode system view.

Usage guidelines

You can enter real-time-mode system view, exclusive-mode system view, or private-mode system view.

·     In real-time-mode system view and its lower-level views, settings are written to the running configuration and take effect immediately.

·     In exclusive-mode system view, private-mode system view, and their lower-level views, settings are saved to the target configuration, which takes effect after being committed by using the commit command.

Only one user can enter exclusive-mode system view or its lower-level views.

·     When a user is in an exclusive-mode view, users in private-mode views cannot commit their target configuration command lines.

·     When no user is in an exclusive-mode view, users in private-mode views can commit their respective target configuration command lines. However, only one user in a private-mode view can commit target configuration command lines at a time.

Unless otherwise stated, entering system view refers to entering real-time-mode system view.

Private-mode views and exclusive-mode views have a leading tilde sign (~) in their prompts as compared to their counterpart real-time-mode views.

Examples

# Enter exclusive-mode system view.

<Sysname> system-view exclusive

Info: The current configuration is locked.

~[Sysname]