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

  man pages->OpenBSD man pages -> kvm_dump (3)              



NAME    [Toc]    [Back]

     kvm_dump_mkheader,  kvm_dump_wrtheader,   kvm_dump_inval   -
crash dump support

SYNOPSIS    [Toc]    [Back]

     #include <kvm.h>

     kvm_dump_mkheader(kvm_t *kd, off_t dump_off);

     kvm_dump_wrtheader(kvm_t *kd, FILE *fp, int dumpsize);

     kvm_dump_inval(kvm_t *kd);

DESCRIPTION    [Toc]    [Back]

     First  note  that the functions described here were designed
to be used by

     The function kvm_dump_mkheader() checks if the physical memory file associated
  with kd contains a valid crash dump header as generated by a dumping
   kernel.    When   a    valid    header    is    found,
kvm_dump_mkheader() initializes
  the  internal  kvm  data structures as if a crash dump
generated by the
     savecore(8) program was opened.  This  has  the  intentional
side effect of
     enabling the address translation machinery.

     A  call  to kvm_dump_mkheader() will most likely be followed
by a call to
     kvm_dump_wrtheader().  This function takes care of  generating the generic
     header,  the  CORE_CPU section and the section header of the
CORE_DATA section.
  The data is written to the file  pointed  at  by  fp.
The dumpsize
     argument  is  only  used to properly set the segment size of
     section.  Note that this function assumes that fp  is  positioned at file
     location  0.   This function will not seek and therefore allows fp to be a
     file pointer obtained by zopen().

     The kvm_dump_inval() function clears the magic number in the
     memory  file  associated  with kd.  The address translations
must be enabled
     for this to work (thus assuming that kvm_dump_mkheader() was
called earlier
 in the sequence).

RETURN VALUES    [Toc]    [Back]

     All  functions  return  0 on success, -1 on failure.  In the
case of failure,
 kvm_geterr(3) can be used to retrieve the cause of  the

SEE ALSO    [Toc]    [Back]


HISTORY    [Toc]    [Back]

     These functions first appeared in NetBSD 1.1a.

OpenBSD      3.6                          March      17,     1996
[ Back ]
 Similar pages
Name OS Title
kvm_dump_inval NetBSD crash-dump support functions
kvm_dump_wrtheader NetBSD crash-dump support functions
kvm_dump_mkheader NetBSD crash-dump support functions
kvm_dump NetBSD crash-dump support functions
cr_read HP-UX read from crash dump
cr_info HP-UX retrieve crash dump information
cr_uncompress HP-UX uncompress a file in a crash dump
cr_verify HP-UX verify integrity of crash dump
cr_open HP-UX open crash dump for reading
cr_close HP-UX close a crash dump descriptor
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service