coregrind/pub_core_signals.h

   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-2017 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)(ThreadId tid, Addr addr);
  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 /*--------------------------------------------------------------------*/