| '\" t |
| .\" Manual page created with latex2man on Thu Nov 20 17:29:54 PST 2003 |
| .\" NOTE: This file is generated, DO NOT EDIT. |
| .de Vb |
| .ft CW |
| .nf |
| .. |
| .de Ve |
| .ft R |
| |
| .fi |
| .. |
| .TH "UNW\\_STEP" "3" "20 November 2003" "Programming Library " "Programming Library " |
| .SH NAME |
| unw_step |
| \-\- advance to next stack frame |
| .PP |
| .SH SYNOPSIS |
| |
| .PP |
| #include <libunwind.h> |
| .br |
| .PP |
| int |
| unw_step(unw_cursor_t *cp); |
| .br |
| .PP |
| .SH DESCRIPTION |
| |
| .PP |
| The unw_step() |
| routine advances the unwind cursor cp |
| to |
| the next older, less deeply nested stack frame. |
| .PP |
| .SH RETURN VALUE |
| |
| .PP |
| On successful completion, unw_step() |
| returns a positive value |
| if the updated cursor refers to a valid stack frame, or 0 if the |
| previous stack frame was the last frame in the chain. On error, the |
| negative value of one of the error\-codes below is returned. |
| .PP |
| .SH THREAD AND SIGNAL SAFETY |
| |
| .PP |
| unw_step() |
| 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_ENOINFO |
| Libunwind |
| was unable to locate the |
| unwind\-info needed to complete the operation. |
| .TP |
| UNW_EBADVERSION |
| The unwind\-info needed to complete the |
| operation has a version or a format that is not understood by |
| libunwind\&. |
| .TP |
| UNW_EINVALIDIP |
| The instruction\-pointer |
| (``program\-counter\&'') of the next stack frame is invalid (e.g., not |
| properly aligned). |
| .TP |
| UNW_EBADFRAME |
| The next stack frame is invalid. |
| .TP |
| UNW_ESTOPUNWIND |
| Returned if a call to |
| find_proc_info() |
| returned \-UNW_ESTOPUNWIND\&. |
| .PP |
| In addition, unw_step() |
| may return any error returned by the |
| find_proc_info(), |
| get_dyn_info_list_addr(), |
| access_mem(), |
| access_reg(), |
| or access_fpreg() |
| call\-backs (see unw_create_addr_space(3)). |
| .PP |
| .SH SEE ALSO |
| |
| .PP |
| libunwind(3), |
| unw_create_addr_space(3) |
| .PP |
| .SH AUTHOR |
| |
| .PP |
| David Mosberger\-Tang |
| .br |
| Hewlett\-Packard Labs |
| .br |
| Palo\-Alto, CA 94304 |
| .br |
| Email: \fBdavidm@hpl.hp.com\fP |
| .br |
| WWW: \fBhttp://www.hpl.hp.com/research/linux/libunwind/\fP\&. |
| .\" NOTE: This file is generated, DO NOT EDIT. |