HP-UX Reference (11i v3 07/02) - 1M System Administration Commands A-M (vol 3)

c
crashconf(1M) crashconf(1M)
NAME
crashconf - configure system crash dumps
SYNOPSIS
/sbin/crashconf
[-adlorstv][-i-e class]... [
-c cmode][-p pmode]... [device]...
DESCRIPTION
crashconf displays and/or 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 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 dumping.
• The concurrency mode selection. This selection is used to turn concurrency
ON or OFF, before dumping.
Currently supported only on Integrity systems.
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 faster and smaller dumps. If the dump is compressed,
savecrash will also copy over the dump faster since the dump will be smaller in size.
Since compressed dump requires additional processors and memory to do the compression, the system may
fall back on uncompressed dump if it could not identify the processing resources required to do compressed
dump.
Turning concurrency mode ON may result in faster dumps depending on the configuration of the dump dev-
ices. Depending on the availability of additional memory and the configuration of dump devices, the system
may fall back to non-concurrent dump mode.
Any changes to the configuration take effect immediately and remain in effect until the next system reboot,
or until changed with a subsequent invocation of crashconf. Using the -t option, changes to the
include and exclude class lists and compression mode and concurrency mode can be made persistent across
system reboots, but the changes do not persist across kernel rebuilds. Use HP SMH (replacement for SAM)
or kctune (see sam(1M), smh(1M), and kctune(1M)) to make tunables persistent. Changes to the dump
device list can be made persistent across system reboots by using the -s option.
device specifies a block or character device file name (legacy or persistent) of a device that is a valid destina-
tion for crash dumps. The devices listed will be added to, deleted from (using -d) or replaced (using
-r)in
the current list of crash dump devices.
Note: A device has several device file names associated with it. These include the legacy device file names
that correspond to the various legacy paths to the device, and one persistent device file name that
corresponds to the lun itself (see intro(7)).
The crash dump subsystem converts the legacy device file name to the persistent device file name prior to
starting the configuration. The crash dump subsystem will also use the block device file name for the
configuration. Use the
-v option to display the persistent device file name. Display the corresponding
legacy device file using ioscan (see ioscan(1M)).
The crash dump subsystem can chooose any available path to the device for the configuration. Therefore,
the configuration of the device may not always be through the path represented by the legacy device file
name. Use the -l option to display the lunpath hardware path (see intro(7)) selected for the configuration.
class is the name (or number) of a system memory class which should be added to the appropriate class list.
The list of system memory classes can be obtained using crashconf -v. The memory page size is 4 Kb.
class may also be the word all, in which case all classes are added to the appropriate list. (The effect of
adding all classes to the included class list is to force full crash dumps under all circumstances. The effect
of adding all classes to the excluded class list is to disable crash dumps.)
HP-UX 11i Version 3: February 2007 − 1 − Hewlett-Packard Company 131