cr_isaddr(3)                                                   cr_isaddr(3)
 NAME    [Toc]    [Back]
      cr_isaddr - validate whether physical page number was dumped
 SYNOPSIS    [Toc]    [Back]
      #include <libcrash.h>
      int cr_isaddr(CRASH *crash_cb, uint64_t pagenum, int *avail);
 DESCRIPTION    [Toc]    [Back]
      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    [Toc]    [Back]
      Returns zero for success.  Other possible return values are described
      in libcrash(5).
 EXAMPLES    [Toc]    [Back]
      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    [Toc]    [Back]
      cr_isaddr() was developed by HP.
 SEE ALSO    [Toc]    [Back]
      cr_open(3), cr_read(3), libcrash(5).
 Hewlett-Packard Company            - 1 -   HP-UX 11i Version 2: August 2003 [ Back ] |