Cisco ASR 14000 Series Management Command Reference page 503

Process and Memory Management Commands on Cisco IOS XR Software
C i s c o C o n f i d e n t i a l - B e t a R e v i e w R 3 . 7. 1
dumpcore
To manually generate a core dump, use the dumpcore command in administration EXEC mode or in
EXEC mode.
Syntax Description
running
suspended
job-id
location node-id
Defaults No default behavior or values
Command Modes Administration EXEC
EXEC
Command History Release
Release 3.7.1
Usage Guidelines To use this command, you must be in a user group associated with a task group that includes the proper
task IDs.
When a process crashes on the Cisco IOS XR software, a core dump file of the event is written to a
designated destination without bringing down the router. Upon receiving notification that a process has
terminated abnormally, the Cisco IOS XR software then respawns the crashed process. Core dump files
are used by Cisco Technical Support Center engineers and development engineers to debug the
Cisco IOS XR software.
On the Cisco IOS XR software, core dumps can be generated manually for a process, even when a
process has not crashed. Two modes exist to generate a core dump manually:
•
•
Core dump files contain the following information about a crashed process:
•
•
OL-17231-01
dumpcore {running | suspended} job-id location node-id
Generates a core dump for a running process.
Suspends a process, generates a core dump for the process, and resumes
the process.
Process instance identifier.
Generates a core dump for a process running on the specified node. The
node-id argument is expressed in the rack/slot/module notation.
Modification
This command was introduced on the Cisco ASR 14000 Series Router.
running—Generates a core dump for a running process. This mode can be used to generate a core
dump on a critical process (a process whose suspension could have a negative impact on the
performance of the router) because the core dump file is generated independently, that is, the process
continues to run as the core dump file is being generated.
suspended—Suspends a process, generates a core dump for the process, and resumes the process.
Because the process is suspended, this mode ensures data consistency in the core dump file.
Register information
Thread status information
Cisco ASR 14000 Series Router System Management Command Reference
dumpcore
SMR-501