2 .\" Manual page created with latex2man on Thu Aug 16 09:44:45 MDT 2007
3 .\" NOTE: This file is generated, DO NOT EDIT.
13 .TH "UNW\\_GET\\_REG" "3" "16 August 2007" "Programming Library " "Programming Library "
16 \-\- get register contents
21 #include <libunwind.h>
25 unw_get_reg(unw_cursor_t *cp,
35 routine reads the value of register
37 in the stack frame identified by cursor cp
39 the value in the word pointed to by valp\&.
41 The register numbering is target\-dependent and described in separate
42 manual pages (e.g., libunwind\-ia64(3) for the IA\-64 target).
43 Furthermore, the exact set of accessible registers may depend on the
45 is referring to. For ordinary stack
46 frames, it is normally possible to access only the preserved
47 (``callee\-saved\&'') registers and frame\-related registers (such as the
48 stack\-pointer). However, for signal frames (see
49 unw_is_signal_frame(3)),
50 it is usually possible to access
53 Note that unw_get_reg()
54 can only read the contents of
55 registers whose values fit in a single word. See
57 for a way to read registers which do not fit
63 On successful completion, unw_get_reg()
65 Otherwise the negative value of one of the error\-codes below is
68 .SH THREAD AND SIGNAL SAFETY
72 is thread\-safe as well as safe to use
73 from a signal handler.
80 An unspecified error occurred.
83 An attempt was made to read a register
84 that is either invalid or not accessible in the current frame.
86 In addition, unw_get_reg()
87 may return any error returned by
93 unw_create_addr_space(3)).
101 unw_is_signal_frame(3),
107 David Mosberger\-Tang
109 Email: \fBdmosberger@gmail.com\fP
111 WWW: \fBhttp://www.nongnu.org/libunwind/\fP\&.
112 .\" NOTE: This file is generated, DO NOT EDIT.