crashconf(1M) crashconf(1M)
NAME [Toc] [Back]
crashconf - configure system crash dumps
SYNOPSIS [Toc] [Back]
/sbin/crashconf [-artv] [-i|-e class] [-c mode] ... [device...]
DESCRIPTION [Toc] [Back]
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.
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,
Hewlett-Packard Company - 1 - HP-UX 11i Version 2: Sep 2004
crashconf(1M) crashconf(1M)
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 [Toc] [Back]
-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 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.
-t When used with the -i, -e or -c options, sets the dump tunables
alwaysdump, dontdump and dump_compress_on respectively, to make
the changes persistent across system reboots.
-v Displays the current crash dump configuration. This is the
default option if no arguments are specified. If any changes to
Hewlett-Packard Company - 2 - HP-UX 11i Version 2: Sep 2004
crashconf(1M) crashconf(1M)
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 [Toc] [Back]
Upon exit, crashconf returns the following values:
0 Success.
1 The requested configuration changes could not be made.
WARNINGS [Toc] [Back]
On systems running VxVM 3.5, the swap volumes to be configured for
system crash dumps should be created with the usage type as swap
during the creation of the swap volume. Not doing so will cause dump
corruption. You could use the -U option of vxassist(1M) to do the
same.
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 [Toc] [Back]
crashconf was developed by HP.
SEE ALSO [Toc] [Back]
lvcreate(1M), vxassist(1M), crashconf(2), pstat(2), fstab(4).
Hewlett-Packard Company - 3 - HP-UX 11i Version 2: Sep 2004 [ Back ] |