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).
       Furthermore, 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'') reg-
       isters and frame-related	registers (such	as  the	 stack-pointer).  How-
       ever,  for  signal  frames (see unw_is_signal_frame(3libunwind)), it is
       usually possible	to access all registers.

       Note that unw_get_fpreg() can only read the contents of	floating-point
       registers.  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
       negative	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
       handler.

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(3libun-
       wind),	 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+14.3.quarterly>

home | help