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 June 06, 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 LIBRARY
  22 .Lb libproc
  23 .Sh SYNOPSIS
  24 .In libproc.h
  25 .Ft int
  26 .Fo Psecflags
  27 .Fa "struct ps_prochandle *P"
  28 .Fa "prsecflags_t **psf"
  29 .Fc
  30 .Ft void
  31 .Fo Psecflags_free
  32 .Fa "struct ps_prochandle *P"
  33 .Fa "prsecflags_t *psf"
  34 .Fc
  35 .Sh DESCRIPTION
  36 The
  37 .Fn Psecflags
  38 function obtains the security flags of the process handle
  39 .Fa P .
  40 The security flags structure will be dynamically allocated and a pointer to it
  41 will be placed in
  42 .Fa psf .
  43 It must be released with a call to
  44 .Fn Psecflags_free .
  45 The definition of the
  46 .Sy prsecflags_t
  47 structure is documented in
  48 .Xr proc 4 .
  49 .Pp
  50 The
  51 .Fn Psecflags_free
  52 function releases the storage in
  53 .Fa psf
  54 that was allocated as a result of calling
  55 .Fn Psecflags .
  56 .Sh RETURN VALUES
  57 Upon successful completion, the
  58 .Fn Psecflags
  59 function returns
  60 .Sy 0
  61 and
  62 .Fa psf
  63 is updated with a pointer to the allocated security flags.
  64 Otherwise,
  65 .Sy -1
  66 is returned and
  67 .Fa psf
  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 security-flags 5