HP-UX Reference (11i v1 00/12) - 5 Miscellaneous Topics, 7 Device (Special) Files, 9 General Information, Index (vol 9)

ManualsBrandsHP ManualsSoftwareHP-UX Reference Manuals

100

__________________________________________________________________________________________________________________________________________________________________________________________________

STANDARD Printed by: Nora Chuang [nchuang] STANDARD

/build/1111/BRICK/man5/!!!intro.5

________________________________________________________________

___ ___

libcrash(5) libcrash(5)

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.

CCNUMADIR (Version 4) This format, used for multi-node machines, consists of a crash.n directory con-

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

numerous node.m.p and 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. sourcesordestinations of this type should be speciﬁed as the pathname to a ccnuma

directory.

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

RETURN VALUES

Most of the calls in libcrash return an integer status value. A zero return value indicates success. A posi-

tive return value indicates some sort of warning, despite which the requested operation was completed. A

negative return value indicates some sort of error, which prevented completion of the requested operation.

The values returned by the library are:

CR_OK Success.

CRWARN_NOEXPECTED

The expected size or checksum of one or more ﬁles in the crash dump was

not recorded, so the integrity of the dump cannot be veriﬁed. The dump

might be corrupt.

CRWARN_NOACTUAL The checksum of one or more ﬁles in the crash dump could not be com-

puted, so it could not be checked against the expected value. The dump

might be corrupt.

CRWARN_SWAPPEDON A raw device containing a portion of the crash dump has been swapped on,

so the dump is probably corrupt.

CRWARN_MISMATCH The size or checksum of one or more ﬁles in the crash dump did not match

what was expected. The dump is probably corrupt.

CRERR_NOPAGE A read or write request was issued for a memory address that does not

exist on the target machine.

CRERR_READONLY A write request was issued for a crash dump. Writes are supported only

to running systems through the /dev/mem driver.

CRERR_WRONGDUMP A raw dump device which is supposed to contain part of the dump does

not. It may have been overwritten by swap activity or by a more recent

dump.

CRERR_WRONGHOST A portion of the crash dump still resides on a dump device of the system

that dumped, which is not the current system.

CRERR_NONODE The speciﬁed node number does not exist.

CRERR_ERRNO A system error occurred. Consult errno for the speciﬁc error. Note

that certain values for errno have speciﬁc meanings in the context of

the library. They include:

[ENOEXEC] A portion of the crash dump could not be uncompressed.

[ENOTDIR] The speciﬁed pathname for the dump was neither a plain

ﬁle, nor a directory containing an INDEX ﬁle, nor the

/dev/mem pseudodriver.

\ Other values of errno have their traditional meanings.

AUTHOR

libcrash was developed by HP.