HP-UX Reference (11i v1 05/09) - 2 System Calls (vol 5)

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 con-
sists 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.
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(1M).
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.
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() .
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 includeC-
lasses parameter is valid.
DC_EXCLUDE crashconf() will change the contents of the excluded class list. The excludeC-
lasses parameter is valid.
DC_DEVICES crashconf() will change the contents of the crash dump device list. The devi-
ceCount, devices and deviceReturn parameters are valid.
DC_SETCOMPRESS
crashconf()
will set the compression mode ON.
DC_SETNOCOMPRESS
crashconf()
will set the compression mode OFF.
operation may also have the following flag set:
DC_REPLACE Changes to any of the lists will replace the current contents of those lists. Without
this flag, changes will add to the current contents of those lists.
Section 2−−44 Hewlett-Packard Company − 1 − HP-UX 11i Version 1: September 2005