Code review comments from jeffpc

          --- old/usr/src/man/man3proc/Psecflags.3proc
          +++ new/usr/src/man/man3proc/Psecflags.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 2016, Richard Lowe.
  13   13  .\"
  14      -.Dd May 14, 2016
       14 +.Dd June 06, 2016
  15   15  .Dt PSECFLAGS 3PROC
  16   16  .Os
  17   17  .Sh NAME
  18   18  .Nm Psecflags ,
  19   19  .Nm Psecflags_free
  20   20  .Nd get and free process security flags
  21   21  .Sh SYNOPSIS
  22   22  .Lb libproc
  23   23  .In libproc.h
  24   24  .Ft int
  25      -.Fo Ppriv
       25 +.Fo Psecflags
  26   26  .Fa "struct ps_prochandle *P"
  27   27  .Fa "prsecflags_t **psf"
  28   28  .Fc
  29   29  .Ft void
  30      -.Fo Ppriv_free
       30 +.Fo Psecflags_free
  31   31  .Fa "struct ps_prochandle *P"
  32   32  .Fa "prsecflags_t *psf"
  33   33  .Fc
  34   34  .Sh DESCRIPTION
  35   35  The
  36   36  .Fn Psecflags
  37   37  function obtains the security flags of the process handle
  38   38  .Fa P .
  39   39  The security flags structure will be dynamically allocated and a pointer to it
  40   40  will be placed in

  41   41  .Fa psf .
  42   42  It must be released with a call to
  43   43  .Fn Psecflags_free .
  44   44  The definition of the
  45   45  .Sy prsecflags_t
  46   46  structure is documented in
  47   47  .Xr proc 4 .
  48   48  .Pp
  49   49  The
  50   50  .Fn Psecflags_free
  51   51  function releases the storage in

  52   52  .Fa psf
  53   53  that was allocated as a result of calling
  54   54  .Fn Psecflags .
  55   55  .Sh RETURN VALUES
  56   56  Upon successful completion, the
  57   57  .Fn Psecflags
  58   58  function returns
  59   59  .Sy 0
  60   60  and
  61   61  .Fa psf
  62      -is updated with a pointer to the allocated privilege set. Otherwise,
       62 +is updated with a pointer to the allocated security flags. Otherwise,
  63   63  .Sy -1
  64   64  is returned and
  65   65  .Fa psf
  66   66  is not updated.
  67   67  .Sh INTERFACE STABILITY
  68   68  .Sy Uncommitted
  69   69  .Sh MT-LEVEL
  70   70  See
  71   71  .Sy LOCKING
  72   72  in
  73   73  .Xr libproc 3LIB .
  74   74  .Sh SEE ALSO
  75   75  .Xr libproc 3LIB ,
  76   76  .Xr proc 4 ,
  77   77  .Xr security-flags 5
    

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX