HP-UX Reference (11i v1 00/12) - 2 System Calls (vol 5)
__________________________________________________________________________________________________________________________________________________________________________________________________
__________________________________________________________________________________________________________________________________________________________________________________________________
STANDARD Printed by: Nora Chuang [nchuang] STANDARD
/build/1111/BRICK/man2/!!!intro.2
________________________________________________________________
___ ___
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 three lists:
• 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.
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.
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.
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.
includeClasses is a bitmask of classes that must be dumped. If it is set to
DT_ALL, all dumps will be full
dumps. Other allowed values are described under Classes, below.
excludeClasses is a bitmask of classes that may not be dumped unless a full dump is required (due to the
cause of the dump, or by explicit operator request). If it is set to
DT_ALL, dumps will be disabled. Other
allowed values are described under Classes, below.
devices is an array of deviceCount pathnames of block device files for crash dump devices. To be valid, a
device must be accessible and must not contain a file system. Where LVM partitions are in use, the device
number must be for a partition, not the physical disk that contains it, and must represent a partition that
is strictly contiguous on the physical disk. (LVM bad-block reallocation, and striping features may not be in
use on the partition.) Depending on the disk type, the dump space may be restricted to the first 2GB or
4GB of the physical disk.
HP-UX Release 11i: December 2000 − 1 − Section 2−−41
___
___