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