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

          --- old/usr/src/man/man3proc/Pcreate_agent.3proc.man.txt
          +++ new/usr/src/man/man3proc/Pcreate_agent.3proc.man.txt
   1    1  PCREATE_AGENT(3PROC)   Process Control Library Functions  PCREATE_AGENT(3PROC)
   2    2  
   3    3  NAME
   4    4       Pcreate_agent - create the agent LWP
   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       Pcreate_agent(struct ps_prochandle *P);
  12   14  
  13   15  DESCRIPTION
  14   16       The Pcreate_agent() function creates the agent LWP in the process
  15   17       represented by the handle P.  The agent LWP is used as a means to force
  16   18       system calls to be invoked on the controlled process.  For more
  17   19       information on the agent LWP, see proc(4).

  18   20  
  19   21       The agent LWP cannot be created for process handles corresponding to core
  20   22       files, zombie processes, processes that have yet to run, and ELF objects.
  21   23  
  22   24       The Pcreate_agent() function is reentrant.  It may be entered
  23   25       recursively.  The act of creating the agent LWP will cause the process to
  24   26       be stopped.  For every call to the Pcreate_agent() function, a
  25   27       corresponding call to Pdestroy_agent(3PROC) is required.
  26   28  
  27   29  RETURN VALUES
  28   30       Upon successful completion, the Pcreate_agent() function returns 0 and
  29   31       creates the agent LWP.  Otherwise, -1 is returned, errno is set to
  30   32       indicate the error, and the agent LWP is not created.
  31   33  
  32   34  ERRORS
  33   35       The Pcreate_agent() function will fail if:
  34   36  
  35   37       ENOENT             The process referred to by P is a core file, zombie,
  36   38                          ELF object, or has not begun execution.
  37   39  
  38   40       Note, it is possible for other error numbers to be returned.  If they
  39   41       are, they represent unanticipated failure.
  40   42  
  41   43  INTERFACE STABILITY
  42   44       Uncommitted
  43   45  
  44   46  MT-LEVEL
  45   47       See LOCKING in libproc(3LIB).
  46   48  
  47   49  SEE ALSO
  48   50       libproc(3LIB), Pdestroy_agent(3PROC), proc(4)
  49   51  
  50   52  illumos                          May 11, 2016                          illumos

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX