PRELEASE(3PROC) Process Control Library Functions PRELEASE(3PROC)
NAME
Prelease,
Pfree - release a process control handle
LIBRARY
Process Control Library (libproc, -lproc)
SYNOPSIS
#include <libproc.h> void Prelease(
struct ps_prochandle *P,
int flags);
void Pfree(
struct ps_prochandle *P);
DESCRIPTION
The
Prelease() function is used to release all of the resources associated
with a
libproc handle. It is suitable for handles to core files, created
processes, and grabbed processes from the
Pgrab_core(3PROC),
Pcreate(3PROC),
Pgrab(3PROC), and
Pgrab_file(3PROC) functions.
After calling the
Prelease() function, all data that was returned via the
handle will no longer be valid. For example, the data from calls to
Pctlfd(3PROC),
Pgetauxvec(3PROC),
Pstatus(3PROC), and others.
The behavior of the released process is controlled by the
flags argument.
By default, if no flags are passed, then the process represented by
P will
be set running if it was created by
Pcreate(3PROC) or if it was not
originally stopped or set to stop in /proc. The following values may be
passed in to the
flags argument. Multiple flags should be be combined with
a bitwise-inclusive-OR.
PRELEASE_CLEAR When releasing the process, clear all tracing
flags that are set on the process.
PRELEASE_RETAIN When releasing the process, retain all tracing
flags that are currently active on the process.
PRELEASE_HANG Leave the process stopped. It will not resume
execution unless it is explicitly enabled with
prun(1) or another process explicitly enables it.
PRELEASE_KILL Release the process and terminate it with SIGKILL.
This option takes precedence over all other values
that may be passed in to
flags.
The
Pfree() function is similar to the
Prelease() function in that it frees
the resources associated with the process handle
P; however, unlike the
Prelease() function, it does not handle any logic to change or set the
grabbed processes state. In general, prefer
Prelease() to
Pfree().
INTERFACE STABILITY
UncommittedMT-LEVEL See
LOCKING in
libproc(3LIB).
SEE ALSO
prun(1),
libproc(3LIB),
Pcreate(3PROC),
Pgrab(3PROC),
Pgrab_core(3PROC),
proc(5)illumos May 11, 2016 illumos