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"
35 #include "wine/exception.h"
37 #include "wine/debug.h"
39 #include "cppexcept.h"
41 #ifdef __i386__ /* CxxFrameHandler is not supported on non-i386 */
43 WINE_DEFAULT_DEBUG_CHANNEL(seh
);
45 DWORD CDECL
cxx_frame_handler( PEXCEPTION_RECORD rec
, cxx_exception_frame
* frame
,
46 PCONTEXT context
, EXCEPTION_REGISTRATION_RECORD
** dispatch
,
47 const cxx_function_descr
*descr
,
48 EXCEPTION_REGISTRATION_RECORD
* nested_frame
, int nested_trylevel
);
50 /* call a function with a given ebp */
51 static inline void *call_ebp_func( void *func
, void *ebp
)
55 __asm__
__volatile__ ("pushl %%ebx\n\t"
61 : "=a" (ret
), "=S" (dummy
), "=D" (dummy
)
62 : "0" (func
), "1" (ebp
) : "ecx", "edx", "memory" );
66 /* call a copy constructor */
67 static inline void call_copy_ctor( void *func
, void *this, void *src
, int has_vbase
)
69 TRACE( "calling copy ctor %p object %p src %p\n", func
, this, src
);
71 /* in that case copy ctor takes an extra bool indicating whether to copy the base class */
72 __asm__
__volatile__("pushl $1; pushl %2; call *%0"
73 : : "r" (func
), "c" (this), "r" (src
) : "eax", "edx", "memory" );
75 __asm__
__volatile__("pushl %2; call *%0"
76 : : "r" (func
), "c" (this), "r" (src
) : "eax", "edx", "memory" );
79 /* call the destructor of the exception object */
80 static inline void call_dtor( void *func
, void *object
)
82 __asm__
__volatile__("call *%0" : : "r" (func
), "c" (object
) : "eax", "edx", "memory" );
85 /* continue execution to the specified address after exception is caught */
86 static inline void DECLSPEC_NORETURN
continue_after_catch( cxx_exception_frame
* frame
, void *addr
)
88 __asm__
__volatile__("movl -4(%0),%%esp; leal 12(%0),%%ebp; jmp *%1"
89 : : "r" (frame
), "a" (addr
) );
90 for (;;) ; /* unreached */
93 static inline void dump_type( const cxx_type_info
*type
)
95 TRACE( "flags %x type %p %s offsets %d,%d,%d size %d copy ctor %p\n",
96 type
->flags
, type
->type_info
, dbgstr_type_info(type
->type_info
),
97 type
->offsets
.this_offset
, type
->offsets
.vbase_descr
, type
->offsets
.vbase_offset
,
98 type
->size
, type
->copy_ctor
);
101 static void dump_exception_type( const cxx_exception_type
*type
)
105 TRACE( "flags %x destr %p handler %p type info %p\n",
106 type
->flags
, type
->destructor
, type
->custom_handler
, type
->type_info_table
);
107 for (i
= 0; i
< type
->type_info_table
->count
; i
++)
110 dump_type( type
->type_info_table
->info
[i
] );
114 static void dump_function_descr( const cxx_function_descr
*descr
)
119 TRACE( "magic %x\n", descr
->magic
);
120 TRACE( "unwind table: %p %d\n", descr
->unwind_table
, descr
->unwind_count
);
121 for (i
= 0; i
< descr
->unwind_count
; i
++)
123 TRACE( " %d: prev %d func %p\n", i
,
124 descr
->unwind_table
[i
].prev
, descr
->unwind_table
[i
].handler
);
126 TRACE( "try table: %p %d\n", descr
->tryblock
, descr
->tryblock_count
);
127 for (i
= 0; i
< descr
->tryblock_count
; i
++)
129 TRACE( " %d: start %d end %d catchlevel %d catch %p %d\n", i
,
130 descr
->tryblock
[i
].start_level
, descr
->tryblock
[i
].end_level
,
131 descr
->tryblock
[i
].catch_level
, descr
->tryblock
[i
].catchblock
,
132 descr
->tryblock
[i
].catchblock_count
);
133 for (j
= 0; j
< descr
->tryblock
[i
].catchblock_count
; j
++)
135 const catchblock_info
*ptr
= &descr
->tryblock
[i
].catchblock
[j
];
136 TRACE( " %d: flags %x offset %d handler %p type %p %s\n",
137 j
, ptr
->flags
, ptr
->offset
, ptr
->handler
,
138 ptr
->type_info
, dbgstr_type_info( ptr
->type_info
) );
143 /* check if the exception type is caught by a given catch block, and return the type that matched */
144 static const cxx_type_info
*find_caught_type( cxx_exception_type
*exc_type
,
145 const 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 const 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
, const 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 const 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 static inline void call_catch_block( PEXCEPTION_RECORD rec
, cxx_exception_frame
*frame
,
279 const 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 const 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 const 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 const cxx_function_descr
*descr
,
361 EXCEPTION_REGISTRATION_RECORD
* nested_frame
,
362 int nested_trylevel
)
364 cxx_exception_type
*exc_type
;
366 if (descr
->magic
!= CXX_FRAME_MAGIC
)
368 ERR( "invalid frame magic %x\n", descr
->magic
);
369 return ExceptionContinueSearch
;
371 if (rec
->ExceptionFlags
& (EH_UNWINDING
|EH_EXIT_UNWIND
))
373 if (descr
->unwind_count
&& !nested_trylevel
) cxx_local_unwind( frame
, descr
, -1 );
374 return ExceptionContinueSearch
;
376 if (!descr
->tryblock_count
) return ExceptionContinueSearch
;
378 if(rec
->ExceptionCode
== CXX_EXCEPTION
)
380 exc_type
= (cxx_exception_type
*)rec
->ExceptionInformation
[2];
382 if (rec
->ExceptionInformation
[0] > CXX_FRAME_MAGIC
&&
383 exc_type
->custom_handler
)
385 return exc_type
->custom_handler( rec
, frame
, context
, dispatch
,
386 descr
, nested_trylevel
, nested_frame
, 0 );
391 TRACE("handling C++ exception rec %p frame %p trylevel %d descr %p nested_frame %p\n",
392 rec
, frame
, frame
->trylevel
, descr
, nested_frame
);
393 dump_exception_type( exc_type
);
394 dump_function_descr( descr
);
400 TRACE("handling C exception code %x rec %p frame %p trylevel %d descr %p nested_frame %p\n",
401 rec
->ExceptionCode
, rec
, frame
, frame
->trylevel
, descr
, nested_frame
);
404 call_catch_block( rec
, frame
, descr
, frame
->trylevel
, exc_type
);
405 return ExceptionContinueSearch
;
409 /*********************************************************************
410 * __CxxFrameHandler (MSVCRT.@)
412 extern DWORD CDECL
__CxxFrameHandler( PEXCEPTION_RECORD rec
, EXCEPTION_REGISTRATION_RECORD
* frame
,
413 PCONTEXT context
, EXCEPTION_REGISTRATION_RECORD
** dispatch
);
414 __ASM_GLOBAL_FUNC( __CxxFrameHandler
,
415 "pushl $0\n\t" /* nested_trylevel */
416 "pushl $0\n\t" /* nested_frame */
417 "pushl %eax\n\t" /* descr */
418 "pushl 28(%esp)\n\t" /* dispatch */
419 "pushl 28(%esp)\n\t" /* context */
420 "pushl 28(%esp)\n\t" /* frame */
421 "pushl 28(%esp)\n\t" /* rec */
422 "call " __ASM_NAME("cxx_frame_handler") "\n\t"
427 /*********************************************************************
428 * __CxxLongjmpUnwind (MSVCRT.@)
430 * Callback meant to be used as UnwindFunc for setjmp/longjmp.
432 void __stdcall
__CxxLongjmpUnwind( const struct MSVCRT___JUMP_BUFFER
*buf
)
434 cxx_exception_frame
*frame
= (cxx_exception_frame
*)buf
->Registration
;
435 const cxx_function_descr
*descr
= (const cxx_function_descr
*)buf
->UnwindData
[0];
437 TRACE( "unwinding frame %p descr %p trylevel %ld\n", frame
, descr
, buf
->TryLevel
);
438 cxx_local_unwind( frame
, descr
, buf
->TryLevel
);
441 #endif /* __i386__ */
444 /*********************************************************************
445 * __CppXcptFilter (MSVCRT.@)
447 int CDECL
__CppXcptFilter(NTSTATUS ex
, PEXCEPTION_POINTERS ptr
)
449 /* only filter c++ exceptions */
450 if (ex
!= CXX_EXCEPTION
) return EXCEPTION_CONTINUE_SEARCH
;
451 return _XcptFilter( ex
, ptr
);
454 /*********************************************************************
455 * _CxxThrowException (MSVCRT.@)
457 void CDECL
_CxxThrowException( exception
*object
, const cxx_exception_type
*type
)
461 args
[0] = CXX_FRAME_MAGIC
;
462 args
[1] = (ULONG_PTR
)object
;
463 args
[2] = (ULONG_PTR
)type
;
464 RaiseException( CXX_EXCEPTION
, EH_NONCONTINUABLE
, 3, args
);
467 /*********************************************************************
468 * __CxxDetectRethrow (MSVCRT.@)
470 BOOL CDECL
__CxxDetectRethrow(PEXCEPTION_POINTERS ptrs
)
472 PEXCEPTION_RECORD rec
;
477 rec
= ptrs
->ExceptionRecord
;
479 if (rec
->ExceptionCode
== CXX_EXCEPTION
&&
480 rec
->NumberParameters
== 3 &&
481 rec
->ExceptionInformation
[0] == CXX_FRAME_MAGIC
&&
482 rec
->ExceptionInformation
[2])
484 ptrs
->ExceptionRecord
= msvcrt_get_thread_data()->exc_record
;
487 return (msvcrt_get_thread_data()->exc_record
== rec
);
490 /*********************************************************************
491 * __CxxQueryExceptionSize (MSVCRT.@)
493 unsigned int CDECL
__CxxQueryExceptionSize(void)
495 return sizeof(cxx_exception_type
);