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

          --- old/usr/src/man/man3proc/Plwp_getspymaster.3proc.man.txt
          +++ new/usr/src/man/man3proc/Plwp_getspymaster.3proc.man.txt
   1    1  PLWP_GETSPYMASTER(3PROC)                     Process Control Library Functions
   2    2  
   3    3  NAME
   4    4       Plwp_getspymaster - get agent LWP spy master 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_getspymaster(struct ps_prochandle *P, lwpid_t lwpid, psinfo_t *ps);
  12   14  
  13   15  DESCRIPTION
  14   16       The Plwp_getspymaster() function returns information about the spy master
  15   17       that corresponds to the agent LWP for the thread lwpid in the process
  16   18       handle P.
  17   19  

  18   20       The agent LWP allows another process to inject actions into the target
  19   21       process.  When an agent LWP is created, it leverages an existing thread
  20   22       in the process and it also creates a record of whom created the agent,
  21   23       which is called the spy master.  For more information on the agent LWP
  22   24       and the spy master, see proc(4).
  23   25  
  24   26       If the thread identified lwpid has an agent LWP, the corresponding ps
  25   27       information (see proc(4) for the definition of the psinfo_t) will be
  26   28       filled into ps.
  27   29  
  28   30       Note, process handles that correspond to a file, created by
  29   31       Pgrab_file(3PROC), cannot have an agent LWP created for them and thus
  30   32       cannot have any spy master information.  In addition, core files from
  31   33       older releases may not have any data on the spy master.
  32   34  
  33   35  RETURN VALUES
  34   36       Upon successful completion, the Plwp_getspymaster() returns 0 and updates
  35   37       ps.  Otherwise, it returns -1, sets errno, and ps is not modified.
  36   38  
  37   39  ERRORS
  38   40       For a full list of possible errors also see the DIAGNOSTICS section in
  39   41       proc(4).
  40   42  
  41   43       The Plwp_getpsinfo() function will fail if:
  42   44  
  43   45       ENODATA            P refers to a file handle obtained through
  44   46                          Pgrab_file(3PROC) or P does not have any information
  45   47                          about the spy master.
  46   48  
  47   49       EINVAL             The process handle P refers to a core file and the
  48   50                          specified thread does not exist.
  49   51  
  50   52                          The thread, lwpid does not have an active agent,
  51   53                          PR_AGENT is not set in the pr_flags member of the
  52   54                          thread's status information.
  53   55  
  54   56       ENOENT             The process handle P refers to an active process and
  55   57                          the specified thread does not exist.
  56   58  
  57   59  INTERFACE STABILITY
  58   60       Uncommitted
  59   61  
  60   62  MT-LEVEL
  61   63       See LOCKING in libproc(3LIB).
  62   64  
  63   65  SEE ALSO
  64   66       libproc(3LIB), proc(4)
  65   67  
  66   68  illumos                          May 11, 2016                          illumos

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX