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

          --- old/usr/src/man/man3proc/Psignal.3proc
          +++ new/usr/src/man/man3proc/Psignal.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 PSIGNAL 3PROC
  16   16  .Os
  17   17  .Sh NAME
  18   18  .Nm Psignal
  19   19  .Nd set signal tracing action
  20      -.Sh SYNOPSIS
       20 +.Sh LIBRARY
  21   21  .Lb libproc
       22 +.Sh SYNOPSIS
  22   23  .In libproc.h
  23   24  .Ft int
  24   25  .Fo Psignal
  25   26  .Fa "struct ps_prochandle *P"
  26   27  .Fa "int which"
  27   28  .Fa "int stop"
  28   29  .Fc
  29   30  .Sh DESCRIPTION
  30   31  The
  31   32  .Fn Psignal

  32   33  function sets the signal tracing flag for the process handle
  33   34  .Fa P .
  34   35  If
  35   36  .Fa stop
  36   37  is
  37   38  .Sy non-zero
  38   39  it causes the process handle to stop threads that encounter the signal
  39   40  .Fa which .
  40   41  If
  41   42  .Fa stop
  42   43  is
  43   44  .Sy zero ,
  44   45  then it disables tracing for the signal
  45   46  .Fa which .
  46   47  .Pp
  47   48  The signal constants, representing valid values for
  48   49  .Fa which ,
  49   50  can be found in
  50   51  .Xr signal.h 3HEAD.
  51   52  The signal
  52   53  .Dv SIGKILL
  53   54  may not be stopped.
  54   55  .Pp
  55   56  Note, only active processes may have their signal tracing flags updated.
  56   57  Process handles that refer to core files, zombie processes, and files do
  57   58  not have signal tracing flags.
  58   59  Calling this function on them is an error.
  59   60  .Sh RETURN VALUES
  60   61  Upon successful completion, the
  61   62  .Fn Psignal
  62   63  function returns the previous disposition of the signal
  63   64  .Fa which .
  64   65  It returns
  65   66  .Sy 1
  66   67  if it was set and
  67   68  .Sy 0
  68   69  if not.
  69   70  Otherwise,
  70   71  .Sy -1
  71   72  is returned and
  72   73  .Sy errno
  73   74  is set to indicate the error.
  74   75  .Sh ERRORS
  75   76  The
  76   77  .Fn Psignal
  77   78  function will fail if:
  78   79  .Bl -tag -width Er
  79   80  .It Er EINVAL
  80   81  .Fa which
  81   82  is
  82   83  .Dv SIGKILL
  83   84  and
  84   85  .Fa stop
  85   86  is non-zero .
  86   87  .Pp
  87   88  .Fa which
  88   89  is not a valid signal.
  89   90  .It Er ENOENT
  90   91  .Fa P
  91   92  does not correspond to an active process.
  92   93  .El
  93   94  .Sh INTERFACE STABILITY
  94   95  .Sy Uncommitted
  95   96  .Sh MT-LEVEL
  96   97  See
  97   98  .Sy LOCKING
  98   99  in
  99  100  .Xr libproc 3LIB .
 100  101  .Sh SEE ALSO
 101  102  .Xr signal.h 3HEAD ,
 102  103  .Xr libproc 3LIB ,
 103  104  .Xr Psetsignal 3PROC ,
 104  105  .Xr proc 4

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX