Go to main content

man pages section 3: Extended Library Functions, Volume 3

Exit Print View

Updated: Thursday, June 13, 2019
 
 

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)