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 that certain types of system crash, such as TOC's, require a full
crash dump. Also, the system operator may request a full crash dump
at the time the dump is taken. In either of these cases, 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.
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
devices
or
-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 configuration information should
retrieve that information using
pstat(2).
Dump devices created by
lvcreate(1M)
must be contiguous
(-Cy
option) with bad
block relocation turned off
(-rn
option).
AUTHOR
crashconf
was developed by HP.
