1 .\"
   2 .\" This file and its contents are supplied under the terms of the
   3 .\" Common Development and Distribution License ("CDDL"), version 1.0.
   4 .\" You may only use this file in accordance with the terms of version
   5 .\" 1.0 of the CDDL.
   6 .\"
   7 .\" A full copy of the text of the CDDL should have accompanied this
   8 .\" source.  A copy of the CDDL is also available via the Internet at
   9 .\" http://www.illumos.org/license/CDDL.
  10 .\"
  11 .\"
  12 .\" Copyright 2015 Joyent, Inc.
  13 .\"
  14 .Dd May 11, 2016
  15 .Dt PPRIV 3PROC
  16 .Os
  17 .Sh NAME
  18 .Nm Ppriv ,
  19 .Nm Ppriv_free
  20 .Nd get and free process privilege sets
  21 .Sh LIBRARY
  22 .Lb libproc
  23 .Sh SYNOPSIS
  24 .In libproc.h
  25 .Ft int
  26 .Fo Ppriv
  27 .Fa "struct ps_prochandle *P"
  28 .Fa "prpriv_t **pprv"
  29 .Fc
  30 .Ft void
  31 .Fo Ppriv_free
  32 .Fa "struct ps_prochandle *P"
  33 .Fa "prpriv_t *prv"
  34 .Fc
  35 .Sh DESCRIPTION
  36 The
  37 .Fn Ppriv
  38 function obtains the privilege set of the process handle
  39 .Fa P .
  40 The privilege set, if it exists, will be dynamically allocated and a
  41 pointer to it will be placed in
  42 .Fa pprv .
  43 It must be released with a call to
  44 .Fn Ppriv_free .
  45 The definition of the
  46 .Sy prpriv_t
  47 structure is documented in
  48 .Xr proc 4 .
  49 .Pp
  50 The
  51 .Fn Ppriv_free
  52 function releases the storage in
  53 .Fa prv
  54 that was allocated as a result of calling
  55 .Fn Ppriv .
  56 .Sh RETURN VALUES
  57 Upon successful completion, the
  58 .Fn Ppriv
  59 function returns
  60 .Sy 0
  61 and
  62 .Fa pprv
  63 is updated with a pointer to the allocated privilege set.
  64 Otherwise,
  65 .Sy -1
  66 is returned and
  67 .Fa pprv
  68 is not updated.
  69 .Sh INTERFACE STABILITY
  70 .Sy Uncommitted
  71 .Sh MT-LEVEL
  72 See
  73 .Sy LOCKING
  74 in
  75 .Xr libproc 3LIB .
  76 .Sh SEE ALSO
  77 .Xr libproc 3LIB ,
  78 .Xr proc 4 ,
  79 .Xr privileges 5