cr_verify.3 (2010 09)

c
cr_verify(3) cr_verify(3)
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.
SEE ALSO
cr_open(3), cr_perror(3), libcrash(5).
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1