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@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
56extern Addr VG_(trampoline_stuff_start);
57extern Addr VG_(trampoline_stuff_end);
58
59#if defined(VGP_x86_linux)
60extern Addr VG_(x86_linux_SUBST_FOR_sigreturn);
61extern Addr VG_(x86_linux_SUBST_FOR_rt_sigreturn);
62extern Char* VG_(x86_linux_REDIR_FOR_index) ( const Char*, Int );
63#endif
64
65#if defined(VGP_amd64_linux)
66extern Addr VG_(amd64_linux_SUBST_FOR_rt_sigreturn);
67extern Addr VG_(amd64_linux_REDIR_FOR_vgettimeofday);
68extern Addr VG_(amd64_linux_REDIR_FOR_vtime);
69extern UInt VG_(amd64_linux_REDIR_FOR_strlen)( void* );
70#endif
71
72#if defined(VGP_ppc32_linux)
73extern Addr  VG_(ppc32_linux_SUBST_FOR_sigreturn);
74extern Addr  VG_(ppc32_linux_SUBST_FOR_rt_sigreturn);
75extern UInt  VG_(ppc32_linux_REDIR_FOR_strlen)( void* );
76extern UInt  VG_(ppc32_linux_REDIR_FOR_strcmp)( void*, void* );
77extern void* VG_(ppc32_linux_REDIR_FOR_strchr)( void*, Int );
78#endif
79
80#if defined(VGP_ppc64_linux)
81extern Addr  VG_(ppc64_linux_SUBST_FOR_rt_sigreturn);
82extern UInt  VG_(ppc64_linux_REDIR_FOR_strlen)( void* );
83extern 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. */
91extern Addr VG_(ppctoc_magic_redirect_return_stub);
92#endif
93
94#if defined(VGP_arm_linux)
95extern UInt  VG_(arm_linux_REDIR_FOR_strlen)( void* );
96//extern void* VG_(arm_linux_REDIR_FOR_index) ( void*, Int );
97extern 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. */
108extern Addr VG_(ppc32_aix5_do_preloads_then_start_client);
109
110/* See comment for VG_(ppctoc_magic_redirect_return_stub) above. */
111extern 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. */
116extern Addr VG_(ppctoc_magic_redirect_return_stub);
117
118/* See comment for ppc32_aix5 equivalent above. */
119extern Addr VG_(ppc64_aix5_do_preloads_then_start_client);
120#endif
121
122#if defined(VGP_x86_darwin)
123extern Addr  VG_(x86_darwin_SUBST_FOR_sigreturn);
124extern SizeT VG_(x86_darwin_REDIR_FOR_strlen)( void* );
125extern SizeT VG_(x86_darwin_REDIR_FOR_strcmp)( void*, void* );
126extern void* VG_(x86_darwin_REDIR_FOR_strcat)( void*, void * );
127extern char* VG_(x86_darwin_REDIR_FOR_strcpy)( char *s1, char *s2 );
128extern SizeT VG_(x86_darwin_REDIR_FOR_strlcat)( char *s1, const char *s2,
129                                                SizeT size );
130#endif
131
132#if defined(VGP_amd64_darwin)
133extern Addr  VG_(amd64_darwin_SUBST_FOR_sigreturn);
134extern SizeT VG_(amd64_darwin_REDIR_FOR_strlen)( void* );
135extern SizeT VG_(amd64_darwin_REDIR_FOR_strcmp)( void*, void* );
136extern void* VG_(amd64_darwin_REDIR_FOR_strcat)( void*, void * );
137extern char* VG_(amd64_darwin_REDIR_FOR_strcpy)( char *s1, char *s2 );
138extern SizeT VG_(amd64_darwin_REDIR_FOR_strlcat)( char *s1, const char *s2,
139                                                  SizeT size );
140extern UInt VG_(amd64_darwin_REDIR_FOR_arc4random)( void );
141#endif
142
143#endif   // __PUB_CORE_TRAMPOLINE_H
144
145/*--------------------------------------------------------------------*/
146/*--- end                                                          ---*/
147/*--------------------------------------------------------------------*/
148