Feedback
Table Of Contents
Cisco IOS Software Modularity Commands
exception crashinfo buffersize
write core (Software Modularity)
Cisco IOS Software Modularity Commands
archive tar
To create a TAR file, to list the files in a TAR file, or to extract the files from a TAR file, use the archive tar command in privileged EXEC mode.
archive tar {/create destination-url flash:/file-url | /table source-url | /xtract source-url flash:/file-url [dir/file...]}
Syntax Description
Command Default
A TAR archive file is not created.
Command Modes
Privileged EXEC (#)
Command History
Usage Guidelines
Filenames, directory names, and image names are also case sensitive.
The TAR file is an archive file from which you can extract files by using the archive tar command.
Examples
The following example shows how to create a TAR file. The command writes the contents of the new-configs directory on the local flash device to a file named saved.tar on the TFTP server at 172.20.136.9.
Switch# archive tar /create tftp:172.20.136.9/saved.tar flash:/new-configsThe following example shows how to display the contents of the c2940-tv0-m.tar file that is in flash memory. The contents of the TAR file appear on the screen.
Switch# archive tar /table flash:c2940-tv0-m.tar
info (219 bytes)
c2940-tv0-mz-121/ (directory)
c2940-tv0-mz-121/html/ (directory)
c2940-tv0-mz-121/html/foo.html (0 bytes)
c2940-tv0-mz-121/vegas-tv0-mz-121.bin (610856 bytes)
c2940-tv0-mz-121/info (219 bytes)
info.ver (219 bytes)
The following example shows how to extract the contents of a TAR file on the TFTP server at 172.20.10.30. This command extracts only the new-configs directory into the root directory on the local flash file system. The remaining files in the saved.tar file are ignored.
Switch# archive tar /xtract tftp:/172.20.10.30/saved.tar flash:/ new-configsclear raw statistics
To clear raw IP statistics when Cisco IOS Software Modularity software is running, use the clear raw statistics command in privileged EXEC mode.
clear raw statistics
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC (#)
Command History
12.2(18)SXF4
This command was introduced to support Software Modularity images.
Usage Guidelines
There are three transport protocols used when Software Modularity software is running: Transmission Control Protocol (TCP), User Datagram Protocol (UDP), and raw IP. The transport protocol statistics are generally counters, but some are averages or time stamps. Use the clear raw statistics command to reset the raw IP statistics, and use the show raw statistics command to display the raw IP statistics. Many of the statistics are relevant to all of the transport protocols. To clear the other transport protocol statistics used in Software Modularity, use the clear tcp statistics and clear udp statistics commands.
Examples
The following example shows how to clear the raw IP statistics using the clear raw statistics command:
Router# clear raw statistics[confirm]Related Commands
clear tcp statistics
Clears TCP statistics.
clear udp statistics
Clears UDP statistics.
show raw statistics
Displays raw IP statistics.
clear udp statistics
To clear User Datagram Protocol (UDP) statistics when Cisco IOS Software Modularity software is running, use the clear udp statistics command in privileged EXEC mode.
clear udp statistics
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC (#)
Command History
12.2(18)SXF4
This command was introduced to support Software Modularity images.
Usage Guidelines
There are three transport protocols used when Software Modularity software is running: Transmission Control Protocol (TCP), UDP, and raw IP. The transport protocol statistics are generally counters, but some are averages or time stamps. Use the clear udp statistics command to reset the UDP statistics, and use the show udp statistics command to display the UDP statistics. Many of the statistics are relevant to all of the transport protocols. To clear the other transport protocol statistics used in Software Modularity, use the clear raw statistics and clear tcp statistics commands.
Examples
The following example shows how to clear the UDP statistics using the clear udp statistics command:
Router# clear udp statistics[confirm]Related Commands
clear raw statistics
Clears raw IP statistics.
clear tcp statistics
Clears TCP statistics.
show udp statistics
Displays UDP statistics.
debug registry
To turn on the debugging output for registry events or errors when Cisco IOS Software Modularity software is running, use the debug registry command in privileged EXEC mode. To turn off debugging output, use the no form of this command or the undebug command.
debug registry {events | errors} [process-name | pid]
no debug registry {events | errors} [process-name | pid]
Syntax Description
Command Modes
Privileged EXEC (#)
Command History
12.2(18)SXF4
This command was introduced to support Software Modularity images.
Usage Guidelines
Use the debug registry command to troubleshoot Software Modularity registry operations.
CautionUse any debugging command with caution because the volume of generated output can slow or stop the router operations. We recommend that this command be used only under the supervision of a Cisco engineer.
Examples
The following example turns on debugging messages for Software Modularity registry events for the TCP process:
Router# debug registry events tcp.procDebug registry events debugging is onThe following example turns on debugging messages for Software Modularity registry errors:
Router# debug registry errorsDebug registry errors debugging is onexception core
To set or change the core dump options for a Cisco IOS Software Modularity process, use the exception core command in global configuration mode. To reset the core dump options to their default settings, use the no form of this command.
exception core process-name {{off | mainmem | mainmem-sharedmem | mainmem-text | mainmem-text-sharedmem | sharedmem [maxcore value]}| maxcore value}
no exception core process-name
Syntax Description
Command Default
Default core dump options are set for a process.
Command Modes
Global configuration (config)
Command History
12.2(18)SXF4
This command was introduced to support Software Modularity images.
Usage Guidelines
Core dumps are taken when every process crashes. Each Cisco IOS Software Modularity software component has an associated .startup file that determines the core dump options (and other attributes) of that process. Use the show processes detailed command to display the core dump options for a process. Use the exception core command to override the default values set in the .startup file for the specific software component.
Note
Examples
In the following example, the maximum number of core dumps for all instances of the Cisco Discovery Protocol (CDP) process is set to 100. The command also limits the core dump output to the main memory text segments.
configure terminalexception core cdp2.proc mainmem-text maxcore 100Related Commands
exception flash
Configures the dump location for core files when a process reloads.
show processes detailed
Displays detailed process information.
exception core-file
To specify the name of the core dump file in Cisco IOS or Cisco IOS Software Modularity software, use the exception core-file command in global configuration mode. To return to the default core filename, use the no form of this command.
Cisco IOS Software
exception core-file filename
no exception core-file
Cisco IOS Software Modularity
exception core-file [filename] [limit upper-limit] [compress] [timestamp]
no exception core-file
Syntax Description
Command Default
Cisco IOS Software: The core file is named hostname-core, where hostname is the name of the router.
Cisco IOS Software Modularity: The core file is named using the name of the process that is being dumped.Command Modes
Global configuration (config)
Command History
10.2
This command was introduced.
12.2(18)SXF4
The limit, compress, and timestamp keywords were added to support Software Modularity images.
Usage Guidelines
If you use TFTP to dump the core file to a server, the router will only dump the first 16 MB of the core file. If the router's memory is larger than 16 MB, the whole core file will not be copied to the server. Therefore, use rcp or FTP to dump the core file. The network dump is not supported in Software Modularity images.
Caution
Examples
Cisco IOS Software
In the following example, the router is configured to use FTP to dump a core file named dumpfile to the FTP server at 172.17.92.2 when the router crashes:
ip ftp username redip ftp password blueexception protocol ftpexception dump 172.17.92.2exception core-file dumpfileCisco IOS Software Modularity
In the following example, the router is configured to dump the main memory used by the TCP process to a file named dump-tcp when the TCP process crashes. The dump file is configured with an upper limit of 20, to be compressed, and to have a time stamp applied.
exception core tcp.proc mainmemexception core-file dump-tcp limit 20 compress timestamp
Note
Related Commands
exception crashinfo buffersize
To change the size of the buffer used for crashinfo files, use the exception crashinfo buffersize command in global configuration mode. To revert to the default buffer size, use the no form of this command.
exception crashinfo buffersize kilobytes
no exception crashinfo buffersize kilobytes
Syntax Description
Command Default
Crashinfo buffer is 32 KB.
Command Modes
Global configuration (config)
Command History
Usage Guidelines
The crashinfo file saves information that helps Cisco technical support representatives to debug problems that caused the Cisco IOS image to fail (crash). The device writes the crash information to the console at the time of the failure, and the file is created the next time you boot the Cisco IOS image after the failure (instead of while the system is failing).
Note
Examples
In the following example, the crashinfo buffer is set to 100 KB:
Router(config)# exception crashinfo buffersize 100Related Commands
exception crashinfo file
Enables the creation of a diagnostic file at the time of unexpected system shutdowns.
exception flash
To handle the device and erase permission for exceptions, and set the local dump location for core files when a process reloads, use the exception flash command in global configuration mode.
exception flash {all | iomem | procmem} device-name
no exception flash
Syntax Description
Command Default
No core dump location is set for a process.
Command Modes
Global configuration (config)
Command History
Usage Guidelines
Core dumps are taken when every process reloads. You can configure up to three destinations, and the order in which the dump locations are used follows the order in which the destinations are configured.
Each Cisco IOS Software Modularity component has an associated .startup file that determines the core dump options (and other attributes) of that process. Use the show processes detailed command to display the core dump options for a process. Use the exception core command to override the default values set in the .startup file for the specific software component.
Caution
Examples
In the following example, three dump locations are configured to dump all the memory:
Router# configure terminalRouter(config)# exception flash all disk1:Router(config)# exception flash all bootflash:Router(config)# exception flash all sup-bootdisk:Related Commands
exception kernel
To configure a networking device to dump the kernel memory, use the exception kernel command in global configuration mode. To turn off the kernel dump facility, use the no form of this command.
exception kernel [filename filename] filepath path [memory kernel]
no exception kernel
Syntax Description
Command Default
No kernel memory is dumped.
Command Modes
Global configuration (config)
Command History
12.2(18)SXF4
This command was introduced to support Software Modularity images.
Usage Guidelines
Use the exception kernel command to dump kernel memory when the kernel reloads. Please note that this is different from process dump, in which a process on the networking device reloads, but not the networking device itself. This command is used to configure where and what to dump. If the dump is to bootflash:, this command is all that is required.
For distributed networking devices, the line card number is added to the default name assigned to the kernel core dump file. For example, the default kernel core dump file for the line card in slot 6 would be kernel_core6.Z.
Caution
Examples
The following example writes kernel exceptions to the disk0:/core directory. Only kernel memory is dumped, and because no filename is specified, the kernel core dump file is given the default name kernel_core.z.
configure terminalexception kernel filepath /disk0:/core memory kernelexception switch kernel
To configure a networking device to dump the kernel memory, use the exception kernel command in global configuration mode. To turn off the kernel dump facility, use the no form of this command.
exception switch kernel filesystem filename
no exception switch kernel filesystem filename
Syntax Description
Command Default
No kernel memory is dumped.
Command Modes
Global configuration (config)
Command History
12.2(33)SXI4
This command was introduced to support software modularity images.
12.2(33)SXI5
This command is not supported in Cisco IOS Release 12.2(33)SXI5 and later releases.
Usage Guidelines
Caution
The exception switch kernel command is available in Cisco IOS Releases 12.2(33)SXI4 and 12.2(33)SXI4a
Use the exception switch kernel command to dump kernel memory when the kernel reloads on the SP. This operation is different from process dump in which a process on the networking device reloads, but not the networking device itself. This command is used to configure where and what to dump. If the dump is to bootflash:, the exception switch kernel command is all that is required.
The filepath keyword only accepts file systems available to the SP. Use this command for configuring modular Cisco IOS kernel core files on the SP.
For distributed networking devices, the line card number is added to the default name assigned to the kernel core dump file. For example, the default kernel core dump file for the line card in slot 6 would be kernel_core6.Z.
Examples
The following example writes kernel exceptions to the disk0:/core directory. Only kernel memory is dumped, and because no filename is specified, the kernel core dump file is given the default name kernel_core.z.
configure terminalexception switch kernel filesystem /disk0:/core memory kernelRelated Commands
install activate
Note
To activate the current pending change set, use the install activate command in privileged EXEC mode.
install activate search-root-directory [reload]
Syntax Description
Command Modes
Privileged EXEC (#)
Command History
Usage Guidelines
Use the install activate command after a patch file or maintenance pack (MP) has been installed. The state of files in the pending change set will change depending on whether a reload is required.
Cisco IOS Software Modularity introduces the concept of installed software that is different from just booting an image on the networking device. Cisco IOS Software Modularity images can be saved into the flash file system and booted like a Cisco IOS image, but this is referred to as uninstalled software. To gain the benefits of the Cisco IOS Software Modularity Installer and permit patch files to be installed, use the install file command to write the software to flash. Installation and activation are now separate processes. The install bind command is used to bind Cisco IOS Software Modularity base images system-wide; and the install activate command must be entered to activate a patch. Some patches will require a reload to be performed, and a message appears on the console after the install activate command has been entered to note the current state of the patch.
Table 5 shows whether the patch code is running in the various patch states. For more details about activating a patch, including a flowchart of the various patch states, see the "Cisco IOS Software Modularity Installation and Configuration" module.
Examples
The following example shows how to activate the current pending change set for the sys directory:
Router# install activate disk0:/sysRelated Commands
install bind
Binds Cisco IOS Software Modularity images.
install file
Installs base system files and patches.
install bind
Note
To bind a Cisco IOS Software Modularity software image system-wide, use the install bind command in global configuration mode. To remove the Software Modularity software binding, use the no form of this command.
install bind search-root-directory [prepend]
no install bind
Syntax Description
Command Default
The Cisco IOS Software Modularity software image is not bound.
Command Modes
Global configuration (config)
Command History
Usage Guidelines
The install bind command generates a boot system command, but the install bind command is not inserted into the configuration. The benefit in using the install bind command is that you just specify the search root directory, which is the destination directory used in the install file command, and the Cisco IOS Software Modularity software will determine the directory structure and image file. If you use the boot system command, you must enter the complete directory path and image name.
Each instance of the boot system command generated by an install bind command is saved in the configuration file in the order in which it was configured, which is the normal behavior for boot system commands. To configure a system to have the newly installed Software Modularity image as the primary image to boot, you must remove all previous boot system commands in the configuration and enter them in the order in which you want them to run. Alternatively, you can download the startup configuration to a text file, insert the new install bind or boot system command, and copy the changes back into the startup configuration.
To remove all boot system commands from the configuration file, use the no form of the boot system command without any arguments. Using the no form of the install bind command will remove only the boot system commands for installed software and leave other boot system commands intact.
Note
Examples
The following example shows how to remove all existing boot system commands and to bind the Software Modularity image in the directory named sys:
Router# configure terminalRouter(config)# no boot systemRouter(config)# install bind disk0:/sysRouter(config)# exitRouter# copy running-config startup-configRelated Commands
boot system
Specifies the system image that the router loads at startup.
install file
Installs base system files and patches.
install clear
Note
To remove an entire installed software system, use the install clear command in privileged EXEC mode.
install clear search-root-directory
Syntax Description
search-root-directory
Local directory specified in the destination-directory argument of a previously executed install file command. Valid root directories are /sys, /oldsys, and /newsys.
Command Modes
Privileged EXEC (#)
Command History
12.2(18)SXF4
This command was introduced to support Software Modularity images.
12.2(33)SXI3
This command was removed.
Usage Guidelines
Use the install clear command with caution because the command cannot be reversed. After an installation is cleared, it cannot be undone. Software that is currently running or that has been bound to run cannot be cleared. For bound software, you must remove the binding with the no install bind command before using the install clear command.
Examples
The following example shows how to clear the system installed in the local directory named sys:
Router# install clear disk0:/sysRelated Commands
install bind
Binds Cisco IOS Software Modularity images.
install file
Installs base system files and patches.
install commit
Note
To define a tag name for a set of Cisco IOS Software Modularity software installed in the destination directory of a previously executed install file command, use the install commit command in privileged EXEC mode.
install commit search-root-directory tag-name
Syntax Description
Command Modes
Privileged EXEC (#)
Command History
12.2(18)SXF4
This command was introduced to support Software Modularity images.
12.2(33)SXI3
This command was removed.
Usage Guidelines
This command creates a point to which a user can roll back a system after a patch is installed that is considered unsatisfactory. The tag-name argument provides a name for the point. A tag name must be unique to the local file system.
Use the install prune command to remove a previously defined tag from the installed software.
Examples
The following example shows how to define a tag named tag1 to identify the software installed in the local directory named sys:
Router# install commit disk0:/sys tag1Related Commands
install copy
Note
To make a copy of the Cisco IOS Software Modularity software, use the install copy command in privileged EXEC mode.
install copy source-root-directory destination-root-directory
Syntax Description
Command Modes
Privileged EXEC (#)
Command History
12.2(18)SXF4
This command was introduced to support Software Modularity images.
12.2(33)SXI3
This command was removed.
Usage Guidelines
Use the install copy command to duplicate the Cisco IOS Software Modularity software at the source directory and place it at the destination directory. Both the source and destination directories must be local to the device.
Examples
The following example shows how to copy the software in the directory named sys into a directory named oldsys:
Router# install copy disk0:/sys disk0:/oldsysRelated Commands
install file
Note
To install Cisco IOS Software Modularity base system files and patches, use the install file command in privileged EXEC mode.
install file source-file-url destination-directory [second-destination-directory] [interactive]
Syntax Description
Command Modes
Privileged EXEC (#)
Command History
Usage Guidelines
Use the optional interactive keyword to display more detailed output during the installation. Messages indicating current tasks that are being performed during the installation may be displayed. The default output is a series of ! characters to indicate progress and a message at the end indicating success or failure.
Cisco IOS Software Modularity introduces the concept of installed software that is different from just booting an image on the networking device. Cisco IOS Software Modularity images can be saved into the flash file system and booted like a Cisco IOS image, but this is referred to as uninstalled software. To gain the benefits of the Cisco IOS Software Modularity Installer and permit patch files to be installed, use the install file command to write the software to local storage. Installation and activation are now separate processes; and the install activate command must be entered to activate patches. Some patches will require a reload to be performed, and a message appears on the console after the install activate command has been entered to note the current state of the patch.
Use the show install command to display information about the currently installed software. Use the install clear command to remove an entire installed software system, or use the install rollback command to remove specific patches installed on top of the software version.
Examples
The following example shows how to install two different files from two different paths into the same local directory:
Router# install file tftp://username@hostname//directory/c6kpatch-vz disk0:/sysRouter# install file rcp://s72033/base/s72033-adventerprisek9_wan_dbg-vz disk0:/sysRelated Commands
install move
Note
To move the Cisco IOS Software Modularity software from a source URL to a destination URL, use the install move command in privileged EXEC mode.
install move source-root-directory destination-root-directory
Syntax Description
Command Modes
Privileged EXEC (#)
Command History
12.2(18)SXF4
This command was introduced to support Software Modularity images.
12.2(33)SXI3
This command was removed.
Usage Guidelines
Use the install move command to copy the Cisco IOS Software Modularity software from a source directory to a destination directory and then remove the software from the source directory. Both the source and destination directories must be local.
Examples
The following example shows how to move the software from the directory named /sys to the directory named /oldsys. The software will be removed from the /sys directory.
Router# install move disk0:/sys disk0:/oldsysRelated Commands
install prune
Note
To remove a tag or unused files from the software that is installed in the destination directory specified in a previously executed install file command, use the install prune command in privileged EXEC mode.
install prune search-root-directory tag-name [files]
Syntax Description
Command Modes
Privileged EXEC (#)
Command History
12.2(18)SXF4
This command was introduced to support Software Modularity images.
12.2(18)SXF8
The files keyword was added.
12.2(33)SXI3
This command was removed.
Usage Guidelines
In addition to removing the tag from the installed software, the install prune command removes any files that are no longer required by the system as a result of the tag removal. After this command is executed, rollback can be performed to any previously installed tag.
When this command is executed using the optional files keyword, all of the tags from the base image to the tag specified are removed except for the specified tag. After this command is entered with the optional files keyword, rollback cannot be done to any tag beyond the specified tag; rollback can be performed to the base image only.
Examples
The following example shows how to remove the tag named tag1 from the installed software.
Router# install prune disk0:/sys tag1The following example shows how to remove all of the tags from the base image up to tag1. Tag1 is not removed.
Router# install prune disk0:/sys tag1 filesRelated Commands
install commit
Defines a tag for a set of software installed by the install file command.
install file
Installs base system files and patches.
install repackage
Note
To create an installation or backup installable file from an installed system when a Cisco IOS Software Modularity image is running, use the install repackage command in privileged EXEC mode.
install repackage source-root-directory destination-file-url [compress]
Syntax Description
Command Modes
Privileged EXEC (#)
Command History
12.2(18)SXF4
This command was introduced to support Software Modularity images.
12.2(33)SXI3
This command was removed.
Usage Guidelines
To allow for easier deployment of a base image and several patches to multiple routers, an installable bundled image, referred to as a repackage, can be replicated. Use the install repackage command to generate a installable file from an installed system. The installable file can be used in an installation on another device or as a backup installation for the current device. While the image is being replicated, the Software Modularity Installer saves everything in the installed state including rollback tags. An initial boot must be performed on the device on which the replicated image is to be installed. The ability to create a repackage allows standard installations to be performed across the network and saves installation time.
Examples
The following example shows how to create an installation or backup file named s72033-finance-vm.repackage from an installed system:
Router# install repackage disk0:/sys disk0:/s72033-finance-vm.repackageRelated Commands
install rollback
Note
To roll back the installed Cisco IOS Software Modularity software to the point at which a tag was defined, use the install rollback command in privileged EXEC mode.
install rollback search-root-directory tag-name
Syntax Description
Command Modes
Privileged EXEC (#)
Command History
12.2(18)SXF4
This command was introduced to support Software Modularity images.
12.2(33)SXI3
This command was removed.
Usage Guidelines
Similar to the idea of a database rollback, Cisco IOS Software Modularity images can roll back to a set of installed files defined by a tag. The installed system is captured at a point in time by defining a tag using the install commit command. If a subsequent installation of a patch file adversely affects the installed system, a rollback can be performed using the defined tag. The install activate command must be entered after the install rollback command to activate the rollback. All installation actions performed since the tag was defined are deleted, and the processes affected by the rollback of installed software are restarted after the rollback is activated. After the restart, these processes use the software that was present at the time the tag was created. Tags can be deleted, and the system will remove all installation files that will now never be used because the tag has been removed.
Examples
The following example shows how to roll back the software to the time that tag1 was defined and then restart all the affected processes. The tag named tag1 is assumed to have been created using the install commit command in an earlier configuration.
Router# install rollback disk0:/sys tag1Router# install activate disk0:/sysRelated Commands
process restart
To terminate and restart a process when a Cisco IOS Software Modularity image is running, use the process restart command in privileged EXEC mode.
process restart process-name [:instance-id] [cold]
Syntax Description
Command Modes
Privileged EXEC (#)
Command History
Usage Guidelines
The process restart command can be used to restart a newly installed version of an executable. Under special circumstances, it can also be used to restart a process that is operating in suboptimal mode. Only processes that are controlled by the System Manager can be restarted.
When restarting, a process will retrieve the previous state information from the saved configuration checkpoint. A cold restart means that the process will delete the previous state information from the saved configuration checkpoint.
If the process restart command is entered without first saving the active running configuration session and checkpointing the configuration changes, the changes could be lost. The following console warning about this possible configuration loss is displayed:
Some config has not yet been checkpointed and may be lost. It is recommended to do a `write checkpoint' to checkpoint the config and re-start the process. Do you want tocontinue ? [no]:If you restart the process, a message similar to the following is displayed:
Restarting process iprouting.iosproc02:51:21: %kern-6-SYSLOG_GEN: <30>:02:51:21:;1144354584.745:sysmgr.proc[72]: Some config for process iprouting.iosproc:1 has not yet beencheckpointed and may be lostTo checkpoint the configuration, use the write checkpoint command. Some commands also checkpoint internally upon being entered, such as the write memory command, the copy running-config startup-config command and the show running-config command.
In Software Modularity, you cannot restart a process on the standby router. The standby router console is disabled by default. If you enable the standby router console, and then enter the process restart command to restart a process, the standby console will reload and display one of the following error messages:
Standby process exited, rebooting.or
This process is not known to sysmgr.Examples
The following example restarts the Cisco Discovery Protocol (CDP) process:
Router# process restart cdp2.iosprocRelated Commands
process start
To initiate (spawn) a foreground or background POSIX process when a Cisco IOS Software Modularity image is running, use the process start command in privileged EXEC mode.
process start path/process-name [argument-1...argument-n] [&]
Syntax Description
Command Modes
Privileged EXEC (#)
Command History
12.2(18)SXF4
This command was introduced to support Software Modularity images.
Usage Guidelines
The process start command is used to control POSIX processes and processes that are registered with sysmgr by using .startup and .init files. To terminate a POSIX process that is running in the foreground, use the Ctrl-C (^C) keyboard sequence.
Output for processes that are running in the foreground is directed to the tty (including Telnet) that initiates the command. Output for processes that are running in the background is directed only to the console.
Examples
The following example initiates a POSIX process to run in the background:
Router# process start disk0:/sbin/process1 &Related Commands
process stop
Terminates a process when running a Cisco IOS Software Modularity image without restarting the process.
process stop
To terminate a process without restarting the process when a Cisco IOS Software Modularity image is running, use the process stop command in privileged EXEC mode.
process stop process-name [:instance-id]
Syntax Description
Command Default
After a process is terminated, the process is restarted.
Command Modes
Privileged EXEC (#)
Command History
12.2(18)SXF4
This command was introduced to support Software Modularity images.
Usage Guidelines
Use the process stop command to shut down (terminate) the specified process and any simultaneously executing copies. The process is not restarted, even if it had a respawn option specified.
Note
Examples
The following example shuts down all instances of the POSIX process named process1:
Router# process stop process1Related Commands
service checkpoint-config
To enable implicit configuration checkpointing when a Cisco IOS Software Modularity image is running, use the service checkpoint-config command in global configuration mode. To return to the default setting, use the no form of this command.
service checkpoint-config
no service checkpoint-config
Syntax Description
This command has no arguments or keywords.
Command Default
Implicit configuration checkpointing is disabled.
Command Modes
Global configuration (config)
Command History
12.2(18)SXF4
This command was introduced to support Software Modularity images.
12.2(33)SXH
Automatic configuration checkpointing is disabled by default.
Usage Guidelines
Implicit configuration checkpointing means that configuration checkpointing occurs for all processes. A Software Modularity process can be restarted under an error condition or after upgrading. When the process is restarted and operational, the state of the process returns to the state the process was in prior to the restart. The software checkpoints the configuration information and when the process restarts, the configuration information is read from the checkpoint.
Configuration checkpoint information is implicitly generated as follows:
•
•
•
If you have a large configuration file, the default configuration checkpoint process may take some time to complete and prevent you from entering other CLI commands to save or display the configuration.
In Cisco IOS Release 12.2(18)SXF4, the checkpoint process is enabled by default. To disable the checkpoint process, enter the no form of the service checkpoint-config command. When you are ready to run the configuration checkpoint process, use the write checkpoint command to run the configuration checkpoint process.
In Cisco IOS Release 12.2(33)SXH, the default setting was changed to no service checkpoint-config, which means the checkpoint process is diabled by default. To enable the checkpoint process in this release, use the service checkpoint-config command.
Examples
In the following example for Cisco IOS Release 12.2(18)SXF4, the no form of the service checkpoint-config command is entered to disable the configuration checkpoint process, configuration commands are entered, and after exiting from the configuration mode the write checkpoint command is entered to run the configuration checkpoint process.
configure terminalno service checkpoint-config!! Configuration commands are entered.endwrite checkpointRelated Commands
write checkpoint
Runs the configuration checkpoint process when a Cisco IOS Software Modularity image is running.
show buffers
To display statistics for the buffer pools on the network server when Cisco IOS or Cisco IOS Software Modularity images are running, use the show buffers command in user EXEC or privileged EXEC mode.
show buffers [{address hex-address | failures | pool pool-name | processes | {all | assigned [process-id] | free | old | input-interface interface-type interface-number} [pool pool-name]} [dump | header | packet]]
Syntax Description
Command Default
If no options are specified, all buffer pool information is displayed.
Command Modes
User EXEC (>)
Privileged EXEC (#)Command History
Examples
Example output varies between Cisco IOS software images and Cisco IOS Software Modularity software images. To view the appropriate output, choose one of the following sections:
•
Cisco IOS Software
The following is sample output from the show buffers command with no arguments, showing all buffer pool information:
Router# show buffersBuffer elements:398 in free list (500 max allowed)1266 hits, 0 misses, 0 createdPublic buffer pools:Small buffers, 104 bytes (total 50, permanent 50):50 in free list (20 min, 150 max allowed)551 hits, 0 misses, 0 trims, 0 createdMiddle buffers, 600 bytes (total 25, permanent 25):25 in free list (10 min, 150 max allowed)39 hits, 0 misses, 0 trims, 0 createdBig buffers, 1524 bytes (total 50, permanent 50):49 in free list (5 min, 150 max allowed)27 hits, 0 misses, 0 trims, 0 createdVeryBig buffers, 4520 bytes (total 10, permanent 10):10 in free list (0 min, 100 max allowed)0 hits, 0 misses, 0 trims, 0 createdLarge buffers, 5024 bytes (total 0, permanent 0):0 in free list (0 min, 10 max allowed)0 hits, 0 misses, 0 trims, 0 createdHuge buffers, 18024 bytes (total 0, permanent 0):0 in free list (0 min, 4 max allowed)0 hits, 0 misses, 0 trims, 0 createdInterface buffer pools:Ethernet0 buffers, 1524 bytes (total 64, permanent 64):16 in free list (0 min, 64 max allowed)48 hits, 0 fallbacks16 max cache size, 16 in cacheEthernet1 buffers, 1524 bytes (total 64, permanent 64):16 in free list (0 min, 64 max allowed)48 hits, 0 fallbacks16 max cache size, 16 in cacheSerial0 buffers, 1524 bytes (total 64, permanent 64):16 in free list (0 min, 64 max allowed)48 hits, 0 fallbacks16 max cache size, 16 in cacheSerial1 buffers, 1524 bytes (total 64, permanent 64):16 in free list (0 min, 64 max allowed)48 hits, 0 fallbacks16 max cache size, 16 in cacheTokenRing0 buffers, 4516 bytes (total 48, permanent 48):0 in free list (0 min, 48 max allowed)48 hits, 0 fallbacks16 max cache size, 16 in cacheTokenRing1 buffers, 4516 bytes (total 32, permanent 32):32 in free list (0 min, 48 max allowed)16 hits, 0 fallbacks0 failures (0 no memory)The following is sample output from the show buffers command with no arguments, showing onlybuffer pool information for Huge buffers. This output shows a highest total of five Huge buffers created five days and 18 hours before the command was issued.
Router# show buffersHuge buffers, 18024 bytes (total 5, permanent 0, peak 5 @ 5d18h): 4 in free list (3 min, 104 max allowed) 0 hits, 1 misses, 101 trims, 106 created 0 failures (0 no memory)The following is sample output from the show buffers command with no arguments, showing only buffer pool information for Huge buffers. This output shows a highest total of 184 Huge buffers created one hour, one minute, and 15 seconds before the command was issued.
Router# show buffersHuge buffers, 65280 bytes (total 4, permanent 2, peak 184 @ 01:01:15):4 in free list (0 min, 4 max allowed)32521 hits, 143636 misses, 14668 trims, 14670 created143554 failures (0 no memory)The following is sample output from the show buffers command with an interface type and interface number:
Router# show buffers Ethernet 0Ethernet0 buffers, 1524 bytes (total 64, permanent 64):16 in free list (0 min, 64 max allowed)48 hits, 0 fallbacks16 max cache size, 16 in cache
Table 6 describes the significant fields shown in the display.
Cisco IOS Software Modularity
The following is sample output from the show buffers command using a Cisco IOS Modularity image from Cisco IOS Release 12.2(18)SXF4 and later releases. Two new output fields were introduced—Public buffer heads and Temporary buffer heads—and are shown within comments in the following sample output.
Router# show buffersBuffer elements:500 in free list (500 max allowed)106586 hits, 0 misses, 0 createdPublic buffer pools:Small buffers, 104 bytes (total 50, permanent 50, peak 54 @ 1d13h):49 in free list (20 min, 150 max allowed)54486 hits, 0 misses, 4 trims, 4 created0 failures (0 no memory)Middle buffers, 600 bytes (total 25, permanent 25, peak 27 @ 1d13h):25 in free list (10 min, 150 max allowed)20 hits, 0 misses, 2 trims, 2 created0 failures (0 no memory)Big buffers, 1536 bytes (total 50, permanent 50):50 in free list (40 min, 150 max allowed)6 hits, 0 misses, 0 trims, 0 created0 failures (0 no memory)VeryBig buffers, 4520 bytes (total 10, permanent 10):10 in free list (0 min, 100 max allowed)0 hits, 0 misses, 0 trims, 0 created0 failures (0 no memory)Large buffers, 5024 bytes (total 0, permanent 0):0 in free list (0 min, 10 max allowed)0 hits, 0 misses, 0 trims, 0 created0 failures (0 no memory)Huge buffers, 18024 bytes (total 1, permanent 0, peak 1 @ 1d13h):0 in free list (0 min, 4 max allowed)1 hits, 0 misses, 0 trims, 0 created0 failures (0 no memory)! Start of Cisco IOS Software Modularity fieldsPublic buffer headers:Header buffers, 880 bytes (total 1000, peak 142 @ 1d13h):864 in permanent free list142 hits, 0 missesTemporary buffer headers:Header buffers, 896 bytes (total 0):0 in free list0 hits, 0 misses, 0 trims, 0 created0 failures! End of Cisco IOS Software Modularity fieldsInterface buffer pools:Logger Pool buffers, 600 bytes (total 150, permanent 150):150 in free list (150 min, 150 max allowed)22 hits, 0 missesTable 7 describes the significant fields shown in the display that are different from the fields in Table 6.
show exception
To display the current exception configuration when a Cisco IOS Software Modularity image is running, use the show exception command in user EXEC or privileged EXEC mode.
show exception
Syntax Description
This command has no arguments or keywords.
Command Modes
User EXEC (>)
Privileged EXEC (#)Command History
12.2(18)SXF4
This command was introduced to support Software Modularity images.
Usage Guidelines
Use the show exception command to display the current process and kernel dumper configuration as configured by the various exception commands used in Software Modularity images.
Examples
The following is sample output from the show exception command:
Router# show exceptionCore Dump Configurations:Choice 1========Filepath : disk0:Filename : test1Lower Filename Suffix : 0Upper Filename Suffix : 4Current Filename Suffix : 0Compression : onChoice 2========Filepath : disk1:Filename : test1Lower Filename Suffix : 0Upper Filename Suffix : 4Current Filename Suffix : 0Compression : onChoice 3========Filepath : slot0Filename : test1Lower Filename Suffix : 0Upper Filename Suffix : 4Current Filename Suffix : 0Compression : onTable 8 describes the significant fields shown in the display.
Related Commands
show install
To display information about the installed Cisco IOS Software Modularity software, including patch files, use the show install command in user EXEC or privileged EXEC mode.
show install [tags] {running | search-root-directory} [tagname tag-name] [detailed | pending]
Syntax Description
Command Modes
User EXEC (>)
Privileged EXEC (#)Command History
Examples
The following is sample output from the show install running command:
Router# show install runningSoftware running on card installed at location s72033 - Slot 5 :B/P C State Filename--- - -------- --------B Active disk0:/sys/s72033/base/s72033-adventerprisek9_wan_dbg-vm(12.2(99)SX1010)Software running on card installed at location s72033_rp - Slot 5 :B/P C State Filename--- - -------- --------P Active disk0:/sys/s72033_rp/patch/patch-AAA1258-patch-0-n.soSoftware running on card installed at location s72033 - Slot 6 :B/P C State Filename--- - -------- --------B Active slavedisk0:/sys/s72033/base/s72033-adventerprisek9_wan_dbg-vm(12.2(99)SX1010)LEGEND:-------:B/P/MP - (B)ase image, (P)atch, or (M)aintenance (P)ack'C' - (C)ommittedPruned - This file has been pruned from the systemActive - This file is active in the systemPendInst - This file is set to be made available to run on thesystem after next activation.PendRoll - This file is set to be rolled back after next activation.InstPRel - This file will run on the system after next reloadRollPRel - This file will be removed from the system after next reloadRPRPndIn - This file is both rolled back pending a reload, and pendinginstallation. On reload, this file will not run and will move toPendInst state. If 'install activate' is done before reload, pendingremoval and install cancel each other and file simply remains activeIPRPndRo - This file is both installed pending a reload, and pending rollback.If the card reloads, it will be active on the system pending a rollbackIf 'install activate' is done before a reload, the pending install andremoval with cancel each other and the file will simply be removedOccluded - This file has been occluded from the system,a newer version of itself has superceded it.Ignored - This file is ignored, is not consumed by target.Table 9 describes the significant fields shown in the display.
The following is sample output from the show install running command with the detailed keyword:
Router# show install running detailedSoftware running on card installed at location s72033 - Slot 5 :Base image : disk0:/sys/s72033/base/s72033-adventerprisek9_wan_dbg-vmVersion : 12.2(99)SX1010File state: Active File Checksum : 8BB2F966EA945E8E25010A1BAC7205C3DFBCA197Date Installed : 19:51:22 UTC Sep 8 2005 Commit Tags : baseSoftware running on card installed at location s72033_rp - Slot 5 :Base image : disk0:/sys/s72033_rp/base/DRACO2_MPFile state: Active File Checksum : 48849DBB2E47A8C55AC68CF3F6EE747B054CD392Date Installed : 19:49:06 UTC Sep 8 2005 Commit Tags : baseSoftware running on card installed at location s72033 - Slot 6 :Base image : slavedisk0:/sys/s72033/base/s72033-adventerprisek9_wan_dbg-vmVersion : 12.2(99)SX1010File state: Active File Checksum : 8BB2F966EA945E8E25010A1BAC7205C3DFBCA197Date Installed : 19:32:21 UTC Sep 8 2005 Commit Tags : base Patch : slavedisk0:/sys/s72033/patch/patch-AAA1258-patch-0-n.soFile state: PendInst File Checksum : A129339A6A3ED1F8B92D6992AD1BE67C716E4430Date Installed : 20:31:01 UTC Sep 9 2005 Commit Tags : NONE Maintenance Pack : MA0005Table 10 describes the significant fields shown in the display.
In the following example, the show install privileged EXEC command is used to display information about the tags that are defined for this system:
Router# show install tags runningTags defined over software running on location s72033 - Slot 5 :Tagname # of Files Date Committed-------------------- ---------- ------------------------base 1 20:08:51 UTC Sep 9 2005MA0005 1 20:34:16 UTC Sep 9 2005Tags defined over software running on location s72033_rp - Slot 5 :Tagname # of Files Date Committed-------------------- ---------- ------------------------base 1 20:08:51 UTC Sep 9 2005MA0005 1 20:34:16 UTC Sep 9 2005Tags defined over software running on location s72033 - Slot 6 :Tagname # of Files Date Committed-------------------- ---------- ------------------------base 1 20:28:54 UTC Sep 9 2005Table 11 describes the significant fields shown in the display.
In the following example, the show install privileged EXEC command is used to display detailed information about the tags that are defined for this system:
Router# show install tags running detailedTags defined over software running on location s72033 :Tag Name :baseDate Committed :Fri Sep 9 17:54:37 2005Files under this tag:disk0:/sys/s72033/base/s72033-adventerprisek9_wan_dbg-vmIn the following example, the show install privileged EXEC command is used to display detailed information about the tag named tag1:
Router# show install tags running tagname tag1 detailedTags defined over software running on location c7200:Tag Name : tag1Date Committed : 01:49:23 UTC Mar 8 2006Files under this tag: disk0:/sys/c7200/base/c7200-p-vmTable 12 describes the significant fields shown in the display.
Related Commands
show memory
To display statistics about memory when Cisco IOS or Cisco IOS software Modularity images are running, use the show memory command in user EXEC or privileged EXEC mode.
Cisco IOS Software
show memory [memory-type] [free] [overflow] [summary]
Cisco IOS Software Modularity
show memory
Syntax Description
Command Modes
User EXEC (>)
Privileged EXEC (#)Command History
Usage Guidelines
Cisco IOS Software
The show memory command displays information about memory available after the system image decompresses and loads.
Cisco IOS Software Modularity
No optional keywords or arguments are supported for the show memory command when a Software Modularity image is running. To display details about PSOIX and Cisco IOS style system memory information when Software Modularity images are running, use the show memory detailed command.
Examples
Example output varies between Cisco IOS software images and Cisco IOS Software Modularity software images. To view the appropriate output, choose one of the following sections:
•
Cisco IOS Software
The following is sample output from the show memory command:
Router# show memoryHead Total(b) Used(b) Free(b) Lowest(b) Largest(b)Processor B0EE38 5181896 2210036 2971860 2692456 2845368Processor memoryAddress Bytes Prev. Next Ref PrevF NextF Alloc PC WhatB0EE38 1056 0 B0F280 1 18F132 List ElementsB0F280 2656 B0EE38 B0FD08 1 18F132 List HeadersB0FD08 2520 B0F280 B10708 1 141384 TTY dataB10708 2000 B0FD08 B10F00 1 14353C TTY Input BufB10F00 512 B10708 B11128 1 14356C TTY Output BufB11128 2000 B10F00 B11920 1 1A110E Interrupt StackB11920 44 B11128 B11974 1 970DE8 *Init*B11974 1056 B11920 B11DBC 1 18F132 messagesB11DBC 84 B11974 B11E38 1 19ABCE Watched BooleanB11E38 84 B11DBC B11EB4 1 19ABCE Watched BooleanB11EB4 84 B11E38 B11F30 1 19ABCE Watched BooleanB11F30 84 B11EB4 B11FAC 1 19ABCE Watched BooleanThe following is sample output from the show memory free command:
Router# show memory freeHead Total(b) Used(b) Free(b) Lowest(b) Largest(b)Processor B0EE38 5181896 2210076 2971820 2692456 2845368Processor memoryAddress Bytes Prev. Next Ref PrevF NextF Alloc PC What24 Free list 1CEB844 32 CEB7A4 CEB88C 0 0 0 96B894 SSE Manager52 Free list 272 Free list 376 Free list 480 Free list 5D35ED4 80 D35E30 D35F4C 0 0 D27AE8 96B894 SSE ManagerD27AE8 80 D27A48 D27B60 0 D35ED4 0 22585E SSE Manager88 Free list 6100 Free list 7D0A8F4 100 D0A8B0 D0A980 0 0 0 2258DA SSE Manager104 Free list 8B59EF0 108 B59E8C B59F84 0 0 0 2258DA (fragment)The output of the show memory free command contains the same types of information as the show memory output, except that only free memory is displayed, and the information is ordered by free list.
The first section of the display includes summary statistics about the activities of the system memory allocator. Table 13 describes the significant fields shown in the first section of the display.
The second section of the display is a block-by-block listing of memory use. Table 14 describes the significant fields shown in the second section of the display.
The show memory io command displays the free I/O memory blocks. On the Cisco 4000 router, this command quickly shows how much unused I/O memory is available.
The following is sample output from the show memory io command:
Router# show memory ioAddress Bytes Prev. Next Ref PrevF NextF Alloc PC What6132DA0 59264 6132664 6141520 0 0 600DDEC 3FCF0 *Packet Buffer*600DDEC 500 600DA4C 600DFE0 0 6132DA0 600FE68 0600FE68 376 600FAC8 600FFE0 0 600DDEC 6011D54 06011D54 652 60119B4 6011FEO 0 600FE68 6013D54 0614FCA0 832 614F564 614FFE0 0 601FD54 6177640 06177640 2657056 6172E90 0 0 614FCA0 0 0Total: 2723244The following example displays details of a memory block overflow correction when the exception memory ignore overflow global configuration command is configured:
Router# show memory overflowCount Buffer Count Last corrected Crashinfo files1 1 00:11:17 slot0:crashinfo_20030620-075755Traceback 607D526C 608731A0 607172F8 607288E0 607A5688 607A566CThe report includes the amount of time since the last correction was made and the name of the file that logged the memory block overflow details.
The show memory sram command displays the free SRAM memory blocks. For the Cisco 4000 router, this command supports the high-speed static RAM memory pool to make it easier for you to debug or diagnose problems with allocation or freeing of such memory.
The following is sample output from the show memory sram command:
Router# show memory sramAddress Bytes Prev. Next Ref PrevF NextF Alloc PC What7AE0 38178 72F0 0 0 0 0 0Total 38178The following example of the show memory command used on the Cisco 4000 router includes information about SRAM memory and I/O memory:
Router# show memoryHead Total(b) Used(b) Free(b) Lowest(b) Largest(b)Processor 49C724 28719324 1510864 27208460 26511644 15513908I/O 6000000 4194304 1297088 2897216 2869248 2896812SRAM 1000 65536 63400 2136 2136 2136Address Bytes Prev. Next Ref PrevF NextF Alloc PC What1000 2032 0 17F0 1 3E73E *Init*17F0 2032 1000 1FE0 1 3E73E *Init*1FE0 544 17F0 2200 1 3276A *Init*2200 52 1FE0 2234 1 31D68 *Init*2234 52 2200 2268 1 31DAA *Init*2268 52 2234 229C 1 31DF2 *Init*72F0 2032 6E5C 7AE0 1 3E73E Init7AE0 38178 72F0 0 0 0 0 0The show memory summary command displays a summary of all memory pools and memory usage per Alloc PC (address of the system call that allocated the block).
The following is a partial sample output from the show memory summary command. This output shows the size, blocks, and bytes allocated. Bytes equal the size multiplied by the blocks. For a description of the other fields, see Table 13 and Table 14.
Router# show memory summaryHead Total(b) Used(b) Free(b) Lowest(b) Largest(b)Processor B0EE38 5181896 2210216 2971680 2692456 2845368Processor memoryAlloc PC Size Blocks Bytes What0x2AB2 192 1 192 IDB: Serial Info0x70EC 92 2 184 Init0xC916 128 50 6400 RIF Cache0x76ADE 4500 1 4500 XDI data0x76E84 4464 1 4464 XDI data0x76EAC 692 1 692 XDI data0x77764 408 1 408 Init0x77776 116 1 116 Init0x777A2 408 1 408 Init0x777B2 116 1 116 Init0xA4600 24 3 72 List0xD9B5C 52 1 52 SSE Manager...0x0 0 3413 2072576 Pool Summary0x0 0 28 2971680 Pool Summary (Free Blocks)0x0 40 3441 137640 Pool Summary (All Block Headers)0x0 0 3413 2072576 Memory Summary0x0 0 28 2971680 Memory Summary (Free Blocks)Cisco IOS Software Modularity
The following is sample output from the show memory command when a Cisco IOS Software Modularity image is running.
Router# show memorySystem Memory: 262144K total, 116148K used, 145996K free 4000K kernel reservedTable 15 describes the significant fields shown in the display.
Related Commands
show memory detailed
To display detailed memory information about POSIX and Cisco IOS processes when Cisco IOS Software Modularity images are running, use the show memory detailed command in privileged EXEC mode.
show memory detailed [process-id | process-name] [start-address [end-address] | bigger | free | physical | shared | statistics | summary]
Syntax Description
Command Default
No detailed memory information about POSIX and Cisco IOS processes is displayed.
Command Modes
Privileged EXEC (#)
Command History
12.2(18)SXF4
This command was introduced to support Software Modularity images.
Usage Guidelines
Detailed output of the process memory on the device is displayed with this command. The process memory summary is displayed first, followed by POSIX and Cisco IOS memory information. The POSIX memory information includes the address, the size in bytes, and the type of memory used by various segments such as program text, data, stack, shared memory, device memory, and heap. Cisco IOS memory information includes the native Cisco IOS display of memory blocks maintained by the Cisco IOS memory management library.
Examples
The following is partial sample output from the show memory detailed command for a Cisco IOS process:
Router# show memory detailed cdp2.iosprocSystem Memory: 131072K total, 115836K used, 15236K free 4000K kernel reservedProcess sbin/cdp2.iosproc, type IOS, PID = 12329636K total, 4K text, 4K data, 28K stack, 600K dynamic16384 heapsize, 3972 allocated, 10848 freeAddress Bytes What0x3B42000 4194304 Shared Memory0x7FBB000 8192 Program Stack0x8020000 49152 Program Text0x802C000 4096 Program Data0x802D000 8192 Allocated memory0x60000000 4096 Shared Memory "SHM_IDB"0x60001000 32768 Shared MemoryHead Total(b) Used(b) Free(b) Lowest(b) Largest(b)Processor 8034058 508152 480420 27732 17368 18716Processor memoryAddress Bytes Prev Next Ref PrevF NextF Alloc PC what08034058 0000020008 00000000 08038EB8 001 -------- -------- 727FB668 Managed Chunk Queue Elements08038EB8 0000002568 08034058 080398F8 001 -------- -------- 72871A44 *Init*080398F8 0000001512 08038EB8 08039F18 001 -------- -------- 728819D4 List Elements...The first section of the display shows system summary information. Table 16 describes the significant fields shown in the first section of the display.
The second section of the display includes process summary statistics about the activities of the system memory allocator. Table 17 describes the significant fields shown in the second section of the display.
The third section of the display shows POSIX process perspective memory information. Table 18 describes the significant fields shown in the third section of the display.
The fourth section of the display shows Cisco IOS memory information as a block-by-block listing of memory use. Table 19 describes the significant fields shown in the fourth section of the display.
The following is sample output from the show memory detailed command for a POSIX process:
Router# show memory detailed 12290System Memory: 131072K total, 115876K used, 15196K free 4000K kernel reservedProcess sbin/sysmgr.proc, type POSIX, PID = 12290400K total, 100K text, 144K data, 12K stack, 144K dynamic81920 heapsize, 68716 allocated, 8824 freeAddress Bytes What0x7FDF000 126976 Program Stack (pages not allocated)0x7FFE000 4096 Program Stack0x8000000 122880 Program Stack (pages not allocated)0x801E000 8192 Program Stack0x8020000 102400 Program Text0x8039000 147456 Program Data0x805D000 8192 Heap Memory0x8060000 16384 Heap Memory0x8064000 16384 Heap Memory0x8068000 8192 Heap Memory0x806C000 16384 Heap Memory0x8070000 16384 Heap Memory0x8074000 16384 Heap Memory0x8078000 16384 Heap Memory0x807C000 16384 Heap Memory0x8080000 16384 Heap MemoryThe following partial sample output from the show memory detailed command with a process name and the physical keyword that displays the summary of physical memory used by the specified process along with the shared memory details:
Router# show memory detailed sysmgr.proc physicalPid Data Stack Dynamic Text Shared Maps Process20482 304K 16K 256K 3480K 468K 60 sysmgr.procTotal Physical Memory used or mapped by sysmgr.procPrivate memory used (Data/Stack/Dynamic) : 576KShared memory mapped (Text/Shared) : 3948KNumber of memory maps : 60Dev 1:Text/Data 2:Mapped 3:Shared 4:DSOFlags SHD:Shared PRV:Private FXD:Fixed ANN:Anon PHY:PhysLZY:Lazy ELF:Elf STK:Stack NOC:NocachePhy Addr Size Pid Virt Addr What Dev Prot MapFlags0x0 32768K 20482 0x70000000 Text 4 R-X SHD FXD ELF0x2000000 32768K 20482 0x72000000 Text 4 R-X SHD FXD ELF0x4000000 32768K 20482 0x74000000 Text 4 R-X SHD FXD ELF0x522B000 4K 20482 0x1020000 Text 4 R-X SHD FXD ELFPhy Addr Size Pid Virt Addr What Dev Prot MapFlags0x9EFD4000 32K 20482 0x105C000 Heap 2 RW- PRV ANN0x9EFF0000 32K 20482 0x1054000 Heap 2 RW- PRV ANN0x9EFF8000 32K 20482 0x1034000 Heap 2 RW- PRV ANN0x9F003000 4K 20482 0x7B43C000 Data 4 RW- PRV FXD ANN ELF...Table 20 describes the significant fields shown in the display.
Related Commands
show memory
Displays system memory information.
show memory detailed all
Displays detailed memory information of all applicable processes.
show memory detailed all
To display detailed memory information of all applicable processes when Cisco IOS Software Modularity images are running, use the show memory detailed all command in privileged EXEC mode.
show memory detailed all [[start-address [end-address] | failures alloc | shared | statistics [history] | summary] | [fast | io | multibus [pci] | pci | processor] [allocating-process [totals] | dead [totals] | free | physical]]
Syntax Description
Command Modes
Privileged EXEC (#)
Command History
Usage Guidelines
Detailed output of all applicable processes on the device is displayed with this command. Use the optional arguments and keywords to display specific detailed information.
Examples
The following is partial sample output from the show memory detailed all command:
Router# show memory detailed allSystem Memory: 2097152K total, 1303301K used, 793851K free, 0K kernel reservedLowest(b) : 812904448Process kernel, type POSIX, PID = 1Process sbin/chkptd.proc, type POSIX, PID = 163863448K total, 2516K text, 672K data, 16K stack, 244K dynamic204800 heapsize, 108612 allocated, 56448 freeAddress Bytes What0x4813D000 4096 Unknown type0x4813E000 126976 Program Stack (pages not allocated)0x4815D000 4096 Program Stack0x4815E000 4096 Unknown type0x4815F000 126976 Program Stack (pages not allocated)0x4817E000 4096 Program Stack0x4817F000 4096 Unknown type0x48180000 516096 Program Stack (pages not allocated)0x481FE000 8192 Program Stack0x48200000 8192 Shared object data "sbin/chkptd.proc"0x48202000 4096 Shared object data "sbin/chkptd.proc"0x48203000 237568 Heap Memory0x68000000 917504 Shared Memory0x680E0000 66191360 Shared Memory0x80100000 8192 Shared Memory0x80102000 4096 Shared Memory0x80103000 397312 Shared Memory0x80164000 4096 Shared Memory0xFE300000 614400 Shared object text "lib/libc.so"0xFE396000 45056 Shared object data "lib/libc.so"0xFE3A1000 12288 Heap Memory0xFE3A4000 20480 Shared object text "lib/s72044-adventerprisek9_dbg-014-dso-"0xFE3A9000 65536 Shared object data "/dev/zero"0xFE3B9000 4096 Shared object data "lib/s72044-adventerprisek9_dbg-014-dso-"0xFE3BA000 434176 Shared object text "lib/s72044-adventerprisek9_dbg-001-dso-"0xFE424000 65536 Shared object data "/dev/zero".....The first section of the display shows system summary information. Table 21 describes the significant fields shown in the first section of the display.
The second section of the display includes process summary statistics about the activities of the system memory allocator. Table 22 describes the significant fields shown in the second section of the display.
The third section of the display shows process perspective memory information. Table 23 describes the significant fields shown in the third section of the display.
The following is partial output from the show memory detailed all io command:
Router# show memory detailed all ioSystem Memory: 2097152K total, 1302133K used, 795019K free, 0K kernel reservedLowest(b) : 812314624Process sbin/ios-base, type IOS, PID = 16425257172K total, 139268K text, 77292K data, 168K stack, 40444K dynamicI/O memoryAddress Bytes Prev Next Ref PrevF NextF Alloc PC what70000000 0000000024 00000000 70000050 000 FAE73E24 0 00000000 (fragmen)70000050 0000000808 70000000 700003B0 001 -------- -------- F9D15B78 *Packet *700003B0 0000000808 70000050 70000710 001 -------- -------- F9D15B78 *Packet *70000710 0000000808 700003B0 70000A70 001 -------- -------- F9D15B78 *Packet *70000A70 0000000808 70000710 70000DD0 001 -------- -------- F9D15B78 *Packet *70000DD0 0000000808 70000A70 70001130 001 -------- -------- F9D15B78 *Packet *70001130 0000000808 70000DD0 70001490 001 -------- -------- F9D15B78 *Packet *Address Bytes Prev Next Ref PrevF NextF Alloc PC what70001490 0000000808 70001130 700017F0 001 -------- -------- F9D15B78 *Packet *700017F0 0000000808 70001490 70001B50 001 -------- -------- F9D15B78 *Packet *70001B50 0000000808 700017F0 70001EB0 001 -------- -------- F9D15B78 *Packet *70001EB0 0000000808 70001B50 70002210 001 -------- -------- F9D15B78 *Packet *70002210 0000000808 70001EB0 70002570 001 -------- -------- F9D15B78 *Packet *70002570 0000000808 70002210 700028D0 001 -------- -------- F9D15B78 *Packet *700028D0 0000000808 70002570 70002C30 001 -------- -------- F9D15B78 *Packet *70002C30 0000000808 700028D0 70002F90 001 -------- -------- F9D15B78 *Packet *70002F90 0000000808 70002C30 700032F0 001 -------- -------- F9D15B78 *Packet *700032F0 0000000808 70002F90 70003650 001 -------- -------- F9D15B78 *Packet *70003650 0000000808 700032F0 700039B0 001 -------- -------- F9D15B78 *Packet *Process sbin/test_proc.iosproc, type IOS, PID = 20551Processor memoryAddress Bytes Prev Next Ref PrevF NextF Alloc PC what4821B058 0000020000 00000000 4821FEB0 001 -------- -------- FE5306C0 Managed s4821FEB0 0000002560 4821B058 482208E8 001 -------- -------- FE4597B4 *Init*482208E8 0000005000 4821FEB0 48221CA8 001 -------- -------- FE60DA80 List Heas48221CA8 0000000088 482208E8 48221D38 001 -------- -------- FE44559C *Init*48221D38 0000000088 48221CA8 48221DC8 001 -------- -------- FE44559C *Init*48221DC8 0000000024 48221D38 48221E18 001 -------- -------- FE445A6C *Init*...Table 24 describes the significant fields shown in the display.
Related Commands
show pakman
To display Packet Manager details, use the show pakman command in privileged EXEC mode.
show pakman {clients | statistics}
Syntax Description
clients
Displays all the clients connected to the Packet Manager.
statistics
Displays Packet Manager statistics.
Command Modes
Privileged EXEC (#)
Command History
12.2(33)SXH1
This command was introduced in a release earlier than Cisco IOS Release 12.2(33)SXH1.
Usage Guidelines
The show pakman command is supported only on Cisco IOS Software Modularity images. The output of the show pakman statistics command provides more information for debugging packet memory issues.
Examples
The following is sample output from the show pakman clients command:
Router# show pakman clientsConnected clients to the Packet Manager=======================================Pid Coid Process Name usage----- ---- ------------ -----24599 196615 ios-base 126/731224613 8 fh_server.proc 0/731224615 9 call_home.proc 0/731224616 10 inetd.proc 0/731224618 131083 ipfs_daemon.proc 0/731224617 12 tcp.proc 0/731224620 13 raw_ip.proc 0/731224621 15 udp.proc 0/731224623 18 cdp2.iosproc 0/731224622 19 iprouting.iosproc 1/7312Table 26 describes the significant fields shown in the display.
The following sample output from the show pakman statistics command displays the different memory regions used by the Packet Manager for various uses. Some regions, such as the temporary packet and subblock region, can have multiple regions because regions can be added when the system requires more packet headers or subblocks. The region provided for data buffers is fixed and does not grow.
Router# show pakman statisticsPacket Manager Regions======================Packet Shared Context 0x6C000000 -> 0x6C003078 (12408 bytes)Permanent Header Region 0x6C004000 -> 0x6C0F8FFF (1003520 bytes)Temp Header & Subblock Region 0x6C0F9000 -> 0x6C175FFF (512000 bytes)Data Buffer Region 0x6400000 -> 0x7FFFFFF (29360128 bytes)Temp Header & Subblock Memory Block Manager Statistics======================================================Blocksize Allocs Frees Inuse Cached136 0 0 0 1272 0 0 0 0544 7 0 7 11088 0 0 0 02176 0 0 0 14352 0 0 0 08704 0 0 0 017408 0 0 0 134816 0 0 0 069632 0 0 0 1139264 0 0 0 1278528 0 0 0 1557056 0 0 0 01114112 0 0 0 0Buffer memory usage: free 507688 total 512000 largest block 278484 in-use 4312.Memory Block grows:0 shrinks:0Data Buffer Memory Block Manager Statistics===========================================Blocksize Allocs Frees Inuse Cached448 66 16 50 0896 31 6 25 71792 56 6 50 53584 0 0 0 17168 74 0 74 214336 0 0 0 128672 0 0 0 057344 0 0 0 1114688 0 0 0 1229376 0 0 0 0458752 0 0 0 0917504 0 0 0 11835008 0 0 0 13670016 1 0 1 6Buffer memory usage: free 24992128 total 29360128 largest block 3669972 in-use 4368000.Threshold tracking is enabled, notify state = 0, memory in-use 4335308.packet count=0 max=0 limit=0 (limited 0 times) drops=0Table 26 describes the significant fields shown in the display.
Related Commands
show buffers
Display statistics for the buffer pools on the network server when Cisco IOS or Cisco IOS Software Modularity images are running.
show processes
To display information about the active Cisco IOS, Cisco IOS XE, or the Cisco IOS Software Modularity POSIX-style processes, use the show processes command in user EXEC or privileged EXEC mode.
show processes [history | process-id | timercheck]
Syntax Description
Command Modes
User EXEC (>)
Privileged EXEC (#)Command History
Usage Guidelines
Cisco IOS Software Modularity
Although no optional keywords or arguments are supported for the base show processes command when a Software Modularity image is running, more details about processes are displayed using the show processes cpu, show processes detailed, show processes kernel, and show processes memory commands.
Examples
Example output varies between Cisco IOS software images and Cisco IOS Software Modularity software images. The following sections show output examples for each image:
•
•
Cisco IOS Software
The following is sample output from the show processes command:
Router# show processesCPU utilization for five seconds: 21%/0%; one minute: 2%; five minutes: 2%PID QTy PC Runtime (ms) Invoked uSecs Stacks TTY Process1 Cwe 606E9FCC 0 1 0 5600/6000 0 Chunk Manager2 Csp 607180F0 0 121055 0 2608/3000 0 Load Meter3 M* 0 8 90 88 9772/12000 0 Exec4 Mwe 619CB674 0 1 023512/24000 0 EDDRI_MAIN5 Lst 606F6AA4 82064 61496 1334 5668/6000 0 Check heaps6 Cwe 606FD444 0 127 0 5588/6000 0 Pool Manager7 Lwe 6060B364 0 1 0 5764/6000 0 AAA_SERVER_DEADT8 Mst 6063212C 0 2 0 5564/6000 0 Timers9 Mwe 600109D4 0 2 0 5560/6000 0 Serial Backgroun10 Mwe 60234848 0 2 0 5564/6000 0 ATM Idle Timer11 Mwe 602B75F0 0 2 0 8564/9000 0 ATM AutoVC Perio12 Mwe 602B7054 0 2 0 5560/6000 0 ATM VC Auto Crea13 Mwe 606068B8 0 2 0 5552/6000 0 AAA high-capacit14 Msi 607BABA4 251264 605013 415 5628/6000 0 EnvMon15 Mwe 607BFF8C 0 1 0 8600/9000 0 OIR Handler16 Mwe 607D407C 0 10089 0 5676/6000 0 IPC Dynamic Cach17 Mwe 607CD03C 0 1 0 5632/6000 0 IPC Zone Manager18 Mwe 607CCD80 0 605014 0 5708/6000 0 IPC Periodic Tim19 Mwe 607CCD24 0 605014 0 5704/6000 0 IPC Deferred Por20 Mwe 607CCE2C 0 1 0 5596/6000 0 IPC Seat ManagerTable 27 describes the significant fields shown in the display.
Note
For a list of process descriptions, see http://www.cisco.com/en/US/products/sw/iosswrel/ps1828/products_tech_note09186a00800a65d0.shtml.
The following is sample output from the show processes history command:
Router# show processes historyPID Exectime(ms) Caller PC Process Name3 12 0x0 Exec16 0 0x603F4DEC GraphIt21 0 0x603CFEF4 TTY Background22 0 0x6042FD7C Per-Second Jobs67 0 0x6015CD38 SMT input39 0 0x60178804 FBM Timer16 0 0x603F4DEC GraphIt21 0 0x603CFEF4 TTY Background22 0 0x6042FD7C Per-Second Jobs16 0 0x603F4DEC GraphIt21 0 0x603CFEF4 TTY Background22 0 0x6042FD7C Per-Second Jobs67 0 0x6015CD38 SMT input39 0 0x60178804 FBM Timer24 0 0x60425070 Compute load avgs11 0 0x605210A8 ARP Input69 0 0x605FDAF4 DHCPD Database69 0 0x605FD568 DHCPD Database51 0 0x60670B3C IP Cache Ager69 0 0x605FD568 DHCPD Database36 0 0x606E96DC SSS Test Client69 0 0x605FD568 DHCPD Database--More--Table 28 describes the significant fields shown in the display.
The following is sample output from the show processes process-id command:
Router# show processes 6Process ID 6 [Pool Manager], TTY 0Memory usage [in bytes]Holding: 921148, Maximum: 940024, Allocated: 84431264, Freed: 99432136Getbufs: 0, Retbufs: 0, Stack: 12345/67890CPU usagePC: 0x60887600, Invoked: 188, Giveups: 100, uSec: 245Sec: 3.03%, 1Min: 2.98%, 5Min: 1.55%, Average: 0.58%,Age: 662314 msec, Runtime: 3841 msecState: Running, Priority: NormalTable 29 describes the significant fields shown in the display.
Cisco IOS Software Modularity
The following is sample output from the show processes command when a Cisco IOS Software Modularity image is running:
Router# show processesTotal CPU utilization for 5 seconds: 99.7%; 1 minute: 98.9%; 5 minutes: 86.5%PID TID Prio STATE Blocked Stack CPU Name1 1 0 Ready 0 (128K) 2m28s procnto-cisco1 2 63 Receive 1 0 (128K) 0.000 procnto-cisco1 3 10 Receive 1 0 (128K) 0.000 procnto-cisco1 4 11 Receive 1 0 (128K) 1.848 procnto-cisco1 5 63 Receive 1 0 (128K) 0.000 procnto-cisco1 6 63 Receive 1 0 (128K) 0.000 procnto-cisco12290 1 10 Receive 1 12288(128K) 0.080 chkptd.proc12290 2 10 Receive 8 12288(128K) 0.000 chkptd.proc3 1 15 Condvar 1027388 12288(128K) 0.016 qdelogger3 2 15 Receive 1 12288(128K) 0.004 qdelogger3 3 16 Condvar 1040024 12288(128K) 0.004 qdelogger4 1 10 Receive 1 4096 (128K) 0.016 devc-pty6 1 62 Receive 1 8192 (128K) 0.256 devc-ser26816 2 63 Intr 8192 (128K) 0.663 devc-ser26817 1 10 Receive 1 32768(128K) 0.080 dumper.proc7 2 10 Receive 1 32768(128K) 0.008 dumper.proc7 3 10 Receive 1 32768(128K) 0.000 dumper.proc7 4 10 Receive 1 32768(128K) 0.020 dumper.proc7 5 10 Receive 1 32768(128K) 0.008 dumper.proc4104 2 10 Receive 1 12288(128K) 0.000 pipe4104 3 10 Receive 1 12288(128K) 0.000 pipe--More--Table 30 describes the significant fields shown in the display.
Cisco Catalyst 4500e Series Switches Running Cisco IOS XE Software
The following is sample output from the show processes command:
Switch# show processesCPU utilization for five seconds: 1%; one minute: 4%; five minutes: 3%PID TID Runtime(ms) Invoked uSecs Stacks Process1 935 596 156971 84/8192 init2 0 79 10405 0/8192 kthreadd3 12 2206 5578 0/8192 migration/04 12 772 15601 0/8192 ksoftirqd/05 6 1089 6357 0/8192 migration/16 14 877 16484 0/8192 ksoftirqd/17 15 374 42475 0/8192 events/08 9 333 27531 0/8192 events/19 5 637 9070 0/8192 khelper61 28 45 628533 0/8192 kblockd/062 80 175 461994 0/8192 kblockd/175 0 21 1238 0/8192 khubd78 0 23 652 0/8192 kseriod83 7 26 271115 0/8192 kmmcd120 0 25 320 0/8192 pdflush121 12 68 190382 0/8192 pdflush122 0 29 172 0/8192 kswapd0123 0 31 161 0/8192 aio/0124 0 33 121 0/8192 aio/1291 0 35 142 0/8192 kpsmoused309 0 37 135 0/8192 rpciod/0310 0 39 128 0/8192 rpciod/1354 71 425 167583 84/8192 udevd700 117 3257 35991 0/8192 loop1716 0 55 1145 0/8192 loop2732 115 2336 49574 0/8192 loop32203 86 627 138015 84/8192 dbus-daemon2539 0 432 1974 84/8192 portmap2545 0 434 2011 84/8192 portmap2588 1 450 2384 84/8192 sshd2602 2 444 6677 84/8192 xinetd2606 1 444 3191 84/8192 xinetd3757 0 71 70 84/8192 vsi work/0--More--Table 31 describes the significant fields shown in the display.
Related Commands
show processes cpu
To display detailed CPU utilization statistics (CPU use per process) when Cisco IOS or Cisco IOS Software Modularity images are running, use the show processes cpu command in user EXEC or privileged EXEC mode.
Cisco IOS Software
show processes cpu [history [table] | sorted [1min | 5min | 5sec]]
Cisco IOS Software Modularity
show processes cpu [detailed [process-id | process-name] | history]
Syntax Description
Command Modes
User EXEC (>)
Privileged EXEC (#)Command History
Usage Guidelines
Cisco IOS Software
If you use the optional history keyword, three graphs are displayed for Cisco IOS images:
•
•
•
Maximum usage is measured and recorded every second; average usage is calculated on periods of more than one second. Consistently high CPU utilization over an extended period indicates a problem. Use the show processes cpu command to troubleshoot. Also, you can use the output of this command in the Cisco Output Interpreter tool to display potential issues and fixes. Output Interpreter is available to registered users of Cisco.com who are logged in and have Java Script enabled.
For a list of system processes, go to http://www.cisco.com/en/US/products/sw/iosswrel/ps1828/products_tech_note09186a00800a65d0.shtml.
Cisco IOS Software Modularity
Cisco IOS Software Modularity images display only one graph that shows the CPU utilization for the last 60 minutes. The horizontal axis shows times (for example, 0, 5, 10, 15 minutes), and the vertical axis shows total percentage of CPU utilization (0 to 100 percent).
Examples
Example output varies between Cisco IOS software images and Cisco IOS Software Modularity software images. The following sections show output examples for each image:
•
Cisco IOS Software
The following is sample output from the show processes cpu command without keywords:
Router# show processes cpuCPU utilization for five seconds: 5%/2%; one minute: 3%; five minutes: 2%PID Runtime (ms) Invoked uSecs 5Sec 1Min 5Min TTY Process1 1736 58 29931 0% 0% 0% 0 Check heaps2 68 585 116 1.00% 1.00% 0% 0 IP Input3 0 744 0 0% 0% 0% 0 TCP Timer4 0 2 0 0% 0% 0% 0 TCP Protocols5 0 1 0 0% 0% 0% 0 BOOTP Server6 16 130 123 0% 0% 0% 0 ARP Input7 0 1 0 0% 0% 0% 0 Probe Input8 0 7 0 0% 0% 0% 0 MOP Protocols9 0 2 0 0% 0% 0% 0 Timers10 692 64 10812 0% 0% 0% 0 Net Background11 0 5 0 0% 0% 0% 0 Logger12 0 38 0 0% 0% 0% 0 BGP Open13 0 1 0 0% 0% 0% 0 Net Input14 540 3466 155 0% 0% 0% 0 TTY Background15 0 1 0 0% 0% 0% 0 BGP I/O16 5100 1367 3730 0% 0% 0% 0 IGRP Router17 88 4232 20 0.20% 1.00% 0% 0 BGP Router18 152 14650 10 0% 0% 0% 0 BGP Scanner19 224 99 2262 0% 0% 1.00% 0 ExecThe following is sample output of the one-hour portion of the output. The Y-axis of the graph is the CPU utilization. The X-axis of the graph is the increment within the time period displayed in the graph. This example shows the individual minutes during the previous hour. The most recent measurement is on the left of the X-axis.
Router# show processes cpu history!--- One minute output omitted6665776865756676676666667667677676766666766767767666566667 63780161989935137097719914437323586899327408582696439226131009080 * * * * * * * *70 * * ***** * ** ***** *** **** ****** * ******* * *60 #***##*##*#***#####*#*###*****#*###*#*#*##*#*##*#*##*****#50 ##########################################################40 ##########################################################30 ##########################################################20 ##########################################################10 ##########################################################0....5....1....1....2....2....3....3....4....4....5....5....0 5 0 5 0 5 0 5 0 5CPU% per minute (last 60 minutes)* = maximum CPU% # = average CPU%!--- 72-hour output omittedThe top two rows, read vertically, display the highest percentage of CPU utilization recorded during the time increment. In this example, the CPU utilization for the last minute recorded is 66 percent. The device may have reached 66 percent only once during that minute, or it may have reached 66 percent multiple times. The device records only the peak reached during the time increment and the average over the course of that increment.
The following is sample output from the show processes cpu command on a Cisco uBR10012 router:
Router# show processes cpuCPU utilization for five seconds: 2%/0%; one minute: 2%; five minutes: 2%PID Runtime(ms) Invoked uSecs 5Sec 1Min 5Min TTY Process1 8 471 16 0.00% 0.00% 0.00% 0 Chunk Manager2 4 472 8 0.00% 0.00% 0.00% 0 Load Meter3 0 1 0 0.00% 0.00% 0.00% 0 IPC 0x50000 Vers4 0 10 0 0.00% 0.00% 0.00% 0 C10K Card Event5 0 65 0 0.00% 0.00% 0.00% 0 Retransmission o6 0 5 0 0.00% 0.00% 0.00% 0 IPC ISSU Dispatc7 5112 472 10830 0.63% 0.18% 0.18% 0 Check heaps8 0 1 0 0.00% 0.00% 0.00% 0 Pool Manager9 0 2 0 0.00% 0.00% 0.00% 0 Timers10 0 2 0 0.00% 0.00% 0.00% 0 Serial Backgroun11 0 786 0 0.00% 0.00% 0.00% 0 WBCMTS process12 0 1 0 0.00% 0.00% 0.00% 0 AAA_SERVER_DEADT13 0 1 0 0.00% 0.00% 0.00% 0 Policy Manager14 0 1 0 0.00% 0.00% 0.00% 0 Crash writer15 0 1 0 0.00% 0.00% 0.00% 0 RO Notify Timers16 0 1 0 0.00% 0.00% 0.00% 0 RMI RM Notify Wa17 0 2364 0 0.00% 0.00% 0.00% 0 Facility Alarm18 0 41 0 0.00% 0.00% 0.00% 0 IPC Dynamic CachThe following is sample output from the show processes cpu command that shows an ARP probe process:
Router# show processes cpu | include ARP17 38140 389690 97 0.00% 0.00% 0.00% 0 ARP Input36 0 1 0 0.00% 0.00% 0.00% 0 IP ARP Probe40 0 1 0 0.00% 0.00% 0.00% 0 ATM ARP INPUT80 0 1 0 0.00% 0.00% 0.00% 0 RARP Input114 0 1 0 0.00% 0.00% 0.00% 0 FR ARPTable 32 describes the fields shown in the output.
Note
Cisco IOS Software Modularity
The following is sample output from the show processes cpu command when a Software Modularity image is running:
Router# show processes cpuTotal CPU utilization for 5 seconds: 99.6%; 1 minute: 98.5%; 5 minutes: 85.3%PID 5Sec 1Min 5Min Process1 0.0% 0.1% 0.8% kernel3 0.0% 0.0% 0.0% qdelogger4 0.0% 0.0% 0.0% devc-pty6 0.7% 0.2% 0.1% devc-ser26817 0.0% 0.0% 0.0% dumper.proc4104 0.0% 0.0% 0.0% pipe8201 0.0% 0.0% 0.0% mqueue8202 0.0% 0.0% 0.0% fsdev.proc8203 0.0% 0.0% 0.0% flashfs_hes_slot1.proc8204 0.0% 0.0% 0.0% flashfs_hes_slot0.proc8205 0.0% 0.0% 0.0% flashfs_hes_bootflash.proc8206 0.0% 0.0% 0.0% dfs_disk2.proc8207 0.0% 0.0% 0.0% dfs_disk1.proc8208 0.0% 0.0% 0.0% dfs_disk0.proc8209 0.0% 0.0% 0.0% ldcache.proc8210 0.0% 0.0% 0.0% watchdog.proc8211 0.0% 0.0% 0.0% syslogd.proc8212 0.0% 0.0% 0.0% name_svr.proc8213 0.0% 0.1% 0.0% wdsysmon.proc8214 0.0% 0.0% 0.0% sysmgr.proc8215 0.0% 0.0% 0.0% kosh.proc12290 0.0% 0.0% 0.0% chkptd.proc12312 0.0% 0.0% 0.0% sysmgr.proc12313 0.0% 0.0% 0.0% syslog_dev.proc12314 0.0% 0.0% 0.0% itrace_exec.proc12315 0.0% 0.0% 0.0% packet.proc12316 0.0% 0.0% 0.0% installer.proc12317 29.1% 28.5% 19.6% ios-base12318 0.0% 0.0% 0.0% fh_fd_oir.proc12319 0.0% 0.0% 0.1% fh_fd_cli.proc12320 0.0% 0.0% 0.0% fh_metric_dir.proc12321 0.0% 0.0% 0.0% fh_fd_snmp.proc12322 0.0% 0.0% 0.0% fh_fd_none.proc12323 0.0% 0.0% 0.0% fh_fd_intf.proc12324 48.5% 48.5% 35.8% iprouting.iosproc12325 0.0% 0.0% 0.0% fh_fd_timer.proc12326 0.0% 0.0% 0.0% fh_fd_ioswd.proc12327 0.0% 0.0% 0.0% fh_fd_counter.proc12328 0.0% 0.0% 0.0% fh_fd_rf.proc12329 0.0% 0.0% 0.0% fh_server.proc12330 0.0% 0.0% 0.0% cdp2.iosproc12331 0.0% 0.0% 0.0% fh_policy_dir.proc12332 0.0% 0.0% 0.0% ipfs_daemon.proc12333 0.0% 0.0% 0.0% raw_ip.proc12334 0.0% 0.0% 0.0% inetd.proc12335 19.1% 20.4% 12.6% tcp.proc12336 0.0% 0.0% 0.0% udp.procTable 33 describes the significant fields shown in the display.
The following is partial sample output from the show processes cpu command with the detailed keyword when a Software Modularity image is running:
Router# show processes cpu detailedTotal CPU utilization for 5 seconds: 99.6%; 1 minute: 99.3%; 5 minutes: 88.6%PID/TID 5Sec 1Min 5Min Process Prio STATE CPU1 0.0% 0.7% 0.7% kernel 8.9001 0.4% 0.7% 11.4% [idle thread] 0 Ready 2m28s2 0.0% 0.0% 0.0% 63 Receive 0.0003 0.0% 0.0% 0.0% 10 Receive 0.0004 0.0% 0.0% 0.1% 11 Receive 1.8485 0.0% 0.0% 0.0% 63 Receive 0.000...PID/TID 5Sec 1Min 5Min Process Prio STATE CPU8214 0.0% 0.0% 0.0% sysmgr.proc 0.2161 0.0% 0.0% 0.0% 10 Receive 0.1322 0.0% 0.0% 0.0% 10 Sigwaitin 0.0003 0.0% 0.0% 0.0% 10 Receive 0.0044 0.0% 0.0% 0.0% 10 Receive 0.0005 0.0% 0.0% 0.0% 10 Receive 0.0006 0.0% 0.0% 0.0% 10 Receive 0.0047 0.0% 0.0% 0.0% 10 Receive 0.0008 0.0% 0.0% 0.0% 10 Receive 0.0009 0.0% 0.0% 0.0% 10 Receive 0.00010 0.0% 0.0% 0.0% 10 Receive 0.00011 0.0% 0.0% 0.0% 10 Receive 0.00012 0.0% 0.0% 0.0% 10 Receive 0.00013 0.0% 0.0% 0.0% 10 Receive 0.02814 0.0% 0.0% 0.0% 10 Receive 0.04015 0.0% 0.0% 0.0% 10 Receive 0.00016 0.0% 0.0% 0.0% 10 Receive 0.00017 0.0% 0.0% 0.0% 10 Receive 0.00418 0.0% 0.0% 0.0% 10 Receive 0.00019 0.0% 0.0% 0.0% 10 Receive 0.00020 0.0% 0.0% 0.0% 10 Receive 0.00021 0.0% 0.0% 0.0% 10 Receive 0.00422 0.0% 0.0% 0.0% 10 Receive 0.000PID/TID 5Sec 1Min 5Min Process Prio STATE CPU8215 0.0% 0.0% 0.0% kosh.proc 0.0441 0.0% 0.0% 0.0% 10 Reply 0.044PID/TID 5Sec 1Min 5Min Process Prio STATE CPU12290 0.0% 0.0% 0.0% chkptd.proc 0.0801 0.0% 0.0% 0.0% 10 Receive 0.0802 0.0% 0.0% 0.0% 10 Receive 0.000PID/TID 5Sec 1Min 5Min Process Prio STATE CPU12312 0.0% 0.0% 0.0% sysmgr.proc 0.1121 0.0% 0.0% 0.0% 10 Receive 0.1122 0.0% 0.0% 0.0% 10 Sigwaitin 0.000PID/TID 5Sec 1Min 5Min Process Prio STATE CPU12316 0.0% 0.0% 0.0% installer.proc 0.0721 0.0% 0.0% 0.0% 10 Receive 0.0003 0.0% 0.0% 0.0% 10 Nanosleep 0.0004 0.0% 0.0% 0.0% 10 Sigwaitin 0.0006 0.0% 0.0% 0.0% 10 Receive 0.000Process sbin/ios-base, type IOS, PID = 12317CPU utilization for five seconds: 12%/9%; one minute: 13%; five minutes: 10%Task Runtime(ms) Invoked uSecs 5Sec 1Min 5Min TTY Task Name1 219 1503 145 0.00% 0.00% 0.00% 0 Hot Service Task2 23680 42384 558 2.39% 6.72% 4.81% 0 Service Task3 6104 11902 512 3.51% 1.99% 1.23% 0 Service Task4 1720 5761 298 1.91% 0.90% 0.39% 0 Service Task5 0 5 0 0.00% 0.00% 0.00% 0 Chunk Manager6 0 1 0 0.00% 0.00% 0.00% 0 Connection Mgr7 4 106 37 0.00% 0.00% 0.00% 0 Load Meter8 6240 7376 845 0.23% 0.15% 0.55% 0 Exec9 379 62 6112 0.00% 0.07% 0.04% 0 Check heaps10 0 1 0 0.00% 0.00% 0.00% 0 Pool Manager11 3 2 1500 0.00% 0.00% 0.00% 0 Timers12 0 1 0 0.00% 0.00% 0.00% 0 AAA_SERVER_DEADT13 0 2 0 0.00% 0.00% 0.00% 0 AAA high-capacit14 307 517 593 0.00% 0.05% 0.03% 0 EnvMon15 0 1 0 0.00% 0.00% 0.00% 0 OIR Handler16 283 58 4879 0.00% 0.04% 0.02% 0 ARP Input17 0 2 0 0.00% 0.00% 0.00% 0 Serial Backgroun18 0 81 0 0.00% 0.00% 0.00% 0 ALARM_TRIGGER_SC19 0 2 0 0.00% 0.00% 0.00% 0 DDR Timers20 0 2 0 0.00% 0.00% 0.00% 0 Dialer event21 4 2 2000 0.00% 0.00% 0.00% 0 Entity MIB API22 0 54 0 0.00% 0.00% 0.00% 0 Compute SRP rate23 0 9 0 0.00% 0.00% 0.00% 0 IPC Dynamic Cach24 0 1 0 0.00% 0.00% 0.00% 0 IPC Zone Manager25 0 1 0 0.00% 0.00% 0.00% 0 IPC Punt Process26 4 513 7 0.00% 0.00% 0.00% 0 IPC Periodic Tim27 11 513 21 0.00% 0.00% 0.00% 0 IPC Deferred Por28 0 1 0 0.00% 0.00% 0.00% 0 IPC Seat Manager29 83 1464 56 0.00% 0.00% 0.00% 0 EEM ED Syslog...Table 34 describes the significant fields shown in the display.
Related Commands
show processes
Displays information about active processes.
show processes memory
Displays the amount of system memory used per system process.
show processes detailed
To display detailed information about POSIX and Cisco IOS processes when Cisco IOS Software Modularity images are running, use the show processes detailed command in user EXEC or privileged EXEC mode.
show processes detailed [process-id | process-name]
Syntax Description
Command Default
If no process ID or process name is specified, detailed information is displayed about all processes.
Command Modes
User EXEC (>)
Privileged EXEC (#)Command History
12.2(18)SXF4
This command was introduced to support Software Modularity images.
Usage Guidelines
Use the show processes detailed command to gather detailed information about the number of tasks running, the process state, and other information about a process that is not displayed by the show processes command.
Examples
The following is sample output from the show processes detailed command for the process named sysmgr.proc:
Router# show processes detailed sysmgr.procJob Id: 67PID: 8210Executable name: sysmgr.procExecutable path: sbin/sysmgr.procInstance ID: 1Args: -pRespawn: ONRespawn count: 1Max. spawns per minute: 30Last started: Mon Aug18 17:08:53 2003Process state: Runcore: SHAREDMEM MAINMEMMax. core: 0Level: 39PID TID Stack pri state Blked HR:MM:SS:MSEC FLAGS NAME8210 1 52K 10 Receive 1 0:00:00:0071 00000000 sysmgr.proc8210 2 52K 10 Sigwaitinfo 0:00:00:0000 00000000 sysmgr.proc8210 3 52K 10 Receive 8 0:00:00:0003 00000000 sysmgr.proc8210 4 52K 10 Reply 1 0:00:00:0003 00000000 sysmgr.proc8210 5 52K 10 Receive 1 0:00:00:0000 00000000 sysmgr.proc8210 6 52K 10 Receive 1 0:00:00:0015 00000000 sysmgr.proc8210 7 52K 10 Receive 1 0:00:00:0000 00000000 sysmgr.proc8210 8 52K 10 Receive 1 0:00:00:0000 00000000 sysmgr.proc-----------------------------------------------------------------Job Id: 78PID: 12308Executable name: sysmgr.procExecutable path: sbin/sysmgr.procInstance ID: 2Args: -pRespawn: ONRespawn count: 1Max. spawns per minute: 30Last started: Mon Aug18 17:08:54 2003Process state: Runcore: SHAREDMEM MAINMEMMax. core: 0Level: 40PID TID Stack pri state Blked HR:MM:SS:MSEC FLAGS NAME12308 1 16K 10 Receive 1 0:00:00:0039 00000000 sysmgr.proc12308 2 16K 10 Sigwaitinfo 0:00:00:0000 00000000 sysmgr.proc-----------------------------------------------------------------Table 35 describes the significant fields shown in the display.
Related Commands
show processes kernel
To display information about System Manager kernel processes when Cisco IOS Software Modularity images are running, use the show processes kernel command in user EXEC or privileged EXEC mode.
show processes kernel {family | files | signal | startup}
Syntax Description
Command Modes
User EXEC (>)
Privileged EXEC (#)Command History
12.2(18)SXF4
This command was introduced to support Software Modularity images.
Examples
The following is sample output from the show processes kernel command with the family keyword:
Router# show processes kernel familyPID Name Session Pgroup PPID Sibling Child1 kernel 1 1 0 0 6712290 dumper.proc 1 87 67 56 03 devc-pty 1 66 67 0 04 devc-ser2681 1 54 67 66 06 pipe 1 69 67 5 08199 mqueue 1 68 67 69 08200 fsdev.proc 1 57 67 68 08201 flashfs_hes_slot1.proc 1 58 67 57 08202 flashfs_hes_bootflash.proc 1 51 67 58 08203 flashfs_hes_slot0.proc 1 50 67 51 08204 dfs_disk1.proc 1 61 67 50 08205 dfs_disk0.proc 1 60 67 61 08206 ldcache.proc 1 64 67 60 08207 syslogd.proc 1 65 67 64 08208 name_svr.proc 1 63 67 65 08209 wdsysmon.proc 1 52 67 63 08210 sysmgr.proc 1 67 1 0 748211 kosh.proc 56 56 67 52 012308 sysmgr.proc 1 78 67 87 012309 chkptd.proc 1 70 67 78 012310 syslog_dev.proc 1 81 67 70 012311 fh_metric_dir.proc 1 82 67 81 0Table 36 describes the significant fields shown in the display.
The following is sample output from the show processes kernel command with the files keyword:
Router# show processes kernel filesPID Open Files Open Channels Name1 2 42 kernel12290 11 8 dumper.proc3 3 68 devc-pty4 3 43 devc-ser26816 4 4 pipe8199 4 11 mqueue8200 10 15 fsdev.proc8201 8 4 flashfs_hes_slot1.proc8202 8 4 flashfs_hes_bootflash.proc8203 9 4 flashfs_hes_slot0.proc8204 10 4 dfs_disk1.proc8205 10 4 dfs_disk0.proc8206 10 7 ldcache.proc8207 12 11 syslogd.proc8208 9 37 name_svr.proc8209 10 42 wdsysmon.proc8210 21 35 sysmgr.proc8211 6 1 kosh.proc12308 11 10 sysmgr.proc12309 12 22 chkptd.proc12310 11 8 syslog_dev.proc12311 14 8 fh_metric_dir.procTable 37 describes the significant fields shown in the display.
The following is sample output from the show processes kernel command with the signal keyword:
Router# show processes kernel signalPID Name Signals Pending Signals Ignored Signals Queued8199 mqueue 0000000000000000 0000000006800000 00000000000000001 0000000000000000 0000000000020000PID Name Signals Pending Signals Ignored Signals Queued8200 fsdev.proc 0000000000000000 0000000006800000 00000000000000001 0000000000000000 00000000002040032 0000000000000000 00000000002040033 0000000000000000 00000000002040034 0000000000000000 00000000002040035 0000000000000000 00000000002040036 0000000000000000 00000000002040037 0000000000000000 0000000000204003Table 38 describes the significant fields shown in the display.
The following is sample output from the show processes kernel command with the startup keyword:
Router# show processes kernel startupPID Last Started State RCnt Name:Instance_Id Args3 08/18/2003 17:08 Run 1 devc-pty:1 -n 324 08/18/2003 17:08 Run 1 devc-ser2681:1 -e -2 -b9600,96000x1e840404^3,0x50 Not configured None 0 ldcache_preload.proc:1 preload6 08/18/2003 17:08 Run 1 pipe:10 Not configured None 0 clock_chip.proc:1 -r0 Not configured None 0 c7200-p-blob:1 -b8199 08/18/2003 17:08 Run 1 mqueue:18200 08/18/2003 17:08 Run 1 fsdev.proc:1 /dev/slot0: /dev/slot1:/dev/disk0: /dev/disk1: /dev/bootflash:8201 08/18/2003 17:08 Run 1 flashfs_hes_slot1.proc:1 -m /slot1: -d/dev/slot1:8202 08/18/2003 17:08 Run 1 flashfs_hes_bootflash.proc:1 -m/bootflash: -d /dev/bootflash:8203 08/18/2003 17:08 Run 1 flashfs_hes_slot0.proc:1 -m /slot0: -d/dev/slot0:8204 08/18/2003 17:08 Run 1 dfs_disk1.proc:1 -m /disk1: -d/dev/disk1:8205 08/18/2003 17:08 Run 1 dfs_disk0.proc:1 -m /disk0: -d/dev/disk0:8206 08/18/2003 17:08 Run 1 ldcache.proc:18207 08/18/2003 17:08 Run 1 syslogd.proc:18208 08/18/2003 17:08 Run 1 name_svr.proc:1 /chan/reg_svr8209 08/18/2003 17:08 Run 1 wdsysmon.proc:1Table 39 describes the significant fields shown in the display.
Related Commands
show processes memory
To display the amount of memory used by each system process in Cisco IOS, Cisco IOS XE, or Cisco IOS Software Modularity images, use the show processes memory command in privileged EXEC mode.
Cisco IOS Software
show processes memory [process-id | sorted [allocated | getbufs | holding]]
Cisco IOS Software Modularity
show processes memory [detailed [process-name[:instance-id] | process-id [taskid task-id]]] [alloc-summary | sorted {start | size | caller}]
Cisco Catalyst 4500e Series Switches Running Cisco IOS XE Software
show processes memory [detailed [process iosd | task task-id] | sorted [allocated | getbufs | holding]]
Syntax Description
Command Default
Cisco IOS Software
The memory used by all types of system processes is displayed.
Cisco IOS XE Software and Software Modularity
The system memory followed by a one-line summary of memory information about each IOS XE or Software Modularity process is displayed.
Command Modes
Privileged EXEC (#)
Command History
Usage Guidelines
The show processes memory command and the show processes memory sorted command displays a summary of total, used, and free memory, followed by a list of processes and their memory impact.
If the standard show processes memory process-id command is used, processes are sorted by their PID. If the show processes memory sorted command is used, the default sorting is by the Holding value.
Output Prior to Releases 12.3(7)T, 12.2(22)S, and 12.0(28)S
The first line (header line) of the show processes memory [sorted] command listed Total memory, Used memory, and Free memory values.
Output in Releases 12.3(7)T, 12.3(8)T, and 12.2(22)S Through 12.2(27)S2, 12.0(28)S, and 12.0(29)S
In Releases 12.3(7)T, 12.2(22)S, and 12.0(28)S, the Memory Thresholding feature was introduced. This feature affected the header line and the Holding column of the show processes memory command as described in this section.
The value for Total in the show processes memory command and the values listed in the Holding column showed the total (cumulative) value for the processor memory pools and the alternate memory pool* (typically, the I/O memory pool). However, the show processes memory sorted version of this command, and other commands, such as the show memory summary command, did not include the alternate memory pool in the totals; that is, these commands showed the total value for the Processor memory pool only. This caused an observed mismatch of memory totals between commands.
If you are using these releases, use the output of the show memory summary command to determine the individual amounts of Total and Free memory for the Processor memory pool and the I/O memory pool.
Output in Releases 12.3(11)T, 12.2(28)S, 12.0(30)S, and Later Releases
Beginning in Releases 12.3(11)T, 12.2(28)S, and 12.0(30)S, the summary information (first output lines) for the show processes memory command is separated by memory pool. For example, there are now individual lines for Total Process Memory, Total I/O Memory, and Total PCI Memory. In these releases or later releases, your Total Process Memory should match the total process memory shown for other commands, such as the show memory summary command.
About Alternate Memory Pools
An "alternate memory pool" is a memory pool that can be used as an alternative to allocate memory when the target (main) memory pool has been filled. For example, many platforms have a memory type called "Fast" that is limited to a small size (because the memory media used for Fast memory is expensive). You can prevent memory allocations from failing once the available Fast memory has been used up by configuring the normal Processor memory as an alternative memory pool for the Fast memory pool.
Cisco IOS XE Software and Software Modularity
Use the show processes memory command without any arguments and keywords to display the system memory followed by a one-line summary of memory information about each modular Cisco IOS process. Use the detailed keyword with this command to display detailed memory information about all processes. Other arguments and keywords are used to display Cisco IOS Software Modularity process memory information for a specified process name or process ID.
On Cisco IOS XE software images only, the detailed keyword will also show Cisco IOS task memory details.
Examples
Example output varies between Cisco IOS software releases. To see the appropriate output, choose one of the following sections:
•
•
•
•
show processes memory Command for Cisco IOS Releases Prior to 12.3(7)T, 12.2(22)S, and 12.0(28)S
The following is sample output from the show processes memory command:
Router# show processes memoryProcessor Pool Total: 25954228 Used: 8368640 Free: 17585588PID TTY Allocated Freed Holding Getbufs Retbufs Process0 0 8629528 689900 6751716 0 0 *Init*0 0 24048 12928 24048 0 0 *Sched*0 0 260 328 68 350080 0 *Dead*1 0 0 0 12928 0 0 Chunk Manager2 0 192 192 6928 0 0 Load Meter3 0 214664 304 227288 0 0 Exec4 0 0 0 12928 0 0 Check heaps5 0 0 0 12928 0 0 Pool Manager6 0 192 192 12928 0 0 Timers7 0 192 192 12928 0 0 Serial Backgroun8 0 192 192 12928 0 0 AAA high-capacit9 0 0 0 24928 0 0 Policy Manager10 0 0 0 12928 0 0 ARP Input11 0 192 192 12928 0 0 DDR Timers12 0 0 0 12928 0 0 Entity MIB API13 0 0 0 12928 0 0 MPLS HC Counter14 0 0 0 12928 0 0 SERIAL A'detect...78 0 0 0 12992 0 0 DHCPD Timer79 0 160 0 13088 0 0 DHCPD Database8329440 TotalTable 40 describes the significant fields shown in the display.
The following is sample output from the show processes memory command when the sorted keyword is used. In this case, the output is sorted by the Holding column, from largest to smallest.
Router# show processes memory sortedProcessor Pool Total: 25954228 Used: 8371280 Free: 17582948PID TTY Allocated Freed Holding Getbufs Retbufs Process0 0 8629528 689900 6751716 0 0 *Init*3 0 217304 304 229928 0 0 Exec53 0 109248 192 96064 0 0 DHCPD Receive56 0 0 0 32928 0 0 COPS19 0 39048 0 25192 0 0 Net Background42 0 0 0 24960 0 0 L2X Data Daemon58 0 192 192 24928 0 0 X.25 Background43 0 192 192 24928 0 0 PPP IP Route49 0 0 0 24928 0 0 TCP Protocols48 0 0 0 24928 0 0 TCP Timer17 0 192 192 24928 0 0 XML Proxy Client9 0 0 0 24928 0 0 Policy Manager40 0 0 0 24928 0 0 L2X SSS manager29 0 0 0 24928 0 0 IP Input44 0 192 192 24928 0 0 PPP IPCP32 0 192 192 24928 0 0 PPP Hooks34 0 0 0 24928 0 0 SSS Manager41 0 192 192 24928 0 0 L2TP mgmt daemon16 0 192 192 24928 0 0 Dialer event35 0 0 0 24928 0 0 SSS Test Client--More--The following is sample output from the show processes memory command when a process ID (process-id) is specified:
Router# show processes memory 1Process ID: 1Process Name: Chunk ManagerTotal Memory Held: 8428 bytesProcessor memory holding = 8428 bytespc = 0x60790654, size = 6044, count = 1pc = 0x607A5084, size = 1544, count = 1pc = 0x6076DBC4, size = 652, count = 1pc = 0x6076FF18, size = 188, count = 1I/O memory holding = 0 bytesRouter# show processes memory 2Process ID: 2Process Name: Load MeterTotal Memory Held: 3884 bytesProcessor memory holding = 3884 bytespc = 0x60790654, size = 3044, count = 1pc = 0x6076DBC4, size = 652, count = 1pc = 0x6076FF18, size = 188, count = 1I/O memory holding = 0 bytesshow processes memory Command for Cisco IOS Releases Prior to 12.3(11)T, 12.2(28)S, and 12.0(30)S
The following example shows the output of the show processes memory command before the changes to the summary information were made. Note that the Total in the show processes summary command output indicates total memory for all memory pools; in this example, the show processes memory total of 35423840 can be obtained by adding the Processor and I/O totals shown in the output of the show memory summary command. Note also that the show processes memory sorted command lists the Total Processor Memory (matches the show memory summary Processor Total), but the show processes memory command (without the sorted keyword) lists the total for all memory pools (Processor plus I/O memory).
Router# show version | include IOSCisco IOS Software, 3600 Software (C3660-BIN-M), Version 12.3(9)Router# show memory summaryHead Total(b) Used(b) Free(b) Lowest(b) Largest(b)Processor 61E379A0 27035232 8089056 18946176 17964108 17963664I/O 3800000 8388608 2815088 5573520 5561520 5573472...Router# show processes memoryTotal: 35423840, Used: 10904192, Free: 24519648PID TTY Allocated Freed Holding Getbufs Retbufs Process0 0 14548868 3004980 9946092 0 0 *Init*0 0 12732 567448 12732 0 0 *Sched*...Router# show processes memory sortedTotal: 27035232, Used: 8089188, Free: 18946044PID TTY Allocated Freed Holding Getbufs Retbufs Process0 0 14548868 3004980 9946092 0 0 *Init*64 0 76436 3084 74768 0 0 CEF process...Router# show version | include IOSCisco IOS Software, 3600 Software (c3660-p-mz), Version 12.0(29)S,Router# show memory summaryHead Total(b) Used(b) Free(b) Lowest(b) Largest(b)Processor 126CB10 49,331,668 6454676 42876992 42642208 42490796Router# show processes memoryTotal: 50,994,868, Used: 6220092, Free: 44774776PID TTY Allocated Freed Holding Getbufs Retbufs Process0 0 6796228 627336 5325956 0 0 *Init*0 0 200 29792 200 0 0 *Sched*0 0 192 744 0 349000 0 *Dead*1 0 0 0 12896 0 0 Chunk Manager...Router# show processes memory sortedTotal: 50,994,868, Used: 6222644, Free: 44772224PID TTY Allocated Freed Holding Getbufs Retbufs Process0 0 6796228 627336 5325956 0 0 *Init*13 0 39056 0 25264 0 0 Net Background48 0 0 0 24896 0 0 L2X SSS manager18 0 0 0 24896 0 0 IP Input...show processes memory Command for Cisco IOS Software Modularity
In a Cisco IOS Software Modularity image IOS, each process maintains its own heap memory, which is taken from the system memory in blocks. The process reuses this memory as required. If all the memory that was requested in a block is no longer in use, then the process can return the memory block to the system.
The following is sample output from the show processes memory command when a Cisco IOS Software Modularity image is running:
Router# show processes memorySystem Memory : 262144K total, 113672K used, 148472K freePID Text Data Stack Dynamic Total Process1 0 0 12 0 12 kernel12290 52 8 28 196 284 dumper.proc3 12 8 8 144 172 devc-pty4 132 8 8 32 180 devc-ser26816 16 12 24 48 100 pipe8199 12 12 8 48 80 mqueue8200 16 24 48 452 540 fsdev.proc8201 52 20 8 96 176 flashfs_hes_slot1.proc8202 52 20 8 80 160 flashfs_hes_bootflash.proc8203 52 20 8 128 208 flashfs_hes_slot0.proc8204 20 68 12 164 264 dfs_disk1.proc8205 20 68 12 164 264 dfs_disk0.proc8206 36 4 8 144 192 ldcache.proc8207 32 8 20 164 224 syslogd.proc8208 24 4 28 464 520 name_svr.proc8209 124 104 28 344 600 wdsysmon.proc8210 100 144 52 328 624 sysmgr.proc8211 12 4 28 64 108 kosh.proc12308 100 144 16 144 404 sysmgr.proc12309 24 4 12 112 152 chkptd.proc12310 12 4 8 96 120 syslog_dev.proc12311 44 4 24 248 320 fh_metric_dir.proc12312 36 4 24 216 280 fh_fd_snmp.proc12313 36 4 24 216 280 fh_fd_intf.proc12314 32 4 24 216 276 fh_fd_timer.proc12315 40 4 24 216 284 fh_fd_ioswd.proc12316 28 4 24 200 256 fh_fd_counter.proc12317 80 20 44 368 512 fh_server.proc12326 140 40 28 280 488 tcp.proc12327 48 4 24 256 332 udp.proc12328 4 4 28 4660 4696 iprouting.iosproc12329 4 4 36 600 644 cdp2.iosprocTable 41 describes the significant fields shown in the display.
The following example shows the output of the show processes memory detailed command wherein the process (ios-base) holds sufficient memory to process a request of the Cisco IOS tasks without having to request more memory from the system. So although the amount of memory of the Cisco IOS tasks increased, the ios-base process does not consume more system memory.
Router# show processes memory detailed 16424 sorted holdingSystem Memory : 2097152K total, 1097777K used, 999375K free, 0K kernel reservedLowest(b) : 1017212928Process sbin/ios-base, type IOS, PID = 16424248904K total, 0K text, 0K data, 168K stack, 248736K dynamicHeap : 385874960 total, 261213896 used, 124661064 freeTask TTY Allocated Freed Holding Getbufs Retbufs TaskName0 0 156853816 11168 156365472 0 0 *Init*38 0 65671128 3320184 62248368 0 0 PF_Init Process661 0 73106800 38231816 33093704 0 0 PIM Process487 0 2656186248 3806507384 33039576 0 0 cmfib652 0 56256064 19166160 27087872 0 0 MFIB_mrib_read4 0 91088216 68828800 13093720 0 0 Service Task629 0 2059320 132840 1927392 0 0 Const2 IPv6 Pro49 0 2155730560 2153990528 1741536 0 9579588 DiagCard1/-10 0 2510481432 1396998880 1463056 2804860 23260 *Dead*444 0 7333952 5940064 1410992 0 0 FM core411 0 12865536 7934952 1396544 0 0 CMET MGR310 0 113849160 121164584 1284240 0 0 ExecThe following is sample output from the show processes memory command with details about the memory of process 12322 and the task with the ID of 1:
Router# show processes memory detailed 12322 taskid 1System Memory : 262144K total, 113456K used, 148688K freeProcess sbin/c7200-p-blob, type IOS, PID = 1232216568K total, 16K text, 8K data, 64K stack, 16480K dynamicMemory Summary for TaskID = 1Holding = 10248PC Size Count0x7322FC74 9192 10x73236538 640 10x73231E8C 256 10x74175060 160 1Table 42 describes the significant fields shown in the display that are different from Table 41.
The following is sample output from the show processes memory command with details about the memory of POSIX process ID 234567 with summary process memory usage per allocator:
Router# show processes memory detailed 234567 alloc-summarySystem Memory : 262144K total, 113672K used, 148472K freeProcess sbin/sysmgr.proc, type POSIX, PID = 12308404K total, 100K text, 144K data, 16K stack, 144K dynamic81920 heapsize, 68620 allocated, 8896 freeAllocated BlocksAddress Usize Size Caller0x0806C358 0x00000478 0x000004D0 0x721C72900x0806D1E0 0x00000128 0x00000130 0x72B902480x0806D318 0x00003678 0x000036E0 0x72B9820C0x0806D700 0x000002A0 0x000002C0 0x72B8EB580x0806D770 0x00000058 0x00000060 0x72BA54880x0806D7D8 0x000000A0 0x000000B0 0x72B8D2280x0806D8A8 0x00000200 0x00000208 0x721A728C0x0806FF78 0x00000068 0x00000070 0x72BA78EC0x08071438 0x0000005C 0x00000068 0x72B908A80x08071508 0x0000010E 0x00000120 0x72BA7AFC0x08072840 0x000000A8 0x000000C0 0x7270A0600x08072910 0x0000010C 0x00000118 0x7273A8980x08072A30 0x000000E4 0x000000F0 0x727490740x08072B28 0x000000B0 0x000000B8 0x7276E87C0x08072BE8 0x0000006C 0x00000078 0x727367A40x08072C68 0x000000B8 0x000000C0 0x7271E2A40x08072D30 0x000000D0 0x000000D8 0x7273834C0x08072E10 0x00000250 0x00000258 0x72718A700x08073070 0x000002F4 0x00000300 0x727264840x08073378 0x000006A8 0x000006B0 0x73EA4DC40x08073A30 0x00000060 0x00000068 0x7352A9F80x08073B38 0x00000068 0x00000070 0x72B920080x08073BB0 0x00000058 0x00000060 0x72B9201C0x08073EB8 0x00002FB4 0x000031C0 0x08026FEC0x08074028 0x000020B8 0x000020C0 0x72709C9C0x08077400 0x000000A0 0x000000A8 0x721DED940x08078028 0x000022B8 0x000022C0 0x727446B80x0807C028 0x00002320 0x00002328 0x72B907C4Free BlocksAddress Size0x0806FFF0 0x000000100x080714A8 0x000000580x08073E18 0x000000980x08073FE8 0x000000180x08076FA0 0x000003280x080774B0 0x00000B500x0807FFB8 0x000000480x08080028 0x00003FD8Table 43 describes the significant fields shown in the display.
Cisco Catalyst 4500e Series Switches Running Cisco IOS XE Software
The following is sample output from the show processes memory command:
Switch# show processes memorySystem memory : 1943928K total, 733702K used, 1210221K free, 153224K kernel reservedLowest(b) : 642265088PID Text Data Stack Dynamic RSS Total Process1 252 480 84 444 1648 3648 init2 0 0 0 0 0 0 kthreadd3 0 0 0 0 0 0 migration/04 0 0 0 0 0 0 ksoftirqd/05 0 0 0 0 0 0 migration/16 0 0 0 0 0 0 ksoftirqd/17 0 0 0 0 0 0 events/08 0 0 0 0 0 0 events/19 0 0 0 0 0 0 khelper61 0 0 0 0 0 0 kblockd/062 0 0 0 0 0 0 kblockd/175 0 0 0 0 0 0 khubd78 0 0 0 0 0 0 kseriod83 0 0 0 0 0 0 kmmcd120 0 0 0 0 0 0 pdflush121 0 0 0 0 0 0 pdflush122 0 0 0 0 0 0 kswapd0123 0 0 0 0 0 0 aio/0124 0 0 0 0 0 0 aio/1291 0 0 0 0 0 0 kpsmoused309 0 0 0 0 0 0 rpciod/0310 0 0 0 0 0 0 rpciod/1354 92 180 84 136 456 2188 udevd700 0 0 0 0 0 0 loop1716 0 0 0 0 0 0 loop2732 0 0 0 0 0 0 loop32203 424 164 84 132 1172 3180 dbus-daemon2539 76 160 84 132 532 1788 portmap2545 76 160 84 132 532 1788 portmap2588 232 396 84 132 992 4596 sshd2602 196 320 84 132 752 2964 xinetd2606 196 320 84 132 748 2964 xinetd3757 76 160 84 132 532 1788 vsi work/03758 76 160 84 132 532 1788 vsi work/1--More--The following is sample output from the show processes memory detailed command:
Switch# show processes memory detailedSystem memory : 1943928K total, 734271K used, 1209657K free, 153224K kernel reservedLowest(b) : 642265088PID Text Data Stack Dynamic RSS Total Process1 252 480 84 444 1648 3648 init354 92 180 84 136 456 2188 udevd2203 424 164 84 132 1172 3180 dbus-daemon2539 76 160 84 132 532 1788 portmap2545 76 160 84 132 532 1788 portmap2588 232 396 84 132 992 4596 sshd2602 196 320 84 132 752 2964 xinetd2606 196 320 84 132 748 2964 xinetd3757 76 160 84 132 532 1788 vsi work/03758 76 160 84 132 532 1788 vsi work/13891 848 148 84 88 1432 2984 check_gdb_statu3895 72 160 84 132 580 1676 watchdog4453 848 276 84 216 1512 3112 app_printf.sh4465 848 272 84 212 1508 3108 app_printf.sh4596 148 43972 84 528 5176 56664 slprocTaskID TTY Allocated Freed Holding Getbufs Retbufs Task1 0 327920 1544 367952 0 0 Chunk Manager2 0 184 184 37032 0 0 Load Meter3 0 0 0 40032 0 0 Deferred Events4 0 17840 3888 40032 0 0 SpanTree Helper5 0 0 0 40032 0 0 Retransmission of I6 0 0 0 40032 0 0 IPC ISSU Receive Pr7 0 0 0 40032 0 0 Check heaps8 0 179248 173976 45304 144568 140316 Pool Manager9 0 184 184 40032 0 0 Timers10 0 184 184 40032 0 0 Serial Background--More--The following is sample output from the show processes memory detailed command specifying the Iosd process:
Switch# show processes memory detailed process iosdProcessor Pool Total: 805306368 Used: 225960152 Free: 579346216I/O Pool Total: 16777216 Used: 216376 Free: 16560840PID TTY Allocated Freed Holding Getbufs Retbufs Process0 0 226577984 4410320 211589320 0 0 *Init*0 0 0 1591600 0 0 0 *Sched*0 0 2568488 1960496 676992 5368513 362940 *Dead*1 0 327920 1544 367952 0 0 Chunk Manager2 0 184 184 37032 0 0 Load Meter3 0 0 0 40032 0 0 Deferred Events4 0 17840 3888 40032 0 0 SpanTree Helper5 0 0 0 40032 0 0 Retransmission o6 0 0 0 40032 0 0 IPC ISSU Receive7 0 0 0 40032 0 0 Check heaps8 0 210880 205608 45304 170080 165828 Pool Manager9 0 184 184 40032 0 0 Timers10 0 184 184 40032 0 0 Serial Backgroun--More--The following is sample output from the show processes memory sorted command:
Switch#show proc memory sortedSystem memory : 1943928K total, 734279K used, 1209649K free, 153224K kernel reservedLowest(b) : 642265088PID Text Data Stack Dynamic RSS Total Process10319 67716 798420 84 252 954524 1012856 iosd4888 1132 200108 84 4076 26772 275408 ffm4884 620 690480 84 5328 18564 728076 eicored7635 144 181696 84 7464 16660 202620 cli_agent9374 1048 298308 84 1128 11488 328992 licensed10335 1676 257544 84 1252 11044 293848 licenseagentd4852 208 208996 84 1848 10812 237632 ha_mgr7566 168 249336 84 1408 8560 273668 installer7585 268 167656 84 1616 8432 185556 snmp_subagent4880 308 135080 84 968 8200 153944 os_info_p4894 100 232936 84 1144 8072 252748 plogd7410 68 233708 84 1172 7928 253840 dtmgr10329 160 142384 84 832 7144 228360 cpumemd4968 104 158828 84 1052 7080 178184 iifd5047 88 165604 84 700 6196 181184 pdsd4870 80 157452 84 728 6088 172244 sysmgr4856 200 132816 84 688 5872 147940 oscore_p--More--Table 44 describes the significant fields shown in the display.
Related Commands
show memory
Displays statistics about memory, including memory-free pool statistics.
show processes
Displays information about the active processes.
show raw statistics
To display raw IP statistics when Cisco IOS Software Modularity software is running, use the show raw statistics command in user EXEC or privileged EXEC mode.
show raw statistics
Syntax Description
This command has no arguments or keywords.
Command Modes
User EXEC (>)
Privileged EXEC (#)Command History
12.2(18)SXF4
This command was introduced to support Software Modularity images.
Usage Guidelines
There are three transport protocols used in Software Modularity: Transmission Control Protocol (TCP), User Datagram Protocol (UDP), and raw IP. The transport protocol statistics are generally counters, though some are averages and time stamps. Use the show raw statistics command to display the raw IP statistics, and use the clear raw statistics command to reset the raw IP statistics. Many of the statistics are relevant to all of the transport protocols. To view the other transport protocol statistics used in Software Modularity, see the show tcp statistics and show udp statistics commands.
Examples
The following is sample output from the show raw statistics command:
Router# show raw statisticsCurrent packet level is 0 (Clear)Rcvd: 0 packets, 0 bytes0 packets dropped in total (0 %)0 packets dropped due to invalid length0 packets dropped due to no protocol listener0 packets dropped due to receive packet limits0 packets dropped due to receive byte limits0 bytes dropped due to receive limitsSent: 11 packets, 0 bytes26 Open sockets0 Packets used by socket I/O0 Packets recovered after starvation0 Packet memory warnings0 Packet memory alarms0 Packet allocation errors0 Transmission pulse errors0 Packet punts from IP9 Packet punts to IP9 Packet punts from application0 Packet punts to application1 packets delivered to IP at a time1 packets received from application at a time3 read notification pulses0 millisecond delay between notification and readTable 45 describes the significant fields shown in the display.
Related Commands
clear raw statistics
Clears raw IP statistics.
show tcp statistics
Displays TCP statistics.
show udp statistics
Displays UDP statistics.
show registry
To display the function registry information when Cisco IOS or Cisco IOS Software Modularity images are running, use the show registry command in user EXEC or privileged EXEC mode.
Cisco IOS Software
show registry [registry-name [registry-number]] [brief | statistics]
Cisco IOS Software Modularity
show registry [name [registry-name [registry-number]]] [brief [name [registry-name [registry-number]]] | preemptions | rpcp status | statistics [brief] [name [registry-name [registry-number]]] [remote]] [process {process-name | process-id}]
Syntax Description
Command Default
If no options are specified, registry information is displayed for all registries.
Command Modes
User EXEC (>)
Privileged EXEC (#)Command History
Examples
Example output varies between Cisco IOS software images and Cisco IOS Software Modularity software images. To view the appropriate output, choose one of the following sections:
•
Cisco IOS Software
The following is sample output from the show registry command using the brief keyword:
Router# show registry atm 3/0/0 briefRegistry objects: 1799 bytes: 213412--Registry 23: ATM RegistryService 23/0:Service 23/1:Service 23/2:Service 23/3:Service 23/4:Service 23/5:Service 23/6:Service 23/7:Service 23/8:Service 23/9:Service 23/10:Service 23/11:Service 23/12:Service 23/13:Service 23/14:...Registry 25: ATM routing RegistryService 25/0:Table 46 describes the significant fields shown in the display.
Cisco IOS Software Modularity
The following is partial sample output from the show registry command when running a software Modularity image:
Router# show registryRegistry information for ios-base:1:=====================================================----------------------------AAA_ACCOUNTING : 11 services/ 1 : List list[000]/ 2 : List list[000]/ 3 : Case size[020] list[000] default=0x7267C5D0 returnd/ 4 : Case size[020] list[000] default=0x7267C5D0 returnd16 0x72779400/ 5 : Case size[020] list[000] default=0x7267C5D0 returnd/ 6 : Case size[020] list[000] default=0x7267C5D0 returnd16 0x7277915C/ 7 : Retval size[020] list[000] default=0x7267C5E4 returno/ 8 : Retval size[020] list[000] default=0x7267C5E4 returno/ 9 : Retval size[020] list[000] default=0x7267C5E4 returno/ 10 : Stub 0x7267C5E4 return_zero/ 11 : Stub 0x76545BA0AAA_ACCOUNTING : 11 services, 140 global bytes, 160 heap bytes...Table 47 describes the significant fields shown in the display.
show tcp
To display the status of Transmission Control Protocol (TCP) connections when Cisco IOS or Cisco IOS Software Modularity images re running, use the show tcp command in user EXEC or privileged EXEC mode.
show tcp [line-number] [tcb address]
Syntax Description
Command Modes
User EXEC (>)
Privileged EXEC (#)Command History
Examples
Example output varies between Cisco IOS software images and Cisco IOS Software Modularity software images. To view the appropriate output, choose one of the following sections:
•
Cisco IOS Software
The following is sample output that displays the status and option flags:
Router# show tcp...Status Flags: passive open, active open, retransmission timeout, app closedOption Flags: vrf id setIP Precedence value: 6...SRTT: 273 ms, RTTO: 490 ms, RTV: 217 ms, KRTT: 0 msminRTT: 0 ms, maxRTT: 300 ms, ACK hold: 200 msStatus Flags: active open, retransmission timeoutOption Flags: vrf id setIP Precedence value: 6Table 48 contains the types of flags, all possible command output enhancements, and descriptions. See Table 49 through Table 53 for descriptions of the other fields in the sample output.
The following is sample output from the show tcp command:
Router# show tcptty0, connection 1 to host ciderConnection state is ESTAB, I/O status: 1, unread input bytes: 0Local host: 172.31.232.17, Local port: 11184Foreign host: 172.31.1.137, Foreign port: 23Enqueued packets for retransmit: 0, input: 0, saved: 0Event Timers (current time is 67341276):Timer: Retrans TimeWait AckHold SendWnd KeepAliveStarts: 30 0 32 0 0Wakeups: 1 0 14 0 0Next: 0 0 0 0 0iss: 67317172 snduna: 67317228 sndnxt: 67317228 sndwnd: 4096irs: 1064896000 rcvnxt: 1064897597 rcvwnd: 2144 delrcvwnd: 0SRTT: 317 ms, RTTO: 900 ms, RTV: 133 ms, KRTT: 0 msminRTT: 4 ms, maxRTT: 300 ms, ACK hold: 300 msFlags: higher precedence, idle user, retransmission timeoutDatagrams (max data segment is 536 bytes):Rcvd: 41 (out of order: 0), with data: 34, total data bytes: 1596Sent: 57 (retransmit: 1), with data: 35, total data bytes: 55Table 49 describes the first five lines of output shown in the above display.
Note
The following line of output shows the current elapsed time according to the system clock of the local host. The time shown is the number of milliseconds since the system started.
Event Timers (current time is 67341276):The following lines of output display the number of times that various local TCP timeout values were reached during this connection. In this example, the local host re-sent data 30 times because it received no response from the remote host, and it sent an acknowledgment many more times because there was no data.
Timer: Retrans TimeWait AckHold SendWnd Keepalive GiveUp PmtuAgerStarts: 30 0 32 0 0 0 0Wakeups: 1 0 14 0 0 0 0Next: 0 0 0 0 0 0 0Table 50 describes the fields in the above lines of output.
The following lines of output display the sequence numbers that TCP uses to ensure sequenced, reliable transport of data. The local host and remote host each use these sequence numbers for flow control and to acknowledge receipt of datagrams.
iss: 67317172 snduna: 67317228 sndnxt: 67317228 sndwnd: 4096irs: 1064896000 rcvnxt: 1064897597 rcvwnd: 2144 delrcvwnd: 0Table 51 describes the fields shown in the display above.
The following lines of output display values that the local host uses to keep track of transmission times so that TCP can adjust to the network that it is using.
SRTT: 317 ms, RTTO: 900 ms, RTV: 133 ms, KRTT: 0 msminRTT: 4 ms, maxRTT: 300 ms, ACK hold: 300 msFlags: higher precedence, idle user, retransmission timeoutTable 52 describes the significant fields shown in the output above.
Note
The following lines of output display the number of datagrams that are transported with data.
Datagrams (max data segment is 536 bytes):Rcvd: 41 (out of order: 0), with data: 34, total data bytes: 1596Sent: 57 (retransmit: 1), with data: 35, total data bytes: 55Table 53 describes the significant fields shown in the last lines of the show tcp command output.
The following is sample output from the show tcp tcb command that displays detailed information by hexadecimal address about an ECN-enabled connection:
Router# show tcp tcb 0x62CD2BB8Connection state is LISTEN, I/O status: 1, unread input bytes: 0Connection is ECN enabledLocal host: 10.10.10.1, Local port: 179Foreign host: 10.10.10.2, Foreign port: 12000Enqueued packets for retransmit: 0, input: 0 mis-ordered: 0 (0 bytes)Event Timers (current time is 0x4F31940):Timer Starts Wakeups NextRetrans 0 0 0x0TimeWait 0 0 0x0AckHold 0 0 0x0SendWnd 0 0 0x0KeepAlive 0 0 0x0GiveUp 0 0 0x0PmtuAger 0 0 0x0DeadWait 0 0 0x0iss: 0 snduna: 0 sndnxt: 0 sndwnd: 0irs: 0 rcvnxt: 0 rcvwnd: 4128 delrcvwnd: 0SRTT: 0 ms, RTTO: 2000 ms, RTV: 2000 ms, KRTT: 0 msminRTT: 60000 ms, maxRTT: 0 ms, ACK hold: 200 msFlags: passive open, higher precedence, retransmission timeoutTCB is waiting for TCP Process (67)Datagrams (max data segment is 516 bytes):Rcvd: 6 (out of order: 0), with data: 0, total data bytes: 0Sent: 0 (retransmit: 0, fastretransmit: 0), with data: 0, total databytes: 0Cisco IOS Software Modularity
The following is sample output from the show tcp tcb command from a Software Modularity image:
Router# show tcp tcb 0x1059C10Connection state is ESTAB, I/O status: 0, unread input bytes: 0Local host: 10.4.2.32, Local port: 23Foreign host: 10.4.2.39, Foreign port: 11000VRF table id is: 0Current send queue size: 0 (max 65536)Current receive queue size: 0 (max 32768) mis-ordered: 0 bytesEvent Timers (current time is 0xB9ACB9):Timer Starts Wakeups Next(msec)Retrans 6 0 0SendWnd 0 0 0TimeWait 0 0 0AckHold 8 4 0KeepAlive 11 0 7199992PmtuAger 0 0 0GiveUp 0 0 0Throttle 0 0 0irs: 1633857851 rcvnxt: 1633857890 rcvadv: 1633890620 rcvwnd: 32730iss: 4231531315 snduna: 4231531392 sndnxt: 4231531392 sndwnd: 4052sndmax: 4231531392 sndcwnd: 10220SRTT: 84 ms, RTTO: 650 ms, RTV: 69 ms, KRTT: 0 msminRTT: 0 ms, maxRTT: 200 ms, ACK hold: 200 msKeepalive time: 7200 sec, SYN wait time: 75 secGiveup time: 0 ms, Retransmission retries: 0, Retransmit forever: FALSEState flags: noneFeature flags: NagleRequest flags: noneWindow scales: rcv 0, snd 0, request rcv 0, request snd 0Timestamp option: recent 0, recent age 0, last ACK sent 0Datagrams (in bytes): MSS 1460, peer MSS 1460, min MSS 1460, max MSS 1460Rcvd: 14 (out of order: 0), with data: 10, total data bytes: 38Sent: 10 (retransmit: 0, fastretransmit: 0), with data: 5, total data bytes: 76Header prediction hit rate: 72 %Socket states: SS_ISCONNECTED, SS_PRIVRead buffer flags: SB_WAIT, SB_SEL, SB_DEL_WAKEUPRead notifications: 4Write buffer flags: SB_DEL_WAKEUPWrite notifications: 0Socket status: 0Related Commands
show tcp statistics
To display TCP statistics, use the show tcp statistics command in user EXEC or privileged EXEC mode.
show tcp statistics
Syntax Description
This command has no arguments or keywords.
Command Modes
User EXEC (>)
Privileged EXEC (#)Command History
Usage Guidelines
Cisco IOS Software Modularity
There are three transport protocols used in Software Modularity: TCP, UDP, and raw IP. The transport protocol statistics are generally counters, though some are averages and time stamps. Use the show tcp statistics command to display the TCP statistics and use the clear tcp statistics command to reset the TCP statistics. Many of the statistics are relevant to all of the transport protocols. To view the other transport protocol statistics used in Software Modularity, see the show raw statistics and show udp statistics commands.
Examples
Example output varies between Cisco IOS software images and Cisco IOS Software Modularity software images. To view the appropriate output, choose one of the following sections:
•
Cisco IOS Software
The following is sample output from the show tcp statistics command:
Router# show tcp statisticsRcvd: 210 Total, 0 no port0 checksum error, 0 bad offset, 0 too short132 packets (26640 bytes) in sequence5 dup packets (502 bytes)0 partially dup packets (0 bytes)0 out-of-order packets (0 bytes)0 packets (0 bytes) with data after window0 packets after close0 window probe packets, 0 window update packets0 dup ack packets, 0 ack packets with unsend data69 ack packets (3044 bytes)Sent: 175 Total, 0 urgent packets16 control packets (including 1 retransmitted)69 data packets (3029 bytes)0 data packets (0 bytes) retransmitted73 ack only packets (49 delayed)0 window probe packets, 17 window update packets7 Connections initiated, 1 connections accepted, 8 connections established8 Connections closed (including 0 dropped, 0 embryonic dropped)1 Total rxmt timeout, 0 connections dropped in rxmt timeout0 Keepalive timeout, 0 keepalive probe, 0 Connections dropped in keepaliveTable 54 describes the significant fields shown in the display.
Cisco IOS Software Modularity
The following is sample output from the show tcp statistics command when a Software Modularity image is running under Cisco IOS Release 12.2(18)SXF4:
Router# show tcp statisticsCurrent packet level is 0 (Clear)Rcvd: 0 Total, 0 no port0 checksum error, 0 bad offset, 0 too short0 packets (0 bytes) in sequence0 dup packets (0 bytes)0 partially dup packets (0 bytes)0 out-of-order packets (0 bytes)0 packets (0 bytes) with data after window0 packets after close0 window probe packets, 0 window update packets0 dup ack packets, 0 ack packets for unsent data0 ack packets (0 bytes)0 packets dropped due to PAWS0 packets dropped due to receive packet limits0 packets dropped due to receive byte limitsSent: 0 Total, 0 urgent packets0 control packets (including 0 retransmitted)0 data packets (0 bytes)0 data packets (0 bytes) retransmitted0 data packets (0 bytes) fastretransmitted0 Sack retransmitted bytes, 0 Sack skipped bytes0 ack only packets (0 delayed)0 window probe packets, 0 window update packets0 Connections initiated, 0 connections accepted, 0 connections established0 Connections closed (including 0 dropped, 0 embryonic dropped)0 Total rxmt timeout, 0 connections dropped in rxmt timeout0 RTO, 0 KRTO (milliseconds)0 VJ SRTT, 0 variance (milliseconds)0 min RTT, 0 max RTT (milliseconds)0 Keepalive timeout, 0 keepalive probe, 0 Connections dropped in keepalive0 increase MSS, 0 decrease MSS15 Open sockets0 Timer interrupts0 Packets used by socket I/O0 Packets used by TCP reassembly0 Packets recovered after starvation0 Packet memory warnings0 Packet memory alarms0 Packet allocation errors0 Packet to octet switches due to send flow control0 Packet to octet switches due to partial ACKs0 Packet to octet switches due to inadequate resources0 Output function calls0 Truncated write I/O vectors0 Transmission pulse errors0 Packet punts from IP 0 Packet punts to IP0 Packet punts from application0 Packet punts to applicationTable 55 describes the significant fields shown in the display that are different from Table 45.
Related Commands
clear tcp statistics
Clears TCP statistics.
show raw statistics
Displays raw IP transport protocol statistics.
show udp statistics
Displays UDP transport protocol statistics.
show udp statistics
To display User Datagram Protocol (UDP) statistics when Cisco IOS Software Modularity software is running, use the show udp statistics command in user EXEC or privileged EXEC mode.
show udp statistics
Syntax Description
This command has no arguments or keywords.
Command Modes
User EXEC (>)
Privileged EXEC (#)Command History
12.2(18)SXF4
This command was introduced to support Software Modularity images.
Usage Guidelines
There are three transport protocols used in Software Modularity: Transmission Control Protocol (TCP), UDP, and raw IP. The transport protocol statistics are generally counters, though some are averages and time stamps. Use the show udp statistics command to display the UDP statistics, and use the clear udp statistics command to reset the UDP statistics. Many of the statistics are relevant to all of the transport protocols. To view the other transport protocol statistics used in Software Modularity, see the show raw statistics and show tcp statistics commands
Examples
The following is sample output from the show udp statistics command:
Router# show udp statisticsCurrent packet level is 0 (Clear)Rcvd: 3291 packets, 0 bytes3291 packets dropped in total (100 %)0 packets dropped due to invalid length0 packets dropped due to invalid checksum3291 packets dropped due to no port0 packets dropped due to receive packet limits0 packets dropped due to receive byte limits0 bytes dropped due to receive limitsSent: 0 packets, 0 bytes5 Open sockets0 Packets used by socket I/O0 Packets recovered after starvation0 Packet memory warnings0 Packet memory alarms0 Packet allocation errors0 Transmission pulse errors3291 Packet punts from IP0 Packet punts to IP0 Packet punts from application0 Packet punts to application1 packets received from IP at a timeTable 56 describes the significant fields shown in the display.
Related Commands
clear udp statistics
Clears UDP statistics.
show raw statistics
Displays raw IP statistics.
show tcp statistics
Displays TCP statistics.
write checkpoint
To run the configuration checkpoint process when a Cisco IOS Software Modularity image is running, use the write checkpoint command in privileged EXEC mode.
write checkpoint
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC (#)
Command History
12.2(18)SXF4
This command was introduced to support Software Modularity images.
Usage Guidelines
If you have a large configuration file, the default implicit configuration checkpoint process may take some time to complete and prevent you from entering other command-line interface (CLI) commands to save or display the configuration. To disable the checkpoint process, enter the no form of the service checkpoint-config command. When you are ready to run the configuration checkpoint process, use the write checkpoint command to run the configuration checkpoint process.
Implicit configuration checkpointing means that configuration checkpointing occurs for all processes. A Software Modularity process can be restarted under an error condition or after upgrading. When the process is restarted and operational, the state of the process returns to the state the process was in prior to the restart. The software checkpoints the configuration information and when the process restarts, the configuration information is read from the checkpoint.
Configuration checkpoint information is implicitly generated as follows:
•
•
•
Examples
In the following example, the no form of the service checkpoint-config command is entered to disable the configuration checkpoint process, configuration commands are entered, and after exiting from the configuration mode the write checkpoint command is entered to run the configuration checkpoint process.
configure terminalno service checkpoint-config!! configuration commands are entered hereendwrite checkpointRelated Commands
service checkpoint-config
Enables implicit configuration checkpointing when running a Cisco IOS Software Modularity image.
write core (Software Modularity)
To generate a core dump for a Cisco IOS Software Modularity process if the process crashes, use the write core command in privileged EXEC mode.
write core process-name [suspend]
Syntax Description
process-name
Process name.
suspend
(Optional) Suspends the process while the core dump is performed.
Command Default
No core dumps are performed if a process crashes.
Command Modes
Privileged EXEC (#)
Command History
12.2(18)SXF4
This command was introduced to support Software Modularity images.
Usage Guidelines
Use the write core (Software Modularity) command to dump the core of the process when the process crashes. The output generated in the dump can be used with the information generated by the exception crashinfo file command to verify the functionality of dumping the process core when the process crashes. Each Cisco IOS Software Modularity component has an associated .startup file that determines the core dump options (and other attributes) of that process. Use the show processes detailed command to display the core dump options for a process. Use the exception core command to override the default values set in the .startup file for the specific software component.
Examples
In the following example, a core dump is generated for the Cisco Discovery Protocol (CDP) process.
write core cdp.procIn the following example, a core dump is generated for the CDP process and the CDP process is suspended while the core dump is performed.
write core cdp.proc suspendRelated Commands
