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

          --- old/usr/src/man/man3proc/Paddr_to_map.3proc.man.txt
          +++ new/usr/src/man/man3proc/Paddr_to_map.3proc.man.txt
   1    1  PADDR_TO_MAP(3PROC)    Process Control Library Functions   PADDR_TO_MAP(3PROC)
   2    2  
   3    3  NAME
   4    4       Paddr_to_map, Paddr_to_text_map, Plmid_to_map, Pname_to_map - lookup
   5    5       memory map information
   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       const prmap_t *
  12   14       Paddr_to_map(struct ps_prochandle *P, uintptr_t addr);
  13   15  
  14   16       const prmap_t *
  15   17       Paddr_to_text_map(struct ps_prochandle *P, uintptr_t addr);
  16   18  
  17   19       const prmap_t *
  18   20       Plmid_to_map(struct ps_prochandle *P, Lmid_t lmid, const char *name);

  19   21  
  20   22       const prmap_t *
  21   23       Pname_to_map(struct ps_prochandle *P, const char *name);
  22   24  
  23   25  DESCRIPTION
  24   26       The Paddr_to_map(), Paddr_to_text_map(), Plmid_to_map(), and
  25   27       Pname_to_map() functions lookup memory map information in the process
  26   28       handle P.  The prmap_t structure provides information such as the size,
  27   29       offset, and object of the mapping and is defined in proc(4).
  28   30  
  29   31       The pointer to the data returned by the library will only be valid for as
  30   32       long as the handle P is valid.  Any calls to Prelease(3PROC) will
  31   33       invalidate the data.
  32   34  
  33   35       The Paddr_to_map() function attempts to find the mapping information
  34   36       corresponding to the address addr.
  35   37  
  36   38       The Paddr_to_text_map() function is similar to the Paddr_to_map()
  37   39       function; however, it only returns successfully if the specified address
  38   40       corresponds to a text mapping as identified by the run-time link-editor.
  39   41       One use of this is to ensure that a mapping is actually a text-mapping
  40   42       before inserting a breakpoint in it.
  41   43  
  42   44       The Pname_to_map() function looks up the object named name and returns
  43   45       the corresponding mapping information.  Two special values may be used
  44   46       for name.  The macro PR_OBJ_EXEC refers to the executable object itself
  45   47       and the macro PR_OBJ_LDSO refers to the object ld.so.1.
  46   48  
  47   49       The Plmid_to_map() function is similar to Pname_to_map().  It allows
  48   50       passing a link-map identifier, lmid, which constricts the search of the
  49   51       object named with name to that link-map.  The special value of
  50   52       PR_LMID_EVERY may be passed to indicate that every link-map should be
  51   53       searched, which is equivalent in behavior to the Pname_to_map() function.
  52   54  
  53   55  RETURN VALUES
  54   56       Upon successful completion, the Paddr_to_map(), Paddr_to_text_map(),
  55   57       Plmid_to_map(), and Pname_to_map() functions return a pointer to the
  56   58       corresponding mapping information.  If none exists then NULL is returned.
  57   59  
  58   60  INTERFACE STABILITY
  59   61       Uncommitted
  60   62  
  61   63  MT-LEVEL
  62   64       See LOCKING in libproc(3LIB).
  63   65  
  64   66  SEE ALSO
  65   67       libproc(3LIB), Prelease(3PROC), proc(4)
  66   68  
  67   69  illumos                          May 11, 2016                          illumos

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX