xref: /illumos-gate/usr/src/man/man3proc/Ppltdest.3proc (revision dcbf3bd6a1f1360fc1afcee9e22c6dcff7844bf2)
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. The returned pointer is not valid after any other
38calls 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. Otherwise,
49.Dv NULL
50is returned.
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 libproc 3LIB
60.Rs
61.%T Linkers and Libraries Guide
62.Re
63