man pages section 3: Extended Library Functions, Volume 3

Prd_agent (3PROC)

Name

Prd_agent - return the rtld_db agent handle for a victim process

Synopsis

#include <libproc.h>

rd_agent_t *Prd_agent(ps_prochandle_t *Pr);

Description

The Pr argument identifies a live victim process attached to the controlling process by the create and grab interfaces. For more information, see the Pcreate(3PROC) and Pgrab(3PROC) man pages.

The Prd_agent() function returns the rtld_db agent handle for the victim process. It is created, used, and maintained by the library.

The rtld_db agent handle is used to exercise features of the debugging interfaces of the runtime linker. For more information, see the rtld_db(3EXT) man page.

Return Values

On failure, the Prd_agent() function returns NULL.

Attributes

See attributes(7) for descriptions of the following attributes:

ATTRIBUTE TYPE ATTRIBUTE VALUE Interface Stability Committed MT-Level Unsafe

See Also

rtld_db(3EXT), libproc.h(3HEAD), libproc(3LIB), Pcreate(3PROC), Pgrab(3PROC), proc(5)