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