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

__________________________________________________________________________________________________________________________________________________________________________________________________
__________________________________________________________________________________________________________________________________________________________________________________________________
STANDARD Printed by: Nora Chuang [nchuang] STANDARD
/build/1111/BRICK/man3/!!!intro.3c
________________________________________________________________
___ ___
c
cr_isaddr(3) cr_isaddr(3)
NAME
cr_isaddr - validate whether physical page number was dumped
SYNOPSIS
#include <libcrash.h>
int cr_isaddr(CRASH *crash_cb, uint64_t pagenum, int *avail);
DESCRIPTION
The cr_isaddr() checks to see if the specified page number, pagenum, is present in the open crash
dump represented by crash_cb. It sets the Boolean to which avail points to indicate the presence (1) or
absence (0) of the page.
RETURN VALUE
Returns zero for success. Other possible return values are described in libcrash(5).
EXAMPLES
Assuming a process opened a crash dump, the following call to cr_isaddr(3) tests for the availability of page
256:
#include <libcrash.h>
CRASH cr_cb;
int avail;
int retval = cr_isaddr(&cr_cb, (uint64_t)256, &avail);
if (retval >= 0 && avail > 0) {
/* Read and process page 256 */
} /* Else ignore pages that are not available */
AUTHOR
cr_isaddr() was developed by HP.
SEE ALSO
cr_open(3), cr_read(3), libcrash(5).
HP-UX Release 11i: December 2000 − 1 − Section 3−−93
___
___