Pclearsig,
Lclearsig —
clear process signals
Process Control Library (libproc, -lproc)
#include
<libproc.h>
int
Pclearsig(
struct
ps_prochandle *P);
int
Lclearsig(
struct
ps_lwphandle *L);
During normal operation a process may receive a signal. Signals may indicate an
error, for example referencing unmapped memory, an alarm firing, requests for
information, and users requesting an interruption. For more information on the
generation and usage of signals, see
signal.h(3HEAD).
The
Pclearsig() function instructs the system
to clear any signal pending delivery to a thread in the process represented by
the process handle
P. The pending signal will
never be delivered to process represented by
P.
The
Lclearsig() function is identical to the
Pclearsig() function, except rather than
operating on the process and its representive thread, it instead operates on
the thread handle
L.
The
Pclearsig() function only has meaning for
active processes. It will fail on process handles corresponding to core files,
zombie processes and ELF objects.
Upon successful completion, the
Pclearsig()
function clears pending faults and returns
0.
Otherwise,
-1 is returned,
errno is set to indicate the error, and no faults
are cleared.
For a full list of possible errors see the
DIAGNOSTICS section in
proc(4).
Uncommitted
See
LOCKING in
libproc(3LIB).
signal.h(3HEAD),
libproc(3LIB),
proc(4)