HP-UX Reference (11i v2 07/12) - 3 Library Functions A-M (vol 6)
c
cr_uncompress(3) cr_uncompress(3)
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 specify-
ing 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 vali-
dated.
#include <libcrash.h>
result = cr_uncompress (crash, "vmunix", vmunix_size, vmunix_cksum);
AUTHOR
cr_uncompress() was developed by HP.
SEE ALSO
gunzip(1), uncompress(1), cr_info(3), cr_open(3), libcrash(5).
HP-UX 11i Version 2: December 2007 Update − 1 − Hewlett-Packard Company 229