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

          --- old/usr/src/man/man3proc/Prelease.3proc.man.txt
          +++ new/usr/src/man/man3proc/Prelease.3proc.man.txt
   1    1  PRELEASE(3PROC)        Process Control Library Functions       PRELEASE(3PROC)
   2    2  
   3    3  NAME
   4    4       Prelease, Pfree - release a process control handle
   5    5  
   6      -SYNOPSIS
        6 +LIBRARY
   7    7       Process Control Library (libproc, -lproc)
        8 +
        9 +SYNOPSIS
   8   10       #include <libproc.h>
   9   11  
  10   12       void
  11   13       Prelease(struct ps_prochandle *P, int flags);
  12   14  
  13   15       void
  14   16       Pfree(struct ps_prochandle *P);
  15   17  
  16   18  DESCRIPTION
  17   19       The Prelease() function is used to release all of the resources

  18   20       associated with a libproc handle.  It is suitable for handles to core
  19   21       files, created processes, and grabbed processes from the
  20   22       Pgrab_core(3PROC), Pcreate(3PROC), Pgrab(3PROC), and Pgrab_file(3PROC)
  21   23       functions.
  22   24  
  23   25       After calling the Prelease() function, all data that was returned via the
  24   26       handle will no longer be valid.  For example, the data from calls to
  25   27       Pctlfd(3PROC), Pgetauxvec(3PROC), Pstatus(3PROC), and others.
  26   28  
  27   29       The behavior of the released process is controlled by the flags argument.
  28   30       By default, if no flags are passed, then the process represented by P
  29   31       will be set running if it was created by Pcreate(3PROC) or if it was not
  30   32       originally stopped or set to stop in /proc.  The following values may be
  31   33       passed in to the flags argument.  Multiple flags should be be combined
  32   34       with a bitwise-inclusive-OR.
  33   35  
  34   36             PRELEASE_CLEAR     When releasing the process, clear all tracing
  35   37                                flags that are set on the process.
  36   38  
  37   39             PRELEASE_RETAIN    When releasing the process, retain all tracing
  38   40                                flags that are currently active on the process.
  39   41  
  40   42             PRELEASE_HANG      Leave the process stopped.  It will not resume
  41   43                                execution unless it is explicitly enabled with
  42   44                                prun(1) or another process explicitly enables
  43   45                                it.
  44   46  
  45   47             PRELEASE_KILL      Release the process and terminate it with
  46   48                                SIGKILL.  This option takes precedence over all
  47   49                                other values that may be passed in to flags.
  48   50  
  49   51       The Pfree() function is similar to the Prelease() function in that it
  50   52       frees the resources associated with the process handle P; however, unlike
  51   53       the Prelease() function, it does not handle any logic to change or set
  52   54       the grabbed processes state.  In general, prefer Prelease() to Pfree().
  53   55  
  54   56  INTERFACE STABILITY
  55   57       Uncommitted
  56   58  
  57   59  MT-LEVEL
  58   60       See LOCKING in libproc(3LIB).
  59   61  
  60   62  SEE ALSO
  61   63       prun(1), libproc(3LIB), Pcreate(3PROC), Pgrab(3PROC), Pgrab_core(3PROC),
  62   64       proc(4)
  63   65  
  64   66  illumos                          May 11, 2016                          illumos

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX