HP-UX Reference (11i v1 00/12) - 1M System Administration Commands A-M (vol 3)

__________________________________________________________________________________________________________________________________________________________________________________________________
__________________________________________________________________________________________________________________________________________________________________________________________________
STANDARD Printed by: Nora Chuang [nchuang] STANDARD
/build/1111/BRICK/man1m/!!!intro.1m
________________________________________________________________
___ ___
c
crashconf(1M) crashconf(1M)
NAME
crashconf - configure system crash dumps
SYNOPSIS
/sbin/crashconf [-arv][-i-e class] ... [device...]
DESCRIPTION
crashconf displays and/or changes the current system crash dump configuration. The crash dump
configuration consists of three lists:
• 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.
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.
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.
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.)
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.
-e The classes 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 classes 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.
-r Specifies that any changes should replace, rather than add to, the current configuration. Thus, if
devicesor -a are specified, the current crash dump device list is replaced with new contents; if
classes are specified with -e, they replace the list of currently excluded classes, and if classes are
specified with
-i, they replace the list of currently included classes.
-v Displays the current crash dump configuration. This is the default option if no arguments are
specified. If any changes to the current configuration are specified on the same command line as
-v,
the configuration will be displayed after the requested changes are made.
RETURN VALUE
Upon exit,
crashconf returns the following values:
0 Success.
1 The requested configuration changes could not be made.
WARNINGS
The output of crashconf is not designed to be parsed by applications or scripts, but only to be read by
humans. The output format may change without notice. Applications which require crash dump
HP-UX Release 11i: December 2000 − 1 − Section 1M−−145
___
___