crashconf(1M)

DESCRIPTION

crashconf displays and/or changes the current system crash dump configuration. The crash dump configuration consists of:

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.

RETURN VALUE

Upon exit, crashconf returns the following values:

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.

SEE ALSO

lvcreate(1M), crashconf(2), pstat(2), fstab(4).