1\documentclass{article} 2\usepackage[fancyhdr,pdf]{latex2man} 3 4\input{common.tex} 5 6\begin{document} 7 8\begin{Name}{3}{unw\_apply\_reg\_state}{David Mosberger-Tang}{Programming Library}{unw\_apply\_reg\_state}unw\_apply\_reg\_state -- apply a register state update to a cursor 9\end{Name} 10 11\section{Synopsis} 12 13\File{\#include $<$libunwind.h$>$}\\ 14 15\Type{int} 16\Func{unw\_apply\_reg\_state}(\Type{unw\_cursor\_t~*}\Var{cp}, 17\Type{void~*}\Var{reg\_states\_data});\\ 18 19\section{Description} 20 21The \Func{unw\_apply\_reg\_state}() routine updates the register values 22of a cursor according to the instructions in \Var{reg\_states\_data}, 23which have been obtained by calling \Var{unw\_reg\_states\_iterate}. 24 25\section{Return Value} 26 27On successful completion, \Func{unw\_apply\_reg\_state}() returns 0. 28Otherwise the negative value of one of the error-codes below is 29returned. 30 31\section{Thread and Signal Safety} 32 33\Func{unw\_apply\_reg\_state}() is thread-safe. If cursor \Var{cp} is 34in the local address-space, this routine is also safe to use from a 35signal handler. 36 37\section{Errors} 38 39\begin{Description} 40\item[\Const{UNW\_EUNSPEC}] An unspecified error occurred. 41\item[\Const{UNW\_ENOINFO}] \Prog{Libunwind} was unable to locate 42 unwind-info for the procedure. 43\item[\Const{UNW\_EBADVERSION}] The unwind-info for the procedure has 44 version or format that is not understood by \Prog{libunwind}. 45\end{Description} 46In addition, \Func{unw\_apply\_reg\_state}() may return any error 47returned by the \Func{access\_mem}() call-back (see 48\Func{unw\_create\_addr\_space}(3)). 49 50\section{See Also} 51 52\SeeAlso{libunwind(3)}, 53\SeeAlso{unw\_reg\_states\_iterate(3)} 54 55\section{Author} 56 57\noindent 58David Mosberger-Tang\\ 59Email: \Email{dmosberger@gmail.com}\\ 60WWW: \URL{http://www.nongnu.org/libunwind/}. 61\LatexManEnd 62 63\end{document} 64