Cisco ASR 14000 Series Management Command Reference page 512

exception sparse
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
exception sparse
To enable or disable sparse core dumps, use the exception sparse command in administration
configuration mode or in global configuration mode. To remove the configuration, use the no form of
this command.
Syntax Description
on
off
Defaults Sparse core dumps are disabled.
Command Modes
Administration configuration
Global configuration
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.
Use the exception sparse command to reduce the amount of data generated in the core dump file. Sparse
core dumps, thus, reduce the amount of time required to generate the core dump file because only
referenced data is generated in the core file (at the cost of lost information in the core file). Reducing the
time required to generate core dump files corresponds to faster process restart times.
Sparse core dumps contain the following information about crashed processes:
•
•
•
•
The exception sparse command dumps memory pages based on trigger addresses found in the
previously listed dump information, according to the following criteria:
•
•
•
Cisco ASR 14000 Series Router System Management Command Reference
SMR-510
exception sparse {on | off}
no exception sparse
Enables sparse core dumps.
Disables sparse core dumps
Modification
This command was introduced on the Cisco ASR 14000 Series Router.
Register information for all threads, and any memory pages referenced in these register values
Stack information for all threads, and any memory pages referenced in these threads
All memory pages referenced by a loaded dynamic loadable library (DLL) data section, if the final
program counter falls in a DLL data section
Any user-specified marker pages from the lib_dumper_marker DLL
If the trigger address in the memory page is in the beginning 128 bytes of the memory page, the
previous memory page in the continuous address region is dumped also.
If the trigger address in the memory page is in the final 128 bytes of the memory page, the next
memory page in the continuous address region is dumped also.
In all other instances, only the memory page that includes the trigger address is dumped.
Process and Memory Management Commands on Cisco IOS XR Software
OL-17231-01