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-2013 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 #endif
  75
  76 #if defined(VGP_ppc32_linux)
  77 extern Addr  VG_(ppc32_linux_SUBST_FOR_sigreturn);
  78 extern Addr  VG_(ppc32_linux_SUBST_FOR_rt_sigreturn);
  79 extern UInt  VG_(ppc32_linux_REDIR_FOR_strlen)( void* );
  80 extern UInt  VG_(ppc32_linux_REDIR_FOR_strcmp)( void*, void* );
  81 extern void* VG_(ppc32_linux_REDIR_FOR_strchr)( void*, Int );
  82 #endif
  83
  84 #if defined(VGP_ppc64be_linux) || defined(VGP_ppc64le_linux)
  85 extern Addr  VG_(ppc64_linux_SUBST_FOR_rt_sigreturn);
  86 extern UInt  VG_(ppc64_linux_REDIR_FOR_strlen)( void* );
  87 extern void* VG_(ppc64_linux_REDIR_FOR_strchr)( void*, Int );
  88 /* A label (sans dot) marking the ultra-magical return stub via which
  89    all redirected and wrapped functions are made to "return" on
  90    ppc64-linux.  The one insn at this label is never really
  91    translated.  Instead, m_translate generates IR to restore the
  92    thread's LR and R2 registers from a small stack in the ppc64 guest
  93    state structure, and then branch to LR.  Convoluted?  Confusing?
  94    You betcha.  Could I think of anything simpler?  No. */
  95 extern Addr VG_(ppctoc_magic_redirect_return_stub);
  96 #endif
  97
  98 #if defined(VGP_arm_linux)
  99 extern Addr  VG_(arm_linux_SUBST_FOR_sigreturn);
 100 extern Addr  VG_(arm_linux_SUBST_FOR_rt_sigreturn);
 101 extern UInt  VG_(arm_linux_REDIR_FOR_strlen)( void* );
 102 //extern void* VG_(arm_linux_REDIR_FOR_index) ( void*, Int );
 103 extern void* VG_(arm_linux_REDIR_FOR_memcpy)( void*, void*, Int );
 104 extern void* VG_(arm_linux_REDIR_FOR_strcmp)( void*, void* );
 105 #endif
 106
 107 #if defined(VGP_tilegx_linux)
 108 extern Addr  VG_(tilegx_linux_SUBST_FOR_rt_sigreturn);
 109 extern UInt  VG_(tilegx_linux_REDIR_FOR_strlen)( void* );
 110 #endif
 111
 112 #if defined(VGP_arm64_linux)
 113 extern Addr  VG_(arm64_linux_SUBST_FOR_rt_sigreturn);
 114 extern ULong VG_(arm64_linux_REDIR_FOR_strlen)( void* );
 115 extern void* VG_(arm64_linux_REDIR_FOR_index) ( void*, Long );
 116 extern Long  VG_(arm64_linux_REDIR_FOR_strcmp)( void*, void* );
 117 #endif
 118
 119 #if defined(VGP_x86_darwin)
 120 extern Addr  VG_(x86_darwin_SUBST_FOR_sigreturn);
 121 extern SizeT VG_(x86_darwin_REDIR_FOR_strlen)( void* );
 122 extern SizeT VG_(x86_darwin_REDIR_FOR_strcmp)( void*, void* );
 123 extern void* VG_(x86_darwin_REDIR_FOR_strcat)( void*, void * );
 124 extern char* VG_(x86_darwin_REDIR_FOR_strcpy)( char *s1, char *s2 );
 125 extern SizeT VG_(x86_darwin_REDIR_FOR_strlcat)( char *s1, const char *s2,
 126                                                 SizeT size );
 127 #endif
 128
 129 #if defined(VGP_amd64_darwin)
 130 extern Addr  VG_(amd64_darwin_SUBST_FOR_sigreturn);
 131 extern SizeT VG_(amd64_darwin_REDIR_FOR_strlen)( void* );
 132 extern SizeT VG_(amd64_darwin_REDIR_FOR_strcmp)( void*, void* );
 133 extern void* VG_(amd64_darwin_REDIR_FOR_strcat)( void*, void * );
 134 extern char* VG_(amd64_darwin_REDIR_FOR_strcpy)( char *s1, char *s2 );
 135 extern SizeT VG_(amd64_darwin_REDIR_FOR_strlcat)( char *s1, const char *s2,
 136                                                   SizeT size );
 137 extern UInt VG_(amd64_darwin_REDIR_FOR_arc4random)( void );
 138 # if DARWIN_VERS == DARWIN_10_9
 139   extern char* VG_(amd64_darwin_REDIR_FOR_strchr)( const char*, int );
 140 # endif
 141 #endif
 142
 143 #if defined(VGP_s390x_linux)
 144 extern Addr VG_(s390x_linux_SUBST_FOR_sigreturn);
 145 extern Addr VG_(s390x_linux_SUBST_FOR_rt_sigreturn);
 146 // Note: Long for the 2nd parameter because according to z-series ABI,
 147 // section "Parameter Passing" SIMPLE_ARG:
 148 // "Values shorter than 64 bits are sign- or zero-extended
 149 // (as appropriate) to 64 bits."
 150 extern void* VG_(s390x_linux_REDIR_FOR_index) ( void*, Long );
 151 #endif
 152
 153 #if defined(VGP_mips32_linux)
 154 extern Addr  VG_(mips32_linux_SUBST_FOR_sigreturn);
 155 extern Addr  VG_(mips32_linux_SUBST_FOR_rt_sigreturn);
 156 extern UInt  VG_(mips32_linux_REDIR_FOR_strlen)( void* );
 157 #endif
 158
 159 #if defined(VGP_mips64_linux)
 160 extern Addr  VG_(mips64_linux_SUBST_FOR_rt_sigreturn);
 161 extern UInt  VG_(mips64_linux_REDIR_FOR_strlen)( void* );
 162 #endif
 163
 164 #endif   // __PUB_CORE_TRAMPOLINE_H
 165
 166 /*--------------------------------------------------------------------*/
 167 /*--- end                                                          ---*/
 168 /*--------------------------------------------------------------------*/