2 Copyright (c) 2004/2005 KJK::Hyperion
4 Permission is hereby granted, free of charge, to any person obtaining a copy of
5 this software and associated documentation files (the "Software"), to deal in
6 the Software without restriction, including without limitation the rights to
7 use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
8 of the Software, and to permit persons to whom the Software is furnished to do
9 so, subject to the following conditions:
11 The above copyright notice and this permission notice shall be included in all
12 copies or substantial portions of the Software.
14 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
15 IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
16 FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
17 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
18 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
19 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
23 #ifndef KJK_PSEH_FRAMEBASED_H_
24 #define KJK_PSEH_FRAMEBASED_H_
26 #include <pseh/framebased/internal.h>
27 #include <pseh/excpt.h>
34 Fall back to non-optimal, non-native NLG implementation for environments
35 without their own (e.g., currently, kernel-mode ReactOS/Windows). THIS IS NOT
36 RECOMMENDED AND IT WILL BE DROPPED IN A FUTURE VERSION BECAUSE IT MAY CAUSE
37 SEVERE STACK CORRUPTION. REIMPLEMENT OR PORT YOUR COMPILER'S NATIVE NLG
38 IMPLEMENTATION INSTEAD.
40 #ifdef _SEH_NO_NATIVE_NLG
41 # include <pseh/setjmp.h>
44 # define _SEHLongJmp longjmp
45 # define _SEHSetJmp setjmp
46 # define _SEHJmpBuf_t jmp_buf
48 typedef struct __SEHFrame
50 _SEHPortableFrame_t SEH_Header
;
55 typedef struct __SEHTryLevel
57 _SEHPortableTryLevel_t ST_Header
;
58 _SEHJmpBuf_t ST_JmpBuf
;
62 static __declspec(noreturn
) __inline
void __stdcall _SEHCompilerSpecificHandler
64 _SEHPortableTryLevel_t
* trylevel
67 _SEHTryLevel_t
* mytrylevel
;
68 mytrylevel
= _SEH_CONTAINING_RECORD(trylevel
, _SEHTryLevel_t
, ST_Header
);
69 _SEHLongJmp(mytrylevel
->ST_JmpBuf
, 1);
72 static const int _SEHScopeKind
= 1;
73 static _SEHPortableFrame_t
* const _SEHPortableFrame
= 0;
76 /* Access the locals for the current frame */
77 #define _SEH_ACCESS_LOCALS(LOCALS_) \
78 _SEH_LOCALS_TYPENAME(LOCALS_) * _SEHPLocals; \
82 _SEH_LOCALS_TYPENAME(LOCALS_) *, \
83 _SEH_CONTAINING_RECORD(_SEHPortableFrame, _SEHFrame_t, SEH_Header) \
87 /* Access local variable VAR_ */
88 #define _SEH_VAR(VAR_) _SEHPLocals->VAR_
90 /* FILTER FUNCTIONS */
91 /* Declares a filter function's prototype */
92 #define _SEH_FILTER(NAME_) \
93 long __stdcall NAME_ \
95 struct _EXCEPTION_POINTERS * _SEHExceptionPointers, \
96 struct __SEHPortableFrame * _SEHPortableFrame \
99 /* Declares a static filter */
100 #define _SEH_STATIC_FILTER(ACTION_) ((_SEHFilter_t)((ACTION_) + 2))
102 /* Declares a PSEH filter wrapping a regular filter function */
103 #define _SEH_WRAP_FILTER(WRAPPER_, NAME_) \
104 static __inline _SEH_FILTER(WRAPPER_) \
106 return (NAME_)(_SEHExceptionPointers); \
109 /* FINALLY FUNCTIONS */
110 /* Declares a finally function's prototype */
111 #define _SEH_FINALLYFUNC(NAME_) \
112 void __stdcall NAME_ \
114 struct __SEHPortableFrame * _SEHPortableFrame \
117 /* Declares a PSEH finally function wrapping a regular function */
118 #define _SEH_WRAP_FINALLY(WRAPPER_, NAME_) \
119 _SEH_WRAP_FINALLY_ARGS(WRAPPER_, NAME_, ())
121 #define _SEH_WRAP_FINALLY_ARGS(WRAPPER_, NAME_, ARGS_) \
122 static __inline _SEH_FINALLYFUNC(WRAPPER_) \
127 #define _SEH_WRAP_FINALLY_LOCALS_ARGS(WRAPPER_, LOCALS_, NAME_, ARGS_) \
128 static __inline _SEH_FINALLYFUNC(WRAPPER_) \
130 _SEH_ACCESS_LOCALS(LOCALS_); \
135 #define _SEHX_TRY_FINALLY(FINALLY_) \
136 _SEH_TRY_FILTER_FINALLY \
138 _SEH_STATIC_FILTER(_SEH_CONTINUE_SEARCH), \
142 #define _SEHX_END_FINALLY _SEH_HANDLE _SEH_END
144 #define _SEHX_TRY_FILTER(FILTER_) \
145 _SEH_TRY_FILTER_FINALLY((FILTER_), 0)
147 #define _SEHX_TRY_HANDLE_FINALLY(FINALLY_) \
148 _SEH_TRY_FILTER_FINALLY \
150 _SEH_STATIC_FILTER(_SEH_EXECUTE_HANDLER), \
155 _SEH_TRY_HANDLE_FINALLY(0)
158 # define _SEH_DECLARE_HANDLERS(FILTER_, FINALLY_) \
159 static const _SEHHandlers_t _SEHHandlers = { (FILTER_), (FINALLY_) };
161 # define _SEH_DECLARE_HANDLERS(FILTER_, FINALLY_) \
162 _SEHHandlers_t _SEHHandlers = { (0), (0) }; \
163 _SEHHandlers.SH_Filter = (FILTER_); \
164 _SEHHandlers.SH_Finally = (FINALLY_);
167 #define _SEHX_TRY_FILTER_FINALLY(FILTER_, FINALLY_) \
169 _SEHPortableFrame_t * const _SEHCurPortableFrame = _SEHPortableFrame; \
172 _SEHFrame_t _SEHFrame; \
173 _SEHTryLevel_t _SEHTryLevel; \
174 _SEHPortableFrame_t * const _SEHPortableFrame = \
175 _SEHScopeKind ? &_SEHFrame.SEH_Header : _SEHCurPortableFrame; \
177 (void)_SEHPortableFrame; \
179 _SEH_DECLARE_HANDLERS((FILTER_), (FINALLY_)); \
181 _SEHTryLevel.ST_Header.SPT_Handlers = &_SEHHandlers; \
185 if(&_SEHLocals != _SEHDummyLocals) \
186 _SEHFrame.SEH_Locals = &_SEHLocals; \
188 _SEHFrame.SEH_Header.SPF_Handler = _SEHCompilerSpecificHandler; \
189 _SEHEnterFrame(&_SEHFrame.SEH_Header, &_SEHTryLevel.ST_Header); \
192 _SEHEnterTry(&_SEHTryLevel.ST_Header); \
195 static const int _SEHScopeKind = 0; \
196 (void)_SEHScopeKind; \
198 if(_SEHSetJmp(_SEHTryLevel.ST_JmpBuf) == 0) \
203 #define _SEHX_HANDLE \
217 if(_SEHHandlers.SH_Finally) \
218 _SEHHandlers.SH_Finally(_SEHPortableFrame); \
223 #define _SEHX_LEAVE break
225 #define _SEHX_GetExceptionCode() (unsigned long)(_SEHPortableFrame->SPF_Code)
227 #define _SEHX_GetExceptionPointers() \
228 ((struct _EXCEPTION_POINTERS *)_SEHExceptionPointers)
230 #define _SEHX_AbnormalTermination() (_SEHPortableFrame->SPF_Code != 0)
235 NOTE: do not move, remove or modify any instance of _SEH2_ASSUME and
236 _SEH2_ASSUMING without doing extensive tests for correctness. Compilers can
237 generate the wrong code in presence of __assume in unpredictable ways. BE SURE
240 #if defined(_MSC_VER) && (_MSC_VER > 1200)
241 # define _SEH2_ASSUME(X_) __assume(X_)
242 # if !defined(_SEH_NO_NATIVE_NLG)
244 If we use the native setjmp, the compiler stops keeping track of variables, so
245 their actual values don't matter anymore. Optimize out some assignments
247 # define _SEH2_ASSUMING(X_)
249 /* No native setjmp, no magic, no assumptions. Actually set the values */
250 # define _SEH2_ASSUMING(X_) X_
253 # define _SEH2_ASSUME(X_)
254 # define _SEH2_ASSUMING(X_) X_
258 # define _SEH2_INIT_CONST static const
260 # define _SEH2_INIT_CONST register const
263 #define _SEH_LEAVE break
267 _SEH2_INIT_CONST int _SEH2TopTryLevel = (_SEHScopeKind != 0); \
268 _SEHPortableFrame_t * const _SEH2CurPortableFrame = _SEHPortableFrame; \
271 static const int _SEHScopeKind = 0; \
272 register int _SEH2State = 0; \
273 register int _SEH2Handle = 0; \
274 _SEHFrame_t _SEH2Frame; \
275 _SEHTryLevel_t _SEH2TryLevel; \
276 _SEHPortableFrame_t * const _SEHPortableFrame = \
277 _SEH2TopTryLevel ? &_SEH2Frame.SEH_Header : _SEH2CurPortableFrame; \
279 (void)_SEHScopeKind; \
280 (void)_SEHPortableFrame; \
291 #define _SEH_EXCEPT(FILTER_) \
297 _SEH2_ASSUME(_SEH2Handle == 0); \
302 _SEH_DECLARE_HANDLERS((FILTER_), 0); \
304 _SEH2TryLevel.ST_Header.SPT_Handlers = &_SEHHandlers; \
306 if(_SEH2TopTryLevel) \
308 if(&_SEHLocals != _SEHDummyLocals) \
309 _SEH2Frame.SEH_Locals = &_SEHLocals; \
311 _SEH2Frame.SEH_Header.SPF_Handler = _SEHCompilerSpecificHandler; \
312 _SEHEnterFrame(&_SEH2Frame.SEH_Header, &_SEH2TryLevel.ST_Header); \
315 _SEHEnterTry(&_SEH2TryLevel.ST_Header); \
317 if((_SEH2Handle = _SEHSetJmp(_SEH2TryLevel.ST_JmpBuf)) == 0) \
319 _SEH2_ASSUMING(++ _SEH2State); \
320 _SEH2_ASSUME(_SEH2State != 0); \
337 #define _SEH_FINALLY(FINALLY_) \
348 _SEH_DECLARE_HANDLERS(0, (FINALLY_)); \
350 _SEH2TryLevel.ST_Header.SPT_Handlers = &_SEHHandlers; \
352 if(_SEH2TopTryLevel) \
354 if(&_SEHLocals != _SEHDummyLocals) \
355 _SEH2Frame.SEH_Locals = &_SEHLocals; \
357 _SEH2Frame.SEH_Header.SPF_Handler = 0; \
358 _SEHEnterFrame(&_SEH2Frame.SEH_Header, &_SEH2TryLevel.ST_Header); \
361 _SEHEnterTry(&_SEH2TryLevel.ST_Header); \
364 _SEH2_ASSUME(_SEH2State != 0); \
371 (FINALLY_)(&_SEH2Frame.SEH_Header); \
380 #define _SEH_HANDLE _SEH_EXCEPT(_SEH_STATIC_FILTER(_SEH_EXECUTE_HANDLER))
382 #define _SEH_GetExceptionCode _SEHX_GetExceptionCode
383 #define _SEH_GetExceptionPointers _SEHX_GetExceptionPointers
384 #define _SEH_AbnormalTermination _SEHX_AbnormalTermination