stack_unwind.h revision 7c478bd95313f5f23a4c958a745db2134aa03244
/*
* CDDL HEADER START
*
* The contents of this file are subject to the terms of the
* Common Development and Distribution License, Version 1.0 only
* (the "License"). You may not use this file except in compliance
* with the License.
*
* You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
* See the License for the specific language governing permissions
* and limitations under the License.
*
* When distributing Covered Code, include this CDDL HEADER in each
* file and include the License file at usr/src/OPENSOLARIS.LICENSE.
* If applicable, add the following below this CDDL HEADER, with the
* fields enclosed by brackets "[]" replaced with your own identifying
* information: Portions Copyright [yyyy] [name of copyright owner]
*
* CDDL HEADER END
*/
/*
* Copyright 2004 Sun Microsystems, Inc. All rights reserved.
* Use is subject to license terms.
*/
/*
* Public interfaces for AMD64 Unwind routines
*/
#ifndef _STACK_UNWIND_H
#define _STACK_UNWIND_H
#pragma ident "%Z%%M% %I% %E% SMI"
#ifdef __cplusplus
extern "C" {
#endif
#if defined(__amd64) /* none of this is valid except for AMD64 */
typedef enum {
_URC_NO_REASON = 0,
_URC_NORMAL_STOP = 4,
_URC_END_OF_STACK = 5,
_URC_HANDLER_FOUND = 6,
_URC_INSTALL_CONTEXT = 7,
typedef int _Unwind_Action;
extern const _Unwind_Action _UA_SEARCH_PHASE;
extern const _Unwind_Action _UA_CLEANUP_PHASE;
extern const _Unwind_Action _UA_HANDLER_FRAME;
extern const _Unwind_Action _UA_FORCE_UNWIND;
struct _Unwind_Exception;
struct _Unwind_Context;
/*
* Signature of language specific call back for deleting exception object
*/
typedef void (*_Unwind_Exception_Cleanup_Fn)(
struct _Unwind_Exception *exc);
/*
* Header preceding language specific exception object
* For Sun C++ these fields are the beginning of the
* language specific structure.
*/
struct _Unwind_Exception {
};
/*
* Signature for language specific routine - address is in eh_frame CIE.
* During phase one it predicts whether exception would be caught at this
* frame and during phase two selects a handler as predicted. An action
* of _UA_FORCE_UNWIND will prevent any catch block from being selected.
*
* The personality function is the only call back used when
* _Unwind_RaiseException() is called.
*/
typedef _Unwind_Reason_Code (*_Unwind_Personality_Fn)(
int version,
struct _Unwind_Exception *exceptionObject,
struct _Unwind_Context *context);
/*
* Signature of callback function that is used when _Unwind_ForcedUnwind()
* is called. It is called at every step of walkback and that can control
* the execution of the personality routine at each frame.
*/
typedef _Unwind_Reason_Code (*_Unwind_Stop_Fn)(
int version,
struct _Unwind_Exception *exceptionObject,
struct _Unwind_Context *context,
void *stop_parameter);
/*
* Here begins the external functional interface
*/
/*
* Used to implement C++ throw - starts walkback with caller's caller.
* The routine in the middle must use %rbp as a frame pointer
*/
struct _Unwind_Exception *exception_object);
/*
* Used (with different stop functions) for POSIX thread cancellation
* and stack walking - starts walkback with caller's caller.
*
* Note: must be called by a routine which has a real FP and doesn't use
* callee saves registers.
*/
struct _Unwind_Exception *exception_object,
void *stop_parameter);
/*
* Used to resume unwinding at end of cleanup (not catch) code
* Assumes that caller is language specific cleanup code and
* pops the stack one level before resuming walk.
*/
/*
* Calls destructor function for exception object
*/
/*
* {
* (*(exception_object->exception_cleanup))(_URC_NO_REASON,
* exception_object);
* }
*/
#if 0
extern "C" _Unwind_Reason_Code
struct _Unwind_Exception *exception_object,
{
if (no_return)
die;
} else {
/*
* Your logic here:
* res = ........
*/
}
switch (res) {
case _URC_NO_REASON:
/*
* framework will call personality routine for current context
* then then move one frame back the stack and call here with
* updated context. POSIX thread cancellation uses this pattern.
*
* If this path is taken the exception object passed must have
* been constructed by the same language system supplying the
* personality routines. i.e. foreign exceptions are not
* implemented.
*
* The Sun Microsystems C++ runtime contains the routine
*
* _ex_unwind(_Unwind_Stop_fn sfunc, void *sfunc_arg)
*
* which is a wrapper around _Unwind_ForcedUnwind that
* sets up a C++ exception object.
*
* Once this path is taken, the stack frame from which
* _Unwind_ForcedUnwind was called is not guaranteed to
* still exist. Thus the return codes listed below which
* result in that call returning are rendered bogus.
*
* A thread reaching the end of the stack during cancellation
* must die instead of returning _URC_END_OF_STACK.
*/
break;
case _URC_CONTINUE_UNWIND:
/*
* framework will move one frame back the stack and
* call here with updated context
*
* The exception record supplied to _Unwind_ForcedUnwind
* need only contain the header and may be stack allocated
* if this function will never allow the personality
* function to run (as in a trace generator).
*/
break;
case _URC_INSTALL_CONTEXT:
/*
* framework will resume execution of user code at location
* specified by (altered) context
*/
break;
case _URC_NORMAL_STOP:
/*
* call to _Unwind_ForcedUnwind will return _URC_NORMAL_STOP
*/
break;
case _URC_END_OF_STACK:
/*
* call to _Unwind_ForcedUnwind will return _URC_END_OF_STACK
*/
break;
case _URC_FATAL_PHASE2_ERROR:
case _URC_FATAL_PHASE1_ERROR:
case _URC_HANDLER_FOUND:
/*
* call to _Unwind_ForcedUnwind will return
* _URC_FATAL_PHASE2_ERROR
*/
break;
}
return (res);
}
#endif
/*
* Stack frame context accessors defined in ABI
* Note: RA is handled as a GR value
*/
/*
* Valid Index values for _Unwind_GetGR
*/
/*
* Valid Index values for _Unwind_SetGR
*/
#endif /* __amd64 */
#ifdef __cplusplus
}
#endif
#endif /* _STACK_UNWIND_H */