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