NAME
cr_verify — verify integrity of crash dump
SYNOPSIS
#include <libcrash.h>
int cr_verify(CRASH *crash_cb, int flags);
DESCRIPTION
cr_verify()
uncompresses and verifies the sizes and checksums of every file
in the crash dump identified by
crash_cb.
flags
is a bitmask of zero or more of the following flag values:
- CR_NOCHECKSUM
cr_verify()
will not attempt to verify checksums of files in the crash
dump if this flag is set. Only sizes will be verified.
- CR_DELAYMSGS
cr_verify()
will write messages to stderr during time-consuming operations
(decompressions and checksums) if this flag is set.
- CR_ERRORMSGS
cr_verify()
will write messages to stderr describing any validation problems
that are encountered. If this flag is set,
cr_perror()
should not be called when
cr_verify()
returns; repeated error messages would result.
RETURN VALUE
Returns zero for success. Other possible return values are described in
libcrash(5).
EXAMPLES
The following call to
cr_verify(3)
verifies the integrity of the dump.
#include <libcrash.h>
CRASH *crash_cb;
int ret;
ret = cr_verify(crash_cb, CR_DELAYMSGS | CR_ERRORMSGS);
WARNINGS
Because it uncompresses and checksums all files in a dump,
cr_verify()
can be very time-consuming. If
CR_DELAYMSGS
was not specified, the calling application
should notify its user before calling
cr_verify()
that there may be a significant delay.
AUTHOR
cr_verify()
was developed by HP.