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

          --- old/usr/src/man/man3proc/Psetsignal.3proc
          +++ new/usr/src/man/man3proc/Psetsignal.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 PSETSIGNAL 3PROC
  16   16  .Os
  17   17  .Sh NAME
  18   18  .Nm Psetsignal
  19   19  .Nd set signal tracing flags
  20      -.Sh SYNOPSIS
       20 +.Sh LIBRARY
  21   21  .Lb libproc
       22 +.Sh SYNOPSIS
  22   23  .In libproc.h
  23   24  .Ft void
  24   25  .Fo Psetsignal
  25   26  .Fa "struct ps_prochandle *P"
  26   27  .Fa "const sigset_t *set"
  27   28  .Fc
  28   29  .Sh DESCRIPTION
  29   30  The
  30   31  .Fn Psetsignal
  31   32  function sets the signal tracing flags for the process handle

  32   33  .Fa P
  33   34  to
  34   35  .Fa set .
  35   36  The call to
  36   37  .Fn Psetsignal
  37   38  replaces any existing signal tracing flags entirely with
  38   39  .Fa set .
  39   40  The signal tracing flags determine which signals, when received by a
  40   41  thread in the process, will cause that thread to stop.
  41   42  For more information on the behavior of the signal tracing flags, including
  42   43  which signals may be traced this way, see the
  43   44  .Sy PCSTRACE
  44   45  section in
  45   46  .Xr proc 4 .
  46   47  .Pp
  47   48  The
  48   49  .Fa set
  49   50  argument may be manipulated with the standard signal set manipulation
  50   51  functions such as
  51   52  .Xr sigaddset 3C ,
  52   53  .Xr sigdelset 3C ,
  53   54  and others which may all be found in
  54   55  .Xr sigsetops 3C .
  55   56  .Pp
  56   57  Note, only active processes may have their signal tracing flags updated.
  57   58  Process handles that refer to core files, zombie processes, and files do
  58   59  not have fault tracing flags and this function is a no-op on them.
  59   60  .Sh INTERFACE STABILITY
  60   61  .Sy Uncommitted
  61   62  .Sh MT-LEVEL
  62   63  See
  63   64  .Sy LOCKING
  64   65  in
  65   66  .Xr libproc 3LIB .
  66   67  .Sh SEE ALSO
  67   68  .Xr sigsetops 3C ,
  68   69  .Xr signal.h 3HEAD ,
  69   70  .Xr libproc 3LIB ,
  70   71  .Xr Psignal 3PROC ,
  71   72  .Xr proc 4

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX