2 * msvcrt C++ exception handling
4 * Copyright 2002 Alexandre Julliard
6 * This library is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU Lesser General Public
8 * License as published by the Free Software Foundation; either
9 * version 2.1 of the License, or (at your option) any later version.
11 * This library is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 * Lesser General Public License for more details.
16 * You should have received a copy of the GNU Lesser General Public
17 * License along with this library; if not, write to the Free Software
18 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
21 * A good reference is the article "How a C++ compiler implements
22 * exception handling" by Vishal Kochhar, available on
23 * www.thecodeproject.com.
27 #include "wine/port.h"
36 #include "wine/exception.h"
38 #include "wine/debug.h"
40 #include "cppexcept.h"
42 WINE_DEFAULT_DEBUG_CHANNEL(seh);
44 #ifdef __i386__ /* CxxFrameHandler is not supported on non-i386 */
46 DWORD CDECL cxx_frame_handler( PEXCEPTION_RECORD rec, cxx_exception_frame* frame,
47 PCONTEXT context, EXCEPTION_REGISTRATION_RECORD** dispatch,
48 cxx_function_descr *descr, EXCEPTION_REGISTRATION_RECORD* nested_frame,
49 int nested_trylevel );
51 /* call a function with a given ebp */
52 inline static void *call_ebp_func( void *func, void *ebp )
56 __asm__ __volatile__ ("pushl %%ebx\n\t"
62 : "=a" (ret), "=S" (dummy), "=D" (dummy)
63 : "0" (func), "1" (ebp) : "ecx", "edx", "memory" );
67 /* call a copy constructor */
68 inline static void call_copy_ctor( void *func, void *this, void *src, int has_vbase )
70 TRACE( "calling copy ctor %p object %p src %p\n", func, this, src );
72 /* in that case copy ctor takes an extra bool indicating whether to copy the base class */
73 __asm__ __volatile__("pushl $1; pushl %2; call *%0"
74 : : "r" (func), "c" (this), "r" (src) : "eax", "edx", "memory" );
76 __asm__ __volatile__("pushl %2; call *%0"
77 : : "r" (func), "c" (this), "r" (src) : "eax", "edx", "memory" );
80 /* call the destructor of the exception object */
81 inline static void call_dtor( void *func, void *object )
83 __asm__ __volatile__("call *%0" : : "r" (func), "c" (object) : "eax", "edx", "memory" );
86 /* continue execution to the specified address after exception is caught */
87 inline static void DECLSPEC_NORETURN continue_after_catch( cxx_exception_frame* frame, void *addr )
89 __asm__ __volatile__("movl -4(%0),%%esp; leal 12(%0),%%ebp; jmp *%1"
90 : : "r" (frame), "a" (addr) );
91 for (;;) ; /* unreached */
94 static inline void dump_type( const cxx_type_info *type )
96 TRACE( "flags %x type %p %s offsets %d,%d,%d size %d copy ctor %p\n",
97 type->flags, type->type_info, dbgstr_type_info(type->type_info),
98 type->offsets.this_offset, type->offsets.vbase_descr, type->offsets.vbase_offset,
99 type->size, type->copy_ctor );
102 static void dump_exception_type( const cxx_exception_type *type )
106 TRACE( "flags %x destr %p handler %p type info %p\n",
107 type->flags, type->destructor, type->custom_handler, type->type_info_table );
108 for (i = 0; i < type->type_info_table->count; i++)
111 dump_type( type->type_info_table->info[i] );
115 static void dump_function_descr( const cxx_function_descr *descr, const cxx_exception_type *info )
120 TRACE( "magic %x\n", descr->magic );
121 TRACE( "unwind table: %p %d\n", descr->unwind_table, descr->unwind_count );
122 for (i = 0; i < descr->unwind_count; i++)
124 TRACE( " %d: prev %d func %p\n", i,
125 descr->unwind_table[i].prev, descr->unwind_table[i].handler );
127 TRACE( "try table: %p %d\n", descr->tryblock, descr->tryblock_count );
128 for (i = 0; i < descr->tryblock_count; i++)
130 TRACE( " %d: start %d end %d catchlevel %d catch %p %d\n", i,
131 descr->tryblock[i].start_level, descr->tryblock[i].end_level,
132 descr->tryblock[i].catch_level, descr->tryblock[i].catchblock,
133 descr->tryblock[i].catchblock_count );
134 for (j = 0; j < descr->tryblock[i].catchblock_count; j++)
136 catchblock_info *ptr = &descr->tryblock[i].catchblock[j];
137 TRACE( " %d: flags %x offset %d handler %p type %p %s\n",
138 j, ptr->flags, ptr->offset, ptr->handler,
139 ptr->type_info, dbgstr_type_info( ptr->type_info ) );
144 /* check if the exception type is caught by a given catch block, and return the type that matched */
145 static const cxx_type_info *find_caught_type( cxx_exception_type *exc_type, catchblock_info *catchblock )
149 for (i = 0; i < exc_type->type_info_table->count; i++)
151 const cxx_type_info *type = exc_type->type_info_table->info[i];
153 if (!catchblock->type_info) return type; /* catch(...) matches any type */
154 if (catchblock->type_info != type->type_info)
156 if (strcmp( catchblock->type_info->mangled, type->type_info->mangled )) continue;
158 /* type is the same, now check the flags */
159 if ((exc_type->flags & TYPE_FLAG_CONST) &&
160 !(catchblock->flags & TYPE_FLAG_CONST)) continue;
161 if ((exc_type->flags & TYPE_FLAG_VOLATILE) &&
162 !(catchblock->flags & TYPE_FLAG_VOLATILE)) continue;
163 return type; /* it matched */
169 /* copy the exception object where the catch block wants it */
170 static void copy_exception( void *object, cxx_exception_frame *frame,
171 catchblock_info *catchblock, const cxx_type_info *type )
175 if (!catchblock->type_info || !catchblock->type_info->mangled[0]) return;
176 if (!catchblock->offset) return;
177 dest_ptr = (void **)((char *)&frame->ebp + catchblock->offset);
179 if (catchblock->flags & TYPE_FLAG_REFERENCE)
181 *dest_ptr = get_this_pointer( &type->offsets, object );
183 else if (type->flags & CLASS_IS_SIMPLE_TYPE)
185 memmove( dest_ptr, object, type->size );
186 /* if it is a pointer, adjust it */
187 if (type->size == sizeof(void *)) *dest_ptr = get_this_pointer( &type->offsets, *dest_ptr );
189 else /* copy the object */
192 call_copy_ctor( type->copy_ctor, dest_ptr, get_this_pointer(&type->offsets,object),
193 (type->flags & CLASS_HAS_VIRTUAL_BASE_CLASS) );
195 memmove( dest_ptr, get_this_pointer(&type->offsets,object), type->size );
199 /* unwind the local function up to a given trylevel */
200 static void cxx_local_unwind( cxx_exception_frame* frame, cxx_function_descr *descr, int last_level)
203 int trylevel = frame->trylevel;
205 while (trylevel != last_level)
207 if (trylevel < 0 || trylevel >= descr->unwind_count)
209 ERR( "invalid trylevel %d\n", trylevel );
212 handler = descr->unwind_table[trylevel].handler;
215 TRACE( "calling unwind handler %p trylevel %d last %d ebp %p\n",
216 handler, trylevel, last_level, &frame->ebp );
217 call_ebp_func( handler, &frame->ebp );
219 trylevel = descr->unwind_table[trylevel].prev;
221 frame->trylevel = last_level;
224 /* exception frame for nested exceptions in catch block */
225 struct catch_func_nested_frame
227 EXCEPTION_REGISTRATION_RECORD frame; /* standard exception frame */
228 EXCEPTION_RECORD *prev_rec; /* previous record to restore in thread data */
229 cxx_exception_frame *cxx_frame; /* frame of parent exception */
230 cxx_function_descr *descr; /* descriptor of parent exception */
231 int trylevel; /* current try level */
232 EXCEPTION_RECORD *rec; /* rec associated with frame */
235 /* handler for exceptions happening while calling a catch function */
236 static DWORD catch_function_nested_handler( EXCEPTION_RECORD *rec, EXCEPTION_REGISTRATION_RECORD *frame,
237 CONTEXT *context, EXCEPTION_REGISTRATION_RECORD **dispatcher )
239 struct catch_func_nested_frame *nested_frame = (struct catch_func_nested_frame *)frame;
241 if (rec->ExceptionFlags & (EH_UNWINDING | EH_EXIT_UNWIND))
243 msvcrt_get_thread_data()->exc_record = nested_frame->prev_rec;
244 return ExceptionContinueSearch;
247 TRACE( "got nested exception in catch function\n" );
249 if(rec->ExceptionCode == CXX_EXCEPTION)
251 PEXCEPTION_RECORD prev_rec = nested_frame->rec;
252 if(rec->ExceptionInformation[1] == 0 && rec->ExceptionInformation[2] == 0)
254 /* exception was rethrown */
255 rec->ExceptionInformation[1] = prev_rec->ExceptionInformation[1];
256 rec->ExceptionInformation[2] = prev_rec->ExceptionInformation[2];
257 TRACE("detect rethrow: re-propagate: obj: %lx, type: %lx\n",
258 rec->ExceptionInformation[1], rec->ExceptionInformation[2]);
261 /* new exception in exception handler, destroy old */
262 void *object = (void*)prev_rec->ExceptionInformation[1];
263 cxx_exception_type *info = (cxx_exception_type*) prev_rec->ExceptionInformation[2];
264 TRACE("detect threw new exception in catch block - destroy old(obj: %p type: %p)\n",
266 if(info && info->destructor)
267 call_dtor( info->destructor, object );
271 return cxx_frame_handler( rec, nested_frame->cxx_frame, context,
272 NULL, nested_frame->descr, &nested_frame->frame,
273 nested_frame->trylevel );
276 /* find and call the appropriate catch block for an exception */
277 /* returns the address to continue execution to after the catch block was called */
278 inline static void call_catch_block( PEXCEPTION_RECORD rec, cxx_exception_frame *frame,
279 cxx_function_descr *descr, int nested_trylevel,
280 cxx_exception_type *info )
284 void *addr, *object = (void *)rec->ExceptionInformation[1];
285 struct catch_func_nested_frame nested_frame;
286 int trylevel = frame->trylevel;
287 thread_data_t *thread_data = msvcrt_get_thread_data();
288 DWORD save_esp = ((DWORD*)frame)[-1];
290 for (i = 0; i < descr->tryblock_count; i++)
292 tryblock_info *tryblock = &descr->tryblock[i];
294 if (trylevel < tryblock->start_level) continue;
295 if (trylevel > tryblock->end_level) continue;
297 /* got a try block */
298 for (j = 0; j < tryblock->catchblock_count; j++)
300 catchblock_info *catchblock = &tryblock->catchblock[j];
303 const cxx_type_info *type = find_caught_type( info, catchblock );
306 TRACE( "matched type %p in tryblock %d catchblock %d\n", type, i, j );
308 /* copy the exception to its destination on the stack */
309 copy_exception( object, frame, catchblock, type );
313 /* no CXX_EXCEPTION only proceed with a catch(...) block*/
314 if(catchblock->type_info)
316 TRACE("found catch(...) block\n");
319 /* unwind the stack */
320 RtlUnwind( frame, 0, rec, 0 );
321 cxx_local_unwind( frame, descr, tryblock->start_level );
322 frame->trylevel = tryblock->end_level + 1;
324 /* call the catch block */
325 TRACE( "calling catch block %p addr %p ebp %p\n",
326 catchblock, catchblock->handler, &frame->ebp );
328 /* setup an exception block for nested exceptions */
330 nested_frame.frame.Handler = catch_function_nested_handler;
331 nested_frame.prev_rec = thread_data->exc_record;
332 nested_frame.cxx_frame = frame;
333 nested_frame.descr = descr;
334 nested_frame.trylevel = nested_trylevel + 1;
335 nested_frame.rec = rec;
337 __wine_push_frame( &nested_frame.frame );
338 thread_data->exc_record = rec;
339 addr = call_ebp_func( catchblock->handler, &frame->ebp );
340 thread_data->exc_record = nested_frame.prev_rec;
341 __wine_pop_frame( &nested_frame.frame );
343 ((DWORD*)frame)[-1] = save_esp;
344 if (info && info->destructor) call_dtor( info->destructor, object );
345 TRACE( "done, continuing at %p\n", addr );
347 continue_after_catch( frame, addr );
353 /*********************************************************************
356 * Implementation of __CxxFrameHandler.
358 DWORD CDECL cxx_frame_handler( PEXCEPTION_RECORD rec, cxx_exception_frame* frame,
359 PCONTEXT context, EXCEPTION_REGISTRATION_RECORD** dispatch,
360 cxx_function_descr *descr, EXCEPTION_REGISTRATION_RECORD* nested_frame,
361 int nested_trylevel )
363 cxx_exception_type *exc_type;
365 if (descr->magic != CXX_FRAME_MAGIC)
367 ERR( "invalid frame magic %x\n", descr->magic );
368 return ExceptionContinueSearch;
370 if (rec->ExceptionFlags & (EH_UNWINDING|EH_EXIT_UNWIND))
372 if (descr->unwind_count && !nested_trylevel) cxx_local_unwind( frame, descr, -1 );
373 return ExceptionContinueSearch;
375 if (!descr->tryblock_count) return ExceptionContinueSearch;
377 if(rec->ExceptionCode == CXX_EXCEPTION)
379 exc_type = (cxx_exception_type *)rec->ExceptionInformation[2];
381 if (rec->ExceptionInformation[0] > CXX_FRAME_MAGIC &&
382 exc_type->custom_handler)
384 return exc_type->custom_handler( rec, frame, context, dispatch,
385 descr, nested_trylevel, nested_frame, 0 );
390 TRACE("handling C++ exception rec %p frame %p trylevel %d descr %p nested_frame %p\n",
391 rec, frame, frame->trylevel, descr, nested_frame );
392 dump_exception_type( exc_type );
393 dump_function_descr( descr, exc_type );
399 TRACE("handling C exception code %lx rec %p frame %p trylevel %d descr %p nested_frame %p\n",
400 rec->ExceptionCode, rec, frame, frame->trylevel, descr, nested_frame );
403 call_catch_block( rec, frame, descr, frame->trylevel, exc_type );
404 return ExceptionContinueSearch;
408 /*********************************************************************
409 * __CxxFrameHandler (MSVCRT.@)
411 extern DWORD CDECL __CxxFrameHandler( PEXCEPTION_RECORD rec, EXCEPTION_REGISTRATION_RECORD* frame,
412 PCONTEXT context, EXCEPTION_REGISTRATION_RECORD** dispatch );
413 __ASM_GLOBAL_FUNC( __CxxFrameHandler,
414 "pushl $0\n\t" /* nested_trylevel */
415 "pushl $0\n\t" /* nested_frame */
416 "pushl %eax\n\t" /* descr */
417 "pushl 28(%esp)\n\t" /* dispatch */
418 "pushl 28(%esp)\n\t" /* context */
419 "pushl 28(%esp)\n\t" /* frame */
420 "pushl 28(%esp)\n\t" /* rec */
421 "call " __ASM_NAME("cxx_frame_handler") "\n\t"
425 #endif /* __i386__ */
427 /*********************************************************************
428 * _CxxThrowException (MSVCRT.@)
430 void CDECL _CxxThrowException( exception *object, const cxx_exception_type *type )
434 args[0] = CXX_FRAME_MAGIC;
435 args[1] = (ULONG_PTR)object;
436 args[2] = (ULONG_PTR)type;
437 RaiseException( CXX_EXCEPTION, EH_NONCONTINUABLE, 3, args );
440 /*********************************************************************
441 * __CxxDetectRethrow (MSVCRT.@)
443 BOOL CDECL __CxxDetectRethrow(PEXCEPTION_POINTERS ptrs)
445 PEXCEPTION_RECORD rec;
450 rec = ptrs->ExceptionRecord;
452 if (rec->ExceptionCode == CXX_EXCEPTION &&
453 rec->NumberParameters == 3 &&
454 rec->ExceptionInformation[0] == CXX_FRAME_MAGIC &&
455 rec->ExceptionInformation[2])
457 ptrs->ExceptionRecord = msvcrt_get_thread_data()->exc_record;
460 return (msvcrt_get_thread_data()->exc_record == rec);
463 /*********************************************************************
464 * __CxxQueryExceptionSize (MSVCRT.@)
466 unsigned int CDECL __CxxQueryExceptionSize(void)
468 return sizeof(cxx_exception_type);