Manualshelf

crashconf.2 (2010 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages
1234
c
crashconf(2) crashconf(2)
NAME
crashconf() - configure system crash dumps
SYNOPSIS
#include <sys/crashconf.h>
int crashconf(
int operation,
int includeClasses,
int excludeClasses,
int deviceCount,
char **devices,
int *deviceReturn
);
DESCRIPTION
crashconf() changes the current system crash dump configuration. The crash dump configuration
consists of:
• The crash dump device list. This list identifies all devices that can be used to store a crash dump.
The devices are used in reverse order, last specified to first.
• The included class list. This list identifies all system memory classes that must be included in any
crash dump.
• The excluded class list. This list identifies all system memory classes that should not be included in a
crash dump.
• The compression mode selection. This selection is used to turn compression
ON or OFF before dump-
ing.
• The concurrency mode selection. This selection is used to turn concurrency
ON or OFF before dump-
ing.
Most system memory classes are in neither the included class list nor the excluded class list. Instead, the
system determines whether or not to dump those classes of memory based on the type of crash that
occurs.
Note the system operator may request a full crash dump at the time the dump is taken. In this case, a
full dump will be performed regardless of the contents of the excluded class list.
Turning compression mode
ON will result in smaller and faster dumps. Copying of compressed dump
from the dump device over to the filesystem will also be faster using savecrash.
Since compressed dump requires additional processors and memory to do the compression, the system
may fall back on uncompressed dump if it is not able to identify the processing resources required to do
compressed dump after a system crash.
Turning concurrency mode
ON may result in faster dumps depending on the configuration of the dump
devices.
Depending on the availability of additional memory and the configuration of dump devices, the system
may fall back to non-concurrent dump mode.
Configuration changes made using
crashconf() take effect immediately and remain in effect until the
next system reboot, or until changed with a subsequent call to crashconf(). Using the
DC_PERSISTENT operation, the dump device list can be made persistent across system reboots. Per-
sistent dump devices information is maintained in the kernel registry services (KRS, see krs(5)).
Parameters
operation is a bitmask specifying what
crashconf() should do. It must have at least one of the follow-
ing flags set:
DC_INCLUDE crashconf() will change the contents of the included class list. The
includeClasses parameter is valid.
DC_EXCLUDE crashconf() will change the contents of the excluded class list. The
excludeClasses parameter is valid.
DC_DEVICES crashconf() will change the contents of the crash dump device list.
The deviceCount , devices and deviceReturn parameters are valid.
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1

Summary of content (4 pages)