PREOPEN(3PROC) Process Control Library Functions PREOPEN(3PROC)
NAME
Preopen - reopen a process
LIBRARY
Process Control Library (libproc, -lproc)
SYNOPSIS
#include <libproc.h> int Preopen(
struct ps_prochandle *P);
DESCRIPTION
The
Preopen() function is used to regain control of the process represented
by the handle
P. A loss of control is indicated by the
Pstatus(3PROC) function returning the value PS_LOST. This may occur when the controlled
process performs an
exec(2) of a setuid or setgid binary or one where the
controlling process cannot read the object file. For more information on
this, see the
PROGRAMMING NOTES section of
proc(5).
If successful, the controlling process will obtain control of the process
specified by
P. If it fails, the controlling process should release the
handle with
Prelease(3PROC). Note there are occasions where due to
permissions it may not be possible to obtain control again.
RETURN VALUES
Upon successful completion, the
Preopen() function returns
0. Otherwise,
-1 is returned.
INTERFACE STABILITY
UncommittedMT-LEVEL See
LOCKING in
libproc(3LIB).
SEE ALSO
exec(2),
libproc(3LIB),
Prelease(3PROC),
Pstatus(3PROC),
proc(5)illumos May 11, 2016 illumos