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