coregrind/pub_core_trampoline.h

   1
   2 /*--------------------------------------------------------------------*/
   3 /*--- The trampoline code page.              pub_core_trampoline.h ---*/
   4 /*--------------------------------------------------------------------*/
   5
   6 /*
   7    This file is part of Valgrind, a dynamic binary instrumentation
   8    framework.
   9
  10    Copyright (C) 2000-2017 Julian Seward
  11       jseward@acm.org
  12
  13    This program is free software; you can redistribute it and/or
  14    modify it under the terms of the GNU General Public License as
  15    published by the Free Software Foundation; either version 2 of the
  16    License, or (at your option) any later version.
  17
  18    This program is distributed in the hope that it will be useful, but
  19    WITHOUT ANY WARRANTY; without even the implied warranty of
  20    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  21    General Public License for more details.
  22
  23    You should have received a copy of the GNU General Public License
  24    along with this program; if not, write to the Free Software
  25    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
  26    02111-1307, USA.
  27
  28    The GNU General Public License is contained in the file COPYING.
  29 */
  30
  31 #ifndef __PUB_CORE_TRAMPOLINE_H
  32 #define __PUB_CORE_TRAMPOLINE_H
  33
  34 #include "pub_core_basics.h"   // VG_ macro
  35
  36 //--------------------------------------------------------------------
  37 // PURPOSE: This module defines a few replacement functions for Linux
  38 // vsyscalls, which we can't implement directly.  It also contains
  39 // stubs for signal returns.  Note, all the code within runs on the
  40 // simulated CPU.  The vsyscall stubs are gotten to by use of the
  41 // redirect mechanism.
  42 //
  43 // Note: generally, putting replacement functions in here is a bad
  44 // idea, since any Dwarf frame-unwind info attached to them will not
  45 // be seen by the unwinder in gcc's runtime support.  This means
  46 // unwinding during exception handling by gcc tends to fail if it
  47 // encounters one of these replacement functions.  A better place to
  48 // put them is in one of the .so's preloaded into the client, since
  49 // the client's ld.so will know about it and so gcc's unwinder
  50 // (somehow) is able to get hold of it.
  51 //--------------------------------------------------------------------
  52
  53 /* These two delimit our handwritten assembly code, so we can tell
  54    tools which track memory that this area should be regarded as
  55    readable, at least.  Otherwise Memcheck complains we're jumping to
  56    invalid addresses. */
  57
  58 extern Addr VG_(trampoline_stuff_start);
  59 extern Addr VG_(trampoline_stuff_end);
  60
  61 #if defined(VGP_x86_linux)
  62 extern Addr VG_(x86_linux_SUBST_FOR_sigreturn);
  63 extern Addr VG_(x86_linux_SUBST_FOR_rt_sigreturn);
  64 extern Char* VG_(x86_linux_REDIR_FOR_index) ( const Char*, Int );
  65 extern UInt VG_(x86_linux_REDIR_FOR_strlen)( void* );
  66 #endif
  67
  68 #if defined(VGP_amd64_linux)
  69 extern Addr VG_(amd64_linux_SUBST_FOR_rt_sigreturn);
  70 extern Addr VG_(amd64_linux_REDIR_FOR_vgettimeofday);
  71 extern Addr VG_(amd64_linux_REDIR_FOR_vtime);
  72 extern Addr VG_(amd64_linux_REDIR_FOR_vgetcpu);
  73 extern UInt VG_(amd64_linux_REDIR_FOR_strlen)( void* );
  74 extern Char* VG_(amd64_linux_REDIR_FOR_index) ( const Char*, Int );
  75 #endif
  76
  77 #if defined(VGP_ppc32_linux)
  78 extern Addr  VG_(ppc32_linux_SUBST_FOR_sigreturn);
  79 extern Addr  VG_(ppc32_linux_SUBST_FOR_rt_sigreturn);
  80 extern UInt  VG_(ppc32_linux_REDIR_FOR_strlen)( void* );
  81 extern UInt  VG_(ppc32_linux_REDIR_FOR_strcmp)( void*, void* );
  82 extern void* VG_(ppc32_linux_REDIR_FOR_strchr)( void*, Int );
  83 #endif
  84
  85 #if defined(VGP_ppc64be_linux) || defined(VGP_ppc64le_linux)
  86 extern Addr  VG_(ppc64_linux_SUBST_FOR_rt_sigreturn);
  87 extern UInt  VG_(ppc64_linux_REDIR_FOR_strlen)( void* );
  88 extern void* VG_(ppc64_linux_REDIR_FOR_strchr)( void*, Int );
  89 /* A label (sans dot) marking the ultra-magical return stub via which
  90    all redirected and wrapped functions are made to "return" on
  91    ppc64-linux.  The one insn at this label is never really
  92    translated.  Instead, m_translate generates IR to restore the
  93    thread's LR and R2 registers from a small stack in the ppc64 guest
  94    state structure, and then branch to LR.  Convoluted?  Confusing?
  95    You betcha.  Could I think of anything simpler?  No. */
  96 extern Addr VG_(ppctoc_magic_redirect_return_stub);
  97 #endif
  98
  99 #if defined(VGP_arm_linux)
 100 extern Addr  VG_(arm_linux_SUBST_FOR_sigreturn);
 101 extern Addr  VG_(arm_linux_SUBST_FOR_rt_sigreturn);
 102 extern UInt  VG_(arm_linux_REDIR_FOR_strlen)( void* );
 103 extern void* VG_(arm_linux_REDIR_FOR_index) ( void*, Int );
 104 extern void* VG_(arm_linux_REDIR_FOR_memcpy)( void*, void*, Int );
 105 extern void* VG_(arm_linux_REDIR_FOR_strcmp)( void*, void* );
 106 #endif
 107
 108 #if defined(VGP_arm64_linux)
 109 extern Addr  VG_(arm64_linux_SUBST_FOR_rt_sigreturn);
 110 extern ULong VG_(arm64_linux_REDIR_FOR_strlen)( void* );
 111 extern void* VG_(arm64_linux_REDIR_FOR_index) ( void*, Long );
 112 extern Long  VG_(arm64_linux_REDIR_FOR_strcmp)( void*, void* );
 113 #endif
 114
 115 #if defined(VGP_x86_darwin)
 116 extern Addr  VG_(x86_darwin_SUBST_FOR_sigreturn);
 117 extern SizeT VG_(x86_darwin_REDIR_FOR_strlen)( void* );
 118 extern SizeT VG_(x86_darwin_REDIR_FOR_strcmp)( void*, void* );
 119 extern void* VG_(x86_darwin_REDIR_FOR_strcat)( void*, void * );
 120 extern char* VG_(x86_darwin_REDIR_FOR_strcpy)( char *s1, char *s2 );
 121 extern SizeT VG_(x86_darwin_REDIR_FOR_strlcat)( char *s1, const char *s2,
 122                                                 SizeT size );
 123 #endif
 124
 125 #if defined(VGP_amd64_darwin)
 126 extern Addr  VG_(amd64_darwin_SUBST_FOR_sigreturn);
 127 extern SizeT VG_(amd64_darwin_REDIR_FOR_strlen)( void* );
 128 extern SizeT VG_(amd64_darwin_REDIR_FOR_strcmp)( void*, void* );
 129 extern void* VG_(amd64_darwin_REDIR_FOR_strcat)( void*, void * );
 130 extern char* VG_(amd64_darwin_REDIR_FOR_strcpy)( char *s1, char *s2 );
 131 extern SizeT VG_(amd64_darwin_REDIR_FOR_strlcat)( char *s1, const char *s2,
 132                                                   SizeT size );
 133 extern UInt VG_(amd64_darwin_REDIR_FOR_arc4random)( void );
 134 # if DARWIN_VERS == DARWIN_10_9
 135   extern char* VG_(amd64_darwin_REDIR_FOR_strchr)( const char*, int );
 136 # endif
 137 #endif
 138
 139 #if defined(VGP_s390x_linux)
 140 extern Addr VG_(s390x_linux_SUBST_FOR_sigreturn);
 141 extern Addr VG_(s390x_linux_SUBST_FOR_rt_sigreturn);
 142 // Note: Long for the 2nd parameter because according to z-series ABI,
 143 // section "Parameter Passing" SIMPLE_ARG:
 144 // "Values shorter than 64 bits are sign- or zero-extended
 145 // (as appropriate) to 64 bits."
 146 extern void* VG_(s390x_linux_REDIR_FOR_index) ( void*, Long );
 147 #endif
 148
 149 #if defined(VGP_mips32_linux)
 150 extern Addr  VG_(mips32_linux_SUBST_FOR_sigreturn);
 151 extern Addr  VG_(mips32_linux_SUBST_FOR_rt_sigreturn);
 152 extern Char* VG_(mips32_linux_REDIR_FOR_index)( const Char*, Int );
 153 extern UInt  VG_(mips32_linux_REDIR_FOR_strlen)( void* );
 154 #endif
 155
 156 #if defined(VGP_mips64_linux)
 157 extern Addr  VG_(mips64_linux_SUBST_FOR_rt_sigreturn);
 158 extern Char* VG_(mips64_linux_REDIR_FOR_index)( const Char*, Int );
 159 extern UInt  VG_(mips64_linux_REDIR_FOR_strlen)( void* );
 160 #endif
 161
 162 #if defined(VGP_x86_solaris)
 163 extern SizeT VG_(x86_solaris_REDIR_FOR_strcmp)(const HChar *, const HChar *);
 164 extern SizeT VG_(x86_solaris_REDIR_FOR_strlen)(const HChar *);
 165 #endif
 166
 167 #if defined(VGP_amd64_solaris)
 168 extern HChar *VG_(amd64_solaris_REDIR_FOR_strcpy)(HChar *, const HChar *);
 169 extern HChar *VG_(amd64_solaris_REDIR_FOR_strncpy)(HChar *, const HChar *,
 170                                                   SizeT);
 171 extern Int VG_(amd64_solaris_REDIR_FOR_strcmp)(const HChar *, const HChar *);
 172 extern HChar *VG_(amd64_solaris_REDIR_FOR_strcat)(HChar *, const HChar *);
 173 extern SizeT VG_(amd64_solaris_REDIR_FOR_strlen)(const HChar *);
 174 #endif
 175
 176 #endif   // __PUB_CORE_TRAMPOLINE_H
 177
 178 /*--------------------------------------------------------------------*/
 179 /*--- end                                                          ---*/
 180 /*--------------------------------------------------------------------*/