blob: ac640541cba143b3aa4ca83b094178cae1a8a674 [file] [log] [blame]
njn0c246472005-05-31 01:00:08 +00001
2/*--------------------------------------------------------------------*/
3/*--- POSIX signals. pub_core_signals.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_SIGNALS_H
32#define __PUB_CORE_SIGNALS_H
33
34//--------------------------------------------------------------------
35// PURPOSE: This module implements all the signal handling stuff.
36//--------------------------------------------------------------------
37
38/* Highest signal the kernel will let us use */
39extern Int VG_(max_signal);
40
41extern void VG_(sigstartup_actions) ( void );
42
43/* Poll a thread's set of pending signals, and update the Thread's context to deliver one */
44extern void VG_(poll_signals) ( ThreadId );
45
46/* Fake system calls for signal handling. */
47extern Int VG_(do_sys_sigaltstack) ( ThreadId tid, vki_stack_t* ss,
48 vki_stack_t* oss );
49extern Int VG_(do_sys_sigaction) ( Int signo,
50 const struct vki_sigaction *new_act,
51 struct vki_sigaction *old_act );
52extern Int VG_(do_sys_sigprocmask) ( ThreadId tid, Int how,
53 vki_sigset_t* set,
54 vki_sigset_t* oldset );
55
56extern void VG_(clear_out_queued_signals)
57 ( ThreadId tid, /* OUT */ vki_sigset_t* saved_mask );
58
59extern void VG_(kill_self)(Int sigNo);
60
61/* These function synthesize a fault, as if the running instruction
62 had had a fault. These functions do not return - they longjmp back
63 into the scheduler so the signal can be delivered. */
64extern void VG_(synth_fault) (ThreadId tid);
65extern void VG_(synth_fault_mapping)(ThreadId tid, Addr addr);
66extern void VG_(synth_fault_perms) (ThreadId tid, Addr addr);
67extern void VG_(synth_sigill) (ThreadId tid, Addr addr);
68
69/* Extend the stack to cover addr, if possible */
70extern Bool VG_(extend_stack)(Addr addr, UInt maxsize);
71
72/* Returns True if the signal is OK for the client to use */
73extern Bool VG_(client_signal_OK)(Int sigNo);
74
75/* Forces the client's signal handler to SIG_DFL - generally just
76 before using that signal to kill the process. */
77extern void VG_(set_default_handler)(Int sig);
78
79#endif // __PUB_CORE_SIGNALS_H
80
81/*--------------------------------------------------------------------*/
82/*--- end ---*/
83/*--------------------------------------------------------------------*/