1.\"
2.\" This file and its contents are supplied under the terms of the
3.\" Common Development and Distribution License ("CDDL"), version 1.0.
4.\" You may only use this file in accordance with the terms of version
5.\" 1.0 of the CDDL.
6.\"
7.\" A full copy of the text of the CDDL should have accompanied this
8.\" source.  A copy of the CDDL is also available via the Internet at
9.\" http://www.illumos.org/license/CDDL.
10.\"
11.\"
12.\" Copyright 2015 Joyent, Inc.
13.\"
14.Dd May 11, 2016
15.Dt PRD_AGENT 3PROC
16.Os
17.Sh NAME
18.Nm Prd_agent
19.Nd get librtld_db agent
20.Sh LIBRARY
21.Lb libproc
22.Sh SYNOPSIS
23.In libproc.h
24.Ft "rd_agent_t *"
25.Fo Prd_agent
26.Fa "struct ps_prochandle *P"
27.Fc
28.Sh DESCRIPTION
29The
30.Fn Prd_agent
31function returns a pointer to an agent suitable for use with the
32run-time link editing database library,
33.Xr librtld_db 3LIB ,
34corresponding to the process handle
35.Fa P .
36.Pp
37The returned agent is valid until either the process handle executes a
38new process image through the
39.Xr exec 2
40family of calls or the process handle
41.Fa P
42is released through a call to
43.Xr Prelease 3PROC .
44.Sh RETURN VALUES
45Upon successful completion, the
46.Fn Prd_agent
47function returns a pointer to the librtld_db agent.
48Otherwise, it returns
49.Dv NULL
50to indicate failure.
51.Sh INTERFACE STABILITY
52.Sy Uncommitted
53.Sh MT-LEVEL
54See
55.Sy LOCKING
56in
57.Xr libproc 3LIB .
58.Sh SEE ALSO
59.Xr exec 2 ,
60.Xr libproc 3LIB ,
61.Xr librtld_db 3LIB ,
62.Xr proc 5
63