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\\_STEP" "3" "16 August 2007" "Programming Library " "Programming Library "
16 \-\- advance to next stack frame
21 #include <libunwind.h>
25 unw_step(unw_cursor_t *cp);
32 routine advances the unwind cursor cp
34 the next older, less deeply nested stack frame.
39 On successful completion, unw_step()
40 returns a positive value
41 if the updated cursor refers to a valid stack frame, or 0 if the
42 previous stack frame was the last frame in the chain. On error, the
43 negative value of one of the error\-codes below is returned.
45 .SH THREAD AND SIGNAL SAFETY
49 is thread\-safe. If cursor cp
51 address\-space, this routine is also safe to use from a signal handler.
58 An unspecified error occurred.
62 was unable to locate the
63 unwind\-info needed to complete the operation.
66 The unwind\-info needed to complete the
67 operation has a version or a format that is not understood by
71 The instruction\-pointer
72 (``program\-counter\&'') of the next stack frame is invalid (e.g., not
76 The next stack frame is invalid.
81 returned \-UNW_ESTOPUNWIND\&.
83 In addition, unw_step()
84 may return any error returned by the
86 get_dyn_info_list_addr(),
90 call\-backs (see unw_create_addr_space(3)).
96 unw_create_addr_space(3)
101 David Mosberger\-Tang
103 Email: \fBdmosberger@gmail.com\fP
105 WWW: \fBhttp://www.nongnu.org/libunwind/\fP\&.
106 .\" NOTE: This file is generated, DO NOT EDIT.