NAME
cr_uncompress — uncompress a file 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 file, 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 files that are a part of the crash dump; see
cr_info(3).
pathname
is the name of the file to uncompress. Supported compression methods
include
gzip(1),
which appends a
.gz
to the filename, and
compress(1),
which appends
.Z.
Respectively,
size
and
checksum
are the expected size and checksum of the uncompressed file.
Either validity check can be disabled by specifying 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 file
vmunix
is uncompressed and validated.
#include <libcrash.h>
result = cr_uncompress (crash, "vmunix", vmunix_size, vmunix_cksum);
AUTHOR
cr_uncompress()
was developed by HP.