blob: e337ad606594d252af85da62a951044268ac09ba [file] [log] [blame]
njn36b66df2005-05-12 05:13:04 +00001
2/*--------------------------------------------------------------------*/
3/*--- The dispatcher. pub_core_dispatch.h ---*/
4/*--------------------------------------------------------------------*/
5
6/*
7 This file is part of Valgrind, a dynamic binary instrumentation
8 framework.
9
10 Copyright (C) 2000-2005 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_DISPATCH_H
32#define __PUB_CORE_DISPATCH_H
33
34//--------------------------------------------------------------------
35// PURPOSE: This module deals with management of the entire process
36// address space. Almost everything depends upon it, including dynamic
37// memory management. Hence this module is almost completely
38// standalone; the only module it uses is m_debuglog. DO NOT CHANGE
39// THIS.
40//--------------------------------------------------------------------
41
42/* This subroutine is called from the C world. It is passed
43 a pointer to the VEX guest state (arch.vex). It must run code
44 from the instruction pointer in the guest state, and exit when
45 VG_(dispatch_ctr) reaches zero, or we need to defer to the scheduler.
46 The return value must indicate why it returned back to the scheduler.
47 It can also be exited if the executing code throws a non-resumable
48 signal, for example SIGSEGV, in which case control longjmp()s back past
49 here.
50
51 This code simply handles the common case fast -- when the translation
52 address is found in the translation cache. For anything else, the
53 scheduler does the work.
54*/
55extern UWord VG_(run_innerloop) ( void* guest_state );
56
57#endif // __PUB_CORE_DISPATCH_H
58
59/*--------------------------------------------------------------------*/
60/*--- end ---*/
61/*--------------------------------------------------------------------*/