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

          --- old/usr/src/man/man3proc/Pctlfd.3proc.man.txt
          +++ new/usr/src/man/man3proc/Pctlfd.3proc.man.txt
   1    1  PCTFLD(3PROC)          Process Control Library Functions         PCTFLD(3PROC)
   2    2  
   3    3  NAME
   4    4       Pctlfd - obtain the process control file descriptor
   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       int
  11   13       Pctlfd(struct ps_prochandle *P);
  12   14  
  13   15  DESCRIPTION
  14   16       The Pctlfd() function returns a file descriptor to the underlying /proc
  15   17       file system ctl file for the process identified by the handle P.  This
  16   18       may be used for injecting control operations manually; however, many
  17   19       interfaces for using it are provided by libproc(3LIB) itself.

  18   20  
  19   21       Only live processes have a control file descriptor.  Process handles that
  20   22       correspond to files and cores, created through Pgrab_file(3PROC) and
  21   23       Pgrab_core(3PROC), do not have a corresponding file descriptor.
  22   24  
  23   25       The file descriptor is invalidated when the process handle is released
  24   26       through Prelease(3PROC) or if control is lost and the handle is reopened.
  25   27  
  26   28  RETURN VALUES
  27   29       Upon successful completion, the Pctlfd() function returns a valid file
  28   30       descriptor.  Otherwise, if none exists, then -1 is returned.
  29   31  
  30   32  INTERFACE STABILITY
  31   33       Uncommitted
  32   34  
  33   35  MT-LEVEL
  34   36       See LOCKING in libproc(3LIB).
  35   37  
  36   38  SEE ALSO
  37   39       libproc(3LIB), Pcreate(3PROC), Pgrab(3PROC), Pgrab_core(3PROC),
  38   40       Pgrab_file(3PROC), Prelease(3PROC), Preopen(3PROC), proc(4)
  39   41  
  40   42  illumos                          May 11, 2016                          illumos

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX