1UNW_GET_FPREG(3)             Programming Library              UNW_GET_FPREG(3)
2
3
4

NAME

6       unw_get_fpreg -- get contents of floating-point register
7

SYNOPSIS

9       #include <libunwind.h>
10
11       int   unw_get_fpreg(unw_cursor_t  *cp,  unw_regnum_t  reg,  unw_fpreg_t
12       *valp);
13

DESCRIPTION

15       The unw_get_fpreg() routine reads the value of floating-point  register
16       reg  in the stack frame identified by cursor cp and stores the value in
17       the variable pointed to by valp.
18
19       The register numbering is target-dependent and  described  in  separate
20       manual  pages (e.g., libunwind-ia64(3) for the IA-64 target).  Further‐
21       more, the exact set of accessible registers may depend on the  type  of
22       frame  that  cp  is referring to. For ordinary stack frames, it is nor‐
23       mally possible to access only the preserved  (``callee-saved'')  regis‐
24       ters  and frame-related registers (such as the stack-pointer). However,
25       for signal frames (see unw_is_signal_frame(3)), it is usually  possible
26       to access all registers.
27
28       Note  that unw_get_fpreg() can only read the contents of floating-point
29       registers. See unw_get_fpreg(3) for a way to read registers  which  fit
30       in a single word.
31

RETURN VALUE

33       On  successful  completion,  unw_get_fpreg()  returns 0.  Otherwise the
34       negative value of one of the error-codes below is returned.
35

THREAD AND SIGNAL SAFETY

37       unw_get_fpreg() is thread-safe as well as safe to  use  from  a  signal
38       handler.
39

ERRORS

41       UNW_EUNSPEC
42               An unspecified error occurred.
43
44       UNW_EBADREG
45               An  attempt  was made to read a register that is either invalid
46              or not accessible in the current frame.
47
48       In addition, unw_get_fpreg() may  return  any  error  returned  by  the
49       access_mem(), access_reg(), and access_fpreg() call-backs (see unw_cre‐
50       ate_addr_space(3)).
51

SEE ALSO

53       libunwind(3),   libunwind-ia64(3),   unw_get_reg(3),   unw_is_fpreg(3),
54       unw_is_signal_frame(3), unw_set_fpreg(3)
55

AUTHOR

57       David Mosberger-Tang
58       Hewlett-Packard Labs
59       Palo-Alto, CA 94304
60       Email: davidm@hpl.hp.com
61       WWW: http://www.hpl.hp.com/research/linux/libunwind/.
62
63
64
65Programming Library             05 August 2004                UNW_GET_FPREG(3)
Impressum