1d0028f3b308078fe19b1ec7a29f1d8cf6ebf39efmostang.com!davidm\documentclass{article} 2d0028f3b308078fe19b1ec7a29f1d8cf6ebf39efmostang.com!davidm\usepackage[fancyhdr,pdf]{latex2man} 3d0028f3b308078fe19b1ec7a29f1d8cf6ebf39efmostang.com!davidm 4d0028f3b308078fe19b1ec7a29f1d8cf6ebf39efmostang.com!davidm\input{common.tex} 5d0028f3b308078fe19b1ec7a29f1d8cf6ebf39efmostang.com!davidm 6d0028f3b308078fe19b1ec7a29f1d8cf6ebf39efmostang.com!davidm\begin{document} 7d0028f3b308078fe19b1ec7a29f1d8cf6ebf39efmostang.com!davidm 8d0028f3b308078fe19b1ec7a29f1d8cf6ebf39efmostang.com!davidm\begin{Name}{3}{unw\_get\_fpreg}{David Mosberger-Tang}{Programming Library}{unw\_get\_fpreg}unw\_get\_fpreg -- get contents of floating-point register 9d0028f3b308078fe19b1ec7a29f1d8cf6ebf39efmostang.com!davidm\end{Name} 10d0028f3b308078fe19b1ec7a29f1d8cf6ebf39efmostang.com!davidm 11d0028f3b308078fe19b1ec7a29f1d8cf6ebf39efmostang.com!davidm\section{Synopsis} 12d0028f3b308078fe19b1ec7a29f1d8cf6ebf39efmostang.com!davidm 13d0028f3b308078fe19b1ec7a29f1d8cf6ebf39efmostang.com!davidm\File{\#include $<$libunwind.h$>$}\\ 14d0028f3b308078fe19b1ec7a29f1d8cf6ebf39efmostang.com!davidm 15d0028f3b308078fe19b1ec7a29f1d8cf6ebf39efmostang.com!davidm\Type{int} \Func{unw\_get\_fpreg}(\Type{unw\_cursor\_t~*}\Var{cp}, \Type{unw\_regnum\_t} \Var{reg}, \Type{unw\_fpreg\_t~*}\Var{valp});\\ 16d0028f3b308078fe19b1ec7a29f1d8cf6ebf39efmostang.com!davidm 17d0028f3b308078fe19b1ec7a29f1d8cf6ebf39efmostang.com!davidm\section{Description} 18d0028f3b308078fe19b1ec7a29f1d8cf6ebf39efmostang.com!davidm 19d0028f3b308078fe19b1ec7a29f1d8cf6ebf39efmostang.com!davidmThe \Func{unw\_get\_fpreg}() routine reads the value of floating-point 20d0028f3b308078fe19b1ec7a29f1d8cf6ebf39efmostang.com!davidmregister \Var{reg} in the stack frame identified by cursor \Var{cp} 21d0028f3b308078fe19b1ec7a29f1d8cf6ebf39efmostang.com!davidmand stores the value in the variable pointed to by \Var{valp}. 22d0028f3b308078fe19b1ec7a29f1d8cf6ebf39efmostang.com!davidm 23d0028f3b308078fe19b1ec7a29f1d8cf6ebf39efmostang.com!davidmThe register numbering is target-dependent and described in separate 24d0028f3b308078fe19b1ec7a29f1d8cf6ebf39efmostang.com!davidmmanual pages (e.g., libunwind-ia64(3) for the IA-64 target). 25d0028f3b308078fe19b1ec7a29f1d8cf6ebf39efmostang.com!davidmFurthermore, the exact set of accessible registers may depend on the 26d0028f3b308078fe19b1ec7a29f1d8cf6ebf39efmostang.com!davidmtype of frame that \Var{cp} is referring to. For ordinary stack 27d0028f3b308078fe19b1ec7a29f1d8cf6ebf39efmostang.com!davidmframes, it is normally possible to access only the preserved 28d0028f3b308078fe19b1ec7a29f1d8cf6ebf39efmostang.com!davidm(``callee-saved'') registers and frame-related registers (such as the 29d0028f3b308078fe19b1ec7a29f1d8cf6ebf39efmostang.com!davidmstack-pointer). However, for signal frames (see 30d0028f3b308078fe19b1ec7a29f1d8cf6ebf39efmostang.com!davidm\Func{unw\_is\_signal\_frame}(3)), it is usually possible to access 31d0028f3b308078fe19b1ec7a29f1d8cf6ebf39efmostang.com!davidmall registers. 32d0028f3b308078fe19b1ec7a29f1d8cf6ebf39efmostang.com!davidm 33d0028f3b308078fe19b1ec7a29f1d8cf6ebf39efmostang.com!davidmNote that \Func{unw\_get\_fpreg}() can only read the contents of 34d0028f3b308078fe19b1ec7a29f1d8cf6ebf39efmostang.com!davidmfloating-point registers. See \Func{unw\_get\_fpreg}(3) for a way to 35d0028f3b308078fe19b1ec7a29f1d8cf6ebf39efmostang.com!davidmread registers which fit in a single word. 36d0028f3b308078fe19b1ec7a29f1d8cf6ebf39efmostang.com!davidm 37d0028f3b308078fe19b1ec7a29f1d8cf6ebf39efmostang.com!davidm\section{Return Value} 38d0028f3b308078fe19b1ec7a29f1d8cf6ebf39efmostang.com!davidm 39d0028f3b308078fe19b1ec7a29f1d8cf6ebf39efmostang.com!davidmOn successful completion, \Func{unw\_get\_fpreg}() returns 0. 40d0028f3b308078fe19b1ec7a29f1d8cf6ebf39efmostang.com!davidmOtherwise the negative value of one of the error-codes below is 41d0028f3b308078fe19b1ec7a29f1d8cf6ebf39efmostang.com!davidmreturned. 42d0028f3b308078fe19b1ec7a29f1d8cf6ebf39efmostang.com!davidm 43d0028f3b308078fe19b1ec7a29f1d8cf6ebf39efmostang.com!davidm\section{Thread and Signal Safety} 44d0028f3b308078fe19b1ec7a29f1d8cf6ebf39efmostang.com!davidm 45d0028f3b308078fe19b1ec7a29f1d8cf6ebf39efmostang.com!davidm\Func{unw\_get\_fpreg}() is thread-safe as well as safe to use 46d0028f3b308078fe19b1ec7a29f1d8cf6ebf39efmostang.com!davidmfrom a signal handler. 47d0028f3b308078fe19b1ec7a29f1d8cf6ebf39efmostang.com!davidm 48d0028f3b308078fe19b1ec7a29f1d8cf6ebf39efmostang.com!davidm\section{Errors} 49d0028f3b308078fe19b1ec7a29f1d8cf6ebf39efmostang.com!davidm 50d0028f3b308078fe19b1ec7a29f1d8cf6ebf39efmostang.com!davidm\begin{Description} 51d0028f3b308078fe19b1ec7a29f1d8cf6ebf39efmostang.com!davidm\item[\Const{UNW\_EUNSPEC}] An unspecified error occurred. 52d0028f3b308078fe19b1ec7a29f1d8cf6ebf39efmostang.com!davidm\item[\Const{UNW\_EBADREG}] An attempt was made to read a register 53d0028f3b308078fe19b1ec7a29f1d8cf6ebf39efmostang.com!davidm that is either invalid or not accessible in the current frame. 54d0028f3b308078fe19b1ec7a29f1d8cf6ebf39efmostang.com!davidm\end{Description} 55d0028f3b308078fe19b1ec7a29f1d8cf6ebf39efmostang.com!davidmIn addition, \Func{unw\_get\_fpreg}() may return any error returned by 56d0028f3b308078fe19b1ec7a29f1d8cf6ebf39efmostang.com!davidmthe \Func{access\_mem}(), \Func{access\_reg}(), and 57d0028f3b308078fe19b1ec7a29f1d8cf6ebf39efmostang.com!davidm\Func{access\_fpreg}() call-backs (see 58d0028f3b308078fe19b1ec7a29f1d8cf6ebf39efmostang.com!davidm\Func{unw\_create\_addr\_space}(3)). 59d0028f3b308078fe19b1ec7a29f1d8cf6ebf39efmostang.com!davidm 60d0028f3b308078fe19b1ec7a29f1d8cf6ebf39efmostang.com!davidm\section{See Also} 61d0028f3b308078fe19b1ec7a29f1d8cf6ebf39efmostang.com!davidm 62d0028f3b308078fe19b1ec7a29f1d8cf6ebf39efmostang.com!davidm\SeeAlso{libunwind(3)}, 63d0028f3b308078fe19b1ec7a29f1d8cf6ebf39efmostang.com!davidm\SeeAlso{libunwind-ia64(3)}, 64d0028f3b308078fe19b1ec7a29f1d8cf6ebf39efmostang.com!davidm\SeeAlso{unw\_get\_reg(3)}, 65d0028f3b308078fe19b1ec7a29f1d8cf6ebf39efmostang.com!davidm\SeeAlso{unw\_is\_fpreg(3)}, 66d0028f3b308078fe19b1ec7a29f1d8cf6ebf39efmostang.com!davidm\SeeAlso{unw\_is\_signal\_frame(3)}, 67d0028f3b308078fe19b1ec7a29f1d8cf6ebf39efmostang.com!davidm\SeeAlso{unw\_set\_fpreg(3)} 68d0028f3b308078fe19b1ec7a29f1d8cf6ebf39efmostang.com!davidm 69d0028f3b308078fe19b1ec7a29f1d8cf6ebf39efmostang.com!davidm\section{Author} 70d0028f3b308078fe19b1ec7a29f1d8cf6ebf39efmostang.com!davidm 71d0028f3b308078fe19b1ec7a29f1d8cf6ebf39efmostang.com!davidm\noindent 72d0028f3b308078fe19b1ec7a29f1d8cf6ebf39efmostang.com!davidmDavid Mosberger-Tang\\ 7375f34ccb7dcdfd2b96e370824b3fd723b2f22b49David Mosberger-TangEmail: \Email{dmosberger@gmail.com}\\ 7475f34ccb7dcdfd2b96e370824b3fd723b2f22b49David Mosberger-TangWWW: \URL{http://www.nongnu.org/libunwind/}. 75d0028f3b308078fe19b1ec7a29f1d8cf6ebf39efmostang.com!davidm\LatexManEnd 76d0028f3b308078fe19b1ec7a29f1d8cf6ebf39efmostang.com!davidm 77d0028f3b308078fe19b1ec7a29f1d8cf6ebf39efmostang.com!davidm\end{document} 78