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 2016, Richard Lowe.
  13 .\"
  14 .Dd May 14, 2016
  15 .Dt PSECFLAGS 3PROC
  16 .Os
  17 .Sh NAME
  18 .Nm Psecflags ,
  19 .Nm Psecflags_free
  20 .Nd get and free process security flags
  21 .Sh SYNOPSIS
  22 .Lb libproc
  23 .In libproc.h
  24 .Ft int
  25 .Fo Ppriv
  26 .Fa "struct ps_prochandle *P"
  27 .Fa "prsecflags_t **psf"
  28 .Fc
  29 .Ft void
  30 .Fo Ppriv_free
  31 .Fa "struct ps_prochandle *P"
  32 .Fa "prsecflags_t *psf"
  33 .Fc
  34 .Sh DESCRIPTION
  35 The
  36 .Fn Psecflags
  37 function obtains the security flags of the process handle
  38 .Fa P .
  39 The security flags structure will be dynamically allocated and a pointer to it
  40 will be placed in
  41 .Fa psf .
  42 It must be released with a call to
  43 .Fn Psecflags_free .
  44 The definition of the
  45 .Sy prsecflags_t
  46 structure is documented in
  47 .Xr proc 4 .
  48 .Pp
  49 The
  50 .Fn Psecflags_free
  51 function releases the storage in
  52 .Fa psf
  53 that was allocated as a result of calling
  54 .Fn Psecflags .
  55 .Sh RETURN VALUES
  56 Upon successful completion, the
  57 .Fn Psecflags
  58 function returns
  59 .Sy 0
  60 and
  61 .Fa psf
  62 is updated with a pointer to the allocated privilege set. Otherwise,
  63 .Sy -1
  64 is returned and
  65 .Fa psf
  66 is not updated.
  67 .Sh INTERFACE STABILITY
  68 .Sy Uncommitted
  69 .Sh MT-LEVEL
  70 See
  71 .Sy LOCKING
  72 in
  73 .Xr libproc 3LIB .
  74 .Sh SEE ALSO
  75 .Xr libproc 3LIB ,
  76 .Xr proc 4 ,
  77 .Xr security-flags 5