1 PCREATE_AGENT(3PROC)   Process Control Library Functions  PCREATE_AGENT(3PROC)
   2 
   3 NAME
   4      Pcreate_agent - create the agent LWP
   5 
   6 SYNOPSIS
   7      Process Control Library (libproc, -lproc)


   8      #include <libproc.h>
   9 
  10      int
  11      Pcreate_agent(struct ps_prochandle *P);
  12 
  13 DESCRIPTION
  14      The Pcreate_agent() function creates the agent LWP in the process
  15      represented by the handle P.  The agent LWP is used as a means to force
  16      system calls to be invoked on the controlled process.  For more
  17      information on the agent LWP, see proc(4).
  18 
  19      The agent LWP cannot be created for process handles corresponding to core
  20      files, zombie processes, processes that have yet to run, and ELF objects.
  21 
  22      The Pcreate_agent() function is reentrant.  It may be entered
  23      recursively.  The act of creating the agent LWP will cause the process to
  24      be stopped.  For every call to the Pcreate_agent() function, a
  25      corresponding call to Pdestroy_agent(3PROC) is required.
  26 
  27 RETURN VALUES

   1 PCREATE_AGENT(3PROC)   Process Control Library Functions  PCREATE_AGENT(3PROC)
   2 
   3 NAME
   4      Pcreate_agent - create the agent LWP
   5 
   6 LIBRARY
   7      Process Control Library (libproc, -lproc)
   8 
   9 SYNOPSIS
  10      #include <libproc.h>
  11 
  12      int
  13      Pcreate_agent(struct ps_prochandle *P);
  14 
  15 DESCRIPTION
  16      The Pcreate_agent() function creates the agent LWP in the process
  17      represented by the handle P.  The agent LWP is used as a means to force
  18      system calls to be invoked on the controlled process.  For more
  19      information on the agent LWP, see proc(4).
  20 
  21      The agent LWP cannot be created for process handles corresponding to core
  22      files, zombie processes, processes that have yet to run, and ELF objects.
  23 
  24      The Pcreate_agent() function is reentrant.  It may be entered
  25      recursively.  The act of creating the agent LWP will cause the process to
  26      be stopped.  For every call to the Pcreate_agent() function, a
  27      corresponding call to Pdestroy_agent(3PROC) is required.
  28 
  29 RETURN VALUES