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

FreeBSD Manual Pages

  
 
  

home | help
UNW_SE...UNCTION(3libunwind) Programming Library  UNW_SE...UNCTION(3libunwind)

NAME
       unw_set_iterate_phdr_function --	set dl_iterate_phdr implementation

SYNOPSIS
       #include	<libunwind.h>

       typedef	 int   (*unw_iterate_phdr_callback_t)(struct  dl_phdr_info  *,
       size_t, void *);
       typedef	 int   (*unw_iterate_phdr_func_t)(unw_iterate_phdr_callback_t,
       void *);

       void   unw_set_iterate_phdr_function(unw_addr_space_t   as,   unw_iter-
       ate_phdr_func_t function);

DESCRIPTION
       The unw_set_iterate_phdr_function() routine  sets  the  dl_iterate_phdr
       implementation  of  address  space as to	the function by	argument func-
       tion.  The function will	be called whenever libunwind needs to  iterate
       over  the program headers of the	application.  This is normally done by
       calling dl_iterate_phdr,	but this function is not  signal  safe.	  With
       the help	of a custom implementation caching and iterating over the pro-
       gram  headers  is  also	possible in an signal-safe manner.  Though the
       burden lies on the user of libunwind.

THREAD AND SIGNAL SAFETY
       unw_set_iterate_phdr_function() is thread safe. If  the	local  address
       space is	passed in argument as, this routine is also safe to use	from a
       signal handler.

SEE ALSO
       libunwind(3libunwind),	 unw_create_addr_space(3libunwind),   dl_iter-
       ate_phdr(3libunwind),

AUTHOR
       Bert Wesarg
       Email: bert.wesarg@googlemail.com
       WWW: http://www.nongnu.org/libunwind/.

Programming Library		29 August 2023	  UNW_SE...UNCTION(3libunwind)

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

home | help