mirror of
https://github.com/Zenithsiz/ftmemsim-valgrind.git
synced 2026-02-03 10:05:29 +00:00
461cc5c003
Sync VEX/LICENSE.GPL with top-level COPYING file. We used 3 different addresses for writing to the FSF to receive a copy of the GPL. Replace all different variants with an URL <http://www.gnu.org/licenses/>. The following files might still have some slightly different (L)GPL copyright notice because they were derived from other programs: - files under coregrind/m_demangle which come from libiberty: cplus-dem.c, d-demangle.c, demangle.h, rust-demangle.c, safe-ctype.c and safe-ctype.h - coregrind/m_demangle/dyn-string.[hc] derived from GCC. - coregrind/m_demangle/ansidecl.h derived from glibc. - VEX files for FMA detived from glibc: host_generic_maddf.h and host_generic_maddf.c - files under coregrin/m_debuginfo derived from LZO: lzoconf.h, lzodefs.h, minilzo-inl.c and minilzo.h - files under coregrind/m_gdbserver detived from GDB: gdb/signals.h, inferiors.c, regcache.c, regcache.h, regdef.h, remote-utils.c, server.c, server.h, signals.c, target.c, target.h and utils.c Plus the following test files: - none/tests/ppc32/testVMX.c derived from testVMX. - ppc tests derived from QEMU: jm-insns.c, ppc64_helpers.h and test_isa_3_0.c - tests derived from bzip2 (with embedded GPL text in code): hackedbz2.c, origin5-bz2.c, varinfo6.c - tests detived from glibc: str_tester.c, pth_atfork1.c - test detived from GCC libgomp: tc17_sembar.c - performance tests derived from bzip2 or tinycc (with embedded GPL text in code): bz2.c, test_input_for_tinycc.c and tinycc.c
124 lines
5.0 KiB
C
124 lines
5.0 KiB
C
|
|
/*--------------------------------------------------------------------*/
|
|
/*--- The scheduler. pub_core_scheduler.h ---*/
|
|
/*--------------------------------------------------------------------*/
|
|
|
|
/*
|
|
This file is part of Valgrind, a dynamic binary instrumentation
|
|
framework.
|
|
|
|
Copyright (C) 2000-2017 Julian Seward
|
|
jseward@acm.org
|
|
|
|
This program is free software; you can redistribute it and/or
|
|
modify it under the terms of the GNU General Public License as
|
|
published by the Free Software Foundation; either version 2 of the
|
|
License, or (at your option) any later version.
|
|
|
|
This program is distributed in the hope that it will be useful, but
|
|
WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
General Public License for more details.
|
|
|
|
You should have received a copy of the GNU General Public License
|
|
along with this program; if not, see <http://www.gnu.org/licenses/>.
|
|
|
|
The GNU General Public License is contained in the file COPYING.
|
|
*/
|
|
|
|
#ifndef __PUB_CORE_SCHEDULER_H
|
|
#define __PUB_CORE_SCHEDULER_H
|
|
|
|
#include "pub_core_basics.h" // VG_ macro
|
|
#include "pub_core_threadstate.h" // VgSchedReturnCode
|
|
|
|
//--------------------------------------------------------------------
|
|
// PURPOSE: This module is the scheduler, which is the main loop
|
|
// controlling the running of all the program's threads.
|
|
// It's at the centre of everything.
|
|
//--------------------------------------------------------------------
|
|
|
|
/* Allocate a new ThreadState */
|
|
extern ThreadId VG_(alloc_ThreadState)(void);
|
|
|
|
/* A thread exits. tid must currently be running. */
|
|
extern void VG_(exit_thread)(ThreadId tid);
|
|
|
|
/* If 'tid' is blocked in a syscall, send it SIGVGKILL so as to get it
|
|
out of the syscall and onto doing the next thing, whatever that is.
|
|
If it isn't blocked in a syscall, has no effect on the thread. */
|
|
extern void VG_(get_thread_out_of_syscall)(ThreadId tid);
|
|
|
|
/* This causes all threads except tid to forceably exit. They aren't actually
|
|
dead by the time this returns; you need to call
|
|
VG_(reap_threads)() to wait for them. */
|
|
extern void VG_(nuke_all_threads_except) ( ThreadId me,
|
|
VgSchedReturnCode reason );
|
|
|
|
/* Make a thread the running thread. The thread must previously been
|
|
sleeping, and not holding the CPU lock. This will set the
|
|
thread state to VgTs_Runnable, and the thread will attempt to take
|
|
the CPU lock. By the time it returns, tid will be the running
|
|
thread. */
|
|
extern void VG_(acquire_BigLock) ( ThreadId tid, const HChar* who );
|
|
|
|
/* Simple version, which simply acquires the lock, but does not mess
|
|
with the guest state in the same way as the non _LL version
|
|
does. */
|
|
extern void VG_(acquire_BigLock_LL) ( const HChar* who );
|
|
|
|
/* Set a thread into a sleeping state. Before the call, the thread
|
|
must be runnable, and holding the CPU lock. When this call
|
|
returns, the thread will be set to the specified sleeping state,
|
|
and will not be holding the CPU lock. Note that another
|
|
thread could be running by the time this call returns, so the
|
|
caller must be careful not to touch any shared state. It is also
|
|
the caller's responsibility to actually block until the thread is
|
|
ready to run again. */
|
|
extern void VG_(release_BigLock) ( ThreadId tid,
|
|
ThreadStatus state, const HChar* who );
|
|
|
|
/* Matching function to acquire_BigLock_LL. */
|
|
extern void VG_(release_BigLock_LL) ( const HChar* who );
|
|
|
|
/* Whether the specified thread owns the big lock. */
|
|
extern Bool VG_(owns_BigLock_LL) ( ThreadId tid );
|
|
|
|
/* Yield the CPU for a while. Drops/acquires the lock using the
|
|
normal (non _LL) functions. */
|
|
extern void VG_(vg_yield)(void);
|
|
|
|
// The scheduler.
|
|
extern VgSchedReturnCode VG_(scheduler) ( ThreadId tid );
|
|
|
|
// Initialise, phase 1. Zero out VG_(threads), decide on the root
|
|
// ThreadId and initialise the bigLock.
|
|
extern ThreadId VG_(scheduler_init_phase1) ( void );
|
|
|
|
// Initialise, phase 2. Is passed the extent of the root thread's
|
|
// client stack end (highest addressable byte) and the root ThreadId
|
|
// decided on by phase 1.
|
|
extern void VG_(scheduler_init_phase2) ( ThreadId main_tid,
|
|
Addr clstack_end,
|
|
SizeT clstack_size );
|
|
|
|
// Allows to disable the polling done to detect vgdb input
|
|
// or to force a poll at next scheduler call.
|
|
extern void VG_(disable_vgdb_poll) (void );
|
|
extern void VG_(force_vgdb_poll) ( void );
|
|
|
|
/* Stats ... */
|
|
extern void VG_(print_scheduler_stats) ( void );
|
|
|
|
/* If False, a fault is Valgrind-internal (ie, a bug) */
|
|
extern Bool VG_(in_generated_code);
|
|
|
|
/* Sanity checks which may be done at any time. The scheduler decides when. */
|
|
extern void VG_(sanity_check_general) ( Bool force_expensive );
|
|
|
|
#endif // __PUB_CORE_SCHEDULER_H
|
|
|
|
/*--------------------------------------------------------------------*/
|
|
/*--- end ---*/
|
|
/*--------------------------------------------------------------------*/
|