cr_isaddr.3 (2010 09)

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 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1