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_open(3)

HP-UX 11i Version 3: February 2007
» 

Technical documentation

» Feedback
Content starts here

 » Table of Contents

 » Index

NAME

cr_open() — open crash dump for reading

SYNOPSIS

#include <libcrash.h>

int cr_open(const char *path, CRASH **crash_cb, int flags);

DESCRIPTION

The cr_open() library call opens a crash dump and passes back a crash dump descriptor.

The path argument points to a path name naming a crash dump directory or file, and must not exceed PATH_MAX bytes in length.

The CRASH * to which crash_cb points is set to a crash dump descriptor, which can then be passed to the other cr_*() functions to access the crash dump.

flags is a bitmask of zero or more of the following flag values, which affect the operation of future calls to libcrash routines for this crash dump, except for cr_verify(3), which has its own flags parameter.

CR_NOCHECKSUM

The library will not attempt to verify checksums of files in the crash dump if this flag is set.

CR_DELAYMSGS

The library will write messages to stderr during time-consuming operations (decompressions and checksums) if this flag is set.

RETURN VALUE

Returns zero for success. Other possible return values are described in libcrash(5).

EXAMPLES

The following call to cr_open() opens crash dump contained in the directory /var/adm/crash/core.0 and returns the crash dump descriptor crash_cb. For an example of reading the crash dump /var/adm/crash/core.0, see the cr_read(3) manual entry.

#include <libcrash.h> CRASH *crash_cb; int ret; ret = cr_open ("/var/adm/crash/core.0", &crash_cb, CR_DELAYMSGS);

AUTHOR

cr_open() 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.