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

          --- old/usr/src/man/man3proc/Ppriv.3proc
          +++ new/usr/src/man/man3proc/Ppriv.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 PPRIV 3PROC
  16   16  .Os
  17   17  .Sh NAME
  18   18  .Nm Ppriv ,
  19   19  .Nm Ppriv_free
  20   20  .Nd get and free process privilege sets
  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 Ppriv
  26   27  .Fa "struct ps_prochandle *P"
  27   28  .Fa "prpriv_t **pprv"
  28   29  .Fc
  29   30  .Ft void
  30   31  .Fo Ppriv_free
  31   32  .Fa "struct ps_prochandle *P"
  32   33  .Fa "prpriv_t *prv"

  33   34  .Fc
  34   35  .Sh DESCRIPTION
  35   36  The
  36   37  .Fn Ppriv
  37   38  function obtains the privilege set of the process handle
  38   39  .Fa P .
  39   40  The privilege set, if it exists, will be dynamically allocated and a
  40   41  pointer to it will be placed in
  41   42  .Fa pprv .
  42   43  It must be released with a call to
  43   44  .Fn Ppriv_free .
  44   45  The definition of the
  45   46  .Sy prpriv_t
  46   47  structure is documented in
  47   48  .Xr proc 4 .
  48   49  .Pp
  49   50  The
  50   51  .Fn Ppriv_free
  51   52  function releases the storage in
  52   53  .Fa prv
  53   54  that was allocated as a result of calling
  54   55  .Fn Ppriv .
  55   56  .Sh RETURN VALUES
  56   57  Upon successful completion, the
  57   58  .Fn Ppriv
  58   59  function returns
  59   60  .Sy 0
  60   61  and
  61   62  .Fa pprv
  62   63  is updated with a pointer to the allocated privilege set.
  63   64  Otherwise,
  64   65  .Sy -1
  65   66  is returned and
  66   67  .Fa pprv
  67   68  is not updated.
  68   69  .Sh INTERFACE STABILITY
  69   70  .Sy Uncommitted
  70   71  .Sh MT-LEVEL
  71   72  See
  72   73  .Sy LOCKING
  73   74  in
  74   75  .Xr libproc 3LIB .
  75   76  .Sh SEE ALSO
  76   77  .Xr libproc 3LIB ,
  77   78  .Xr proc 4 ,
  78   79  .Xr privileges 5

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX