8158 Want named threads API
9857 proc manpages should have LIBRARY section

          --- old/usr/src/man/man3proc/Pclearsig.3proc
          +++ new/usr/src/man/man3proc/Pclearsig.3proc

   1    1  .\"
   2    2  .\" This file and its contents are supplied under the terms of the
   3    3  .\" Common Development and Distribution License ("CDDL"), version 1.0.
   4    4  .\" You may only use this file in accordance with the terms of version
   5    5  .\" 1.0 of the CDDL.
   6    6  .\"
   7    7  .\" A full copy of the text of the CDDL should have accompanied this
   8    8  .\" source.  A copy of the CDDL is also available via the Internet at
   9    9  .\" http://www.illumos.org/license/CDDL.
  10   10  .\"

  11   11  .\"
  12   12  .\" Copyright 2015 Joyent, Inc.
  13   13  .\"
  14   14  .Dd May 11, 2016
  15   15  .Dt PCLEARSIG 3PROC
  16   16  .Os
  17   17  .Sh NAME
  18   18  .Nm Pclearsig ,
  19   19  .Nm Lclearsig
  20   20  .Nd clear process signals
  21      -.Sh SYNOPSIS
       21 +.Sh LIBRARY
  22   22  .Lb libproc
       23 +.Sh SYNOPSIS
  23   24  .In libproc.h
  24   25  .Ft int
  25   26  .Fo Pclearsig
  26   27  .Fa "struct ps_prochandle *P"
  27   28  .Fc
  28   29  .Ft int
  29   30  .Fo Lclearsig
  30   31  .Fa "struct ps_lwphandle *L"
  31   32  .Fc
  32   33  .Sh DESCRIPTION

  33   34  During normal operation a process may receive a signal.
  34   35  Signals may indicate an error, for example referencing unmapped memory, an alarm
  35   36  firing, requests for information, and users requesting an interruption.
  36   37  For more information on the generation and usage of signals, see
  37   38  .Xr signal.h 3HEAD .
  38   39  .Pp
  39   40  The
  40   41  .Fn Pclearsig
  41   42  function instructs the system to clear any signal pending delivery to
  42   43  a thread in the process represented by the process handle
  43   44  .Fa P .
  44   45  The pending signal will never be delivered to process represented by
  45   46  .Fa P .
  46   47  .Pp
  47   48  The
  48   49  .Fn Lclearsig
  49   50  function is identical to the
  50   51  .Fn Pclearsig
  51   52  function, except rather than operating on the process and its
  52   53  representive thread, it instead operates on the thread handle
  53   54  .Fa L .
  54   55  .Pp
  55   56  The
  56   57  .Fn Pclearsig
  57   58  function only has meaning for active processes.
  58   59  It will fail on process handles corresponding to core files, zombie processes
  59   60  and ELF objects.
  60   61  .Sh RETURN VALUES
  61   62  Upon successful completion, the
  62   63  .Fn Pclearsig
  63   64  function clears pending faults and
  64   65  returns
  65   66  .Sy 0 .
  66   67  Otherwise,
  67   68  .Sy -1
  68   69  is returned,
  69   70  .Sy errno
  70   71  is set to indicate the error,
  71   72  and no faults are cleared.
  72   73  .Sh ERRORS
  73   74  For a full list of possible errors see the
  74   75  .Sy DIAGNOSTICS
  75   76  section in
  76   77  .Xr proc 4 .
  77   78  .Sh INTERFACE STABILITY
  78   79  .Sy Uncommitted
  79   80  .Sh MT-LEVEL
  80   81  See
  81   82  .Sy LOCKING
  82   83  in
  83   84  .Xr libproc 3LIB .
  84   85  .Sh SEE ALSO
  85   86  .Xr signal.h 3HEAD ,
  86   87  .Xr libproc 3LIB ,
  87   88  .Xr proc 4

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX