1
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-2010 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#include "pub_tool_signals.h"       // I want to get rid of this header...
39
40/* Highest signal the kernel will let us use */
41extern Int VG_(max_signal);
42
43/* Use high signals because native pthreads wants to use low */
44#define VG_SIGVGKILL       (VG_(max_signal)-0)
45#define VG_SIGVGRTUSERMAX  (VG_(max_signal)-1)
46
47extern void VG_(sigstartup_actions) ( void );
48
49/* Poll a thread's set of pending signals, and update the Thread's
50   context to deliver one (viz, create signal frames if needed) */
51extern void VG_(poll_signals) ( ThreadId );
52
53/* Fake system calls for signal handling. */
54extern SysRes VG_(do_sys_sigaltstack) ( ThreadId tid, vki_stack_t* ss,
55                                                      vki_stack_t* oss );
56extern SysRes VG_(do_sys_sigaction)   ( Int signo,
57                                        const vki_sigaction_toK_t* new_act,
58                                        vki_sigaction_fromK_t* old_act );
59extern SysRes VG_(do_sys_sigprocmask) ( ThreadId tid, Int how,
60                                        vki_sigset_t* set,
61                                        vki_sigset_t* oldset );
62
63extern void VG_(clear_out_queued_signals)
64                  ( ThreadId tid, /* OUT */ vki_sigset_t* saved_mask );
65
66extern void VG_(kill_self)(Int sigNo);
67
68/* These function synthesize a fault, as if the running instruction
69   had had a fault.  These functions do not return - they longjmp back
70   into the scheduler so the signal can be delivered. */
71extern void VG_(synth_fault)        (ThreadId tid);
72extern void VG_(synth_fault_mapping)(ThreadId tid, Addr addr);
73extern void VG_(synth_fault_perms)  (ThreadId tid, Addr addr);
74extern void VG_(synth_sigill)       (ThreadId tid, Addr addr);
75extern void VG_(synth_sigtrap)      (ThreadId tid);
76extern void VG_(synth_sigbus)       (ThreadId tid);
77
78/* Extend the stack to cover addr, if possible */
79extern Bool VG_(extend_stack)(Addr addr, UInt maxsize);
80
81/* Forces the client's signal handler to SIG_DFL - generally just
82   before using that signal to kill the process. */
83extern void VG_(set_default_handler)(Int sig);
84
85#endif   // __PUB_CORE_SIGNALS_H
86
87/*--------------------------------------------------------------------*/
88/*--- end                                                          ---*/
89/*--------------------------------------------------------------------*/
90