| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112 |
- '\" t
- .\" Manual page created with latex2man on Thu Aug 16 09:44:45 MDT 2007
- .\" NOTE: This file is generated, DO NOT EDIT.
- .de Vb
- .ft CW
- .nf
- ..
- .de Ve
- .ft R
- .fi
- ..
- .TH "UNW\\_GET\\_REG" "3" "16 August 2007" "Programming Library " "Programming Library "
- .SH NAME
- unw_get_reg
- \-\- get register contents
- .PP
- .SH SYNOPSIS
- .PP
- #include <libunwind.h>
- .br
- .PP
- int
- unw_get_reg(unw_cursor_t *cp,
- unw_regnum_t
- reg,
- unw_word_t *valp);
- .br
- .PP
- .SH DESCRIPTION
- .PP
- The unw_get_reg()
- routine reads the value of register
- reg
- in the stack frame identified by cursor cp
- and stores
- the value in the word pointed to by valp\&.
- .PP
- The register numbering is target\-dependent and described in separate
- manual pages (e.g., libunwind\-ia64(3) for the IA\-64 target).
- Furthermore, the exact set of accessible registers may depend on the
- type of frame that cp
- is referring to. For ordinary stack
- frames, it is normally possible to access only the preserved
- (``callee\-saved\&'') registers and frame\-related registers (such as the
- stack\-pointer). However, for signal frames (see
- unw_is_signal_frame(3)),
- it is usually possible to access
- all registers.
- .PP
- Note that unw_get_reg()
- can only read the contents of
- registers whose values fit in a single word. See
- unw_get_fpreg(3)
- for a way to read registers which do not fit
- this constraint.
- .PP
- .SH RETURN VALUE
- .PP
- On successful completion, unw_get_reg()
- returns 0.
- Otherwise the negative value of one of the error\-codes below is
- returned.
- .PP
- .SH THREAD AND SIGNAL SAFETY
- .PP
- unw_get_reg()
- is thread\-safe as well as safe to use
- from a signal handler.
- .PP
- .SH ERRORS
- .PP
- .TP
- UNW_EUNSPEC
- An unspecified error occurred.
- .TP
- UNW_EBADREG
- An attempt was made to read a register
- that is either invalid or not accessible in the current frame.
- .PP
- In addition, unw_get_reg()
- may return any error returned by
- the access_mem(),
- access_reg(),
- and
- access_fpreg()
- call\-backs (see
- unw_create_addr_space(3)).
- .PP
- .SH SEE ALSO
- .PP
- libunwind(3),
- libunwind\-ia64(3),
- unw_get_fpreg(3),
- unw_is_signal_frame(3),
- unw_set_reg(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.
|
