Jump to content United States-English
HP.com Home Products and Services Support and Drivers Solutions How to Buy
» Contact HP
More options
HP.com home
HP-UX Reference > C

cr_info(3)

HP-UX 11i Version 3: February 2007
» 

Technical documentation

» Feedback
Content starts here

 » Table of Contents

 » Index

NAME

cr_info — retrieve crash dump information

SYNOPSIS

#include <libcrash.h>

cr_info_t *cr_info(CRASH *crash_cb);

DESCRIPTION

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_hostnameName of system dumped
char*cri_modelModel string from system
char*cri_panicPanic message
char*cri_releaseRelease string from system
char*cri_dumptimeTime of the crash dump
char*cri_savetimeTime crash dump saved
uint64_tcri_chunksizeSize of uncompressed image files.
uint64_tcri_memsizePhysical size of memory (bytes)
uint64_tcri_num_errNumber of error messages
char**cri_errmsgError messages from INDEX file
uint64_tcri_num_warnNumber of warning messages
char**cri_warnmsgWarning messages from INDEX file
uint64_tcri_num_modNumber of module structures
cri_modinfo_t*cri_modinfoArray of module structures
uint32_tcri_num_nodesNumber of nodes
uint32_tcri_monarch_nodePhysical 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 null-terminated 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.

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_loadpathFile path when loaded into memory
char*mdi_savepathFile path when saved in crash directory
uint64_tmdi_sizeSize in bytes
uint64_tmdi_checksumChecksum 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

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

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

cr_info() was developed by HP.

Printable version
Privacy statement Using this site means you accept its terms Feedback to webmaster
© 1983-2007 Hewlett-Packard Development Company, L.P.