1 PGRAB_FILE(3PROC)      Process Control Library Functions     PGRAB_FILE(3PROC)
   2 
   3 NAME
   4      Pgrab_file - grab and inspect an ELF object
   5 
   6 SYNOPSIS
   7      Process Control Library (libproc, -lproc)


   8      #include <libproc.h>
   9 
  10      struct ps_prochandle
  11      Pgrab_file(const char *fname, int *perr);
  12 
  13 DESCRIPTION
  14      The Pgrab_file() function creates a handle to the ELF object contained in
  15      file fname.  This handle is considered an idle handle, it allows one to
  16      inspect aspects of the ELF contents present in the handle, for example
  17      obtaining CTF information and looking up symbols.
  18 
  19      There is no running state associated with this handle nor can there be.
  20      If one intends to control a running process or create a process, see
  21      Pgrab(3PROC) and Pcreate(3PROC) respectively.  To inspect a core file use
  22      Pgrab_core(3PROC).
  23 
  24      The perr argument must be a non-NULL pointer which will store a more
  25      detailed error in the event that Pgrab_file() fails.  A human-readable
  26      form of the error can be obtained with Pgrab_error(3PROC).
  27 

   1 PGRAB_FILE(3PROC)      Process Control Library Functions     PGRAB_FILE(3PROC)
   2 
   3 NAME
   4      Pgrab_file - grab and inspect an ELF object
   5 
   6 LIBRARY
   7      Process Control Library (libproc, -lproc)
   8 
   9 SYNOPSIS
  10      #include <libproc.h>
  11 
  12      struct ps_prochandle
  13      Pgrab_file(const char *fname, int *perr);
  14 
  15 DESCRIPTION
  16      The Pgrab_file() function creates a handle to the ELF object contained in
  17      file fname.  This handle is considered an idle handle, it allows one to
  18      inspect aspects of the ELF contents present in the handle, for example
  19      obtaining CTF information and looking up symbols.
  20 
  21      There is no running state associated with this handle nor can there be.
  22      If one intends to control a running process or create a process, see
  23      Pgrab(3PROC) and Pcreate(3PROC) respectively.  To inspect a core file use
  24      Pgrab_core(3PROC).
  25 
  26      The perr argument must be a non-NULL pointer which will store a more
  27      detailed error in the event that Pgrab_file() fails.  A human-readable
  28      form of the error can be obtained with Pgrab_error(3PROC).
  29