mirror of
https://github.com/tobast/libunwind-eh_elf.git
synced 2024-11-29 02:07:39 +01:00
90 lines
1.6 KiB
Groff
90 lines
1.6 KiB
Groff
'\" t
|
|
.\" Manual page created with latex2man on Wed Aug 16 11:09:44 PDT 2017
|
|
.\" NOTE: This file is generated, DO NOT EDIT.
|
|
.de Vb
|
|
.ft CW
|
|
.nf
|
|
..
|
|
.de Ve
|
|
.ft R
|
|
|
|
.fi
|
|
..
|
|
.TH "UNW\\_APPLY\\_REG\\_STATE" "3" "16 August 2017" "Programming Library " "Programming Library "
|
|
.SH NAME
|
|
unw_apply_reg_state
|
|
\-\- apply a register state update to a cursor
|
|
.PP
|
|
.SH SYNOPSIS
|
|
|
|
.PP
|
|
#include <libunwind.h>
|
|
.br
|
|
.PP
|
|
int
|
|
unw_apply_reg_state(unw_cursor_t *cp,
|
|
void *reg_states_data);
|
|
.br
|
|
.PP
|
|
.SH DESCRIPTION
|
|
|
|
.PP
|
|
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\&.
|
|
.PP
|
|
.SH RETURN VALUE
|
|
|
|
.PP
|
|
On successful completion, unw_apply_reg_state()
|
|
returns 0.
|
|
Otherwise the negative value of one of the error\-codes below is
|
|
returned.
|
|
.PP
|
|
.SH THREAD AND SIGNAL SAFETY
|
|
|
|
.PP
|
|
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.
|
|
.PP
|
|
.SH ERRORS
|
|
|
|
.PP
|
|
.TP
|
|
UNW_EUNSPEC
|
|
An unspecified error occurred.
|
|
.TP
|
|
UNW_ENOINFO
|
|
Libunwind
|
|
was unable to locate
|
|
unwind\-info for the procedure.
|
|
.TP
|
|
UNW_EBADVERSION
|
|
The unwind\-info for the procedure has
|
|
version or format that is not understood by libunwind\&.
|
|
.PP
|
|
In addition, unw_apply_reg_state()
|
|
may return any error
|
|
returned by the access_mem()
|
|
call\-back (see
|
|
unw_create_addr_space(3)).
|
|
.PP
|
|
.SH SEE ALSO
|
|
|
|
.PP
|
|
libunwind(3),
|
|
unw_reg_states_iterate(3)
|
|
.PP
|
|
.SH AUTHOR
|
|
|
|
.PP
|
|
David Mosberger\-Tang
|
|
.br
|
|
Email: \fBdmosberger@gmail.com\fP
|
|
.br
|
|
WWW: \fBhttp://www.nongnu.org/libunwind/\fP\&.
|
|
.\" NOTE: This file is generated, DO NOT EDIT.
|