2 * msvcrt.dll exception handling
4 * Copyright 2000 Jon Griffiths
5 * Copyright 2005 Juan Lang
7 * This library is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU Lesser General Public
9 * License as published by the Free Software Foundation; either
10 * version 2.1 of the License, or (at your option) any later version.
12 * This library is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 * Lesser General Public License for more details.
17 * You should have received a copy of the GNU Lesser General Public
18 * License along with this library; if not, write to the Free Software
19 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
23 * See http://www.microsoft.com/msj/0197/exception/exception.htm,
24 * but don't believe all of it.
26 * FIXME: Incomplete support for nested exceptions/try block cleanup.
30 #include "wine/port.h"
38 #include "wine/exception.h"
42 #include "msvcrt/float.h"
43 #include "msvcrt/signal.h"
44 #include "wine/debug.h"
46 WINE_DEFAULT_DEBUG_CHANNEL(msvcrt);
48 /* VC++ extensions to Win32 SEH */
49 typedef struct _SCOPETABLE
52 int (*lpfnFilter)(PEXCEPTION_POINTERS);
53 int (*lpfnHandler)(void);
54 } SCOPETABLE, *PSCOPETABLE;
56 typedef struct _MSVCRT_EXCEPTION_FRAME
58 EXCEPTION_REGISTRATION_RECORD *prev;
59 void (*handler)(PEXCEPTION_RECORD, EXCEPTION_REGISTRATION_RECORD*,
60 PCONTEXT, PEXCEPTION_RECORD);
61 PSCOPETABLE scopetable;
64 PEXCEPTION_POINTERS xpointers;
65 } MSVCRT_EXCEPTION_FRAME;
67 #define TRYLEVEL_END (-1) /* End of trylevel list */
69 #if defined(__GNUC__) && defined(__i386__)
70 inline static void call_finally_block( void *code_block, void *base_ptr )
72 __asm__ __volatile__ ("movl %1,%%ebp; call *%%eax" \
73 : : "a" (code_block), "g" (base_ptr));
76 inline static DWORD call_filter( void *func, void *arg, void *ebp )
79 __asm__ __volatile__ ("pushl %%ebp; pushl %3; movl %2,%%ebp; call *%%eax; popl %%ebp; popl %%ebp"
81 : "0" (func), "r" (ebp), "r" (arg)
82 : "ecx", "edx", "memory" );
87 static DWORD MSVCRT_nested_handler(PEXCEPTION_RECORD rec,
88 EXCEPTION_REGISTRATION_RECORD* frame,
90 EXCEPTION_REGISTRATION_RECORD** dispatch)
92 if (rec->ExceptionFlags & 0x6)
93 return ExceptionContinueSearch;
95 return ExceptionCollidedUnwind;
99 /*********************************************************************
100 * _EH_prolog (MSVCRT.@)
103 /* Provided for VC++ binary compatibility only */
104 __ASM_GLOBAL_FUNC(_EH_prolog,
108 "movl %esp, %fs:0\n\t"
109 "movl 12(%esp), %eax\n\t"
110 "movl %ebp, 12(%esp)\n\t"
111 "leal 12(%esp), %ebp\n\t"
116 /*******************************************************************
117 * _global_unwind2 (MSVCRT.@)
119 void _global_unwind2(EXCEPTION_REGISTRATION_RECORD* frame)
121 TRACE("(%p)\n",frame);
122 RtlUnwind( frame, 0, 0, 0 );
125 /*******************************************************************
126 * _local_unwind2 (MSVCRT.@)
128 void _local_unwind2(MSVCRT_EXCEPTION_FRAME* frame, int trylevel)
130 MSVCRT_EXCEPTION_FRAME *curframe = frame;
131 EXCEPTION_REGISTRATION_RECORD reg;
133 TRACE("(%p,%d,%d)\n",frame, frame->trylevel, trylevel);
135 /* Register a handler in case of a nested exception */
136 reg.Handler = (PEXCEPTION_HANDLER)MSVCRT_nested_handler;
137 reg.Prev = NtCurrentTeb()->Tib.ExceptionList;
138 __wine_push_frame(®);
140 while (frame->trylevel != TRYLEVEL_END && frame->trylevel != trylevel)
142 int curtrylevel = frame->scopetable[frame->trylevel].previousTryLevel;
144 curframe->trylevel = curtrylevel;
145 if (!frame->scopetable[curtrylevel].lpfnFilter)
147 ERR("__try block cleanup not implemented - expect crash!\n");
148 /* FIXME: Remove current frame, set ebp, call
149 * frame->scopetable[curtrylevel].lpfnHandler()
153 __wine_pop_frame(®);
154 TRACE("unwound OK\n");
157 /*********************************************************************
158 * _except_handler2 (MSVCRT.@)
160 int _except_handler2(PEXCEPTION_RECORD rec,
161 EXCEPTION_REGISTRATION_RECORD* frame,
163 EXCEPTION_REGISTRATION_RECORD** dispatcher)
165 FIXME("exception %lx flags=%lx at %p handler=%p %p %p stub\n",
166 rec->ExceptionCode, rec->ExceptionFlags, rec->ExceptionAddress,
167 frame->Handler, context, dispatcher);
168 return ExceptionContinueSearch;
171 /*********************************************************************
172 * _except_handler3 (MSVCRT.@)
174 int _except_handler3(PEXCEPTION_RECORD rec,
175 MSVCRT_EXCEPTION_FRAME* frame,
176 PCONTEXT context, void* dispatcher)
178 #if defined(__GNUC__) && defined(__i386__)
181 EXCEPTION_POINTERS exceptPtrs;
182 PSCOPETABLE pScopeTable;
184 TRACE("exception %lx flags=%lx at %p handler=%p %p %p semi-stub\n",
185 rec->ExceptionCode, rec->ExceptionFlags, rec->ExceptionAddress,
186 frame->handler, context, dispatcher);
188 __asm__ __volatile__ ("cld");
190 if (rec->ExceptionFlags & (EH_UNWINDING | EH_EXIT_UNWIND))
192 /* Unwinding the current frame */
193 _local_unwind2(frame, TRYLEVEL_END);
194 TRACE("unwound current frame, returning ExceptionContinueSearch\n");
195 return ExceptionContinueSearch;
199 /* Hunting for handler */
200 exceptPtrs.ExceptionRecord = rec;
201 exceptPtrs.ContextRecord = context;
202 *((DWORD *)frame-1) = (DWORD)&exceptPtrs;
203 trylevel = frame->trylevel;
204 pScopeTable = frame->scopetable;
206 while (trylevel != TRYLEVEL_END)
208 if (pScopeTable[trylevel].lpfnFilter)
210 TRACE("filter = %p\n", pScopeTable[trylevel].lpfnFilter);
212 retval = call_filter( pScopeTable[trylevel].lpfnFilter, &exceptPtrs, &frame->_ebp );
214 TRACE("filter returned %s\n", retval == EXCEPTION_CONTINUE_EXECUTION ?
215 "CONTINUE_EXECUTION" : retval == EXCEPTION_EXECUTE_HANDLER ?
216 "EXECUTE_HANDLER" : "CONTINUE_SEARCH");
218 if (retval == EXCEPTION_CONTINUE_EXECUTION)
219 return ExceptionContinueExecution;
221 if (retval == EXCEPTION_EXECUTE_HANDLER)
223 /* Unwind all higher frames, this one will handle the exception */
224 _global_unwind2((EXCEPTION_REGISTRATION_RECORD*)frame);
225 _local_unwind2(frame, trylevel);
227 /* Set our trylevel to the enclosing block, and call the __finally
228 * code, which won't return
230 frame->trylevel = pScopeTable->previousTryLevel;
231 TRACE("__finally block %p\n",pScopeTable[trylevel].lpfnHandler);
232 call_finally_block(pScopeTable[trylevel].lpfnHandler, &frame->_ebp);
233 ERR("Returned from __finally block - expect crash!\n");
236 trylevel = pScopeTable->previousTryLevel;
240 TRACE("exception %lx flags=%lx at %p handler=%p %p %p stub\n",
241 rec->ExceptionCode, rec->ExceptionFlags, rec->ExceptionAddress,
242 frame->handler, context, dispatcher);
244 TRACE("reached TRYLEVEL_END, returning ExceptionContinueSearch\n");
245 return ExceptionContinueSearch;
248 /*********************************************************************
249 * _abnormal_termination (MSVCRT.@)
251 int _abnormal_termination(void)
253 FIXME("(void)stub\n");
258 * setjmp/longjmp implementation
262 #define MSVCRT_JMP_MAGIC 0x56433230 /* ID value for new jump structure */
263 typedef void (*MSVCRT_unwind_function)(const void*);
266 * The signatures of the setjmp/longjmp functions do not match that
267 * declared in the setjmp header so they don't follow the regular naming
268 * convention to avoid conflicts.
271 /*******************************************************************
274 DEFINE_REGS_ENTRYPOINT( MSVCRT__setjmp, 4, 0 );
275 void WINAPI __regs_MSVCRT__setjmp(struct MSVCRT___JUMP_BUFFER *jmp, CONTEXT86* context)
278 jmp->Ebp = context->Ebp;
279 jmp->Ebx = context->Ebx;
280 jmp->Edi = context->Edi;
281 jmp->Esi = context->Esi;
282 jmp->Esp = context->Esp;
283 jmp->Eip = context->Eip;
284 jmp->Registration = (unsigned long)NtCurrentTeb()->Tib.ExceptionList;
285 if (jmp->Registration == TRYLEVEL_END)
286 jmp->TryLevel = TRYLEVEL_END;
288 jmp->TryLevel = ((MSVCRT_EXCEPTION_FRAME*)jmp->Registration)->trylevel;
289 TRACE("returning 0\n");
293 /*******************************************************************
294 * _setjmp3 (MSVCRT.@)
296 DEFINE_REGS_ENTRYPOINT( MSVCRT__setjmp3, 8, 0 );
297 void WINAPI __regs_MSVCRT__setjmp3(struct MSVCRT___JUMP_BUFFER *jmp, int nb_args, CONTEXT86* context)
299 TRACE("(%p,%d)\n",jmp,nb_args);
300 jmp->Ebp = context->Ebp;
301 jmp->Ebx = context->Ebx;
302 jmp->Edi = context->Edi;
303 jmp->Esi = context->Esi;
304 jmp->Esp = context->Esp;
305 jmp->Eip = context->Eip;
306 jmp->Cookie = MSVCRT_JMP_MAGIC;
308 jmp->Registration = (unsigned long)NtCurrentTeb()->Tib.ExceptionList;
309 if (jmp->Registration == TRYLEVEL_END)
311 jmp->TryLevel = TRYLEVEL_END;
315 void **args = ((void**)context->Esp)+2;
317 if (nb_args > 0) jmp->UnwindFunc = (unsigned long)*args++;
318 if (nb_args > 1) jmp->TryLevel = (unsigned long)*args++;
319 else jmp->TryLevel = ((MSVCRT_EXCEPTION_FRAME*)jmp->Registration)->trylevel;
322 size_t size = (nb_args - 2) * sizeof(DWORD);
323 memcpy( jmp->UnwindData, args, min( size, sizeof(jmp->UnwindData) ));
326 TRACE("returning 0\n");
330 /*********************************************************************
333 DEFINE_REGS_ENTRYPOINT( MSVCRT_longjmp, 8, 0 );
334 void WINAPI __regs_MSVCRT_longjmp(struct MSVCRT___JUMP_BUFFER *jmp, int retval, CONTEXT86* context)
336 unsigned long cur_frame = 0;
338 TRACE("(%p,%d)\n", jmp, retval);
340 cur_frame=(unsigned long)NtCurrentTeb()->Tib.ExceptionList;
341 TRACE("cur_frame=%lx\n",cur_frame);
343 if (cur_frame != jmp->Registration)
344 _global_unwind2((EXCEPTION_REGISTRATION_RECORD*)jmp->Registration);
346 if (jmp->Registration)
348 if (!IsBadReadPtr(&jmp->Cookie, sizeof(long)) &&
349 jmp->Cookie == MSVCRT_JMP_MAGIC && jmp->UnwindFunc)
351 MSVCRT_unwind_function unwind_func;
353 unwind_func=(MSVCRT_unwind_function)jmp->UnwindFunc;
357 _local_unwind2((MSVCRT_EXCEPTION_FRAME*)jmp->Registration,
364 TRACE("Jump to %lx returning %d\n",jmp->Eip,retval);
365 context->Ebp = jmp->Ebp;
366 context->Ebx = jmp->Ebx;
367 context->Edi = jmp->Edi;
368 context->Esi = jmp->Esi;
369 context->Esp = jmp->Esp;
370 context->Eip = jmp->Eip;
371 context->Eax = retval;
374 /*********************************************************************
375 * _seh_longjmp_unwind (MSVCRT.@)
377 void __stdcall _seh_longjmp_unwind(struct MSVCRT___JUMP_BUFFER *jmp)
379 _local_unwind2( (MSVCRT_EXCEPTION_FRAME *)jmp->Registration, jmp->TryLevel );
383 static __sighandler_t sighandlers[NSIG] = { SIG_DFL };
385 static BOOL WINAPI msvcrt_console_handler(DWORD ctrlType)
392 if (sighandlers[SIGINT])
394 if (sighandlers[SIGINT] != SIG_IGN)
395 sighandlers[SIGINT](SIGINT);
403 typedef void (*float_handler)(int, int);
405 /* The exception codes are actually NTSTATUS values */
410 } float_exception_map[] = {
411 { EXCEPTION_FLT_DENORMAL_OPERAND, _FPE_DENORMAL },
412 { EXCEPTION_FLT_DIVIDE_BY_ZERO, _FPE_ZERODIVIDE },
413 { EXCEPTION_FLT_INEXACT_RESULT, _FPE_INEXACT },
414 { EXCEPTION_FLT_INVALID_OPERATION, _FPE_INVALID },
415 { EXCEPTION_FLT_OVERFLOW, _FPE_OVERFLOW },
416 { EXCEPTION_FLT_STACK_CHECK, _FPE_STACKOVERFLOW },
417 { EXCEPTION_FLT_UNDERFLOW, _FPE_UNDERFLOW },
420 static LONG WINAPI msvcrt_exception_filter(struct _EXCEPTION_POINTERS *except)
422 LONG ret = EXCEPTION_CONTINUE_SEARCH;
424 if (!except || !except->ExceptionRecord)
425 return EXCEPTION_CONTINUE_SEARCH;
427 switch (except->ExceptionRecord->ExceptionCode)
429 case EXCEPTION_ACCESS_VIOLATION:
430 if (sighandlers[SIGSEGV])
432 if (sighandlers[SIGSEGV] != SIG_IGN)
433 sighandlers[SIGSEGV](SIGSEGV);
434 ret = EXCEPTION_CONTINUE_EXECUTION;
438 * http://msdn.microsoft.com/library/en-us/vclib/html/_CRT_signal.asp
439 * the FPE signal handler takes as a second argument the type of
440 * floating point exception.
442 case EXCEPTION_FLT_DENORMAL_OPERAND:
443 case EXCEPTION_FLT_DIVIDE_BY_ZERO:
444 case EXCEPTION_FLT_INEXACT_RESULT:
445 case EXCEPTION_FLT_INVALID_OPERATION:
446 case EXCEPTION_FLT_OVERFLOW:
447 case EXCEPTION_FLT_STACK_CHECK:
448 case EXCEPTION_FLT_UNDERFLOW:
449 if (sighandlers[SIGFPE])
451 if (sighandlers[SIGFPE] != SIG_IGN)
453 int i, float_signal = _FPE_INVALID;
455 float_handler handler = (float_handler)sighandlers[SIGFPE];
456 for (i = 0; i < sizeof(float_exception_map) /
457 sizeof(float_exception_map[0]); i++)
458 if (float_exception_map[i].status ==
459 except->ExceptionRecord->ExceptionCode)
461 float_signal = float_exception_map[i].signal;
464 handler(SIGFPE, float_signal);
466 ret = EXCEPTION_CONTINUE_EXECUTION;
469 case EXCEPTION_ILLEGAL_INSTRUCTION:
470 if (sighandlers[SIGILL])
472 if (sighandlers[SIGILL] != SIG_IGN)
473 sighandlers[SIGILL](SIGILL);
474 ret = EXCEPTION_CONTINUE_EXECUTION;
481 void msvcrt_init_signals(void)
483 SetConsoleCtrlHandler(msvcrt_console_handler, TRUE);
484 SetUnhandledExceptionFilter(msvcrt_exception_filter);
487 void msvcrt_free_signals(void)
489 SetConsoleCtrlHandler(msvcrt_console_handler, FALSE);
490 SetUnhandledExceptionFilter(NULL);
493 /*********************************************************************
495 * MS signal handling is described here:
496 * http://msdn.microsoft.com/library/en-us/vclib/html/_CRT_signal.asp
497 * Some signals may never be generated except through an explicit call to
500 __sighandler_t MSVCRT_signal(int sig, __sighandler_t func)
502 __sighandler_t ret = SIG_ERR;
504 TRACE("(%d, %p)\n", sig, func);
506 if (func == SIG_ERR) return SIG_ERR;
510 /* Cases handled internally. Note SIGTERM is never generated by Windows,
511 * so we effectively mask it.
519 ret = sighandlers[sig];
520 sighandlers[sig] = func;
528 /*********************************************************************
529 * _XcptFilter (MSVCRT.@)
531 int _XcptFilter(NTSTATUS ex, PEXCEPTION_POINTERS ptr)
533 TRACE("(%ld,%p)\n", ex, ptr);
534 /* I assume ptr->ExceptionRecord->ExceptionCode is the same as ex */
535 return msvcrt_exception_filter(ptr);