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

          --- old/usr/src/man/man3proc/Pobjname.3proc.man.txt
          +++ new/usr/src/man/man3proc/Pobjname.3proc.man.txt
   1    1  POBJNAME(3PROC)        Process Control Library Functions       POBJNAME(3PROC)
   2    2  
   3    3  NAME
   4    4       Pobjname, Pobjname_resolved - turn a virtual address into its mapped
   5    5       object
   6    6  
   7      -SYNOPSIS
        7 +LIBRARY
   8    8       Process Control Library (libproc, -lproc)
        9 +
       10 +SYNOPSIS
   9   11       #include <libproc.h>
  10   12  
  11   13       char *
  12   14       Pobjname(struct ps_prochandle *P, uintptr_t addr, char *buffer,
  13   15           size_t bufsize);
  14   16  
  15   17       char *
  16   18       Pobjname_resolved(struct ps_prochandle *P, uintptr_t addr, char *buffer,
  17   19           size_t bufsize);
  18   20  

  19   21  DESCRIPTION
  20   22       The Pobjname() and Pobjname_resolved() functions attempt to determine the
  21   23       underlying mapped object that contains the virtual address addr in the
  22   24       process handle P.
  23   25  
  24   26       A program consists of multiple memory mappings.  Some are provided by the
  25   27       system, such as the stack and the heap.  While others are created through
  26   28       explicit calls to mmap(2) or brought in by the run-time link-editor due
  27   29       to dependencies specified in binaries and libraries.
  28   30  
  29   31       If addr is contained in a mapping, then up to bufsize characters,
  30   32       including the null terminator, of the name of the corresponding object
  31   33       will be written into buffer.  The Pobjname_resolved() function attempts
  32   34       to resolve the object to a full file system path.  If the full file-
  33   35       system path cannot be determined, then it will fall back to the name that
  34   36       the run-time link-editor has for that mapping, which is the behavior of
  35   37       Pobjname().
  36   38  
  37   39  RETURN VALUES
  38   40       Upon successful completion, the Pobjname() and Pobjname_resolved()
  39   41       functions return buffer.  Otherwise, NULL is returned to indicate the
  40   42       object name could not be found.
  41   43  
  42   44  INTERFACE STABILITY
  43   45       Uncommitted
  44   46  
  45   47  MT-LEVEL
  46   48       See LOCKING in libproc(3LIB).
  47   49  
  48   50  SEE ALSO
  49   51       mmap(2), libproc(3LIB), Pobject_iter(3PROC), proc(4)
  50   52  
  51   53  illumos                          May 11, 2016                          illumos

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX