HP-UX Reference (11i v1 00/12) - 3 Library Functions A-M (vol 6)

ManualsBrandsHP ManualsSoftwareHP-UX Reference Manuals

141

142

143

144

145

146

147

148

149

150

__________________________________________________________________________________________________________________________________________________________________________________________________

STANDARD Printed by: Nora Chuang [nchuang] STANDARD

/build/1111/BRICK/man3/!!!intro.3c

________________________________________________________________

___ ___

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 veriﬁes the sizes and checksums of every ﬁle in the crash dump

identiﬁed by crash_cb.

ﬂags is a bitmask of zero or more of the following ﬂag values:

CR_NOCHECKSUM cr_verify() will not attempt to verify checksums of ﬁles in the crash dump if

this ﬂag is set. Only sizes will be veriﬁed.

CR_DELAYMSGS cr_verify() will write messages to stderr during time-consuming operations

(decompressions and checksums) if this ﬂag is set.

CR_ERRORMSGS cr_verify() will write messages to stderr describing any validation problems

that are encountered. If this ﬂag 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) veriﬁes the integrity of the dump.

#include <libcrash.h>

CRASH *crash_cb;

int ret;

ret = cr_verify(crash_cb, CR_DELAYMSGS | CR_ERRORMSGS);

WARNING

Because it uncompresses and checksums all ﬁles in a dump, cr_verify() can be very time-consuming.

If CR_DELAYMSGS was not speciﬁed, the calling application should notify its user before calling

cr_verify() that there may be a signiﬁcant delay.

AUTHOR

cr_verify() was developed by HP.