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 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.

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

INTERFACE STABILITY

Uncommitted

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

SEE ALSO

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

illumos May 16, 2020 illumos