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

FreeBSD Manual Pages

  
 
  

home | help
UNW_IS...L_FRAME(3libunwind) Programming Library  UNW_IS...L_FRAME(3libunwind)

NAME
       unw_is_signal_frame -- check if current frame is	a signal frame

SYNOPSIS
       #include	<libunwind.h>

       int unw_is_signal_frame(unw_cursor_t *cp);

DESCRIPTION
       The  unw_is_signal_frame() routine returns a positive value if the cur-
       rent frame identified by	cp is a	signal frame, also known as  a	signal
       trampoline,  and	 a value of 0 otherwise.  For the purpose of this dis-
       cussion,	a signal frame is a frame that was created in  response	 to  a
       potentially  asynchronous  interruption.	  For UNIX and UNIX-like plat-
       forms, such frames are normally created by the kernel when delivering a
       signal.	In a kernel environment, a signal frame	 might,	 for  example,
       correspond to a frame created in	response to a device interrupt.

       Signal  frames  are somewhat unusual because the	asynchronous nature of
       the events that create them require storing the contents	 of  registers
       that are	normally treated as scratch (``caller-saved'') registers.

RETURN VALUE
       On  successful  completion,  unw_is_signal_frame()  returns  a positive
       value if	the current frame is a signal frame, or	0 if it	is not.	Other-
       wise, a negative	value of one of	the error codes	below is returned.

THREAD AND SIGNAL SAFETY
       unw_is_signal_frame() is	thread safe as well as safe to use from	a sig-
       nal handler.

ERRORS
       UNW_ENOINFO
	       Libunwind is unable to determine	whether	 or  not  the  current
	      frame is a signal	frame.

SEE ALSO
       libunwind(3libunwind),	unw_get_reg(3libunwind),   unw_set_reg(3libun-
       wind), unw_get_fpreg(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_IS...L_FRAME(3libunwind)

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

home | help