Home | History | Annotate | Download | only in coregrind
      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-2010 Julian Seward
     11       jseward (at) 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 //--------------------------------------------------------------------
     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 #endif
     64 
     65 #if defined(VGP_amd64_linux)
     66 extern Addr VG_(amd64_linux_SUBST_FOR_rt_sigreturn);
     67 extern Addr VG_(amd64_linux_REDIR_FOR_vgettimeofday);
     68 extern Addr VG_(amd64_linux_REDIR_FOR_vtime);
     69 extern UInt VG_(amd64_linux_REDIR_FOR_strlen)( void* );
     70 #endif
     71 
     72 #if defined(VGP_ppc32_linux)
     73 extern Addr  VG_(ppc32_linux_SUBST_FOR_sigreturn);
     74 extern Addr  VG_(ppc32_linux_SUBST_FOR_rt_sigreturn);
     75 extern UInt  VG_(ppc32_linux_REDIR_FOR_strlen)( void* );
     76 extern UInt  VG_(ppc32_linux_REDIR_FOR_strcmp)( void*, void* );
     77 extern void* VG_(ppc32_linux_REDIR_FOR_strchr)( void*, Int );
     78 #endif
     79 
     80 #if defined(VGP_ppc64_linux)
     81 extern Addr  VG_(ppc64_linux_SUBST_FOR_rt_sigreturn);
     82 extern UInt  VG_(ppc64_linux_REDIR_FOR_strlen)( void* );
     83 extern void* VG_(ppc64_linux_REDIR_FOR_strchr)( void*, Int );
     84 /* A label (sans dot) marking the ultra-magical return stub via which
     85    all redirected and wrapped functions are made to "return" on
     86    ppc64-linux/ppc64-aix5/ppc32-aix5.  The one insn at this label is
     87    never really translated.  Instead, m_translate generates IR to
     88    restore the thread's LR and R2 registers from a small stack in the
     89    ppc64 guest state structure, and then branch to LR.  Convoluted?
     90    Confusing?  You betcha.  Could I think of anything simpler?  No. */
     91 extern Addr VG_(ppctoc_magic_redirect_return_stub);
     92 #endif
     93 
     94 #if defined(VGP_arm_linux)
     95 extern UInt  VG_(arm_linux_REDIR_FOR_strlen)( void* );
     96 //extern void* VG_(arm_linux_REDIR_FOR_index) ( void*, Int );
     97 extern void* VG_(arm_linux_REDIR_FOR_memcpy)( void*, void*, Int );
     98 #endif
     99 
    100 #if defined(VGP_ppc32_aix5)
    101 /* A label (sans dot) marking the client start point for ppc32_aix5.
    102    This function is entered with r3 holding a pointer to the
    103    AIX5PreloadPage struct set up by m_initimg.  It first tries to
    104    __loadx the _core.so and _tool.so preloads mentioned in the struct;
    105    then it cleans up the register state to be more what it really
    106    should be at client startup, and finally it jumps to the client's
    107    real entry point. */
    108 extern Addr VG_(ppc32_aix5_do_preloads_then_start_client);
    109 
    110 /* See comment for VG_(ppctoc_magic_redirect_return_stub) above. */
    111 extern Addr VG_(ppctoc_magic_redirect_return_stub);
    112 #endif
    113 
    114 #if defined(VGP_ppc64_aix5)
    115 /* See comment for VG_(ppctoc_magic_redirect_return_stub) above. */
    116 extern Addr VG_(ppctoc_magic_redirect_return_stub);
    117 
    118 /* See comment for ppc32_aix5 equivalent above. */
    119 extern Addr VG_(ppc64_aix5_do_preloads_then_start_client);
    120 #endif
    121 
    122 #if defined(VGP_x86_darwin)
    123 extern Addr  VG_(x86_darwin_SUBST_FOR_sigreturn);
    124 extern SizeT VG_(x86_darwin_REDIR_FOR_strlen)( void* );
    125 extern SizeT VG_(x86_darwin_REDIR_FOR_strcmp)( void*, void* );
    126 extern void* VG_(x86_darwin_REDIR_FOR_strcat)( void*, void * );
    127 extern char* VG_(x86_darwin_REDIR_FOR_strcpy)( char *s1, char *s2 );
    128 extern SizeT VG_(x86_darwin_REDIR_FOR_strlcat)( char *s1, const char *s2,
    129                                                 SizeT size );
    130 #endif
    131 
    132 #if defined(VGP_amd64_darwin)
    133 extern Addr  VG_(amd64_darwin_SUBST_FOR_sigreturn);
    134 extern SizeT VG_(amd64_darwin_REDIR_FOR_strlen)( void* );
    135 extern SizeT VG_(amd64_darwin_REDIR_FOR_strcmp)( void*, void* );
    136 extern void* VG_(amd64_darwin_REDIR_FOR_strcat)( void*, void * );
    137 extern char* VG_(amd64_darwin_REDIR_FOR_strcpy)( char *s1, char *s2 );
    138 extern SizeT VG_(amd64_darwin_REDIR_FOR_strlcat)( char *s1, const char *s2,
    139                                                   SizeT size );
    140 extern UInt VG_(amd64_darwin_REDIR_FOR_arc4random)( void );
    141 #endif
    142 
    143 #endif   // __PUB_CORE_TRAMPOLINE_H
    144 
    145 /*--------------------------------------------------------------------*/
    146 /*--- end                                                          ---*/
    147 /*--------------------------------------------------------------------*/
    148