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

          --- old/usr/src/man/man3proc/Pzonename.3proc.man.txt
          +++ new/usr/src/man/man3proc/Pzonename.3proc.man.txt
   1    1  PZONENAME(3PROC)       Process Control Library Functions      PZONENAME(3PROC)
   2    2  
   3    3  NAME
   4    4       Pzonename, Pzoneroot, Pzonepath - get zone name, root, and full object
   5    5       path
   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       Pzonename(struct ps_prochandle *P, char *buf, size_t nbyte);
  13   15  
  14   16       char *
  15   17       Pzoneroot(struct ps_prochandle *P, char *buf, size_t nbyte);
  16   18  
  17   19       char *
  18   20       Pzonepath(struct ps_prochandle *P, const char *path, char *buf,

  19   21           size_t nbyte);
  20   22  
  21   23  DESCRIPTION
  22   24       The Pzonename() function attempts to determine the name of the zone for
  23   25       the process handle P.  If found, up to nbytes, including a null
  24   26       terminator, will be written into buf.
  25   27  
  26   28       The Pzoneroot() function attempts to determine the root of the zone
  27   29       corresponding to the process handle P.  If found, up to nbytes, including
  28   30       a null terminator, will be written into buf.  If the root cannot be
  29   31       found, for example a core file that did not originate on the current
  30   32       system, then the empty string will be written into buf.
  31   33  
  32   34       The Pzonepath() function attempts to derive the full path of the object
  33   35       path in a zone relative to the root associated with the current process
  34   36       handle P.  If found, up to nbytes, including a null terminator, will be
  35   37       written into buf.  It is legal to use the same buffer for both path and
  36   38       buf; it will not be updated unless the function completes successfully.
  37   39  
  38   40  RETURN VALUES
  39   41       Upon successful completion, the Pzonename(), Pzoneroot(), and Pzonepath()
  40   42       functions return buf.  Otherwise, if an error occurred, NULL is returned
  41   43       and errno is set.
  42   44  
  43   45  ERRORS
  44   46       The Pzonename() and Pzoneroot() functions will fail if:
  45   47  
  46   48       ENODATA            P refers to a core file and zone information was not
  47   49                          available in the core dump or P refers to an ELF
  48   50                          object grabbed through Pgrab_file(3PROC).
  49   51  
  50   52       EFAULT             P refers to an active process and buf is invalid.
  51   53  
  52   54       The Pzoneroot() function will fail if:
  53   55  
  54   56       ENOMEM             Insufficient memory was available on the system.
  55   57  
  56   58  INTERFACE STABILITY
  57   59       Uncommitted
  58   60  
  59   61  MT-LEVEL
  60   62       See LOCKING in libproc(3LIB).
  61   63  
  62   64  SEE ALSO
  63   65       getzoneidbyname(3C), libproc(3LIB), proc(4)
  64   66  
  65   67  illumos                          May 11, 2016                          illumos

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX