Psignal —
set signal tracing action
Process Control Library (libproc, -lproc)
#include
<libproc.h>
int
Psignal(
struct
ps_prochandle *P,
int which,
int stop);
The
Psignal() function sets the signal
tracing flag for the process handle
P. If
stop is
non-zero
it causes the process handle to stop threads that encounter the signal
which. If
stop is
zero,
then it disables tracing for the signal
which.
The signal constants, representing valid values for
which, can be found in
signal.h(3HEAD.) The signal
SIGKILL may not be stopped.
Note, only active processes may have their signal tracing flags updated. Process
handles that refer to core files, zombie processes, and files do not have
signal tracing flags. Calling this function on them is an error.
Upon successful completion, the
Psignal()
function returns the previous disposition of the signal
which. It returns
1 if it was set and
0 if not. Otherwise,
-1 is returned and
errno is set to indicate the error.
The
Psignal() function will fail if:
-
-
EINVAL- which is
SIGKILL and
stop is non-zero .
which is not a valid signal.
-
-
ENOENT- P does not correspond to an active
process.
Uncommitted
See
LOCKING in
libproc(3LIB).
signal.h(3HEAD),
libproc(3LIB),
Psetsignal(3PROC),
proc(4)