NAME [Toc] [Back]
cr_uncompress - uncompress a file in a crash dump
SYNOPSIS [Toc] [Back]
int cr_uncompress(CRASH *crash_cb, const char *pathname,
uint64_t size, uint64_t checksum);
DESCRIPTION [Toc] [Back]
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
RETURN VALUE [Toc] [Back]
Returns zero for success. Other possible return values are described
EXAMPLE [Toc] [Back]
The following call to cr_uncompress(3) ensures that the kernel file
vmunix is uncompressed and validated.
result = cr_uncompress (crash, "vmunix", vmunix_size, vmunix_cksum);
AUTHOR [Toc] [Back]
cr_uncompress() was developed by HP.
SEE ALSO [Toc] [Back]
gunzip(1), uncompress(1), cr_info(3), cr_open(3), libcrash(5).
Hewlett-Packard Company - 1 - HP-UX 11i Version 2: August 2003 [ Back ]