cc/td/doc/product/software/ios121/121sup/121csum1
hometocprevnextglossaryfeedbacksearchhelp
PDF

Table of Contents

Basic System Management Commands

Basic System Management Commands

This chapter explains the function and syntax of the basic system management commands. For more information about defaults and usage guidelines, see the corresponding chapter of the Cisco IOS Configuration Fundamentals Command Reference, Release 12.1.

absolute

To specify an absolute time when a time range is in effect, use the absolute time-range configuration command. To remove the time limitation, use the no form of this command.

absolute [start time date] [end time date]

no absolute

Syntax Description

start time date

(Optional) Absolute time and date that the associated permit or deny statement starts going into effect. The time is expressed in a 24-hour clock, in the form of hours:minutes. For example, 8:00 is 8:00 am and 20:00 is 8:00 pm. The date is expressed in the format day month year. The minimum start is 00:00 1 January 1993. If no start time and date are specified, the permit or deny statement is in effect immediately.

end time date

(Optional) Absolute time and date that the associated permit or deny statement is no longer in effect. Same time and date format as described for the start. The end time and date must be after the start time and date. The maximum end time is 23:59 31 December 2035. If no end time and date are specified, the permit or deny statement is in effect indefinitely.

alias

To create a command alias, use the alias global configuration command. Use the no form of this command to delete all aliases in a command mode or to delete a specific alias, and to revert to the original command syntax.

alias mode alias-name alias-command-line

no alias mode [alias-name]

Syntax Description

mode

Command mode of the original and alias commands.

alias-name

Command alias.

alias-command-line

Original command syntax.

buffers

To make adjustments to initial buffer pool settings and to the limits at which temporary buffers are created and destroyed, use the buffers global configuration command. Use the no form of this command to return the buffers to their default size.

buffers {small | middle | big | verybig | large | huge | type number} {permanent | max-free
| min-free | initial} number

no buffers {small | middle | big | verybig | large | huge | type number} {permanent | max-free
| min-free | initial} number

Syntax Description

small

Buffer size of this public buffer pool is 104 bytes.

middle

Buffer size of this public buffer pool is 600 bytes.

big

Buffer size of this public buffer pool is 1524 bytes.

verybig

Buffer size of this public buffer pool is 4520 bytes.

large

Buffer size of this public buffer pool is 5024 bytes.

huge

Default buffer size of this public buffer pool is 18024 bytes. This value can be configured with the buffers huge size command.

type number

Interface type and interface number of the interface buffer pool. The type value cannot be fddi.

permanent

Number of permanent buffers that the system tries to create and keep. Permanent buffers are normally not trimmed by the system.

max-free

Maximum number of free or unallocated buffers in a buffer pool.
A maximum of 20,480 small buffers can be constructed in the pool.

min-free

Minimum number of free or unallocated buffers in a buffer pool.

initial

Number of additional temporary buffers that are to be allocated when the system is reloaded. This keyword can be used to ensure that the system has necessary buffers immediately after reloading in a high-traffic environment.

number

Number of buffers to be allocated.

buffers huge size

To dynamically resize all huge buffers to the value you specify, use the buffers huge size global configuration command. Use the no form of this command to restore the default buffer values.

buffers huge size number

no buffers huge size number

Syntax Description

number

Huge buffer size, in bytes.

calendar set

To set the system calendar, use one of the formats of the calendar set EXEC command.

calendar set hh:mm:ss day month year

calendar set hh:mm:ss month day year

Syntax Description

hh:mm:ss

Current time in hours (military format), minutes, and seconds.

day

Current day (by date) in the month.

month

Current month (by name).

year

Current year (no abbreviation).

clock calendar-valid

To configure a router as a time source for a network based on its calendar, use the clock calendar-valid global configuration command. Use the no form of this command to specify that the calendar is not an authoritative time source.

clock calendar-valid

no clock calendar-valid

Syntax Description

This command has no arguments or keywords.

clock read-calendar

To manually read the calendar into the system clock, use the clock read-calendar EXEC command.

clock read-calendar

Syntax Description

This command has no arguments or keywords.

clock set

To manually set the system clock, use one of the formats of the clock set EXEC command.

clock set hh:mm:ss day month year

clock set hh:mm:ss month day year

Syntax Description

hh:mm:ss

Current time in hours (military format), minutes, and seconds.

day

Current day (by date) in the month.

month

Current month (by name).

year

Current year (no abbreviation).

clock summer-time

To configure the system to automatically switch to summer time (daylight savings time), use one of the formats of the clock summer-time global configuration command. Use the no form of this command to configure the Cisco IOS software not to automatically switch to summer time.

clock summer-time zone recurring [week day month hh:mm week day month hh:mm [offset]]

clock summer-time zone date date month year hh:mm date month year hh:mm [offset]

clock summer-time zone date month date year hh:mm month date year hh:mm [offset]

no clock summer-time

Syntax Description

zone

Name of the time zone (PDT,...) to be displayed when summer time is in effect.

recurring

Indicates that summer time should start and end on the corresponding specified days every year.

date

Indicates that summer time should start on the first specific date listed in the command and end on the second specific date in the command.

week

(Optional) Week of the month (1 to 5 or last).

day

(Optional) Day of the week (Sunday, Monday,...).

date

Date of the month (1 to 31).

month

(Optional) Month (January, February,...).

year

Year (1993 to 2035).

hh:mm

(Optional) Time (military format) in hours and minutes.

offset

(Optional) Number of minutes to add during summer time (default is 60).

clock timezone

To set the time zone for display purposes, use the clock timezone global configuration command. To set the time to Coordinated Universal Time (UTC), use the no form of this command.

clock timezone zone hours [minutes]

no clock timezone

Syntax Description

zone

Name of the time zone to be displayed when standard time is in effect.

hours

Hours offset from UTC.

minutes

(Optional) Minutes offset from UTC.

clock update-calendar

To set the calendar from the system clock, use the clock update-calendar EXEC command.

clock update-calendar

Syntax Description

This command has no arguments or keywords.

downward-compatible-config

To generate a configuration that is compatible with an earlier Cisco IOS release, use the downward-compatible-config global configuration command. To remove this feature, use the no form of this command.

downward-compatible-config version

no downward-compatible-config

Syntax Description

version

Cisco IOS Release number, not earlier than 10.2.

hostname

To specify or modify the host name for the network server, use the hostname global configuration command. The host name is used in prompts and default configuration filenames. The setup command facility also prompts for a host name at startup.

hostname name

Syntax Description

name

New host name for the network server.

ip bootp server

To access the BOOTP service available from hosts on the network, use the ip bootp server global configuration command. Use the no form of the command to disable these services.

ip bootp server

no ip bootp server

Syntax Description

This command has no arguments or keywords.

ip telnet source-interface

To allow a user to select an address of an interface as the source address for Telnet connections, use the ip telnet source-interface global configuration command. Use the no form of this command to reset the source address to the default for each connection.

ip telnet source-interface interface

no ip telnet source-interface

Syntax Description

interface

The interface whose address is to be used as the source for Telnet connections.

ip tftp source-interface

To allow a user to select the interface whose address will be used as the source address for TFTP connections, use the ip tftp source-interface global configuration command.

ip tftp source-interface interface

no ip tftp source-interface

Syntax Description

interface

The interface whose address is to be used as the source for TFTP connections.

load-interval

To change the length of time for which data is used to compute load statistics, use the load-interval interface configuration command. Use the no form of this command to revert to the default setting.

load-interval seconds

no load-interval seconds

Syntax Description

seconds

Length of time for which data is used to compute load statistics. A value that is a multiple of 30, from 30 to 600 (30, 60, 90, 120, and so forth).

ntp access-group

To control access to the system's Network Time Protocol (NTP) services, use the ntp access-group global configuration command. To remove access control to the system's NTP services, use the no form of this command.

ntp access-group {query-only | serve-only | serve | peer} access-list-number

no ntp access-group {query-only | serve-only | serve | peer}

Syntax Description

query-only

Allows only NTP control queries. See RFC 1305 (NTP version 3).

serve-only

Allows only time requests.

serve

Allows time requests and NTP control queries, but does not allow the system to synchronize to the remote system.

peer

Allows time requests and NTP control queries and allows the system to synchronize to the remote system.

access-list-number

Number (1 to 99) of a standard IP access list.

ntp authenticate

To enable Network Time Protocol (NTP) authentication, use the ntp authenticate global configuration command. Use the no form of this command to disable the feature.

ntp authenticate

no ntp authenticate

Syntax Description

This command has no arguments or keywords.

ntp authentication-key

To define an authentication key for Network Time Protocol (NTP), use the ntp authentication-key global configuration command. Use the no form of this command to remove the authentication key for NTP.

ntp authentication-key number md5 value

no ntp authentication-key number

Syntax Description

number

Key number (1 to 4294967295).

md5

Authentication key. Message authentication support is provided using the message digest algorithm 5(MD5) algorithm. The key type md5 is currently the only key type supported.

value

Key value (an arbitrary string of up to eight characters).

ntp broadcast

To specify that a specific interface should send Network Time Protocol (NTP) broadcast packets, use the ntp broadcast interface configuration command. Use the no form of this command to disable this capability.

ntp broadcast [version number]

no ntp broadcast

Syntax Description

version number

(Optional) Number from 1 to 3 indicating the NTP version.

ntp broadcast client

To allow the system to receive Network Time Protocol (NTP) broadcast packets on an interface, use the ntp broadcast client interface configuration command. Use the no form of this command to disable this capability.

ntp broadcast client

no ntp broadcast client

Syntax Description

This command has no arguments or keywords.

ntp broadcastdelay

To set the estimated round-trip delay between the Cisco IOS software and a Network Time Protocol (NTP) broadcast server, use the ntp broadcastdelay global configuration command. Use the no form of this command to revert to the default value.

ntp broadcastdelay microseconds

no ntp broadcastdelay

Syntax Description

microseconds

Estimated round-trip time (in microseconds) for NTP broadcasts. The range is from 1 to 999999.

ntp clock-period


Caution Do not enter this command; it is documented for informational purposes only. The system automatically generates this command as Network Time Protocol (NTP) determines the clock error and compensates.

As NTP compensates for the error in the system clock, it keeps track of the correction factor for this error. The system automatically saves this value into the system configuration using the ntp clock-period global configuration command. The system uses the no form of this command to revert to the default.

ntp clock-period value

no ntp clock-period

Syntax Description

value

Amount to add to the system clock for each clock hardware tick (in units of
2 to 32 seconds).

ntp disable

To prevent an interface from receiving Network Time Protocol (NTP) packets, use the ntp disable interface configuration command. To enable receipt of NTP packets on an interface, use the no form of this command.

ntp disable

no ntp disable

Syntax Description

This command has no arguments or keywords.

ntp master

To configure the Cisco IOS software as a Network Time Protocol (NTP) master clock to which peers synchronize themselves when an external NTP source is not available, use the ntp master global configuration command. To disable the master clock function, use the no form of this command.

ntp master [stratum]

no ntp master [stratum]


Caution Use this command with extreme caution. It is very easy to override valid time sources using this command, especially if a low stratum number is configured. Configuring multiple machines in the same network with the ntp master command can cause instability in keeping time if the machines do not agree on the time.

Syntax Description

stratum

(Optional) Number from 1 to 15. Indicates the NTP stratum number that the system will claim.

ntp peer

To configure the system clock to synchronize a peer or to be synchronized by a peer, use the
ntp peer global configuration command. To disable this capability, use the no form of this command.

ntp peer ip-address [version number] [key keyid] [source interface] [prefer]

no ntp peer ip-address

Syntax Description

ip-address

IP address of the peer providing, or being provided, the clock synchronization.

version

(Optional) Defines the Network Time Protocol (NTP) version number.

number

(Optional) NTP version number (1 to 3).

key

(Optional) Defines the authentication key.

keyid

(Optional) Authentication key to use when sending packets to this peer.

source

(Optional) Names the interface.

interface

(Optional) Name of the interface from which to pick the IP source address.

prefer

(Optional) Makes this peer the preferred peer that provides synchronization.

ntp server

To allow the system clock to be synchronized by a time server, use the ntp server global configuration command. To disable this capability, use the no form of this command.

ntp server ip-address [version number] [key keyid] [source interface] [prefer]

no ntp server ip-address

Syntax Description

ip-address

IP address of the time server providing the clock synchronization.

version

(Optional) Defines the Network Time Protocol (NTP) version number.

number

(Optional) NTP version number (1 to 3).

key

(Optional) Defines the authentication key.

keyid

(Optional) Authentication key to use when sending packets to this peer.

source

(Optional) Identifies the interface from which to pick the IP source address.

interface

(Optional) Name of the interface from which to pick the IP source address.

prefer

(Optional) Makes this server the preferred server that provides synchronization.

ntp source

To use a particular source address in Network Time Protocol (NTP) packets, use the ntp source global configuration command. Use the no form of this command to remove the specified source address.

ntp source type number

no ntp source

Syntax Description

type

Type of interface.

number

Number of the interface.

ntp trusted-key

To authenticate the identity of a system to which Network Time Protocol (NTP) will synchronize, use the ntp trusted-key global configuration command. Use the no form of this command to disable authentication of the identity of the system.

ntp trusted-key key-number

no ntp trusted-key key-number

Syntax Description

key-number

Key number of authentication key to be trusted.

ntp update-calendar

To periodically update the calendar from Network Time Protocol (NTP), use the ntp update-calendar global configuration command. Use the no form of this command to disable the periodic updates.

ntp update-calendar

no ntp update-calendar

Syntax Description

This command has no arguments or keywords.

periodic

To specify a recurring (weekly) time range for functions that support the time-range feature, use the periodic time-range configuration command. To remove the time limitation, use the no form of this command.

periodic days-of-the-week hh:mm to [days-of-the-week] hh:mm

no periodic days-of-the-week hh:mm to [days-of-the-week] hh:mm

Syntax Description

days-of-the-week

The first occurrence of this argument is the starting day or days for which the associated time range is in effect. The second occurrence is the ending day or days for which the associated statement is in effect.

This argument can be any single day or combinations of days: Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday. Other possible values are:

daily --- Monday through Sunday

weekdays --- Monday through Friday

weekend --- Saturday and Sunday

If the ending days of the week are the same as the starting days of the week, they can be omitted.

hh:mm

The first occurrence of this argument is the starting hours:minutes for which the associated time range is in effect. The second occurrence is the ending hours:minutes for which the associated statement is in effect.

The hours:minutes are expressed in a 24-hour clock. For example, 8:00 is 8:00 a.m. and 20:00 is 8:00 p.m.

prompt

To customize the prompt, use the prompt global configuration command. To revert to the default prompt, use the no form of this command.

prompt string

no prompt [string]

Syntax Description

string

Prompt. It can consist of all printing characters and the escape sequences listed in Table 14.


Table 14: Custom Prompt Escape Sequences
Escape Sequence Interpretation

%h

Host name. This is either Router or the name defined with the hostname global configuration command.

%n

Physical terminal line (TTY) number of the EXEC user.

%p

Prompt character itself. It is either an angle bracket (>) for EXEC mode or a pound sign (#) for privileged EXEC mode.

%s

Space.

%t

Tab.

%%

Percent sign (%)

scheduler allocate

To guarantee CPU time for processes, use the scheduler allocate global configuration command on the Cisco 7200 series and Cisco 7500 series routers. The no form of this command restores the default.

scheduler allocate interrupt-time process-time

no scheduler allocate

Syntax Description

interrupt-time

Integer (in microseconds) that limits the maximum number of microseconds to spend on fast switching within any one network interrupt context. The range is 400 to 60000 microseconds. The default is 4000 microseconds.

process-time

Integer (in microseconds) that guarantees the minimum number of microseconds to spend at the process level when network interrupts are disabled. The range is 100 to 4000. The default is 200 microseconds.

scheduler interval

To control the maximum amount of time that can elapse without running system processes, use the scheduler interval global configuration command. The no form of this command restores the default.

scheduler interval milliseconds

no scheduler interval

Syntax Description

milliseconds

Integer that specifies the interval, in milliseconds. The minimum interval that you can specify is 500 milliseconds; there is no maximum value.

service decimal-tty

To specify that line numbers be displayed and interpreted as decimal numbers rather than octal numbers, use the service decimal-tty global configuration command. Use the no form of this command to restore the default.

service decimal-tty

no service decimal-tty

Syntax Description

This command has no arguments or keywords.

service exec-wait

To delay the startup of the EXEC on noisy lines, use the service exec-wait global configuration command. Use the no form of this command to disable the delay function.

service exec-wait

no service exec-wait

Syntax Description

This command has no arguments or keywords.

service finger

To allow Finger protocol requests (defined in RFC 742) to be made of the network server, use the service finger global configuration command. This service is equivalent to issuing a remote show users command. Use the no form of this command to remove this service.

service finger

no service finger

Syntax Description

This command has no arguments or keywords.

service hide-telnet-address

To hide addresses while trying to establish a Telnet session, use the service hide-telnet-address global configuration command. Use the no form of this command to remove this service.

service hide-telnet-address

no service hide-telnet-address

Syntax Description

This command has no arguments or keywords.

service nagle

To enable the Nagle congestion control algorithm, use the service nagle global configuration command. Use the no form of this command to disable the algorithm.

service nagle

no service nagle

Syntax Description

This command has no arguments or keywords.

service prompt config

To display the configuration prompt (config), use the service prompt config global configuration command. Use the no form of this command to remove the configuration prompt.

service prompt config

no service prompt config

Syntax Description

This command has no arguments or keywords.

service tcp-small-servers

To access minor TCP/IP services available from hosts on the network, use the service tcp-small-servers global configuration command. Use the no form of the command to disable these services.

service tcp-small-servers

no service tcp-small-servers

Syntax Description

This command has no arguments or keywords.

service telnet-zero-idle

To set the TCP window to zero (0) when the Telnet connection is idle, use the service telnet-zero-idle global configuration command. Use the no form of this command to disable this service.

service telnet-zero-idle

no service telnet-zero-idle

Syntax Description

This command has no arguments or keywords.

service udp-small-servers

To access minor User Datagram Protocol (UDP) services available from hosts on the network, use the service udp-small-servers global configuration command. Use the no form of the command to disable these services.

service udp-small-servers

no service udp-small-servers

Syntax Description

This command has no arguments or keywords.

show aliases

To display all alias commands, or the alias commands in a specified mode, use the show aliases EXEC command.

show aliases [mode]

Syntax Description

mode

(Optional) Command mode.

show buffers

To display statistics for the buffer pools on the network server, use the show buffers EXEC command.

show buffers [type number | alloc [dump]]

Syntax Description

type number

(Optional) Displays interface pool information. If the specified interface type and number has its own buffer pool, displays information for that pool. Value of type can be ethernet, serial, tokenring, fddi, bri, atm, e1, t1.

alloc

(Optional) Displays a brief listing of all allocated buffers.

dump

(Optional) Dumps all allocated buffers. This keyword must be used with the alloc keyword, not by itself.

show calendar

To display the calendar hardware setting, use the show calendar EXEC command.

show calendar

Syntax Description

This command has no arguments or keywords.

show clock

To display the system clock, use the show clock EXEC command.

show clock [detail]

Syntax Description

detail

(Optional) Indicates the clock source (NTP, VINES, system calendar, and so forth) and the current summer-time setting (if any).

show ntp associations

To show the status of Network Time Protocol (NTP) associations, use the show ntp associations EXEC command.

show ntp associations [detail]

Syntax Description

detail

(Optional) Shows detailed information about each NTP association.

show ntp status

To show the status of Network Time Protocol (NTP), use the show ntp status EXEC command.

show ntp status

Syntax Description

This command has no arguments or keywords.

show sntp

To show information about the Simple Network Time Protocol (SNTP), use the show sntp EXEC command on a Cisco 1003, Cisco 1004, or Cisco 1005 router.

show sntp

Syntax Description

This command has no arguments or keywords.

sntp broadcast client

To use the Simple Network Time Protocol (SNTP) to accept Network Time Protocol (NTP) traffic from any broadcast server, use the sntp broadcast client global configuration command to configure a Cisco 1003, Cisco 1004, or Cisco 1005 router. The no form of the command prevents the router from accepting broadcast traffic.

sntp broadcast client

no sntp broadcast client

Syntax Description

This command has no arguments or keywords.

sntp server

To configure a Cisco 1003, Cisco 1004, or Cisco 1005 router to use the Simple Network Time Protocol (SNTP) to request and accept Network Time Protocol (NTP) traffic from a time server, use the sntp server global configuration command. The no form of the command removes a server from the list of NTP servers.

sntp server {address | hostname} [version number]

no sntp server {address | hostname}

Syntax Description

address

IP address of the time server.

hostname

Host name of the time server.

version number

(Optional) Version of NTP to use. The default is 1.

time-range

To enable time-range configuration mode and define time ranges for functions (such as extended access lists), use the time-range global configuration command. To remove the time limitation, use the no form of this command.

time-range time-range-name

no time-range time-range-name

Syntax Description

time-range-name

Desired name for the time range. The name cannot contain a space or quotation mark, and must begin with a letter.


hometocprevnextglossaryfeedbacksearchhelp
Posted: Wed Jul 26 15:56:35 PDT 2000
Copyright 1989-2000©Cisco Systems Inc.