Process and Memory Management Commands
on Cisco IOS-XR Software
This chapter describes the commands used to manage processes and memory on the
Cisco IOS-XR software.
Cisco IOS-XR System Management Command Reference
S MR-2 7 3
Process and Memory Management Commands on Cisco IOS-XR Software
monitor processes
Table 14
Interactive Display Com m ands for the m onitor processes Com m and (continued)
Command Description
m
c
Sorts display by memory used.
Sorts display by number of open channels.
Sorts display by number of open files.
f
Examples
monitor processes
RP/0/RP1/CPU0:router# monitor processes
195 processes; 628 threads; 3300 channels, 4579 fds
CPU states: 47.6% idle, 1.2% user, 51.1% kernel
Memory: 2048M total, 1576M avail, page size 4K
JID TIDS Chans
FDs Tmrs
MEM
0
228K
1M
648K
352K
16M
564K
216K
240K
204K
HH:MM:SS
5:53:31 51.11% kernel
CPU NAME
1
52
342
27 198
5 215
4 195
8
44
14
10
39
14
8
1
5
6
0
11
5
0:00:02 0.52% devc-conaux
0:00:08 0.34% wdsysmon
0:00:00 0.16% ptop
0:00:09 0.07% shelfmgr
0:00:29 0.06% eth_server
0:00:05 0.02% bcm_process
0:00:02 0.01% sysdb_medusa_s
0:00:01 0.01% devc-vty
0:00:09 0.01% packet
495806
293
1
7
11
3
1
31
24
10
7
55
121
311
2
4
18
40
19
4
5
4
138
265
4
5
14
31
monitor processes location
RP/0/RP1/CPU0:router# monitor processes location 0/rp1/cpu0
202 processes; 724 threads; 3750 channels, 5092 fds
CPU states: 48.8% idle, 0.8% user, 1.5% kernel
Memory: 2048M total, 1526M avail, page size 4K
JID TIDS Chans
FDs Tmrs
MEM
0
HH:MM:SS
CPU NAME
1
27 205
3
1
10:54:12 1.52% procnto-600-smp-cisco-in
str
264
53
180
69
5
42
19
564
42
8
4
0
6
3
0
1
1
4
4
272K
1M
1M
0:00:15 0.37% packet
0:00:06 0.10% dllmgr
0:00:19 0.05% gsp
0:00:54 0.04% qnet
0:00:04 0.03% pkgfs
0:00:00 0.02% envmon
0:00:00 0.02% showd_lc
0:00:17 0.02% sysdb_svr_local
0:00:07 0.02% sysdb_medusa_s
2 202
15
22
5
2
93
94
4
6
6
1M
67
6
956K
480K
112K
1M
156
294
314
310
18
12
14
18
1
3 185
4
7
276K
monitor processes dumbtty
RP/0/RP1/CPU0:router# monitor processes dumbtty
Computing times...195 processes; 628 threads; 3721 channels, 4801 fds
CPU states: 37.1% idle, 1.1% user, 61.7% kernel
Memory: 2048M total, 1576M avail, page size 4K
JID TIDS Chans
FDs Tmrs
MEM
0
648K
352K
HH:MM:SS
6:33:33 61.76% kernel
0:00:00 0.64% ptop
CPU NAME
1
544958
293
27 198
6
8
1
0
1
7
1
31
39
11
0:00:10 0.10% shelfmgr
Cisco IOS-XR System Management Command Reference
S MR-2 7 5
Process and Memory Management Commands on Cisco IOS-XR Software
monitor processes
180
304
55
15
3
11
22
2
82
14
24
91
35
25
10
42
29
14
8
18
34
8
6
7
5
3
4
5
2
5M
304K
16M
0:00:26 0.10% gsp
0:00:02 0.06% statsd_manager
0:00:32 0.03% eth_server
0:00:31 0.03% qnet
0:00:01 0.03% dsc
0:00:00 0.03% statsd_server
0:00:06 0.03% bcm_process
70
1M
153
303
121
120K
292K
564K
3
3
195 processes; 628 threads; 3409 channels, 4601 fds
CPU states: 46.5% idle, 0.5% user, 52.8% kernel
Memory: 2048M total, 1576M avail, page size 4K
JID TIDS Chans
FDs Tmrs
MEM
0
228K
352K
1M
240K
2M
804K
944K
216K
1M
HH:MM:SS
6:33:44 52.89% kernel
CPU NAME
1
52
27 198
5 215
6
44
1
5
8
4
5
9
0
0
4
6
0:00:06 0.38% devc-conaux
0:00:08 0.03% sysdb_mc
0:00:12 0.03% sysdb_svr_local
0:00:02 0.02% devc-vty
0:00:09 0.01% snmpd
0:00:04 0.00% pkgfs
0:00:06 0.00% dllmgr
0:00:03 0.00% sysdb_medusa_s
0:00:08 0.00% wdsysmon
309
315
138
298
67
6
25
23
3 177
14
4
9
4
14
25
4
40
111
7
53
2 195
547
18
311
342
4
7
4 195
14
Use of Interactive Commands
When the n or d interactive command is used, the monitor processes command prompts you to enter a
number. For example, when the interactive command n is entered, the prompt responds as shown below:
Enter number of procs to display: 15
195 processes; 628 threads; 3375 channels, 4495 fds
CPU states: 49.0% idle, 0.9% user, 50.0% kernel
Memory: 2048M total, 1576M avail, page size 4K
JID TIDS Chans
FDs Tmrs
MEM
0
228K
352K
1M
304K
352K
1M
HH:MM:SS
6:11:43 50.01% kernel
CPU NAME
1
52
27 198
5 215
2
44
39
14
29
23
14
111
19
18
17
36
34
46
31
1
5
11
4
7
8
6
9
4
4
0:00:05 0.72% devc-conaux
0:00:09 0.04% shelfmgr
0:00:11 0.03% sysdb_svr_local
0:00:01 0.02% statsd_manager
0:00:08 0.02% sysdb_mc
0:00:08 0.01% wdsysmon
0:00:09 0.00% snmpd
0:00:09 0.00% packet
0:00:00 0.00% dsc
0:00:00 0.00% sc_reddrv
0:00:00 0.00% qlink
0:00:00 0.00% statsd_server
0:00:00 0.00% ospf
293
315
304
309
342
298
265
153
290
275
303
262
239
7
31
3 177
3
6
14
25
4 195
9
5
2
4
7
3
5
3
25
31
35
6
34
25
23
26
2M
204K
120K
112K
588K
292K
1M
2
7
5
6
9
452K
0:00:00 0.00% lpts_pa
If the number you enter is outside the acceptable range, you will be prompted for another number:
Enter number of procs to display: 435
Please enter a number between 5 and 40
Enter number of procs to display:
Related Commands
Command
Description
Displays auto-updating thread statistics.
Displays information on all processes, or a single process.
Cisco IOS-XR System Management Command Reference
S MR-2 7 6
Process and Memory Management Commands on Cisco IOS-XR Software
monitor threads
monitor threads
To display auto-updating statistics on threads in a full-screen mode, use the monitor threads command
in EXEC mode.
monitor threads [dumbtty] [iteration number] [location node-id]
Syntax Description
dumbtty
(Optional) Displays the output of the command as if on a dumb
terminal (the screen is not refreshed).
iteration number
location node-id
(Optional) Number of times the statistics display is to be updated, in
the range from 0 to 4294967295.
(Optional) Displays the output from the command from the designated
node. The node-id argument is entered in the rack/slot/module
notation.
Defaults
When all keywords are omitted, the command displays the first ten threads for the local node, sorted in
descending order by the time used. The display is cleared and updated every 5 seconds until you quit the
monitor command.
Command Modes
Command History
EXEC
Release
Modification
Release 2.0
This command was introduced.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper
task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services
on Cisco IOS-XR Software module of the Cisco IOS-XR System Security Configuration Guide.
This command shows the top 10 threads based on CPU usage. The display refreshes every 10 seconds.
•
To change the parameters displayed by the monitor threads command, enter one of the key
•
•
To terminate the display and return to the system prompt, enter the q key.
To list the interactive commands, type ? during the display. Example:
Table 15
Interactive Display Com m ands for the m onitor threads Com m and
Command Description
q
n
Quits the interactive display and returns to the system prompt.
Changes the number of threads to be displayed.
Cisco IOS-XR System Management Command Reference
S MR-2 7 7
Process and Memory Management Commands on Cisco IOS-XR Software
monitor threads
Table 15
Interactive Display Com m ands for the m onitor threads Com m and (continued)
Command Description
d
l
Changes the delay interval between updates.
Refreshes the screen.
Examples
monitor threads
RP/0/RP1/CPU0:router# monitor threads
195 processes; 628 threads;
CPU states: 98.2% idle, 0.9% user, 0.7% kernel
Memory: 2048M total, 1576M avail, page size 4K
JID
1
1
342
52
52
TID LAST_CPU PRI STATE HH:MM:SS
CPU COMMAND
12
25
1
1
1
1
0
1
0
0
0
0
0
10 Rcv
10 Run
19 Rcv
21 Rcv
18 Rcv
10 Rply
55 Rcv
10 Rcv
10 Rcv
55 Rcv
0:00:09
0:00:30
0:00:07
0:00:03
0:00:02
0:00:00
0:00:06
0:00:02
0:00:11
0:00:11
0.42% procnto-600-smp-cisco-instr
0.36% procnto-600-smp-cisco-instr
0.20% wdsysmon
0.15% devc-conaux
0.07% devc-conaux
0.07% top
0.03% shelfmgr
0.03% eth_server
0.03% sysdb_svr_local
0.02% eth_server
5
3
1
6
8
3
7
532670
293
55
315
55
monitor threads location
RP/0/RP1/CPU0:router# monitor threads location 0/rp1/cpu0
Computing times...195 processes; 628 threads;
CPU states: 95.1% idle, 2.7% user, 2.0% kernel
Memory: 2048M total, 1576M avail, page size 4K
JID
1
TID LAST_CPU PRI STATE HH:MM:SS
CPU COMMAND
2.08% procnto-600-smp-cisco-instr
0.89% packet
0.65% qsm
0.51% top
0.07% shelfmgr
0.07% gsp
0.07% sysdb_svr_local
0.04% eth_server
0.04% gsp
25
5
0
0
1
0
1
1
0
1
0
0
10 Run
10 SigW
10 Rcv
10 Rply
55 Rcv
10 Rcv
10 Rcv
55 Rcv
10 Rcv
10 Rcv
0:00:32
0:00:09
0:00:00
0:00:00
0:00:01
0:00:02
0:00:12
0:00:12
0:00:01
0:00:01
265
279
557246
293
180
315
55
1
1
5
13
3
7
1
9
180
298
0.04% snmpd
Use of Interactive Commands
When the n or d interactive command is used, the monitor threads command prompts for a number
appropriate to the specific interactive command. The following is sample output from the monitor
threads command showing the use of the interactive command n after the first display cycle to change
the number of threads:
RP/0/RP1/CPU0:router# monitor threads
Computing times... 87 processes; 249 threads;
CPU states: 84.8% idle, 4.2% user, 10.9% kernel
Memory: 256M total, 175M avail, page size 4K
JID
TID PRI STATE HH:MM:SS
CPU COMMAND
Cisco IOS-XR System Management Command Reference
S MR-2 7 8
Process and Memory Management Commands on Cisco IOS-XR Software
monitor threads
1
553049
58
6 10 Run
1 10 Rply
3 10 Rcv
3 10 Rcv
1 10 Rcv
5 10 Rcv
2 10 Rcv
1 10 Rcv
1 10 NSlp
9 10 Intr
0:00:10
0:00:00
0:00:24
0:00:21
0:00:20
0:00:20
0:00:05
0:00:05
0:00:04
0:00:04
10.92% kernel
4.20% top
0.00% sysdbsvr
0.00% kernel
0.00% wdsysmon
0.00% kernel
0.00% qnet
0.00% netio
0.00% envmon_periodic
0.00% netio
1
69
1
159
160
157
160
n
Enter number of threads to display: 3
Please enter a number between 5 and 40
Enter number of threads to display: 8
87 processes; 249 threads;
CPU states: 95.3% idle, 2.9% user, 1.7% kernel
Memory: 256M total, 175M avail, page size 4K
JID
1
69
TID PRI STATE HH:MM:SS
CPU COMMAND
1.76% kernel
1.11% wdsysmon
0.40% sysdbsvr
0.23% envmon_periodic
0.20% qnet
0.20% top
0.13% qnet
0.10% netio
6 10 Run
1 10 Rcv
3 10 Rcv
1 10 NSlp
19 10 Rcv
1 10 Rply
12 10 Rcv
1 10 Rcv
0:00:11
0:00:20
0:00:24
0:00:04
0:00:02
0:00:00
0:00:03
0:00:05
58
157
159
553049
159
160
When a number outside the acceptable range is entered, the acceptable range is displayed:
Please enter a number between 5 and 40
Enter number of threads to display:
Related Commands
Command
Description
Displays interactive, auto-updating process statistics in a full-screen mode.
Cisco IOS-XR System Management Command Reference
S MR-2 7 9
Process and Memory Management Commands on Cisco IOS-XR Software
process
process
To start, terminate, or restart a process, use the process command in EXEC mode.
process {blocked | kill | restart | start} [executable-name | job-id] [location {node-id | all}]
Syntax Description
blocked
Collects debug information. The node will be restarted if the mandatory reboot
flag is set.
kill
Kills (stops) a process. The process will not be restarted even if considered
“mandatory”.
restart
Restarts a process.
Starts a process.
start
executable-name
(Optional) Performs the action for all the simultaneously executing instances of
the process, if applicable.
job-id
(Optional) Performs the action for only the process instance associated with the
job-id.
location node-id
location all
(Optional) Specifies a node. The node-id argument is entered in the
rack/slot/module notation.
(Optional) Specifies all nodes.
Defaults
No default behavior or values
EXEC
Command Modes
Command History
Release
Modification
This command was introduced.
Release 2.0
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper
task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services
on Cisco IOS-XR Software module of the Cisco IOS-XR System Security Configuration Guide.
Under normal circumstances, processes are started and restarted automatically by the operating system
as required. If a process crashes, it will be automatically restarted.
You can also use the process commands to manually stop, start or restart individual processes. These
commands should be used only under the supervision of a Cisco support representative because they can
cause a loss of router operations.
Caution
Manually killing or restarting a process can seriously impact the operation of a router. Use these
commands only under the direction of a Cisco technical support representative.
Cisco IOS-XR System Management Command Reference
S MR-2 8 0
Process and Memory Management Commands on Cisco IOS-XR Software
process
process kill
The process kill command will shut down (terminate) the specified process and copies associated with
the specified process. The process is not restarted, even if considered “mandatory.” Use the show
processes command to display a list of executable processes running on the system.
Caution
Killing a process can result in an RP failover, system failure or both. This command is intended for use
only under the direct supervision of a Cisco technical support representative.
process restart
The process restart command is used to restart a process, such as a process that is not functioning
optimally.
process start
The process start command starts a process that is not currently running, such as a process that was
terminated using the process kill command. If multiple copies are on the system, all instances of the
process will be started simultaneously.
process blocked
This command is used by Cisco support representatives to collect debug information about a process. If
the mandatory command is set for a process, the process blocked command will also cause the node to
restart.
Examples
In the following example, the OSPF process is restarted with the process restart. command:
RP/0/RP1/CPU0:router# process restart isis
RP/0/RP1/CPU0:router#RP/0/RP1/CPU0:Mar 30 15:24:41 : isis[343]: %ISIS-6-INFO_ST
RTUP_START : Cisco NSF controlled start beginning
RP/0/RP1/CPU0:router#RP/0/RP1/CPU0:Mar 30 15:24:52 : isis[352]: %ISIS-6-INFO_ST
RTUP_FINISH : Cold controlled start completed
In the following example, the OSPF process is terminated with the process kill command:
RP/0/RP1/CPU0:router# process kill isis
RP/0/RP1/CPU0:router#
In the following example, the OSPF process is started with the process start command:
RP/0/RP1/CPU0:router# process start isis
RP/0/RP1/CPU0:router#RP/0/RP1/CPU0:Mar 30 15:27:19 : isis[227]: %ISIS-6-INFO_STA
RTUP_START : Cold controlled start beginning
RP/0/RP1/CPU0:Mar 30 15:27:31 : isis[352]: %ISIS-6-INFO_STARTUP_FINISH : Cold co
ntrolled start completed
Related Commands
Command
Description
Sets the options for mandatory processes.
Displays information on the running processes.
Cisco IOS-XR System Management Command Reference
S MR-2 8 1
Process and Memory Management Commands on Cisco IOS-XR Software
process core
process core
To change the core dump options for a process, use the process core command in EXEC mode.
process {executable-name | job-id} core {mainmem | mainmem-sharedmem | mainmem-text |
mainmem-text-sharedmem | sharedmem | copy | off} [maxcore value] [location node-id]
Syntax Description
executable-name
job-id
Executable name of the process for which you want to change core
dump options. Specifying an executable-name value changes the core
dumping option for multiple instances of a running process.
Job ID associated with the process instance. Specifying a job-id value
changes the core dumping option for only a single instance of a
running process.
core
Indicates a core dump option change for the specified process.
Dumps the main memory of a crashed process.
mainmem
mainmem-sharedmem
mainmem-text
Dumps the main memory and the shared memory of a crashed process.
Dumps the main memory and text of a crashed process.
mainmem-text-sharedmem Dumps the main memory, shared memory and text of a crashed
process.
sharedmem
copy
Dumps the shared memory of a crashed process.
Copies a core dump locally before performing the core dump.
off
Indicates that a core dump will not be taken upon the termination of
the specified process.
maxcore value
(Optional) Maximum number of core dumps allowed for the specified
process since its creation.
location node-id
(Optional) Sets the core dump options to a designated node. The
node-id argument is entered in the rack/slot/module notation.
Defaults
By default, processes are configured to dump shared memory, text area, stack, data section and heap.
Command Modes
Command History
EXEC
Release
Modification
Release 2.0
This command was introduced.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper
task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services
on Cisco IOS-XR Software module of the Cisco IOS-XR System Security Configuration Guide.
The modular architecture of the Cisco IOS-XR software allows core dumps for individual processes. By
default, processes are configured to dump shared memory, text area, stack, data section and heap.
Cisco IOS-XR System Management Command Reference
S MR-2 8 2
Process and Memory Management Commands on Cisco IOS-XR Software
process core
Specifying the process name (executable-name) changes the core dumping option for all instances of the
process. Specifying a job-id value changes the core dumping option for a single instance of a running
process.
Examples
In the following example, the process core command is used to enable dumping of main memory and
shared memory:
RP/0/RP1/CPU0:router# process ospf core mainmem-sharedmem
In the following example, the process core command is used to turn off core dumping for a process:
RP/0/RP1/CPU0:router# process media_ether_config_di core off
Core dumping is turned back on by specifying the type of core dump for a process, as shown in the
following example:
RP/0/RP1/CPU0:router# process media_ether_config_di core mainmem-text-sharedmem
Related Commands
Command
Description
Displays information about processes.
Cisco IOS-XR System Management Command Reference
S MR-2 8 3
Process and Memory Management Commands on Cisco IOS-XR Software
process mandatory
process mandatory
To set the mandatory reboot options for a process, use the process mandatory command in EXEC mode.
process mandatory
process mandatory {on | off} {executable-name | job-id} [location node-id]
process mandatory reboot
process mandatory reboot {enable | disable}
process mandatory toggle
process mandatory toggle {executable-name | job-id} [location node-id]
Syntax Description
on
Turns on mandatory process attribute.
off
Turns off the mandatory process attribute. The process will not be
considered mandatory.
reboot
Enables or disables the reboot action when mandatory process fails.
Toggles mandatory process attribute
toggle
executable-name
Executable name of the process you want to terminate. Terminates the
process and all the simultaneously executing copies, if applicable.
job-id
Job ID associated with the process you want to terminate. Terminates only
the process associated with the job ID.
location node-id
(Optional) Sets the mandatory settings for a process on a designated node.
The node-id argument is entered in the rack/slot/module notation.
Defaults
No default behavior or values
EXEC
Command Modes
Command History
Release
Modification
This command was introduced.
Release 2.0
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper
task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services
on Cisco IOS-XR Software module of the Cisco IOS-XR System Security Configuration Guide.
If a process unexpectedly goes down, the following action will occur based on whether the process is
considered “mandatory.”
•
If the process is mandatory, and the process cannot be restarted, the node will automatically reboot.
Cisco IOS-XR System Management Command Reference
S MR-2 8 4
Process and Memory Management Commands on Cisco IOS-XR Software
process mandatory
•
If the process is not mandatory and cannot be restarted, it will stay down and the node will not
reboot.
Examples
Turning the mandatory attribute on or off for a process
In the following example, the mandatory attribute is turned on for the “media_ether_config_di” process:
RP/0/RP1/CPU0:router# process mandatory on media_ether_config_di
Turning the reboot option on or off with the process mandatory reboot command
In the following example, the system is set to reboot the node if a mandatory process goes down and
cannot be restarted:
RP/0/RP1/CPU0:router# process mandatory reboot enable
RP/0/RP1/CPU0:Mar 19 19:28:10 : sysmgr[71]: %SYSMGR-4-MANDATORY_REBOOT_ENABLE :
mandatory reboot option enabled by request
In the following example, the system is set not to reboot the node if a mandatory process goes down and
cannot be restarted. In this case, the mandatory process will be restarted, but the node will not ne
rebooted.
RP/0/RP1/CPU0:router# process mandatory reboot disable
RP/0/RP1/CPU0:Mar 19 19:31:20 : sysmgr[71]: %SYSMGR-4-MANDATORY_REBOOT_OVERRIDE
: mandatory reboot option overridden by request
Related Commands
Command
Description
Displays information, attributes and settings for a processes.
Cisco IOS-XR System Management Command Reference
S MR-2 8 5
Process and Memory Management Commands on Cisco IOS-XR Software
show memory
show memory
To display the available physical memory on the networking device and the memory usage of processes
on the networking device, use the show memory command in EXEC mode.
show memory [job-id | location node-id | summary]
Syntax Descriptionl
job-id
(Optional) Displays the memory available and memory usage information for
only the process associated with this job identifier. If the job-id argument is not
specified, this command displays information for all running processes.
location node-id
(Optional) Displays the available physical memory from the designated node.
The node-id argument is entered in the rack/slot/module notation.
summary
(Optional) Displays only a summary of the physical memory and memory usage
information.
Command Modes
Command History
EXEC
Release
Modification
Release 2.0
This command was introduced.
Usage Guidelines
Examples
To use this command, you must be in a user group associated with a task group that includes the proper
task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services
on Cisco IOS-XR Software module of the Cisco IOS-XR System Security Configuration Guide.
The following is partial sample output from the show memory command entered without keywords or
arguments:
RP/0/RP1/CPU0:router# show memory
Physical Memory:2048M total
Application Memory :1802M (1636M available)
Image:116M (bootram:116M)
Reserved:128M, IOMem:0, flashfsys:0
Total shared window:0
kernel:jid 1
Address
0008f000
000b2000
Bytes
12288
12288
What
Program Stack
Program Stack
Total Allocated Memory:0
Total Shared Memory:0
sbin/devc-pty:jid 68
Address
Bytes
4096
516096
8192
What
4817f000
48180000
481fe000
48200000
Program Stack (pages not allocated)
Program Stack (pages not allocated)
Program Stack
28672
Physical Mapped Memory
Cisco IOS-XR System Management Command Reference
S MR-2 8 6
Process and Memory Management Commands on Cisco IOS-XR Software
show memory
48207000
48208000
4096
4096
ANON FIXED ELF SYSRAM
ANON FIXED ELF SYSRAM
The following is sample output from the show memory command entered with the job ID 7 to show the
memory usage information for the process associated with this job identifier:
RP/0/RP1/CPU0:router# show memory 7
Physical Memory: 256M total
Application Memory : 249M (217M available)
Image: 2M (bootram: 2M)
Reserved: 4M, IOMem: 0, flashfsys: 0
sbin/pipe: jid 7
Address
Bytes
126976
4096
126976
4096
126976
4096
126976
4096
122880
8192
12288
4096
What
07f7c000
07f9b000
07f9d000
07fbc000
07fbe000
07fdd000
07fdf000
07ffe000
08000000
0801e000
08020000
08023000
08024000
08025000
08029000
7c001000
7e000000
Program Stack (pages not allocated)
Program Stack
Program Stack (pages not allocated)
Program Stack
Program Stack (pages not allocated)
Program Stack
Program Stack (pages not allocated)
Program Stack
Program Stack (pages not allocated)
Program Stack
Physical Mapped Memory
Program Text or Data
Program Text or Data
Allocated Memory
4096
16384
16384
319488
8192
Allocated Memory
DLL Text libc.dll
DLL Data libc.dll
Related Commands
Command
Description
Displays information about the heap space for a process.
Displays information about processes, including memory usage.
Cisco IOS-XR System Management Command Reference
S MR-2 8 7
Process and Memory Management Commands on Cisco IOS-XR Software
show memory heap
show memory heap
To display information about the heap space for a process, use the show memory heap command in
EXEC mode.
show memory heap [allocated] [dllname] [failure] [free] [summary] job-id
Syntax Description
allocated
dllname
failure
free
(Optional) Displays a list of all allocated heap blocks.
(Optional) Displays heaps with DLL names.
(Optional) Displays a summary of heap failures.
(Optional) Displays a list of all free heap blocks.
summary
job-id
(Optional) Displays a summary of the information about the heap space.
Information for the process associated with this job identifier.
Command Modes
Command History
EXEC
Release
Modification
Release 2.0
This command was introduced.
Usage Guidelines
Examples
To use this command, you must be in a user group associated with a task group that includes the proper
task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services
on Cisco IOS-XR Software module of the Cisco IOS-XR System Security Configuration Guide.
The following is sample output from the show memory heap command, specifying only the job
identifier 111:
RP/0/RP1/CPU0:router> show memory heap 111
Malloc summary for pid 16433:
Heapsize 16384: allocd 6328, free 8820, overhead 1236
Calls: mallocs 144; reallocs 73; frees 5; [core-allocs 1; core-frees 0]
Block Allocated List
Total
Usize
Total
Size
Block
Count
Name/ID/Caller
0x000008c1 0x000008cc 0x00000001 0x7c018a10
0x000005ac 0x00000974 0x00000079 0x7c02b9e0
0x000004f0 0x000004f8 0x00000001 0x7c02b6fc
0x00000080 0x00000088 0x00000001 0x7c01936c
0x00000034 0x00000048 0x00000001 0x7c018954
0x00000024 0x00000030 0x00000001 0x7c019278
0x00000018 0x00000020 0x00000001 0x7c019b2c
0x00000008 0x00000010 0x00000001 0x7c017178
0x00000008 0x00000010 0x00000001 0x7c00fb54
0x00000008 0x00000010 0x00000001 0x7c00fb80
0x00000008 0x00000010 0x00000001 0x7c00fbb8
Cisco IOS-XR System Management Command Reference
S MR-2 8 8
Process and Memory Management Commands on Cisco IOS-XR Software
show memory heap
The following is sample output from the show memory heap command, specifying the allocated and
free keywords and the job identifier:
RP/0/RP1/CPU0:router# show memory heap allocated free 5
Block Allocated List
Usize
Size
Address
Name/ID/Caller
0x000008c1 0x000008cc 0x08029e7c 0x7c018a10
0x000004fc 0x00000504 0x08029554[0x18 0x30-byte objects: 0x1 allocd, 0x17 free]
caller(id)/usize/addr: 0x7c019278/0x28/0x8029574
0x000004f0 0x000004f8 0x0802bc00 0x7c02b6fc
0x0000037c 0x00000384 0x08029a60[0x18 0x20-byte objects: 0x1 allocd, 0x17 free]
caller(id)/usize/addr: 0x7c019b2c/0x1c/0x8029a80
0x0000031c 0x00000324 0x0802a7d0[0x20 0x14-byte objects: 0x20 allocd, 0x0 free]
caller(id)/usize/addr: 0x7c02b9e0/0x10/0x802a7f0,0x802a808,0x802a820,0x802a838,
0x802a850,0x802a868,0x802a880,0x802a898,0x802a8b0,0x802a8c8,0x802a8e0,0x802a8f8,
0x802a910,0x802a928,0x802a940,0x802a958,0x802a970,0x802a988,0x802a9a0,0x802a9b8,
0x802a9d0,0x802a9e8,0x802aa00,0x802aa18,0x802aa30,0x802aa48,0x802aa60,0x802aa78,
0x802aa90,0x802aaa8,0x802aac0,0x802aad8
0x0000031c 0x00000324 0x0802ac2c[0x20 0x14-byte objects: 0x20 allocd, 0x0 free]
caller(id)/usize/addr: 0x7c02b9e0/0x10/0x802ac4c,0x802ac64,0x802ac7c,0x802ac94,
0x802acac,0x802acc4,0x802acdc,0x802acf4,0x802ad0c,0x802ad24,0x802ad3c,0x802ad54,
0x802ad6c,0x802ad84,0x802ad9c,0x802adb4,0x802adcc,0x802ade4,0x802adfc,0x802ae14,
0x802ae2c,0x802ae44,0x802ae5c,0x802ae74,0x802ae8c,0x802aea4,0x802aebc,0x802aed4,
0x802aeec,0x802af04,0x802af1c,0x802af34
0x0000031c 0x00000324 0x0802b1a8[0x20 0x14-byte objects: 0x20 allocd, 0x0 free]
caller(id)/usize/addr: 0x7c02b9e0/0x10/0x802b1c8,0x802b1e0,0x802b1f8,0x802b210,
0x802b228,0x802b240,0x802b258,0x802b270,0x802b288,0x802b2a0,0x802b2b8,0x802b2d0,
0x802b2e8,0x802b300,0x802b318,0x802b330,0x802b348,0x802b360,0x802b378,0x802b390,
0x802b3a8,0x802b3c0,0x802b3d8,0x802b3f0,0x802b408,0x802b420,0x802b438,0x802b450,
0x802b468,0x802b480,0x802b498,0x802b4b0
0x0000031c 0x00000324 0x0802b8d4[0x20 0x14-byte objects: 0x19 allocd, 0x7 free]
caller(id)/usize/addr: 0x7c02b9e0/0x10/0x802b8f4,0x802b90c,0x802b924,0x802b93c,
0x802b954,0x802b96c,0x802b984,0x802b99c,0x802b9b4,0x802b9cc,0x802b9e4,0x802b9fc,
0x802ba14,0x802ba2c,0x802ba44,0x802ba5c,0x802ba74,0x802ba8c,0x802baa4,0x802babc,
0x802bad4,0x802baec,0x802bb04,0x802bb1c,0x802bb34
0x0000029c 0x000002a4 0x0802901c[0x20 0x10-byte objects: 0x4 allocd, 0x1c free]
caller(id)/usize/addr: 0x7c017178/0xc/0x802903c 0x7c00fb54/0xc/0x8029050 0x7c00
fb80/0xc/0x8029064 0x7c00fbb8/0xc/0x8029078
0x0000027c 0x00000284 0x080292c8[0x8 0x48-byte objects: 0x1 allocd, 0x7 free]
caller(id)/usize/addr: 0x7c018954/0x38/0x80292e8
0x00000080 0x00000088 0x08029dec 0x7c01936c
Block Free List
Size
Address
0x00000078 0x0802a750
0x00000128 0x0802aafc
0x00000248 0x0802af58
0x000003f8 0x0802b4d4
0x00000ef8 0x0802c100
The following is sample output from the show memory heap command, specifying the summary
keyword and the job identifier:
RP/0/RP1/CPU0:router# show memory heap summary 65
Malloc summary for pid 20495 process pcmciad:
Heapsize 65536: allocd 40332, free 16568, overhead 8636
Calls: mallocs 883; reallocs 3; frees 671; [core-allocs 4; core-frees 0]
Band size 16, element per block 48, nbuint 1
Completely free blocks: 0
Block alloced: 2, Block freed: 0
allocs: 85, frees: 20
allocmem: 1040, freemem: 496, overhead: 448
Cisco IOS-XR System Management Command Reference
S MR-2 8 9
Process and Memory Management Commands on Cisco IOS-XR Software
show memory heap
blocks: 2, blknodes: 96
Band size 24, element per block 34, nbuint 1
Completely free blocks: 0
Block alloced: 1, Block freed: 0
allocs: 243, frees: 223
allocmem: 480, freemem: 336, overhead: 168
blocks: 1, blknodes: 34
Band size 32, element per block 26, nbuint 1
Completely free blocks: 0
Block alloced: 1, Block freed: 0
allocs: 107, frees: 97
allocmem: 320, freemem: 512, overhead: 136
blocks: 1, blknodes: 26
Band size 40, element per block 22, nbuint 1
Completely free blocks: 0
Block alloced: 2, Block freed: 0
allocs: 98, frees: 74
allocmem: 960, freemem: 800, overhead: 240
blocks: 2, blknodes: 44
Band size 48, element per block 18, nbuint 1
Completely free blocks: 0
Block alloced: 1, Block freed: 0
allocs: 53, frees: 42
allocmem: 528, freemem: 336, overhead: 104
blocks: 1, blknodes: 18
Band size 56, element per block 16, nbuint 1
Completely free blocks: 0
Block alloced: 1, Block freed: 0
allocs: 8, frees: 4
allocmem: 224, freemem: 672, overhead: 96
blocks: 1, blknodes: 16
Band size 64, element per block 14, nbuint 1
Completely free blocks: 0
Block alloced: 1, Block freed: 0
allocs: 6, frees: 2
allocmem: 256, freemem: 640, overhead: 88
blocks: 1, blknodes: 14
Band size 72, element per block 12, nbuint 1
Completely free blocks: 0
Block alloced: 1, Block freed: 0
allocs: 1, frees: 0
allocmem: 72, freemem: 792, overhead: 80
blocks: 1, blknodes: 12
Related Commands
Command
Description
Displays the available physical memory and processes memory on a router.
Cisco IOS-XR System Management Command Reference
S MR-2 9 0
Process and Memory Management Commands on Cisco IOS-XR Software
show processes
show processes
To display information about active processes, use the show processes command in EXEC mode.
show processes [job-id | process-name] {aborts | blocked | boot | cpu | distribution | dynamic |
failover | family | files | location | log | mandatory | memory | searchpath | signal | startup |
threadname} [location node-id]
Syntax Description
job-id
(Optional) Displays information for only the process instance associated
with the job-id argument.
process-name
(Optional) Displays information for all the simultaneously executing
instances of the process, if applicable.
aborts
Displays process aborts.
blocked
boot
Displays details about reply/send/mutex blocked processes.
Displays process boot information.
cpu
Displays CPU use per process.
distribution
dynamic
failover
family
Displays the distribution of processes.
Displays process data for dynamically created processes.
Displays process failover information.
Displays the process session and family information.
Displays information about open files and open communication channels.
Displays process log.
files
log
mandatory
memory
searchpath
signal
Displays process data for mandatory processes.
Displays information about the text, data, and stack usage for processes.
Displays the search path.
Displays the signal options for blocked, pending, ignored, and queued
signals.
startup
Displays process data for processes created at startup
Displays thread names.
threadname
location node-id
(Optional) Displays information about the active processes from a
designated node. The node-id argument is entered in the rack/slot/module
notation.
Command Modes
Command History
EXEC
Release
Modification
Release 2.0
This command was introduced.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper
task IDs. For detailed information about user groups and task IDs, refer to the Configuring AAA Services
on Cisco IOS-XR Software module of the Cisco IOS-XR System Security Configuration Guide.
Cisco IOS-XR System Management Command Reference
S MR-2 9 1
Process and Memory Management Commands on Cisco IOS-XR Software
show processes
The show processes command displays general information on the active processes. To view more
detailed information for a process, include the job-id or process-name.
You can also use the monitor command to determine the top users of the CPU.
Examples
The following is partial sample output from the show processes command:
RP/0/RP1/CPU0:router# show processes
JID
1
1
1
1
1
1
1
1
1
1
1
1
1
1
1
1
TID LastCPU Stack pri state
HR:MM:SS:MSEC NAME
1
0
1
1
1
0
1
0
0
1
1
1
0
1
1
1
0
1
0
0K
0K
0 Ready
1:57:41:0542 procnto-600-smp-cisco-instr
1:57:37:0022 procnto-600-smp-cisco-instr
0:00:05:0723 procnto-600-smp-cisco-instr
0:00:00:0001 procnto-600-smp-cisco-instr
0:00:00:0000 procnto-600-smp-cisco-instr
0:00:00:0000 procnto-600-smp-cisco-instr
0:00:00:0000 procnto-600-smp-cisco-instr
0:00:01:0885 procnto-600-smp-cisco-instr
0:00:03:0416 procnto-600-smp-cisco-instr
0:00:00:0001 procnto-600-smp-cisco-instr
0:00:04:0861 procnto-600-smp-cisco-instr
0:00:02:0020 procnto-600-smp-cisco-instr
0:00:03:0278 procnto-600-smp-cisco-instr
0:00:00:0732 procnto-600-smp-cisco-instr
0:00:02:0692 procnto-600-smp-cisco-instr
0:00:03:0788 procnto-600-smp-cisco-instr
0:00:11:0785 procnto-600-smp-cisco-instr
0:00:04:0037 procnto-600-smp-cisco-instr
2
0 Running
3
4
5
6
7
8
9
10
11
15
18
20
21
22
23
25
0K 10 Receive
0K 10 Receive
0K 63 Receive
0K 63 Receive
0K 63 Receive
0K 10 Receive
0K 10 Receive
0K 10 Receive
0K 10 Receive
0K 10 Receive
0K 10 Receive
0K 10 Receive
0K 10 Receive
0K 10 Running
0K 10 Receive
0K 10 Receive
1
1
--More--
The show process process-name command displays detailed information about a process:
RP/0/RP1/CPU0:router# show processes ospf
Job Id: 261
PID: 139453
Executable path: /hfr-rout-0.44.0/bin/ospf
Instance #: 1
Version ID: 00.00.0000
Respawn: ON
Respawn count: 1
Max. spawns per minute: 12
Last started: Wed Mar 17 07:46:26 2004
Process state: Run
Package state: Normal
Started on config: cfg/gl/ipv4-ospf/proc/100/ord_a/routerid
core: TEXT SHAREDMEM MAINMEM
Max. core: 0
Mandatory: ON
Placement: ON
startup_path: /pkg/startup/ospf.startup
Process cpu time: 0.410 user, 0.183 kernel, 0.593 total
JID
261
261
261
261
TID LastCPU Stack pri state
HR:MM:SS:MSEC NAME
0:00:00:0397 ospf
0:00:00:0003 ospf
0:00:00:0007 ospf
0:00:00:0000 ospf
1
2
3
4
0
1
0
1
40K 10 Receive
40K 10 Receive
40K 10 Receive
40K 10 Condvar
--More--
Cisco IOS-XR System Management Command Reference
S MR-2 9 2
Process and Memory Management Commands on Cisco IOS-XR Software
show processes
The show processes memory command displays details of memory usage for a given process or for all
processes, as shown in the following example:
RP/0/RP1/CPU0:router# show processes memory
JID
55
Text
Data
4096
4096
4096
4096
4096
4096
4096
4096
4096
4096
4096
4096
4096
4096
4096
4096
4096
4096
Stack
69632
20480
45056
77824
57344
143360
24576
36864
40960
28672
32768
110592
40960
40960
40960
40960
40960
40960
Dynamic Process
17072128 eth_server
13238272 hfr_fgid_server
10526720 syslogd
9797632 bgp
5877760 parser_server
3084288 netio
2314240 nvram
1699840 sysdb_svr_local
1576960 wdsysmon
1490944 nvgen_server
1425408 hd_drv
1421312 qnet
1392640 ospf
1392640 ospf
1392640 ospf
1392640 ospf
1392640 ospf
1392640 ospf
28672
143360
167936
512000
57344
40960
8192
164
317
122
265
254
63
314
341
259
189
69
348
347
346
345
344
261
4096
495616
53248
32768
77824
323584
323584
323584
323584
323584
323584
--More--
The following is partial sample output from the show processes signal command:
RP/0/RP1/CPU0:router# show processes signal
pid name
signals pending signals ignored
signals queued
tid
1 kernel
1
2
signals blocked signals pending
0000000000000000 0000000006c20100 0000000000000000
0000000000000000 00ffffffffffffff
0000000000000000 00ffffffffffffff
3
4
5
6
7
8
9
10
11
12
14
14
15
16
0000000000000000 00ffffffffbffeff
0000000000000000 00ffffffffbffeff
0000000000000000 00ffffffffbffeff
0000000000000000 00ffffffffbffeff
0000000000000000 00ffffffffbffeff
0000000000000000 00ffffffffbffeff
0000000000000000 00ffffffffbffeff
0000000000000000 00ffffffffbffeff
0000000000000000 00ffffffffbffeff
0000000000000000 00ffffffffbffeff
0000000000000000 00ffffffffbffeff
0000000000000000 00ffffffffbffeff
0000000000000000 00ffffffffbffeff
0000000000000000 00ffffffffbffeff
--More--
The following is partial sample output from the show processes family command:
RP/0/RP1/CPU0:router# show processes family
id name
1 kernel
session pgroup
ppid sibling
child
0
5
1
1
1
1
1
1
1
1
72
2
0
71
71
71
71
71
71
71
0
0
0
72 wd-mbi
53 dllmgr
278 qsm
67 pkgfs
68 devc-pty
52 devc-conaux
0
278
67
68
52
54
72
67
68
65545
0
65669
Cisco IOS-XR System Management Command Reference
S MR-2 9 3
Process and Memory Management Commands on Cisco IOS-XR Software
show processes
65545 pkgfs
65546 ksh
66 pipe
1
65545
65546
66
67
52
71
71
71
71
71
65
71
71
71
0
0
0
0
0
0
0
0
65546
1
1
1
1
1
1
1
1
1
52
61
66
56
64
0
65
70
63
56 devf-scrp
56
61
64
65
65
70
63
55
61 mqueue
64 pci_bus_mgr
65 pcmciad
65559
65552 cardmgrd
70 syslogd_helper
63 nvram
55 eth_server
--More--
0
0
0
0
The following is partial sample output from the show processes files command:
RP/0/RP1/CPU0:router# show processes files
JID
1
72
Open Files NAME
13
4
kernel
wd-mbi
53
278
67
588
16
6
dllmgr
qsm
pkgfs
68
52
65545
65546
66
4
45
5
5
4
devc-pty
devc-conaux
pkgfs
ksh
pipe
56
61
3
4
devf-scrp
mqueue
64
65
65552
70
63
9
11
6
16
13
14
pci_bus_mgr
pcmciad
cardmgrd
syslogd_helper
nvram
55
eth_server
--More--
The following is partial sample output from the show processes blocked command:
RP/0/RP1/CPU0:router# show processes blocked
Jid
65546
105
105
324
65669 1237125
236 123014
163 123022
163 123022
335 139436
65740 1401036
65741 1401037
Pid Tid
Name State Blocked-on
4106
1
2
3
1
1
2
2
3
1
1
1
ksh Reply
attachd Reply
attachd Reply
tftp_server Reply
exec Reply
4104 devc-conaux
20499 eth_server
4109 mqueue
41012
41012
41031
4109 mqueue
1 kernel
lpts_fm Reply
fdiagd Reply
fdiagd Reply
41049 lpts_pa
20499 eth_server
4109 mqueue
udp_snmpd Reply 123005 udp
more Reply
show_processes Reply
4107 pipe
1 kernel
The following is partial sample output from the show processes boot command:
RP/0/RP1/CPU0:router# show processes boot
Band
Name
Finished %Idle
JID
Ready
Last Process
----- -------- -------- -------- -------- ------- ---------------------------
1.0 MBI
40.0 ARB
100.0 INFRA
150.0 ACTIVE
15.582 67.770%
26.713 93.540%
144.134 77.020%
58 15.582 insthelper
281 11.131 redcon
198 117.421 instdir
168.367
0.090%
271 24.233 policy_repository
Cisco IOS-XR System Management Command Reference
S MR-2 9 4
Process and Memory Management Commands on Cisco IOS-XR Software
show processes
999.0 FINAL
177.738
JID
0.000%
172
9.371 fm_script_dir
Process
Started Level
Inst Ready
------- ----- -------- ---- ------- -------------------------------
0.000
0.000
0.000
0.000
0.000
0.000
0.000
0.000 16.0
0.000 20.0
--More--
0.5
1.0
2.0
3.0
3.0
6.0
8.0
72
53
67
52
68
66
61
56
64
1
1
1
1
1
1
1
1
1
0.000 wd-mbi
0.000 dllmgr
0.000 pkgfs
0.000 devc-conaux
0.000 devc-pty
0.000 pipe
0.000 mqueue
0.000 devf-scrp
0.000 pci_bus_mgr
The following is sample output from the show processes cpu command:
RP/0/RP1/CPU0:router# show processes cpu
CPU utilization for one minute: 1%; five minutes: 1%; fifteen minutes: 1%
PID
1
3
1Min
0%
0%
0%
0%
0%
0%
0%
0%
0%
0%
0%
0%
0%
0%
0%
5Min
0%
0%
0%
0%
0%
0%
0%
0%
0%
0%
0%
0%
0%
0%
0%
15Min Process
0% kernel
0% dllmgr
0% wd-mbi
0% pkgfs
0% devc-pty
0% devc-conaux
0% pkgfs
0% ksh
0% pipe
4098
4102
4103
4104
4105
4106
4107
4109
12300
16398
20495
20496
20497
0% mqueue
0% devf-scrp
0% pci_bus_mgr
0% pcmciad
0% cardmgrd
0% syslogd_helper
--More--
The following is partial sample output from the show processes log command:
RP/0/RP1/CPU0:router# show processes log
01/01 00:00:02.091 1 Hello from init !!
01/01 00:00:02.093 1 Wait for pkgfs at '/pkg'
01/01 00:00:03.138 1 Boot Device = /dev/null
01/01 00:00:03.139 1 Create event manager
01/01 00:00:03.199 1 Attach to msg channel
01/01 00:00:03.200 1 Create msg handling thread
01/01 00:00:03.200 2 sysmgr_lite_process_msg: In sysmgr_process_msg thread
01/01 00:00:03.200 2 Attaching respawn handler
01/01 00:00:03.201 1 read_init_startup_list: opening directory /pkg/init.d for .
init files
01/01 00:00:03.201 2 Attaching async handler
01/01 00:00:03.202 2 Attaching sync handler
01/01 00:00:03.202 2 starting ih_timer
01/01 00:00:03.202 2 lite_set_timer: id=1, 1800 seconds
01/01 00:00:03.202 2 Servicing msgs
01/01 00:00:03.205 1 read_init_startup_list: Opening /pkg/init.d/bfm.init
01/01 00:00:03.208 1 read_init_startup_list: finished /pkg/init.d/bfm.init pcb->
name=bfm_server
01/01 00:00:03.208 1 read_init_startup_list: Opening /pkg/init.d/clock_chip.init
01/01 00:00:03.210 1 read_init_startup_list: finished /pkg/init.d/clock_chip.ini
t pcb->name=clock_chip
Cisco IOS-XR System Management Command Reference
S MR-2 9 5
Process and Memory Management Commands on Cisco IOS-XR Software
show processes
01/01 00:00:03.211 1 read_init_startup_list: Opening /pkg/init.d/devc_conaux.ini
t
01/01 00:00:03.213 1 read_init_startup_list: finished /pkg/init.d/devc_conaux.in
it pcb->name=devc-conaux
01/01 00:00:03.213 1 read_init_startup_list: Opening /pkg/init.d/dllmgr.init
01/01 00:00:03.215 1 read_init_startup_list: finished /pkg/init.d/dllmgr.init pc
b->name=dllmgr
01/01 00:00:03.215 1 read_init_startup_list: Opening /pkg/init.d/dumper.init
--More--
Related Commands
Command
Description
Displays auto-updating process statistics in a full-screen mode.
Displays auto-updating process and thread statistics in a full-screen mode.
Cisco IOS-XR System Management Command Reference
S MR-2 9 6
|
