cr_verify(3) cr_verify(3)
NAME [Toc] [Back]
cr_verify - verify integrity of crash dump
SYNOPSIS [Toc] [Back]
#include <libcrash.h>
int cr_verify(CRASH *crash_cb, int flags);
DESCRIPTION [Toc] [Back]
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 [Toc] [Back]
Returns zero for success. Other possible return values are described
in libcrash(5).
EXAMPLES [Toc] [Back]
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 [Toc] [Back]
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 [Toc] [Back]
cr_verify() was developed by HP.
Hewlett-Packard Company - 1 - HP-UX 11i Version 2: August 2003
cr_verify(3) cr_verify(3)
SEE ALSO [Toc] [Back]
cr_open(3), cr_perror(3), libcrash(5).
Hewlett-Packard Company - 2 - HP-UX 11i Version 2: August 2003 [ Back ] |
