1 /****************************************************************************
3 * GNAT COMPILER COMPONENTS *
7 * C Implementation File *
9 * Copyright (C) 2005-2018, Free Software Foundation, Inc. *
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. *
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. *
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/>. *
27 * GNAT was originally developed by the GNAT team at New York University. *
28 * Extensive contributions were provided by Ada Core Technologies Inc. *
30 ****************************************************************************/
32 /* This unit contains support for SEH (Structured Exception Handling).
33 Right now the only implementation is for Win32. */
35 #if defined (_WIN32) || (defined (__CYGWIN__) && defined (__SEH__))
36 /* Include system headers, before system.h poisons malloc. */
45 /* We don't have libiberty, so use malloc. */
46 #define xmalloc(S) malloc (S)
59 /* Addresses of exception data blocks for predefined exceptions. */
60 extern struct Exception_Data constraint_error
;
61 extern struct Exception_Data numeric_error
;
62 extern struct Exception_Data program_error
;
63 extern struct Exception_Data storage_error
;
64 extern struct Exception_Data tasking_error
;
65 extern struct Exception_Data _abort_signal
;
67 #define Raise_From_Signal_Handler \
68 ada__exceptions__raise_from_signal_handler
69 extern void Raise_From_Signal_Handler (struct Exception_Data
*, const char *)
73 #if defined (_WIN32) || (defined (__CYGWIN__) && defined (__SEH__))
76 extern void _global_unwind2 (void *);
78 EXCEPTION_DISPOSITION __gnat_SEH_error_handler
79 (struct _EXCEPTION_RECORD
*, void*, struct _CONTEXT
*, void*) ATTRIBUTE_NORETURN
;
81 struct Exception_Data
*
82 __gnat_map_SEH (EXCEPTION_RECORD
* ExceptionRecord
, const char **msg
);
84 /* Convert an SEH exception to an Ada one. Return the exception ID
85 and set MSG with the corresponding message. */
87 struct Exception_Data
*
88 __gnat_map_SEH (EXCEPTION_RECORD
* ExceptionRecord
, const char **msg
)
90 switch (ExceptionRecord
->ExceptionCode
)
92 case EXCEPTION_ACCESS_VIOLATION
:
93 /* If the failing address isn't maximally-aligned or if the page
94 before the faulting page is not accessible, this is a program error.
96 if ((ExceptionRecord
->ExceptionInformation
[1] & 3) != 0
98 ((FARPROC
)(ExceptionRecord
->ExceptionInformation
[1] + 4096)))
100 *msg
= "EXCEPTION_ACCESS_VIOLATION";
101 return &program_error
;
105 /* otherwise it is a stack overflow */
106 *msg
= "stack overflow or erroneous memory access";
107 return &storage_error
;
110 case EXCEPTION_ARRAY_BOUNDS_EXCEEDED
:
111 *msg
= "EXCEPTION_ARRAY_BOUNDS_EXCEEDED";
112 return &constraint_error
;
114 case EXCEPTION_DATATYPE_MISALIGNMENT
:
115 *msg
= "EXCEPTION_DATATYPE_MISALIGNMENT";
116 return &constraint_error
;
118 case EXCEPTION_FLT_DENORMAL_OPERAND
:
119 *msg
= "EXCEPTION_FLT_DENORMAL_OPERAND";
120 return &constraint_error
;
122 case EXCEPTION_FLT_DIVIDE_BY_ZERO
:
123 *msg
= "EXCEPTION_FLT_DENORMAL_OPERAND";
124 return &constraint_error
;
126 case EXCEPTION_FLT_INVALID_OPERATION
:
127 *msg
= "EXCEPTION_FLT_INVALID_OPERATION";
128 return &constraint_error
;
130 case EXCEPTION_FLT_OVERFLOW
:
131 *msg
= "EXCEPTION_FLT_OVERFLOW";
132 return &constraint_error
;
134 case EXCEPTION_FLT_STACK_CHECK
:
135 *msg
= "EXCEPTION_FLT_STACK_CHECK";
136 return &program_error
;
138 case EXCEPTION_FLT_UNDERFLOW
:
139 *msg
= "EXCEPTION_FLT_UNDERFLOW";
140 return &constraint_error
;
142 case EXCEPTION_INT_DIVIDE_BY_ZERO
:
143 *msg
= "EXCEPTION_INT_DIVIDE_BY_ZERO";
144 return &constraint_error
;
146 case EXCEPTION_INT_OVERFLOW
:
147 *msg
= "EXCEPTION_INT_OVERFLOW";
148 return &constraint_error
;
150 case EXCEPTION_INVALID_DISPOSITION
:
151 *msg
= "EXCEPTION_INVALID_DISPOSITION";
152 return &program_error
;
154 case EXCEPTION_NONCONTINUABLE_EXCEPTION
:
155 *msg
= "EXCEPTION_NONCONTINUABLE_EXCEPTION";
156 return &program_error
;
158 case EXCEPTION_PRIV_INSTRUCTION
:
159 *msg
= "EXCEPTION_PRIV_INSTRUCTION";
160 return &program_error
;
162 case EXCEPTION_SINGLE_STEP
:
163 *msg
= "EXCEPTION_SINGLE_STEP";
164 return &program_error
;
166 case EXCEPTION_STACK_OVERFLOW
:
167 *msg
= "EXCEPTION_STACK_OVERFLOW";
168 return &storage_error
;
176 #if !(defined (_WIN64) && defined (__SEH__))
178 EXCEPTION_DISPOSITION
179 __gnat_SEH_error_handler (struct _EXCEPTION_RECORD
* ExceptionRecord
,
180 void *EstablisherFrame ATTRIBUTE_UNUSED
,
181 struct _CONTEXT
* ContextRecord ATTRIBUTE_UNUSED
,
182 void *DispatcherContext ATTRIBUTE_UNUSED
)
184 struct Exception_Data
*exception
;
187 exception
= __gnat_map_SEH (ExceptionRecord
, &msg
);
189 if (exception
== NULL
)
191 exception
= &program_error
;
192 msg
= "unhandled signal";
195 #if ! defined (_WIN64)
196 /* This call is important as it avoids locking the second time we catch a
197 signal. Note that this routine is documented as internal to Windows and
198 should not be used. */
200 _global_unwind2 (EstablisherFrame
);
201 /* Call equivalent to RtlUnwind (EstablisherFrame, NULL, NULL, 0); */
204 Raise_From_Signal_Handler (exception
, msg
);
206 #endif /* !(defined (_WIN64) && defined (__SEH__)) */
209 /* On x86_64 windows exception mechanism is no more based on a chained list
210 of handlers addresses on the stack. Instead unwinding information is used
211 to retrieve the exception handler (similar to ZCX GCC mechanism). So in
212 order to register an exception handler we need to put in the final
213 executable some unwinding information. This information might be present
214 statically in the image file inside the .pdata section or registered
215 through RtlAddFunctionTable API. Currently the GCC toolchain does not
216 generate the .pdata information for each function. As we don't need to
217 handle SEH exceptions except for signal handling we are registering a
218 "fake" unwinding data that associate a SEH exception handler to the
219 complete .text section. As we never return from the handler, the system
220 does not try to do the final unwinding using the pdata information. The
221 unwinding is handled by the runtime using either the GNAT SJLJ mechanism
222 or the ZCX GCC mechanism.
224 Solutions based on SetUnhandledExceptionFilter have been discarded as this
225 function is mostly disabled on last Windows versions.
226 Using AddVectoredExceptionHandler should also be discarded as it overrides
227 all SEH exception handlers that might be present in the program itself and
228 the loaded DLL (for example it results in unexpected behaviors in the
232 /* Don't use this trick when SEH are emitted by gcc, as it will conflict with
236 " .section .rdata, \"dr\"\n"
239 " .byte 9\n" /* UNW_FLAG_EHANDLER | UNW_VERSION */
240 " .byte 0\n" /* Prologue size. */
241 " .byte 0\n" /* Count of unwind code. */
242 " .byte 0\n" /* Frame register and offset. */
243 " .rva __gnat_SEH_error_handler\n"
245 " .section .pdata, \"dr\"\n"
247 " .long 0\n" /* ImageBase */
249 " .rva unwind_info\n"
255 void __gnat_install_SEH_handler (void *eh ATTRIBUTE_UNUSED
)
257 /* Nothing to do, the handler is statically installed by the asm statement
261 #else /* defined (_WIN64) */
262 /* Install the Win32 SEH exception handler. Note that the caller must have
263 allocated 8 bytes on the stack and pass the pointer to this stack
264 space. This is needed as the SEH exception handler must be on the stack of
269 __gnat_install_SEH_handler ((void*)buf);
273 This call must be done before calling the main procedure or the thread
274 entry. The stack space must exists during all the main run. */
277 __gnat_install_SEH_handler (void *ER
)
281 /* put current handler in ptr */
283 asm ("mov %%fs:(0),%0" : "=r" (ptr
));
285 ((int *)ER
)[0] = (int)ptr
; /* previous handler */
286 ((int *)ER
)[1] = (int)__gnat_SEH_error_handler
; /* new handler */
288 /* ER is the new handler, set fs:(0) with this value */
290 asm volatile ("mov %0,%%fs:(0)": : "r" (ER
));
294 #else /* defined (_WIN32) */
295 /* For all non Windows targets we provide a dummy SEH install handler. */
296 void __gnat_install_SEH_handler (void *eh ATTRIBUTE_UNUSED
)