1 PCLEARSIG(3PROC)       Process Control Library Functions      PCLEARSIG(3PROC)
   2 
   3 NAME
   4      Pclearsig, Lclearsig - clear process signals
   5 
   6 LIBRARY
   7      Process Control Library (libproc, -lproc)
   8 
   9 SYNOPSIS
  10      #include <libproc.h>
  11 
  12      int
  13      Pclearsig(struct ps_prochandle *P);
  14 
  15      int
  16      Lclearsig(struct ps_lwphandle *L);
  17 
  18 DESCRIPTION
  19      During normal operation a process may receive a signal.  Signals may
  20      indicate an error, for example referencing unmapped memory, an alarm
  21      firing, requests for information, and users requesting an interruption.
  22      For more information on the generation and usage of signals, see
  23      signal.h(3HEAD).
  24 
  25      The Pclearsig() function instructs the system to clear any signal pending
  26      delivery to a thread in the process represented by the process handle P.
  27      The pending signal will never be delivered to process represented by P.
  28 
  29      The Lclearsig() function is identical to the Pclearsig() function, except
  30      rather than operating on the process and its representative thread, it
  31      instead operates on the thread handle L.
  32 
  33      The Pclearsig() function only has meaning for active processes.  It will
  34      fail on process handles corresponding to core files, zombie processes and
  35      ELF objects.
  36 
  37 RETURN VALUES
  38      Upon successful completion, the Pclearsig() function clears pending
  39      faults and returns 0.  Otherwise, -1 is returned, errno is set to
  40      indicate the error, and no faults are cleared.
  41 
  42 ERRORS
  43      For a full list of possible errors see the DIAGNOSTICS section in
  44      proc(4).
  45 
  46 INTERFACE STABILITY
  47      Uncommitted
  48 
  49 MT-LEVEL
  50      See LOCKING in libproc(3LIB).
  51 
  52 SEE ALSO
  53      signal.h(3HEAD), libproc(3LIB), proc(4)
  54 
  55 illumos                          May 16, 2020                          illumos