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 /*--------------------------------------------------------------------*/
169