unw_set_iterate_phdr_function - Man Page

#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_iterate_phdr_func_t function);

The unw_set_iterate_phdr_function() routine sets the dl_iterate_phdr implementation of address space as to the function by argument function​. 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 program headers is also possible in an signal-safe manner.  Though the burden lies on the user of libunwind​.

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.

libunwind(3libunwind), unw_create_addr_space(3libunwind), dl_iterate_phdr(3libunwind),

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