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 PPLTDEST 3PROC
16.Os
17.Sh NAME
18.Nm Ppltdest
19.Nd determine PLT destination symbol
20.Sh SYNOPSIS
21.Lb libproc
22.In libproc.h
23.Ft "const char *"
24.Fo Ppltdest
25.Fa "struct ps_prochandle *P"
26.Fa "uintptr_t addr"
27.Fc
28.Sh DESCRIPTION
29The
30.Fn Ppltdest
31function determines if the address at
32.Fa addr
33in the process handle
34.Fa P
35corresponds to an entry in the procedure linkage table (PLT) and if so,
36returns a pointer to a null-terminated character string that contains
37the symbol's name.
38The returned pointer is not valid after any other calls to function in
39.Xr libproc 3LIB .
40The
41.Fn Ppltdest
42is also a useful way to determine if
43.Fa addr
44corresponds to an address in the PLT.
45.Sh RETURN VALUES
46Upon successful completion, the
47.Fn Ppltdest
48returns a pointer to a character string with the name.
49Otherwise,
50.Dv NULL
51is returned.
52.Sh INTERFACE STABILITY
53.Sy Uncommitted
54.Sh MT-LEVEL
55See
56.Sy LOCKING
57in
58.Xr libproc 3LIB .
59.Sh SEE ALSO
60.Xr libproc 3LIB
61.Rs
62.%T Linkers and Libraries Guide
63.Re
64