| PCLEARSIG(3PROC) | Process Control Library Functions | PCLEARSIG(3PROC) |
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 representative 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(5).
See LOCKING in libproc(3LIB).
| May 16, 2020 | OmniOS |