2 /*--------------------------------------------------------------------*/
3 /*--- The trampoline code page. pub_core_trampoline.h ---*/
4 /*--------------------------------------------------------------------*/
7 This file is part of Valgrind, a dynamic binary instrumentation
10 Copyright (C) 2000-2010 Julian Seward
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.
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.
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
28 The GNU General Public License is contained in the file COPYING.
31 #ifndef __PUB_CORE_TRAMPOLINE_H
32 #define __PUB_CORE_TRAMPOLINE_H
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.
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 //--------------------------------------------------------------------
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
56 extern void VG_(trampoline_stuff_start);
57 extern void VG_(trampoline_stuff_end);
59 #if defined(VGP_x86_linux)
60 extern void VG_(x86_linux_SUBST_FOR_sigreturn);
61 extern void VG_(x86_linux_SUBST_FOR_rt_sigreturn);
62 extern Char* VG_(x86_linux_REDIR_FOR_index) ( const Char*, Int );
65 #if defined(VGP_amd64_linux)
66 extern void VG_(amd64_linux_SUBST_FOR_rt_sigreturn);
67 extern void VG_(amd64_linux_REDIR_FOR_vgettimeofday);
68 extern void VG_(amd64_linux_REDIR_FOR_vtime);
69 extern UInt VG_(amd64_linux_REDIR_FOR_strlen)( void* );
72 #if defined(VGP_ppc32_linux)
73 extern void VG_(ppc32_linux_SUBST_FOR_sigreturn);
74 extern void 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 );
80 #if defined(VGP_ppc64_linux)
81 extern void 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 void VG_(ppctoc_magic_redirect_return_stub);
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 );
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
108 extern void VG_(ppc32_aix5_do_preloads_then_start_client);
110 /* See comment for VG_(ppctoc_magic_redirect_return_stub) above. */
111 extern void VG_(ppctoc_magic_redirect_return_stub);
114 #if defined(VGP_ppc64_aix5)
115 /* See comment for VG_(ppctoc_magic_redirect_return_stub) above. */
116 extern void VG_(ppctoc_magic_redirect_return_stub);
118 /* See comment for ppc32_aix5 equivalent above. */
119 extern void VG_(ppc64_aix5_do_preloads_then_start_client);
122 #if defined(VGO_darwin)
123 extern void VG_(x86_darwin_SUBST_FOR_sigreturn);
124 extern SizeT VG_(darwin_REDIR_FOR_strlen)( void* );
125 extern SizeT VG_(darwin_REDIR_FOR_strcmp)( void*, void* );
126 extern void* VG_(darwin_REDIR_FOR_strcat)( void*, void * );
127 extern char* VG_(darwin_REDIR_FOR_strcpy)( char *s1, char *s2 );
128 extern SizeT VG_(darwin_REDIR_FOR_strlcat)( char *s1, const char *s2, SizeT size );
129 extern UInt VG_(darwin_REDIR_FOR_arc4random)( void );
132 #if defined(VGO_l4re)
133 extern void VG_(x86_l4re_SUBST_FOR_sigreturn);
134 extern void VG_(x86_l4re_SUBST_FOR_rt_sigreturn);
135 extern Char* VG_(x86_l4re_REDIR_FOR_index) ( const Char*, Int );
136 extern void VG_(x86_l4re_REDIR_FOR_syscall_page)(void);
138 extern void VG_(l4re_trampoline_stuff_start);
139 extern void VG_(l4re_trampoline_stuff_end);
142 #endif // __PUB_CORE_TRAMPOLINE_H
144 /*--------------------------------------------------------------------*/
146 /*--------------------------------------------------------------------*/