table of contents
UNW_APPLY_REG_STATE(3libunwind) | Programming Library | UNW_APPLY_REG_STATE(3libunwind) |
NAME¶
unw_apply_reg_state -- apply a register state update to a cursor
SYNOPSIS¶
#include <libunwind.h>
int unw_apply_reg_state(unw_cursor_t *cp, void *reg_states_data);
DESCRIPTION¶
The unw_apply_reg_state() routine updates the register values of a cursor according to the instructions in reg_states_data, which have been obtained by calling unw_reg_states_iterate.
RETURN VALUE¶
On successful completion, unw_apply_reg_state() returns 0. Otherwise the negative value of one of the error codes below is returned.
THREAD AND SIGNAL SAFETY¶
unw_apply_reg_state() is thread safe. If cursor cp is in the local address space, this routine is also safe to use from a signal handler.
ERRORS¶
- UNW_EUNSPEC
-
An unspecified error occurred. - UNW_ENOINFO
-
Libunwind was unable to locate unwind-info for the procedure. - UNW_EBADVERSION
-
The unwind info for the procedure has version or format that is not understood by libunwind.
In addition, unw_apply_reg_state() may return any error returned by the access_mem() call-back (see unw_create_addr_space(3libunwind)).
SEE ALSO¶
libunwind(3libunwind), unw_reg_states_iterate(3libunwind)
AUTHOR¶
David Mosberger-Tang
Email: dmosberger@gmail.com
WWW: http://www.nongnu.org/libunwind/.
29 August 2023 | Programming Library |