2003-04-01 09:19:34 +02:00
|
|
|
\documentclass{article}
|
|
|
|
|
\usepackage[fancyhdr,pdf]{latex2man}
|
|
|
|
|
|
|
|
|
|
\input{common.tex}
|
|
|
|
|
|
|
|
|
|
\begin{document}
|
|
|
|
|
|
|
|
|
|
\begin{Name}{3}{unw\_getcontext}{David Mosberger-Tang}{Programming Library}{unw\_getcontext}unw\_getcontext -- get initial machine-state
|
|
|
|
|
\end{Name}
|
|
|
|
|
|
|
|
|
|
\section{Synopsis}
|
|
|
|
|
|
|
|
|
|
\File{\#include $<$libunwind.h$>$}\\
|
|
|
|
|
|
|
|
|
|
\Type{int} \Func{unw\_getcontext}(\Type{unw\_context\_t~*}\Var{ucp});\\
|
|
|
|
|
|
|
|
|
|
\section{Description}
|
|
|
|
|
|
|
|
|
|
The \Func{unw\_getcontext}() routine initializes the context structure
|
|
|
|
|
pointed to by \Var{ucp} with the machine-state of the call-site. The
|
|
|
|
|
exact set of registers stored by \Func{unw\_getcontext}() is
|
|
|
|
|
platform-specific, but, in general, at least all preserved
|
|
|
|
|
(``callee-saved'') and all frame-related registers, such as the
|
|
|
|
|
stack-pointer, will be stored.
|
|
|
|
|
|
2004-01-21 02:05:07 +01:00
|
|
|
This routine is normally implemented as a macro and applications
|
|
|
|
|
should not attempt to take its address.
|
|
|
|
|
|
2003-04-01 09:19:34 +02:00
|
|
|
\section{Return Value}
|
|
|
|
|
|
|
|
|
|
On successful completion, \Func{unw\_getcontext}() returns 0.
|
|
|
|
|
Otherwise, a value of -1 is returned.
|
|
|
|
|
|
|
|
|
|
\section{Thread and Signal Safety}
|
|
|
|
|
|
|
|
|
|
\Func{unw\_getcontext}() is thread-safe as well as safe to use
|
|
|
|
|
from a signal handler.
|
|
|
|
|
|
|
|
|
|
\section{See Also}
|
|
|
|
|
|
|
|
|
|
\SeeAlso{libunwind(3)},
|
|
|
|
|
\SeeAlso{unw\_init\_local(3)}
|
|
|
|
|
|
|
|
|
|
\section{Author}
|
|
|
|
|
|
|
|
|
|
\noindent
|
|
|
|
|
David Mosberger-Tang\\
|
|
|
|
|
Hewlett-Packard Labs\\
|
|
|
|
|
Palo-Alto, CA 94304\\
|
|
|
|
|
Email: \Email{davidm@hpl.hp.com}\\
|
|
|
|
|
WWW: \URL{http://www.hpl.hp.com/research/linux/libunwind/}.
|
|
|
|
|
\LatexManEnd
|
|
|
|
|
|
|
|
|
|
\end{document}
|
