| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106 |
- '\" 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\\_STEP" "3" "16 August 2007" "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. 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 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
- Email: \fBdmosberger@gmail.com\fP
- .br
- WWW: \fBhttp://www.nongnu.org/libunwind/\fP\&.
- .\" NOTE: This file is generated, DO NOT EDIT.
|
