PCLEARSIG(3PROC) Process Control Library Functions PCLEARSIG(3PROC)

NAME


Pclearsig, Lclearsig - clear process signals

LIBRARY


Process Control Library (libproc, -lproc)

SYNOPSIS


#include <libproc.h>

int
Pclearsig(struct ps_prochandle *P);

int
Lclearsig(struct ps_lwphandle *L);

DESCRIPTION


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.

RETURN VALUES


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.

ERRORS


For a full list of possible errors see the DIAGNOSTICS section in proc(4).

INTERFACE STABILITY


Uncommitted

MT-LEVEL
See LOCKING in libproc(3LIB).

SEE ALSO


signal.h(3HEAD), libproc(3LIB), proc(4)

illumos May 11, 2016 illumos