GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  UNW_STEP (3)

NAME

unw_step -- advance to next stack frame

CONTENTS

Synopsis
Description
Return Value
Thread And Signal Safety
Errors
See Also
Author

SYNOPSIS

#include <libunwind.h>

int unw_step(unw_cursor_t *cp);

DESCRIPTION

The unw_step() routine advances the unwind cursor cp to the next older, less deeply nested stack frame.

RETURN VALUE

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.

THREAD AND SIGNAL SAFETY

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.

ERRORS

UNW_EUNSPEC
  An unspecified error occurred.
UNW_ENOINFO
  Libunwind was unable to locate the unwind-info needed to complete the operation.
UNW_EBADVERSION
  The unwind-info needed to complete the operation has a version or a format that is not understood by libunwind.
UNW_EINVALIDIP
  The instruction-pointer (‘‘program-counter’’) of the next stack frame is invalid (e.g., not properly aligned).
UNW_EBADFRAME
  The next stack frame is invalid.
UNW_ESTOPUNWIND
  Returned if a call to find_proc_info() returned -UNW_ESTOPUNWIND.
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)).

SEE ALSO

libunwind(3), unw_create_addr_space(3)

AUTHOR

David Mosberger-Tang
Email: dmosberger@gmail.com
WWW: http://www.nongnu.org/libunwind/.

Search for    or go to Top of page |  Section 3 |  Main Index


Programming Library UNW\_STEP (3) 16 August 2007

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.