crashutil.1m (2010 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

crashutil(1M) crashutil(1M)

NAME

crashutil - manipulate crash dump data

SYNOPSIS

/usr/sbin/crashutil

[-q][-v version ] source [destination ]

DESCRIPTION

crashutil copies and preserves crash dump data, and performs format conversions on it. Common

uses of crashutil include:

• Copying portions of a dump that still reside on a raw dump device into a crash dump directory.

• Converting between different formats of crash dumps.

• Copying crash dumps from one directory, or medium, to another.

crashutil will write to its destination the crash dump it reads from its source . The crash dump format

used to write the destination is speciﬁed with

-v;if -v is not speciﬁed, the destination will have the

same format as the source.Ifnodestination is speciﬁed, source is used; the format conversion will be

done in place in the source , without copying. When

crashutil completes successfully, the entire con-

tents of the crash dump will exist at destination ; any portions that had still been on raw dump devices

will have been copied to destination .

There are three known dump formats:

COREFILE (Version 0) This format, used up through HP-UX

10.01, consists of a single ﬁle containing

the physical memory image, with a 1-to-1 correspondence between ﬁle offset and memory

address. Normally there is an associated ﬁle containing the kernel image. source sor

destination s of this type must be speciﬁed as two pathnames to plain ﬁles, separated by

whitespace; the ﬁrst is the core image ﬁle and the second is the kernel image ﬁle.

COREDIR (Version 1) This format, used in HP-UX 10.10, 10.20, and 10.30,

consists of a core.n direc-

tory containing an

INDEX ﬁle, the kernel (vmunix) ﬁle, and numerous core.n

.m ﬁles,

which contain portions of the physical memory image. source sordestination s of this type

should be speciﬁed as the pathname to a core directory.

CRASHDIR (Version 2) This format, used in HP-UX 11.00 and later, consists of a

crash.n directory

containing an

INDEX ﬁle, the kernel and all dynamically loaded kernel module ﬁles, and

numerous image.m.p ﬁles, each of which contain portions of the physical memory image

and metadata describing which memory pages were dumped and which were not. source s

or destination s of this type should be speciﬁed as the pathname to a crash directory.

PARDIR (Version 3) This format is used in HP-UX Release 11i Version 1.0 and later. It is very simi-

lar in structure to the CRASHDIR format in that it consists of a crash.n directory con-

taining an INDEX ﬁle, the kernel and all dynamically loaded kernel module ﬁles, and

numerous image.m.p ﬁles, each of which contain portions of the physical memory image

and metadata describing which memory pages were dumped and which were not. In addi-

tion to the primary INDEX ﬁle, there are auxiliary index ﬁles, that contain metadata

describing the image ﬁles containing the memory pages. This format will be used when

the dump is compressed. See crashconf (1M).

Other formats, for example tape archival formats, may be added in the future.

When the source and destination are different types of ﬁles — for example, when source is a directory and

destination is a pair of plain ﬁles — both must be speciﬁed.

Options

-q (Quiet) Disables the printing of progress messages. Warning and error messages are still

printed.

-v version Speciﬁes the version of the destination format. Allowed values are COREFILE, COREDIR,

CRASHDIR, PARDIR, 0, 1, 2 or 3. Also allowed is the keyword CURRENT, which speciﬁes

that the destination format should be the same as the current source format. CURRENT is

the default if -v is not speciﬁed. If the destination format is PARDIR, then the source for-

mat should also be PARDIR. Conversion to PARDIR from older formats is not supported.

RETURN VALUE

Upon exit,

crashutil returns the following values:

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

Summary of content (2 pages)

PAGE 1
crashutil(1M) crashutil(1M) NAME crashutil - manipulate crash dump data SYNOPSIS /usr/sbin/crashutil [-q] [-v version ] source [destination ] DESCRIPTION crashutil copies and preserves crash dump data, and performs format conversions on it. Common uses of crashutil include: • Copying portions of a dump that still reside on a raw dump device into a crash dump directory. • Converting between different formats of crash dumps. • Copying crash dumps from one directory, or medium, to another.
PAGE 2
crashutil(1M) 0 1 crashutil(1M) The operation was successful. The operation failed, and an appropriate error message was printed. EXAMPLES An HP-UX 11.00 crash dump was saved by savecrash (1M) to /var/adm/crash/crash.2. The -p flag was specified to savecrash , specifying that only those portions of the dump which were endangered by swap activity should be saved; the rest are still resident in the raw dump devices.