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