mirror of
https://github.com/Zenithsiz/ftmemsim-valgrind.git
synced 2026-02-03 18:13:01 +00:00
123 lines
4.9 KiB
C
123 lines
4.9 KiB
C
|
|
/*--------------------------------------------------------------------*/
|
|
/*--- The scheduler. pub_core_scheduler.h ---*/
|
|
/*--------------------------------------------------------------------*/
|
|
|
|
/*
|
|
This file is part of Valgrind, a dynamic binary instrumentation
|
|
framework.
|
|
|
|
Copyright (C) 2000-2013 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, write to the Free Software
|
|
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
|
|
02111-1307, USA.
|
|
|
|
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);
|
|
|
|
/* Nuke all threads except tid. */
|
|
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 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 ---*/
|
|
/*--------------------------------------------------------------------*/
|