1ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown
2ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown/*--------------------------------------------------------------------*/
3ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown/*--- System call wrappers, etc.                pub_core_syswrap.h ---*/
4ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown/*--------------------------------------------------------------------*/
5ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown
6ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown/*
7ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown   This file is part of Valgrind, a dynamic binary instrumentation
8ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown   framework.
9ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown
10663860b1408516d02ebfcb3a9999a134e6cfb223Ben Cheng   Copyright (C) 2000-2012 Julian Seward
11ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown      jseward@acm.org
12ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown
13ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown   This program is free software; you can redistribute it and/or
14ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown   modify it under the terms of the GNU General Public License as
15ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown   published by the Free Software Foundation; either version 2 of the
16ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown   License, or (at your option) any later version.
17ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown
18ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown   This program is distributed in the hope that it will be useful, but
19ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown   WITHOUT ANY WARRANTY; without even the implied warranty of
20ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
21ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown   General Public License for more details.
22ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown
23ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown   You should have received a copy of the GNU General Public License
24ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown   along with this program; if not, write to the Free Software
25ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown   Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
26ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown   02111-1307, USA.
27ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown
28ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown   The GNU General Public License is contained in the file COPYING.
29ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown*/
30ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown
31ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown#ifndef __PUB_CORE_SYSWRAP_H
32ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown#define __PUB_CORE_SYSWRAP_H
33ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown
34ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown//--------------------------------------------------------------------
35ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown// PURPOSE: This module contains all the syscall junk:  mostly PRE/POST
36ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown// wrappers, but also the main syscall jacketing code.
37ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown//--------------------------------------------------------------------
38ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown
39ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown// Allocates a stack for the first thread, then runs it,
40ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown// as if the thread had been set up by clone()
41ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brownextern void VG_(main_thread_wrapper_NORETURN)(ThreadId tid);
42ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown
43ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brownextern void VG_(client_syscall) ( ThreadId tid, UInt trc );
44ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown
45ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brownextern void VG_(post_syscall)   ( ThreadId tid );
46ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown
47ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown/* Clear this module's private state for thread 'tid' */
48ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brownextern void VG_(clear_syscallInfo) ( Int tid );
49ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown
50ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown// Fix up a thread's state when syscall is interrupted by a signal.
51ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brownextern void VG_(fixup_guest_state_after_syscall_interrupted)(
52ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown               ThreadId tid,
53ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown               Addr     ip,
54ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown               SysRes   sysret,
55ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown               Bool     restart
56ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown            );
57ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown
58ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown// Wait until all other threads are dead
59ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brownextern void VG_(reap_threads)(ThreadId self);
60ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown
61ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown// Release resources held by this thread
62ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brownextern void VG_(cleanup_thread) ( ThreadArchState* );
63ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown
64ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown/* fd leakage calls. */
65ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brownextern void VG_(init_preopened_fds) ( void );
66ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brownextern void VG_(show_open_fds) ( void );
67ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown
68ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown// When the final thread is done, where shall I call to shutdown the
69ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown// system cleanly?  Is set once at startup (in m_main) and never
70ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown// changes after that.  Is basically a pointer to the exit
71ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown// continuation.  This is all just a nasty hack to avoid calling
72ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown// directly from m_syswrap to m_main at exit, since that would cause
73ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown// m_main to become part of a module cycle, which is silly.
74ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brownextern void (* VG_(address_of_m_main_shutdown_actions_NORETURN) )
75ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown            (ThreadId,VgSchedReturnCode);
76ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown
77ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown#endif   // __PUB_CORE_SYSWRAP_H
78ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown
79ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown/*--------------------------------------------------------------------*/
80ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown/*--- end                                                          ---*/
81ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown/*--------------------------------------------------------------------*/
82ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown
83