cr_uncompress.3 (2010 09)

cr_uncompress(3) cr_uncompress(3)

NAME

cr_uncompress - uncompress a ﬁle in a crash dump

SYNOPSIS

#include <libcrash.h>

int cr_uncompress(CRASH *crash_cb, const char *pathname,

uint64_t size, uint64_t checksum);

DESCRIPTION

The cr_uncompress()

ensures that a ﬁle, part of a crash dump described by crash_cb ,is

uncompressed and matches its expected size and checksum (as computed by cksum(1)). This call is most

often used to ensure the integrity of module ﬁles that are a part of the crash dump; see cr_info (3).

pathname is the name of the ﬁle to uncompress. Supported compression methods include gzip(1), which

appends a

.gz to the ﬁlename, and compress (1), which appends

.Z. Respectively, size and checksum are

the expected size and checksum of the uncompressed ﬁle. Either validity check can be disabled by speci-

fying zero for the corresponding parameter.

RETURN VALUE

Returns zero for success. Other possible return values are described in libcrash (5).

EXAMPLE

The following call to cr_uncompress(3) ensures that the kernel ﬁle

vmunix is uncompressed and vali-

dated.

#include <libcrash.h>

result = cr_uncompress (crash, "vmunix", vmunix_size, vmunix_cksum);

AUTHOR

cr_uncompress() was developed by HP.