*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->HP-UX 11i man pages -> cr_info (3)              
Title
Content
Arch
Section
 

Contents


 cr_info(3)                                                       cr_info(3)




 NAME    [Toc]    [Back]
      cr_info - retrieve crash dump information

 SYNOPSIS    [Toc]    [Back]
      #include <libcrash.h>

      cr_info_t *cr_info(CRASH *crash_cb);

 DESCRIPTION    [Toc]    [Back]
      The cr_info() function returns a pointer to a cr_info_t structure with
      information about an open crash dump.

    cr_info_t
      The cr_info_t structure contains the following fields.  Note that
      there is no necessary correlation between the placement in this list
      and the order in the structure, and the structure may contain other,
      reserved fields.  In the future, this structure may change in size and
      should not be copied to avoid compatibility problems with various
      releases.

      char             *cri_hostname       Name of system dumped
      char             *cri_model          Model string from system
      char             *cri_panic          Panic message
      char             *cri_release        Release string from system
      char             *cri_dumptime       Time of the crash dump
      char             *cri_savetime       Time crash dump saved
      uint64_t          cri_chunksize      Size of uncompressed image files.
      uint64_t          cri_memsize        Physical size of memory (bytes)
      uint64_t          cri_num_err        Number of error messages
      char            **cri_errmsg         Error messages from INDEX file
      uint64_t          cri_num_warn       Number of warning messages
      char            **cri_warnmsg        Warning messages from INDEX file
      uint64_t          cri_num_mod        Number of module structures
      cri_modinfo_t    *cri_modinfo        Array of module structures
      uint32_t          cri_num_nodes      Number of nodes
      uint32_t          cri_monarch_node   Physical monarch node number

      The fields cri_hostname, cri_model, cri_panic, cri_release,
      cri_dumptime, and cri_savetime are all null-terminated strings;
      respectively, representing the name and model of the system that
      dumped, the panic message, the release version string of the kernel,
      and the times that the system dumped and the dump was saved.  The
      amount, in bytes, of physical memory on the system is in cri_memsize.
      The target size, in bytes, of individual uncompressed image files is
      in cri_chunksize.  cri_errmsg and cri_warnmsg are arrays of nullterminated
 strings with the list of saved messages.  cri_num_err and
      cri_num_warn are the number of strings in each list.  cri_modinfo is
      an array of cri_modinfo_t structures defining the loaded kernel
      modules; there are cri_num_mod elements in the array.  cri_num_nodes
      is the number of nodes contained on the machine and cri_monarch_node
      is the physical node number of the monarch.



 Hewlett-Packard Company            - 1 -   HP-UX 11i Version 2: August 2003






 cr_info(3)                                                       cr_info(3)




    cri_modinfo_t
      The cri_modinfo_t structure contains information specific to kernel
      modules loaded into memory at the time of the system crash.  The
      specific fields are:

        char       *mdi_loadpath   File path when loaded into memory
        char       *mdi_savepath   File path when saved in crash directory
        uint64_t    mdi_size       Size in bytes
        uint64_t    mdi_checksum   Checksum of the file from cksum(1)

      Again, the order of these fields within the structure is not
      specified, and other reserved fields may be present in the structure.

      The caller must not modify any information in any of the structures
      returned by cr_info().

 RETURN VALUE    [Toc]    [Back]
      cr_info() returns a pointer to the cr_info_t structure described
      above.  If crash_cb is not a valid descriptor of a crash dump opened
      with cr_open(), the return value is undefined.

 EXAMPLES    [Toc]    [Back]
      Assuming a process opened a crash dump, the following call to
      cr_info(3) retrieves the information about the open crash dump.

           #include <libcrash.h>

           CRASH *crshdes;
           cr_info_t *cri;

           cri = cr_info(crshdes);

 AUTHOR    [Toc]    [Back]
      cr_info() was developed by HP.

 SEE ALSO    [Toc]    [Back]
      cr_open(3), libcrash(5).


 Hewlett-Packard Company            - 2 -   HP-UX 11i Version 2: August 2003
[ Back ]
      
      
 Similar pages
Name OS Title
cr_read HP-UX read from crash dump
kvm_dump_mkheader NetBSD crash-dump support functions
kvm_dump NetBSD crash-dump support functions
libcrash HP-UX crash dump access library
cr_uncompress HP-UX uncompress a file in a crash dump
cr_verify HP-UX verify integrity of crash dump
kvm_dump_inval NetBSD crash-dump support functions
cr_open HP-UX open crash dump for reading
cr_close HP-UX close a crash dump descriptor
crashutil HP-UX manipulate crash dump data
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service