• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1 
2 /*--------------------------------------------------------------------*/
3 /*--- Create/destroy signal delivery frames.                       ---*/
4 /*---                                          pub_core_sigframe.h ---*/
5 /*--------------------------------------------------------------------*/
6 
7 /*
8    This file is part of Valgrind, a dynamic binary instrumentation
9    framework.
10 
11    Copyright (C) 2000-2017 Julian Seward
12       jseward@acm.org
13 
14    This program is free software; you can redistribute it and/or
15    modify it under the terms of the GNU General Public License as
16    published by the Free Software Foundation; either version 2 of the
17    License, or (at your option) any later version.
18 
19    This program is distributed in the hope that it will be useful, but
20    WITHOUT ANY WARRANTY; without even the implied warranty of
21    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
22    General Public License for more details.
23 
24    You should have received a copy of the GNU General Public License
25    along with this program; if not, write to the Free Software
26    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
27    02111-1307, USA.
28 
29    The GNU General Public License is contained in the file COPYING.
30 */
31 
32 #ifndef __PUB_CORE_SIGFRAME_H
33 #define __PUB_CORE_SIGFRAME_H
34 
35 #include "pub_core_basics.h"     // VG_ macro
36 #include "pub_core_vki.h"        // vki_sigset_t et al.
37 
38 //--------------------------------------------------------------------
39 // PURPOSE: This module creates and destroys signal delivery frames
40 // for client threads, saving/restoring the thread CPU state in the
41 // frame appropriately.
42 //--------------------------------------------------------------------
43 
44 /* This is an arbitrary si_code that we only use internally for SIGSEGV.
45    It corresponds to the value SI_KERNEL on Linux, but that's not really
46    of any significance. */
47 #define VKI_SEGV_MADE_UP_GPF 0x80
48 
49 /* Create a signal frame for thread 'tid'. */
50 extern
51 void VG_(sigframe_create) ( ThreadId tid,
52                             Bool on_altstack,
53                             Addr sp_top_of_frame,
54                             const vki_siginfo_t *siginfo,
55                             const struct vki_ucontext *uc,
56                             void *handler,
57                             UInt flags,
58                             const vki_sigset_t *mask,
59                             void *restorer );
60 
61 /* Remove a signal frame from thread 'tid's stack, and
62    restore the CPU state from it. */
63 extern
64 void VG_(sigframe_destroy)( ThreadId tid, Bool isRT );
65 
66 #if defined(VGO_solaris)
67 extern
68 void VG_(sigframe_return)(ThreadId tid, const vki_ucontext_t *uc);
69 #endif
70 
71 #endif   // __PUB_CORE_SIGFRAME_H
72 
73 /*--------------------------------------------------------------------*/
74 /*--- end                                      pub_core_sigframe.h ---*/
75 /*--------------------------------------------------------------------*/
76