HP-UX Reference (11i v2 03/08) - 1M System Administration Commands A-M (vol 3)

c
crashconf(1M) crashconf(1M)
NAME
crashconf - configure system crash dumps
SYNOPSIS
/sbin/crashconf
[-artv][-i-e class ][
-c mode] ... [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 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 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.
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 option -t, changes to
the include and exclude class lists and compression mode can be made persistent across system reboots.
But the changes do not persist across kernel rebuilds. Use SAM or kctune(1M) to do this.
device specifies a block device file name of a device that is a valid destination for crash dumps. All such
devices listed on the command line will be added to the end of the current list of crash dump devices, or
will replace the current list of crash dump devices, depending on whether
-r is specified.
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
4Kb.
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.)
mode, either
ON or OFF, will turn compression ON or OFF, in the dump path.
Options
-a The file /etc/fstab is read, and all dump devices identified in it will be added to (or will
replace) the current list of crash dump devices. This is in addition to any crash dump devices
specified on the command line. See fstab(4) for information on the format of /etc/fstab.
-c The mode specified with -c will be used to set the compression mode. If the system is not able to
identify enough processing resources to do compressed dump, a warning message will be issued.
-e The class es specified with -e will be added to (or will replace) the list of excluded (i.e., should not
dump) classes. If any of those classes are present in the current included class list, they will be
removed from it.
-i The class es specified with -i will be added to (or will replace) the list of included (i.e., must dump)
classes. If any of those classes are present in the current excluded class list, they will be removed
from it.
HP-UX 11i Version 2: August 2003 − 1 − Hewlett-Packard Company Section 1M−−105