|PGRAB_FILE(3PROC)||Process Control Library Functions||PGRAB_FILE(3PROC)|
Pgrab_file — grab
and inspect an ELF object
Process Control Library (libproc, -lproc)
Pgrab_file(const char *fname,
function creates a handle to the ELF object contained in file
fname. This handle is considered an
handle, it allows one to inspect aspects of the ELF contents present in the
handle, for example obtaining CTF information and looking up symbols.
There is no running state associated with this handle nor can there be. If one intends to control a running process or create a process, see Pgrab(3PROC) and Pcreate(3PROC) respectively. To inspect a core file use Pgrab_core(3PROC).
When finished with the returned handle, Prelease(3PROC) must be called to clean up resources associated with it.
Upon successful completion, the
Pgrab_file() function returns a control handle to
the process. Otherwise,
NULL is returned and
perr is filled in with an error code.
|May 11, 2016||OmniOS|