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

          --- old/usr/src/man/man3proc/Psetpriv.3proc
          +++ new/usr/src/man/man3proc/Psetpriv.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 PSETPRIV 3PROC
  16   16  .Os
  17   17  .Sh NAME
  18   18  .Nm Psetpriv
  19   19  .Nd set process privileges
  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 Psetpriv
  25   26  .Fa "struct ps_prochandle *P"
  26   27  .Fa "prpriv_t *pprv"
  27   28  .Fc
  28   29  .Sh DESCRIPTION
  29   30  The
  30   31  .Fn Psetpriv
  31   32  function updates the privileges of the process handle

  32   33  .Fa P
  33   34  to the set described by
  34   35  .Fa pprv .
  35   36  The updated privilege set has restrictions on what it may change for a
  36   37  process which are documented in the
  37   38  .Sy PCSPRIV
  38   39  section of
  39   40  .Xr proc 4 .
  40   41  In addition, the definition of the
  41   42  .Sy prpriv_t
  42   43  structure is described in
  43   44  .Xr proc 4 .
  44   45  .Pp
  45   46  The current privilege set for the process may be obtained through a call
  46   47  to
  47   48  .Xr Ppriv 3PROC .
  48   49  .Pp
  49   50  Note, the privilege set may only be updated for active processes.
  50   51  Process handles which correspond to core files, zombie processes, and
  51   52  files, may not have their privilege sets updated.
  52   53  .Sh RETURN VALUES
  53   54  Upon successful completion, the
  54   55  .Fn Psetpriv
  55   56  function returns
  56   57  .Sy 0
  57   58  and updates the privilege sets of the process.
  58   59  Otherwise,
  59   60  .Sy -1
  60   61  is returned and
  61   62  .Sy errno
  62   63  is set to indicate the error.
  63   64  .Sh ERRORS
  64   65  For a full list of possible errors see the
  65   66  .Sy DIAGNOSTICS
  66   67  section in
  67   68  .Xr proc 4 .
  68   69  .Pp
  69   70  The
  70   71  .Fn Psetpriv
  71   72  function will fail if:
  72   73  .Bl -tag -width Er
  73   74  .It Er EBADF
  74   75  .Fa P
  75   76  doesn't refer to an active process, but a core file, zombie, or a file.
  76   77  .El
  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 libproc 3LIB ,
  86   87  .Xr Ppriv 3PROC ,
  87   88  .Xr proc 4 ,
  88   89  .Xr privileges 5

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX