1 /****************************************************************************
2  *                                                                          *
3  *                         GNAT COMPILER COMPONENTS                         *
4  *                                                                          *
5  *                             S I G T R A M P                              *
6  *                                                                          *
7  *                              C Header File                               *
8  *                                                                          *
9  *            Copyright (C) 2011, Free Software Foundation, Inc.            *
10  *                                                                          *
11  * GNAT is free software;  you can  redistribute it  and/or modify it under *
12  * terms of the  GNU General Public License as published  by the Free Soft- *
13  * ware  Foundation;  either version 3,  or (at your option) any later ver- *
14  * sion.  GNAT is distributed in the hope that it will be useful, but WITH- *
15  * OUT ANY WARRANTY;  without even the  implied warranty of MERCHANTABILITY *
16  * or FITNESS FOR A PARTICULAR PURPOSE.                                     *
17  *                                                                          *
18  * As a special exception under Section 7 of GPL version 3, you are granted *
19  * additional permissions described in the GCC Runtime Library Exception,   *
20  * version 3.1, as published by the Free Software Foundation.               *
21  *                                                                          *
22  * You should have received a copy of the GNU General Public License and    *
23  * a copy of the GCC Runtime Library Exception along with this program;     *
24  * see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see    *
25  * <http://www.gnu.org/licenses/>.                                          *
26  *                                                                          *
27  * GNAT was originally developed  by the GNAT team at  New York University. *
28  * Extensive contributions were provided by Ada Core Technologies Inc.      *
29  *                                                                          *
30  ****************************************************************************/
31 
32 /* On targets where this is implemented, we resort to a signal handler
33    trampoline to set-up the DWARF Call Frame Information that let unwinders
34    walk through the signal frame up into the interrupted application code.
35    This file introduces the relevant declarations.  */
36 
37 /* This file should only be #included on targets that do implement the
38    trampoline, which needs to expose the following interface:  */
39 
40 #ifdef __cplusplus
41 extern "C" {
42 #endif
43 
44   typedef void sighandler_t (int signo, void *siginfo, void *sigcontext);
45 
46   void __gnat_sigtramp  (int signo, void *siginfo, void *sigcontext,
47 			 sighandler_t * handler);
48 
49   /* To be called from an established signal handler.  Setup the DWARF CFI
50      bits letting unwinders walk through the signal frame up into the
51      interrupted application code, and then call HANDLER (SIGNO, SIGINFO,
52      SIGCONTEXT).  */
53 
54 #ifdef __cplusplus
55 }
56 #endif
57