cli
Use the cli command to configure the behavior of the command-line interface, including how long a session can be inactive before the system logs it out automatically, paging settings, terminal size and so on.
Most of the cli commands can be set for either the current session or as the new default for all sessions. The command-line mode required for each is different as follows:
Changing a cli session setting requires only Standard command-line mode. |
Changing a cli default setting requires Configure command-line mode. |
The cli command has the following syntax:
cli
clear-history
default
auto-logout <number of minutes>
init-resize
paging enable
progress enable
prompt <confirm-reload | confirm-reset | confirm-unsaved | empty-password> session
auto-logout <number of minutes>
paging enable
progress enable
terminal
length <number of lines>
resize
type <ansi | console | dumb | linux | screen | vt52 | vt100 | vt102 | vt220 | xterm>
width <number of characters>
The following table describes the arguments for the cli command:
Command |
Description |
||||||||||||
clear-history |
Clears the command history for the current user. |
||||||||||||
default auto-logout <number of minutes>session auto-logout <number of minutes> |
Specifies how long a CLI session can remain inactive before it is automatically logged out by the system. Use the corresponding command to configure this either for the current session or as the new CLI default. For example: (config) # cli session auto-logout 180 Use a value of 0 to specify that sessions never log out automatically due to inactivity. For example, to specify that the current CLI session never expires due to inactivity, use the following command: (config) # cli session auto-logout 0 Note: Commands that produce a lot of output such as show log continuous might timeout depending on the auto-logout configuration. |
||||||||||||
default init-resize |
Directly reads terminal dimensions from the device on CLI startup. |
||||||||||||
default paging enable |
Specifies whether paging is enabled for screen output that exceeds the current window size. When paging is enabled (the default), you can page through output using the same features as the Linux programs less and more. Press the h key to see paging options. 1 Viewing Paging Options provides an example. Use the corresponding command to configure this either for the current session or as the new CLI default. |
||||||||||||
default progress enable |
Specifies whether the CLI should provide progress updates for operations that take a long time to complete. Use the corresponding command to configure this either for the current session or as the new CLI default. |
||||||||||||
prompt <confirm-reload | |
Configures when the CLI should prompt you for input, as follows:
|
||||||||||||
session terminal length <number of lines> session terminal resize
session terminal type session terminal width <number of characters> |
Configures the terminal output to specified dimensions, as follows:
Refer also to terminal. |
Related Commands
The following table summarizes other commands related to the cli command:
Task |
Command |
Displays CLI options. |
# show cli |
Displays CLI command history. |
# show cli history |
Displays CLI command history for a specified number of lines. |
# show cli history 10 |
Does not automatically log users out due to keyboard inactivity. |
(config) # no cli default auto-logout |
Does not read terminal dimensions from the device on CLI startup. |
(config) # no cli default init-resize |
Disables paging. |
(config) # no cli default paging enable |
Disables progress updates. |
(config) # no cli default progress enable |
Does not prompt for confirmation before rebooting. |
(config) # no cli default prompt confirm-reload |
Does not prompt for confirmation before resetting to factory state. |
(config) # no cli default prompt confirm-reset |
Does not save unsaved changes before rebooting. |
(config) # no cli default prompt confirm-unsaved |
Assumes there is no password if none is specified in a pseudo-URL for SCP. |
(config) # no cli default prompt empty-password |
Does not automatically log users out due to keyboard inactivity. |
(config) # no cli session auto-logout |
Disables paging. |
(config) # no cli session paging enable |
Disables progress updates. |
(config) # no cli session progress enable |
Clears the terminal type. |
(config) # no cli session terminal type |