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(4).

Uncommitted

See LOCKING in libproc(3LIB).

signal.h(3HEAD), libproc(3LIB), proc(4)
May 16, 2020 illumos