1999-05-12 15:10:39 +02:00
|
|
|
/*
|
|
|
|
* Wine exception handling
|
|
|
|
*
|
|
|
|
* Copyright (c) 1999 Alexandre Julliard
|
|
|
|
*/
|
|
|
|
|
|
|
|
#ifndef __WINE_WINE_EXCEPTION_H
|
|
|
|
#define __WINE_WINE_EXCEPTION_H
|
|
|
|
|
|
|
|
#include <setjmp.h>
|
|
|
|
#include "winnt.h"
|
|
|
|
#include "thread.h"
|
|
|
|
|
|
|
|
/* The following definitions allow using exceptions in Wine and Winelib code
|
|
|
|
*
|
|
|
|
* They should be used like this:
|
|
|
|
*
|
1999-05-14 20:21:55 +02:00
|
|
|
* __TRY
|
1999-05-12 15:10:39 +02:00
|
|
|
* {
|
|
|
|
* do some stuff that can raise an exception
|
|
|
|
* }
|
|
|
|
* __EXCEPT(filter_func,param)
|
|
|
|
* {
|
|
|
|
* handle the exception here
|
|
|
|
* }
|
1999-05-14 20:21:55 +02:00
|
|
|
* __ENDTRY
|
1999-05-12 15:10:39 +02:00
|
|
|
*
|
|
|
|
* or
|
|
|
|
*
|
1999-05-14 20:21:55 +02:00
|
|
|
* __TRY
|
1999-05-12 15:10:39 +02:00
|
|
|
* {
|
|
|
|
* do some stuff that can raise an exception
|
|
|
|
* }
|
|
|
|
* __FINALLY(finally_func,param)
|
|
|
|
*
|
|
|
|
* The filter_func must be defined with the WINE_EXCEPTION_FILTER
|
|
|
|
* macro, and return one of the EXCEPTION_* code; it can use
|
|
|
|
* GetExceptionInformation and GetExceptionCode to retrieve the
|
|
|
|
* exception info.
|
|
|
|
*
|
|
|
|
* The finally_func must be defined with the WINE_FINALLY_FUNC macro.
|
|
|
|
*
|
1999-05-14 20:21:55 +02:00
|
|
|
* Warning: inside a __TRY or __EXCEPT block, 'break' or 'continue' statements
|
1999-06-18 20:26:35 +02:00
|
|
|
* break out of the current block. You cannot use 'return', 'goto'
|
|
|
|
* or 'longjmp' to leave a __TRY block, as this will surely crash.
|
|
|
|
* You can use them to leave a __EXCEPT block though.
|
1999-05-12 15:10:39 +02:00
|
|
|
*
|
|
|
|
* -- AJ
|
|
|
|
*/
|
|
|
|
|
1999-05-14 20:21:55 +02:00
|
|
|
/* Define this if you want to use your compiler built-in __try/__except support.
|
|
|
|
* This is only useful when compiling to a native Windows binary, as the built-in
|
|
|
|
* compiler exceptions will most certainly not work under Winelib.
|
|
|
|
*/
|
|
|
|
#ifdef USE_COMPILER_EXCEPTIONS
|
|
|
|
|
|
|
|
#define __TRY __try
|
1999-06-18 20:26:35 +02:00
|
|
|
#define __EXCEPT(func) __except((func)(GetExceptionInformation()))
|
|
|
|
#define __FINALLY(func) __finally { (func)(!AbnormalTermination()); }
|
1999-05-14 20:21:55 +02:00
|
|
|
#define __ENDTRY /*nothing*/
|
|
|
|
|
|
|
|
#else /* USE_COMPILER_EXCEPTIONS */
|
|
|
|
|
|
|
|
#define __TRY \
|
|
|
|
do { __WINE_FRAME __f; \
|
|
|
|
int __first = 1; \
|
|
|
|
for (;;) if (!__first) \
|
|
|
|
{ \
|
|
|
|
do {
|
1999-05-12 15:10:39 +02:00
|
|
|
|
1999-06-18 20:26:35 +02:00
|
|
|
#define __EXCEPT(func) \
|
1999-05-14 20:21:55 +02:00
|
|
|
} while(0); \
|
|
|
|
EXC_pop_frame( &__f.frame ); \
|
|
|
|
break; \
|
|
|
|
} else { \
|
|
|
|
__f.frame.Handler = (PEXCEPTION_HANDLER)WINE_exception_handler; \
|
1999-06-18 20:26:35 +02:00
|
|
|
__f.u.filter = (func); \
|
1999-05-14 20:21:55 +02:00
|
|
|
EXC_push_frame( &__f.frame ); \
|
1999-06-18 20:26:35 +02:00
|
|
|
if (setjmp( __f.jmp)) { \
|
|
|
|
const __WINE_FRAME * const __eptr WINE_UNUSED = &__f; \
|
1999-05-14 20:21:55 +02:00
|
|
|
do {
|
|
|
|
|
|
|
|
#define __ENDTRY \
|
|
|
|
} while (0); \
|
|
|
|
break; \
|
|
|
|
} \
|
|
|
|
__first = 0; \
|
|
|
|
} \
|
1999-05-12 15:10:39 +02:00
|
|
|
} while (0);
|
|
|
|
|
1999-06-18 20:26:35 +02:00
|
|
|
#define __FINALLY(func) \
|
1999-05-14 20:21:55 +02:00
|
|
|
} while(0); \
|
|
|
|
EXC_pop_frame( &__f.frame ); \
|
1999-06-18 20:26:35 +02:00
|
|
|
(func)(1); \
|
1999-05-14 20:21:55 +02:00
|
|
|
break; \
|
|
|
|
} else { \
|
|
|
|
__f.frame.Handler = (PEXCEPTION_HANDLER)WINE_finally_handler; \
|
1999-06-18 20:26:35 +02:00
|
|
|
__f.u.finally_func = (func); \
|
1999-05-14 20:21:55 +02:00
|
|
|
EXC_push_frame( &__f.frame ); \
|
|
|
|
__first = 0; \
|
|
|
|
} \
|
|
|
|
} while (0);
|
1999-05-12 15:10:39 +02:00
|
|
|
|
|
|
|
|
1999-06-18 20:26:35 +02:00
|
|
|
typedef DWORD (*CALLBACK __WINE_FILTER)(PEXCEPTION_POINTERS);
|
|
|
|
typedef void (*CALLBACK __WINE_FINALLY)(BOOL);
|
1999-05-12 15:10:39 +02:00
|
|
|
|
1999-06-18 20:26:35 +02:00
|
|
|
#define WINE_EXCEPTION_FILTER(func) DWORD WINAPI func( EXCEPTION_POINTERS *__eptr )
|
|
|
|
#define WINE_FINALLY_FUNC(func) void WINAPI func( BOOL __normal )
|
1999-05-12 15:10:39 +02:00
|
|
|
|
1999-05-14 20:21:55 +02:00
|
|
|
#define GetExceptionInformation() (__eptr)
|
1999-06-18 20:26:35 +02:00
|
|
|
#define GetExceptionCode() (__eptr->ExceptionRecord->ExceptionCode)
|
1999-05-14 20:21:55 +02:00
|
|
|
#define AbnormalTermination() (!__normal)
|
1999-05-12 15:10:39 +02:00
|
|
|
|
1999-06-18 20:26:35 +02:00
|
|
|
typedef struct __tagWINE_FRAME
|
1999-05-12 15:10:39 +02:00
|
|
|
{
|
|
|
|
EXCEPTION_FRAME frame;
|
|
|
|
union
|
|
|
|
{
|
1999-06-18 20:26:35 +02:00
|
|
|
/* exception data */
|
|
|
|
__WINE_FILTER filter;
|
|
|
|
/* finally data */
|
|
|
|
__WINE_FINALLY finally_func;
|
1999-05-12 15:10:39 +02:00
|
|
|
} u;
|
1999-06-18 20:26:35 +02:00
|
|
|
jmp_buf jmp;
|
|
|
|
/* hack to make GetExceptionCode() work in handler */
|
|
|
|
DWORD ExceptionCode;
|
|
|
|
const struct __tagWINE_FRAME *ExceptionRecord;
|
1999-05-12 15:10:39 +02:00
|
|
|
} __WINE_FRAME;
|
|
|
|
|
|
|
|
extern DWORD WINAPI WINE_exception_handler( PEXCEPTION_RECORD record, EXCEPTION_FRAME *frame,
|
|
|
|
CONTEXT *context, LPVOID pdispatcher );
|
|
|
|
extern DWORD WINAPI WINE_finally_handler( PEXCEPTION_RECORD record, EXCEPTION_FRAME *frame,
|
|
|
|
CONTEXT *context, LPVOID pdispatcher );
|
|
|
|
|
1999-05-14 20:21:55 +02:00
|
|
|
#endif /* USE_COMPILER_EXCEPTIONS */
|
|
|
|
|
1999-05-12 15:10:39 +02:00
|
|
|
static inline EXCEPTION_FRAME *EXC_push_frame( EXCEPTION_FRAME *frame )
|
|
|
|
{
|
1999-05-14 20:21:55 +02:00
|
|
|
#if defined(__GNUC__) && defined(__i386__)
|
|
|
|
EXCEPTION_FRAME *prev;
|
|
|
|
__asm__ __volatile__(".byte 0x64\n\tmovl (0),%0"
|
|
|
|
"\n\tmovl %0,(%1)"
|
|
|
|
"\n\t.byte 0x64\n\tmovl %1,(0)"
|
|
|
|
: "=&r" (prev) : "r" (frame) : "memory" );
|
|
|
|
return prev;
|
|
|
|
#else
|
1999-06-26 20:30:03 +02:00
|
|
|
TEB *teb = NtCurrentTeb();
|
1999-05-12 15:10:39 +02:00
|
|
|
frame->Prev = teb->except;
|
|
|
|
teb->except = frame;
|
1999-05-14 20:21:55 +02:00
|
|
|
return frame->Prev;
|
|
|
|
#endif
|
1999-05-12 15:10:39 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
static inline EXCEPTION_FRAME *EXC_pop_frame( EXCEPTION_FRAME *frame )
|
|
|
|
{
|
1999-05-14 20:21:55 +02:00
|
|
|
#if defined(__GNUC__) && defined(__i386__)
|
|
|
|
__asm__ __volatile__(".byte 0x64\n\tmovl %0,(0)"
|
|
|
|
: : "r" (frame->Prev) : "memory" );
|
|
|
|
return frame->Prev;
|
|
|
|
|
|
|
|
#else
|
1999-06-26 20:30:03 +02:00
|
|
|
NtCurrentTeb()->except = frame->Prev;
|
1999-05-12 15:10:39 +02:00
|
|
|
return frame->Prev;
|
1999-05-14 20:21:55 +02:00
|
|
|
#endif
|
1999-05-12 15:10:39 +02:00
|
|
|
}
|
|
|
|
|
1999-06-18 20:26:35 +02:00
|
|
|
#ifdef __WINE__
|
|
|
|
typedef DWORD (*DEBUGHOOK)( EXCEPTION_RECORD *, CONTEXT *, BOOL );
|
|
|
|
extern void EXC_SetDebugEventHook( DEBUGHOOK hook );
|
|
|
|
extern DEBUGHOOK EXC_GetDebugEventHook(void);
|
|
|
|
extern void EXC_InitHandlers(void);
|
|
|
|
#endif
|
|
|
|
|
1999-05-12 15:10:39 +02:00
|
|
|
#endif /* __WINE_WINE_EXCEPTION_H */
|