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