NAME

Prd_agent — get librtld_db agent

LIBRARY

Process Control Library (libproc, -lproc)

SYNOPSIS

#include <libproc.h>

rd_agent_t *
Prd_agent(struct ps_prochandle *P);

DESCRIPTION

The Prd_agent() function returns a pointer to an agent suitable for use with the run-time link editing database library, librtld_db(3LIB), corresponding to the process handle P.

The returned agent is valid until either the process handle executes a new process image through the exec(2) family of calls or the process handle P is released through a call to Prelease(3PROC).

RETURN VALUES

Upon successful completion, the Prd_agent() function returns a pointer to the librtld_db agent. Otherwise, it returns NULL to indicate failure.

INTERFACE STABILITY

Uncommitted

MT-LEVEL

See LOCKING in libproc(3LIB).

SEE ALSO

exec(2), libproc(3LIB), librtld_db(3LIB), proc(5)