1 PRD_AGENT(3PROC)       Process Control Library Functions      PRD_AGENT(3PROC)
   2 
   3 NAME
   4      Prd_agent - get librtld_db agent
   5 
   6 LIBRARY
   7      Process Control Library (libproc, -lproc)
   8 
   9 SYNOPSIS
  10      #include <libproc.h>
  11 
  12      rd_agent_t *
  13      Prd_agent(struct ps_prochandle *P);
  14 
  15 DESCRIPTION
  16      The Prd_agent() function returns a pointer to an agent suitable for use
  17      with the run-time link editing database library, librtld_db(3LIB),
  18      corresponding to the process handle P.
  19 
  20      The returned agent is valid until either the process handle executes a
  21      new process image through the exec(2) family of calls or the process
  22      handle P is released through a call to Prelease(3PROC).
  23 
  24 RETURN VALUES
  25      Upon successful completion, the Prd_agent() function returns a pointer to
  26      the librtld_db agent.  Otherwise, it returns NULL to indicate failure.
  27 
  28 INTERFACE STABILITY
  29      Uncommitted
  30 
  31 MT-LEVEL
  32      See LOCKING in libproc(3LIB).
  33 
  34 SEE ALSO
  35      exec(2), libproc(3LIB), librtld_db(3LIB), proc(4)
  36 
  37 illumos                          May 11, 2016                          illumos