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
Process and Memory Management Commands on Cisco IOS XR Software
exception sparse
SMR-510
Cisco ASR 14000 Series Router System Management Command Reference
OL-17231-01
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.
exception
sparse
{
on
|
off
}
no
exception
sparse
Syntax Description
Defaults
Sparse core dumps are disabled.
Command Modes
Administration configuration
Global configuration
Command History
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:
•
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
The
exception sparse
command dumps memory pages based on trigger addresses found in the
previously listed dump information, according to the following criteria:
•
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.
on
Enables sparse core dumps.
off
Disables sparse core dumps
Release
Modification
Release 3.7.1
This command was introduced on the Cisco ASR 14000 Series Router.
