From 88c6bcd7949ac2028ede1a4f8524a25a8de932c3 Mon Sep 17 00:00:00 2001 From: "mostang.com!davidm" Date: Fri, 21 Feb 2003 07:36:26 +0000 Subject: [PATCH] Add note that unw_resume() does NOT execute unwind-handlers (personality-routines). (Logical change 1.52) --- doc/unw_resume.tex | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/doc/unw_resume.tex b/doc/unw_resume.tex index f7f458a7..e111e332 100644 --- a/doc/unw_resume.tex +++ b/doc/unw_resume.tex @@ -37,6 +37,14 @@ contents of that register. In other words, the exception handling arguments are installed even in cases where normally only the ``preserved'' registers are restored. +Note that \Func{unw\_resume}() does \emph{not} invoke any unwind +handlers (aka, ``personality routines''). If a program needs this, it +will have to do so on its own by obtaining the \Type{unw\_proc\_info\_t} +of each unwound frame and appropriately processing its unwind handler +and language-specific data area (lsda). These steps are generally +dependent on the target-platform and are regulated by the +processor-specific ABI (application-binary interface). + \section{Return Value} For local unwinding, \Func{unw\_resume}() does not return on success.