crashconf.2 (2010 09)

c
crashconf(2) crashconf(2)
DC_SETCOMPRESS crashconf()
will set the compression mode ON.
DC_SETNOCOMPRESS crashconf()
will set the compression mode OFF.
DC_SETCONCURRENT crashconf()
will set the concurrency mode ON.
DC_SETNOCONCURRENT crashconf()
will set the concurrency mode OFF.
DC_PERSISTENT crashconf() will mark the current dump device list as persistent.
Once this is used, from the next boot onwards, system will ignore dev-
ices marked for dump using lvlnboot, vxvmboot
, and
/stand/system.
Instead, the persistent device list is used.
DC_LEGACY_MODE crashconf()
will change dump configuration mode. From next boot
onwards devices marked for dump using
lvlnboot,
vxvmboot, and
/stand/system will be configured as dump devices during boot-up.
Marking dump devices using lvlnboot, vxvmboot, and
/stand/system will be obsoleted in the next HP-UX release. This
operation is only provided to maintain backward compatibility for this
release.
DC_REMOVE crashconf() will remove the list of devices specified in devices from
the current dump device list.
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 or character device files (legacy or persistent, see
intro (7)) for crash dump devices. To be valid, a device must be accessible and must not contain a file sys-
tem. 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 2 GB or 4 GB of the physical disk.
deviceReturn is an array of deviceCount integers for returning the results of attempting to configure the
corresponding device from the devices array. Upon return, each element is set to a numeric value indi-
cating the result of configuring the corresponding device as follows:
0 Successfully configured the corresponding device as a dump device.
<0 Failed to configure the corresponding device as a dump device. The absolute value of the
returned number can be used as an index into an array of error messages. The error mes-
sage strings are defined in
CCERR_STRINGS (see below).
>0 The corresponding device has been configured but there is one or more notes or warnings
associated with the device. The returned value is a bitmap of warnings. The warning mes-
sage strings are defined in
CCWARN_STRINGS (see below).
Any parameters which are not used for the given operation should be set to zero. Note that both devices
and deviceReturn must be specified if
DC_DEVICES is specified.
Classes
The following system memory classes have been defined as of this writing. Refer to the output of the
crashconf command or to /usr/include/sys/crashconf.h for definitions of any classes added
since publication. The memory page size is 4 Kb.
DT_UNUSED Unused physical memory pages
DT_KCODE Kernel code pages
DT_BCACHE Buffer cache data pages
DT_KSDATA Kernel static data pages
2 Hewlett-Packard Company 2 HP-UX 11i Version 3: September 2010