Home | History | Annotate | Download | only in coregrind 
      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 (at) 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