| PCTFLD(3PROC) | Process Control Library Functions | PCTFLD(3PROC) |
Pctlfd — obtain
the process control file descriptor
Process Control Library (libproc, -lproc)
#include
<libproc.h>
int
Pctlfd(struct ps_prochandle
*P);
The
Pctlfd()
function returns a file descriptor to the underlying /proc file system
ctl file for
the process identified by the handle P. This may be
used for injecting control operations manually; however, many interfaces for
using it are provided by
libproc(3LIB) itself.
Only live processes have a control file descriptor. Process handles that correspond to files and cores, created through Pgrab_file(3PROC) and Pgrab_core(3PROC), do not have a corresponding file descriptor.
The file descriptor is invalidated when the process handle is released through Prelease(3PROC) or if control is lost and the handle is reopened.
Upon successful completion, the Pctlfd()
function returns a valid file descriptor. Otherwise, if none exists, then
-1 is
returned.
See LOCKING in libproc(3LIB).
libproc(3LIB), Pcreate(3PROC), Pgrab(3PROC), Pgrab_core(3PROC), Pgrab_file(3PROC), Prelease(3PROC), Preopen(3PROC), proc(5)
| May 11, 2016 | OmniOS |