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

          --- old/usr/src/man/man3proc/Plwp_getpsinfo.3proc.man.txt
          +++ new/usr/src/man/man3proc/Plwp_getpsinfo.3proc.man.txt
   1    1  PLWP_GETPSINFO(3PROC)  Process Control Library Functions PLWP_GETPSINFO(3PROC)
   2    2  
   3    3  NAME
   4    4       Plwp_getpsinfo - get thread specific ps information
   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       Plwp_getpsinfo(struct ps_prochandle *P, lwpid_t lwpid, lwpsinfo_t *lps);
  12   14  
  13   15  DESCRIPTION
  14   16       The Plwp_getpsinfo() function looks up the thread-specific ps(1)
  15   17       information for the thread specified by lwpid in the process handle P.
  16   18       The caller should provide a pointer to an lwpsinfo_t, lps, whose
  17   19       definition can be found in proc(4).  lps will be filled in with

  18   20       information such as the thread's id, its current state, priority, and
  19   21       run-time.
  20   22  
  21   23       The Plwp_getpsinfo() function only works on process handles that refer to
  22   24       active processes and core files, it does not work on process handles that
  23   25       refer to individual files.
  24   26  
  25   27  RETURN VALUES
  26   28       Upon successful completion, the Plwp_getpsinfo() function returns 0 and
  27   29       lps is filled in with the thread-specific ps(1) information.  Otherwise,
  28   30       -1 is returned and errno is set to indicate the error.
  29   31  
  30   32  ERRORS
  31   33       For a full list of possible errors also see the DIAGNOSTICS section in
  32   34       proc(4).
  33   35  
  34   36       The Plwp_getpsinfo() function will fail if:
  35   37  
  36   38       ENODATA            P refers to a file handle obtained through
  37   39                          Pgrab_file(3PROC).
  38   40  
  39   41       EINVAL             The process handle P refers to a core file and the
  40   42                          specified thread does not exist.
  41   43  
  42   44       ENOENT             The process handle P refers to an active process and
  43   45                          the specified thread does not exist.
  44   46  
  45   47  INTERFACE STABILITY
  46   48       Uncommitted
  47   49  
  48   50  MT-LEVEL
  49   51       See LOCKING in ps(1), libproc(3LIB).
  50   52  
  51   53  SEE ALSO
  52   54       libproc(3LIB), proc(4)
  53   55  
  54   56  illumos                          May 11, 2016                          illumos

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX