Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
UNW_GET_FPREG(3libunwind)     Programming Library      UNW_GET_FPREG(3libunwind)

NAME
     unw_get_fpreg -- get contents of floating-point register

SYNOPSIS
     #include <libunwind.h>

     int unw_get_fpreg(unw_cursor_t *cp, unw_regnum_t reg, unw_fpreg_t *valp);

DESCRIPTION
     The  unw_get_fpreg() routine reads the value of floating-point register reg
     in the stack frame identified by cursor cp and  stores  the  value  in  the
     variable pointed to by valp.

     The register numbering is target-dependent and described in separate manual
     pages  (e.g.,  libunwind-ia64(3libunwind)	for the IA-64 target).	Further-
     more, the exact set of accessible registers may depend on the type of frame
     that cp is referring to. For ordinary stack frames, it is normally possible
     to access only the preserved (``callee-saved'') registers and frame-related
     registers (such as the stack-pointer).  However,  for  signal  frames  (see
     unw_is_signal_frame(3libunwind)), it is usually possible to access all reg-
     isters.

     Note that unw_get_fpreg() can only read the contents of floating-point reg-
     isters. See unw_get_fpreg(3libunwind) for a way to read registers which fit
     in a single word.

RETURN VALUE
     On  successful  completion, unw_get_fpreg() returns 0.  Otherwise the nega-
     tive value of one of the error codes below is returned.

THREAD AND SIGNAL SAFETY
     unw_get_fpreg() is thread safe as well as safe to use from  a  signal  han-
     dler.

ERRORS
     UNW_EUNSPEC
	     An unspecified error occurred.

     UNW_EBADREG
	     An  attempt  was  made to read a register that is either invalid or
	    not accessible in the current frame.

     In addition, unw_get_fpreg() may return  any  error  returned  by	the  ac-
     cess_mem(),  access_reg(),  and  access_fpreg()  call-backs  (see	unw_cre-
     ate_addr_space(3libunwind)).

SEE ALSO
     libunwind(3libunwind), libunwind-ia64(3libunwind), unw_get_reg(3libunwind),
     unw_is_fpreg(3libunwind),			unw_is_signal_frame(3libunwind),
     unw_set_fpreg(3libunwind)

AUTHOR
     David Mosberger-Tang
     Email: dmosberger@gmail.com
     WWW: http://www.nongnu.org/libunwind/.

Programming Library		 29 August 2023        UNW_GET_FPREG(3libunwind)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=unw_get_fpreg&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help