crashconf.1m (2010 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

crashconf(1M) crashconf(1M)

NAME

crashconf - conﬁgure system crash dumps

SYNOPSIS

/sbin/crashconf

[-adlorstv][-i-e class ]... [

-c cmode][-p pmode]... [device ]...

DESCRIPTION

crashconf displays and/or changes the current system crash dump conﬁguration. The crash dump

conﬁguration consists of:

• The crash dump device list. This list identiﬁes all devices that can be used to store a crash dump.

• The included class list. This list identiﬁes all system memory classes that must be included in any

crash dump.

• The excluded class list. This list identiﬁes 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.

• The concurrency mode selection. This selection is used to turn concurrency

ON or OFF, before dump-

ing. Currently supported only on Integrity systems.

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.

Turning concurrency mode

ON may result in faster dumps depending on the conﬁguration of the dump

devices. Depending on the availability of additional memory and the conﬁguration of dump devices, the

system may fall back to non-concurrent dump mode.

Any changes to the conﬁguration take effect immediately and remain in effect until the next system

reboot, or until changed with a subsequent invocation of

crashconf. Using the -t option, changes to

the include and exclude class lists and compression mode and concurrency mode can be made persistent

across system reboots, but the changes do not persist across kernel rebuilds. Use HP SMH (replacement

for SAM) or kctune (see sam(1M), smh(1M), and kctune (1M)) to make tunables persistent. Changes to

the dump device list can be made persistent across system reboots by using the -s option.

device speciﬁes a block or character device ﬁle name (legacy or persistent) of a device that is a valid desti-

nation for crash dumps. The devices listed will be added to, deleted from (using

-d) or replaced (using -

r) in the current list of crash dump devices.

NOTE: A device has several device ﬁle names associated with it. These include the legacy device ﬁle

names that correspond to the various legacy paths to the device, and one persistent device ﬁle name that

corresponds to the lun itself (see intro (7)).

The crash dump subsystem converts the legacy device ﬁle name to the persistent device ﬁle name prior to

starting the conﬁguration. The crash dump subsystem will also use the block device ﬁle name for the

conﬁguration. Use the

-v option to display the persistent device ﬁle name. Display the corresponding

legacy device ﬁle using ioscan (see ioscan (1M)).

The crash dump subsystem can choose any available path to the device for the conﬁguration. Therefore,

the conﬁguration of the device may not always be through the path represented by the legacy device ﬁle

name. Use the

-l option to display the lunpath hardware path (see intro (7)) selected for the

conﬁguration.

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

4 Kb.

HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1

Summary of content (4 pages)

PAGE 1
crashconf(1M) crashconf(1M) NAME crashconf - configure system crash dumps SYNOPSIS /sbin/crashconf [-adlorstv] [-i-e class ]... [-c cmode] [-p pmode ]... [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.
PAGE 2
crashconf(1M) crashconf(1M) 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.) Persistent Dump Devices To mark the dump devices as persistent, there are two configuration modes available.
PAGE 3
crashconf(1M) crashconf(1M) contents. Likewise, with -r, the -e and -i options replace the current class list. This option cannot be used with the -d option. -s Mark the dump device list as persistent across reboots. This will also enable the config_crashconf_mode. Use -o to switch back to config_deprecated_mode. The -s and -o options are mutually exclusive.
PAGE 4
(Notes) A (Notes) cA 4 Hewlett-Packard Company −1− HP-UX 11i Version 3: September 2010