-
Cisco IOS Configuration Fundamentals and Network Management Command Reference, Release 12.3 T
-
Introduction
-
CFR Commands: absolute through clock timezone
-
CFR Commands: clock update-calendar through escape-character
-
CFR Commands: event application through ip ftp passive
-
CFR Commands: major rising through periodic
-
CFR Commands: ping through service sequence-numbers
-
CFR Commands: service slave-log through show
tee -
CFR Commands: show context through show ip sla monitor total-statistics
-
CFR Commands [12.3T]: 'show kron schedule' through 'show rtr collection-statistics'
-
CFR Commands: show rtr configuration through snmp-server enable informs
-
CFR Commands: snmp-server enable traps through statistics-distribution-interval
-
CFR Commands: stopbits through ttl ip
-
CFR Commands: type dhcp through xsm vdm
-
Appendix: ASCII Character Set and Hex Values (12.3T CF CR)
-
Table Of Contents
process cpu statistics limit entry-percentage
rtr responder type frame-relay
rtr slm frame-relay statistics
ping
To diagnose basic network connectivity on AppleTalk, ATM, Connectionless Network Service (CLNS), DECnet, IP, Novell IPX, or source-route bridging (SRB) networks, use the ping command in user EXEC or privileged EXEC mode.
ping [[protocol [tag] {host-name | system-address}]
Syntax Description
Command Modes
User EXEC
Privileged EXECCommand History
Usage Guidelines
The ping command sends an echo request packet to an address, and then awaits a reply. Ping output can help you evaluate path-to-host reliability, delays over the path, and whether the host can be reached or is functioning. For example, the ping clns command sends International Organization for Standardization (ISO) CLNS echo packets to test the reachability of a remote router over a connectionless Open System Interconnection (OSI) network.
If you enter the ping command without any other syntax (ping<cr>), the CLI will display an interactive system dialog that prompts you for the additional syntax appropriate to the protocol you specify (See the "Examples" section).
To exit the interactive ping dialog before responding to all the prompts, type the escape sequence. The default escape sequence is Ctrl-^,X (Simultaneously press and release the Ctrl, Shift, and 6 keys and then press the X key). The escape sequence will vary depending on your line configuration. For example, another commonly used escape sequence is Ctrl-c.
Table 53 describes the test characters sent by the ping facility.
Note
Not all protocols require hosts to support pings. For some protocols, the pings are Cisco-defined and can be answered only by another Cisco router.
The availability of protocol keywords depends on what protocols are enabled on your system.
Issuing the ping command in User EXEC mode will generally offer fewer syntax options than issuing the ping command in Privileged EXEC mode.
Examples
After you enter the ping command in privileged EXEC mode, the system prompts you for a protocol keyword. The default protocol is IP.
If you enter a host name or address on the same line as the ping command, the default action is taken as appropriate for the protocol type of that name or address.
The following example is sample dialog from the ping command using default values. The specific dialog varies somewhat from protocol to protocol.
Router# pingProtocol [ip]:Target IP address: 192.168.7.27Repeat count [5]:Datagram size [100]:Timeout in seconds [2]:Extended commands [n]:Sweep range of sizes [n]:Type escape sequence to abort.Sending 5, 100-byte ICMP Echos to 192.168.7.27, timeout is 2 seconds:!!!!!Success rate is 100 percent, round-trip min/avg/max = 1/2/4 msTable 54 describes the significant fields shown in the display.
Table 54 ping Field Descriptions for IP
Protocol [ip]:
Prompts for a supported protocol. Default: ip.
Target IP address:
Prompts for the IP address or host name of the destination node you plan to ping. If you have specified a supported protocol other than IP, enter an appropriate address for that protocol here. Default: none.
Repeat count [5]:
Number of ping packets that will be sent to the destination address. Default: 5.
Datagram size [100]:
Size of the ping packet (in bytes). Default: 100 bytes.
Timeout in seconds [2]:
Timeout interval. Default: 2 (seconds).
Extended commands [n]:
Specifies whether a series of additional commands appears.
Sweep range of sizes [n]:
Allows you to vary the sizes of the echo packets being sent. This capability is useful for determining the minimum sizes of the MTUs1 configured on the nodes along the path to the destination address. Packet fragmentation contributing to performance problems can then be reduced.
!!!!!
Each exclamation point (!) indicates receipt of a reply. A period (.) indicates that the network server timed out while waiting for a reply. Other characters may appear in the ping output display, depending on the protocol type.
Success rate is 100 percent
Percentage of packets successfully echoed back to the router. Anything less than 80 percent is usually considered problematic.
round-trip min/avg/max = 1/2/4 ms
Round-trip travel time intervals for the protocol echo packets, including minimum/average/maximum (in milliseconds).
1 MTU = maximum transmission unit
The following example verifies connectivity to the neighboring ATM device for the ATM PVC with the virtual path identifier (VPI)/virtual channel identifier (VCI) value 0/16:
Router# pingProtocol [ip]:atmATM Interface:atm1/0VPI value [0]:VCI value [1]:16Loopback - End(0), Segment(1) [0]:1Repeat Count [5]:Timeout [2]:Type escape sequence to abort.Sending 5, 53-byte segment OAM echoes, timeout is 2 seconds:!!!!!Success rate is 100 percent (5/5), round-trip min/avg/max = 1/1/1 msTable 55 describes the default ping fields shown in the display.
Related Commands
ping ip
To test network connectivity on IP networks, use the ping ip command in privileged EXEC mode.
ping ip {host-name | ip-address} [data [hex-data-pattern] | df-bit | repeat [repeat-count] | size [datagram-size] [source {source-address | source-interface} ] [timeout seconds] [validate] [verbose]
Syntax Description
Command Modes
Privileged EXEC
Command History
10.0
This command was introduced.
12.0
The data, df-bit, repeat, size, source, timeout, and validate keywords were added.
Usage Guidelines
The ping command sends an echo request packet to an address, then awaits a reply. Ping output can help you evaluate path-to-host reliability, delays over the path, and whether the host can be reached or is functioning.
To abnormally terminate a ping session, type the escape sequence—by default, Ctrl-^ X. You type the default by simultaneously pressing and releasing the Ctrl, Shift, and 6 keys, and then pressing the X key.
Table 56 describes the test characters that the ping facility sends.
Note
Examples
After you enter the ping command in privileged mode, the system prompts you for a protocol keyword. The default protocol is IP.
If you enter a host name or address on the same line as the ping command, the default action is taken as appropriate for the protocol type of that name or address.
The optional data, df-bit, repeat, size, source, timeout, and validate keywords can be used to avoid extended ping command output. You can use as many of these keywords as you need, and you can use them in any order after the host-name or system-address arguments.
Although the precise dialog varies somewhat from protocol to protocol, all are similar to the ping session using default values shown in the following output:
Router# pingProtocol [ip]:Target IP address: 192.168.7.27Repeat count [5]:Datagram size [100]:Timeout in seconds [2]:Extended commands [n]:Sweep range of sizes [n]:Type escape sequence to abort.Sending 5, 100-byte ICMP Echos to 192.168.7.27, timeout is 2 seconds:!!!!!Success rate is 100 percent, round-trip min/avg/max = 1/2/4 msTable 57 describes the default ping fields shown in the display.
Related Commands
ping ipv6
Tests the connection to a remote host on the network using IPv6.
ping vrf
Tests the connection in the context of a specific VPN (VRF).
ping vrf
To test a connection in the context of a specific VPN connection, use the ping vrf command in Exec mode.
ping vrf vrf-name [tag] [connection] target-address [connection-options]
Syntax Description
Defaults
The default connection type for ping is IP (specifically, IPv4).
Command Modes
User EXEC
Privileged EXECCommand History
Usage Guidelines
A VPN routing/forwarding (VRF) instance is used to identify a VPN. To check if a configured VRF is working, you can use the ping vrf command.
When attempting to ping from a provider edge (PE) router to a customer edge (CE) router, or from a PE router to PE router, the standard ping command will not usually work. The ping vrf command allows you to ping the IP addresses of LAN interfaces on CE routers.
If you are on a PE router, be sure to indicate the specific VRF (VPN) name, as shown in the "Examples" section.
If all required information is not provided at the command line, the system will enter the interactive dialog (extended mode) for ping.
Examples
In the following example, the target host in the domain 209.165.201.1 is pinged (using IP/ICMP) in the context of the "Customer_A" VPN connection.
Router# ping vrf Customer_A 209.165.201.1Type escape sequence to abort.Sending 5, 100-byte ICMP Echos to 209.165.201.1, timeout is 2 seconds:!!!!!Success rate is 100 percent (5/5), round-trip min/avg/max = 176/264/576 msPressing the Enter key before providing all of the required options will begin the interactive dialog for ping. In the following example, the interactive dialog is started after the "ip" protocol is specified, but no address is given:
Router# ping vrf Customer_B ipTarget IP address: 209.165.200.225Repeat count [5]:Datagram size [100]:Timeout in seconds [2]:Extended commands [n]: ySource address or interface:Type of service [0]:Set DF bit in IP header? [no]:Validate reply data? [no]:Data pattern [0xABCD]:Loose, Strict, Record, Timestamp, Verbose[none]: RecordNumber of hops [ 9 ]:Loose, Strict, Record, Timestamp, Verbose[RV]:Sweep range of sizes [n]:Type escape sequence to abort.Sending 5, 100-byte ICMP Echos to 209.165.200.225, timeout is 2 seconds:Packet has IP options: Total option bytes= 39, padded length=40Record route: <*>(0.0.0.0)(0.0.0.0)(0.0.0.0)(0.0.0.0)(0.0.0.0)(0.0.0.0)(0.0.0.0)(0.0.0.0)(0.0.0.0)...Success rate is 100 percent (5/5), round-trip min/avg/max = 4/4/4 msThe following example shows the various options for IP in the ping vrf command:
Router# show parser dump exec | include ping vrf1 ping vrf <string>1 ping vrf <string> ip <string>1 ping vrf <string> ip (interactive)1 ping vrf <string> ip <string>1 ping vrf <string> ip <string> source <address>1 ping vrf <string> ip <string> source <interface>1 ping vrf <string> ip <string> repeat <1-2147483647>1 ping vrf <string> ip <string> size Number1 ping vrf <string> ip <string> df-bit1 ping vrf <string> ip <string> validate1 ping vrf <string> ip <string> data <0-65535>1 ping vrf <string> ip <string> timeout <0-3600>1 ping vrf <string> ip <string> verbose1 ping vrf <string> ip <string> data <0-65535>1 ping vrf <string> ip <string> timeout <0-3600>1 ping vrf <string> tag1 ping vrf <string> atm1 ping vrf <string> ipv61 ping vrf <string> appletalk1 ping vrf <string> decnet1 ping vrf <string> clns1 ping vrf <string> ipx1 ping vrf <string> sna1 ping vrf <string> srbRelated Commands
policy (ERM)
To configure an ERM resource policy, use the policy command in ERM configuration mode. To disable this function, use the no form of this command.
policy policy-name [global | type resource-user-type]
no policy policy-name
Syntax Description
Command Default
Disabled
Command Modes
ERM configuration
Command History
Usage Guidelines
You can configure a resource policy only in ERM configuration mode.
Examples
The following example shows how to configure a resource policy with the policy name cpu_mem_policy and the resource type iosprocess:
Router(config-erm)# policy cpu_mem_policy type iosprocessRelated Commands
policy (resource group)
To apply an already configured policy to a specified resource group, use the policy command in resource group configuration mode. To disable this function, use the no form of this command.
policy policy-name
no policy policy-name
Syntax Description
policy-name
Applies the specified policy to a resource group. The policy-name argument specifies the name of the policy you want to apply to the resource group.
Command Default
Disabled
Command Modes
Resource group configuration
Command History
Usage Guidelines
Before applying a policy to a resource group, you must configure a resource policy using the policy policy-name command in ERM configuration mode and create a resource group using the user group resource-group-name type resource-user-type command in ERM configuration mode.
When you apply a policy using the policy policy-name command in resource group configuration mode, you are applying a policy (which contains the thresholds) to the resource group you created using the user group resource-group-name type resource-user-type command in ERM configuration mode.
For example, say you have created a resource group with the name lowPrioUsers and iosprocess as the type. You have some low-priority RUs or tasks like HTTP and SNMP, and you want to set a threshold for all the low-priority RUs together, not separately. You must add the RUs to the resource group using the instance instance-name command and then apply a resource policy. If the resource policy you applied sets a minor rising threshold value of 10% for the resource group, then when the accumulated usage of both HTTP and SNMP RUs crosses the 10% mark, a notification is sent to the RUs in the resource group lowPrioUsers. That is, if HTTP usage is 4% and SNMP usage is 7%, then a notification is sent to the resource group. This facility helps to set thresholds for a group of RUs, as it is difficult to set a threshold for every single RU.
Examples
The following example shows how to apply a resource policy named cpu_mem_policy to a resource group named lowPrioUsers:
Router(config-erm)# user group lowPrioUsers type iosprocessRouter(config-res-group)# policy group-policy1Related Commands
policy-list
To associate a policy list with a Command Scheduler occurrence, use the policy-list command in kron-occurrence configuration mode. To delete a policy list from the Command Scheduler occurrence, use the no form of this command.
policy-list list-name
no policy-list list-name
Syntax Description
list-name
Name of policy list. If the list-name is new, a policy list structure will be created. If the list-name is not new, the existing policy list will be edited.
Defaults
No policy list is associated.
Command Modes
Kron-occurrence configuration (config-kron-occurrence)
Command History
Usage Guidelines
Use the policy-list command with the kron occurrence command to schedule one or more policy lists to run at the same time or interval. Use the kron policy-list command in conjunction with the cli command to create a Command Scheduler policy list containing EXEC command line interface (CLI) commands to be scheduled to run on the router at a specified time.
The Command Scheduler process is useful to automate the running of EXEC commands at recurring intervals, and can it be used in remote routers to minimize manual intervention.
Examples
The following example shows how to create a Command Scheduler occurrence named may and associate a policy list named sales-may with the occurrence:
Router(config)# kron occurrence may at 6:30 may 20 oneshotRouter(config-kron-occurrence)# policy-list sales-mayRelated Commands
poll-interval
To configure the polling interval for a bulk statistics schema, use the poll-interval command in Bulk Statistics Schema configuration mode. To remove a previously configured polling interval, use the no form of this command.
poll-interval minutes
no poll-interval minutes
Syntax Description
minutes
Polling interval of data for this schema in minutes. The valid range is from 1 minute to 20000 minutes. The default is 5 minutes.
Defaults
Object instances are polled once every five minutes.
Command Modes
Bulk Statistics Schema configuration (config-bulk-sc)
Command History
Usage Guidelines
The poll-interval command sets how often the MIB instances specified by the schema and associated object list are to be polled. Collected data is stored in the local bulk statistics file for later transfer.
Examples
In the following example the polling interval for bulk statistics collection is set to once every 3 minutes in the schema called Ethernet2/1-CAR:
Router(config)# snmp mib bulkstat schema Ethernet2/1-CARRouter(config-bulk-sc)# object-list CAR-mibRouter(config-bulk-sc)# poll-interval 3Router(config-bulk-sc)# instance wildcard oid 3.1Router(config-bulk-sc)# exitRelated Commands
snmp mib bulkstat schema
Names a bulk statistics schema and enters Bulk Statistics Schema configuration mode.
printer
To configure a printer and assign a server tty line (or lines) to it, use the printer command in global configuration mode. To disable printing on a tty line, use the no form of this command.
printer printer-name {line number | rotary number} [newline-convert | formfeed]
no printer
Syntax Description
Defaults
No printers are defined by default.
Command Modes
Global configuration
Command History
Usage Guidelines
This command enables you to configure a printer for operations and assign either a single tty line or a group of tty lines to it. To make multiple printers available through the same printer name, specify the number of a rotary group.
In addition to configuring the printer with the printer command, you must modify the file /etc/printcap on your UNIX system to include the definition of the remote printer in the Cisco IOS software. Refer to the Cisco IOS Configuration Fundamentals Configuration Guide for additional information.
Use the optional newline-convert keyword in UNIX environments that cannot handle single-character line terminators. This converts newline characters to a carriage-return, linefeed sequence. Use the formfeed keyword when using the line printer daemon (lpd) protocol to print and your system is unable to separate individual output jobs with a form feed (page eject). You can enter the newline-convert and formfeed keywords together and in any order.
Examples
In the following example a printer named printer1 is configured and output is assigned to tty line 4:
Router(config)# printer printer1 line 4Related Commands
private
To save user EXEC command changes between terminal sessions, use the private command in line configuration mode. To restore the default condition, use the no form of this command.
private
no private
Syntax Description
This command has no arguments or keywords.
Defaults
User-set configuration options are cleared with the exit EXEC command or when the interval set with the exec-timeout line configuration command has passed.
Command Modes
Line configuration
Command History
Usage Guidelines
This command ensures that the terminal parameters set by the user remain in effect between terminal sessions. This behavior is desirable for terminals in private offices.
Examples
In the following example, line 15 (in this example, vty 1) is configured to keep all user-supplied settings at system restarts:
Router(config)# line 15Router(config-line)# privateRelated Commands
process cpu statistics limit entry-percentage
To set the process entry limit and the size of the history table for CPU utilization statistics, use the process cpu statistics limit entry-percentage command in global configuration mode. To disable CPU utilization statistics, use the no form of this command.
process cpu statistics limit entry-percentage number [size seconds]
no process cpu statistics limit entry-percentage
Syntax Description
Defaults
size seconds: 600 seconds
Command Modes
Global configuration
Command History
Usage Guidelines
Use the process cpu statistics limit entry-percentage command to set the entry limit and size of CPU utilization statistics.
Examples
The following example shows how to set an entry limit at 40 percent and a size of 300 seconds:
Router(config)# process cpu statistics limit entry-percentage 40 size 300Related Commands
process cpu threshold type
To set CPU thresholding notification types and values, use the process cpu threshold type command in global configuration mode. To disable CPU thresholding notifications, use the no form of this command.
process cpu threshold type {total | process | interrupt} rising percentage interval seconds [falling percentage interval seconds]
no process cpu threshold type {total | process | interrupt}
Syntax Description
Defaults
CPU thresholding notifications are disabled.
Command Modes
Global configuration
Command History
Usage Guidelines
This command defines CPU usage thresholds that, when crossed, cause a CPU thresholding notification. When this command is enabled, Cisco IOS software polls the system at the configured interval. Notification occurs in two situations:
•
•
Examples
The following example shows how to set the total CPU utilization notification threshold at 80 percent for a rising threshold notification and 20 percent for a falling threshold notification, with a 5-second polling interval.
Router(config)# process cpu threshold type total rising 80 interval 5 falling 20 interval 5Related Commands
process-max-time
To configure the amount of time after which a process should voluntarily yield to another process, use the process-max-time command in global configuration mode. To reset this value to the system default, use the no form of this command.
process-max-time milliseconds
no process-max-time milliseconds
Syntax Description
milliseconds
Maximum duration (in milliseconds) that a process can run before suspension. The range is from 20to 200 milliseconds.
Defaults
The default maximum process time is 200 milliseconds.
Command Modes
Global configuration
Command History
