Jump to content United States-English
HP.com Home Products and Services Support and Drivers Solutions How to Buy
» Contact HP
More options
HP.com home
HP-UX Reference > U

uwx_step(3X)

Integrity Systems Only
HP-UX 11i Version 3: February 2007
» 

Technical documentation

» Feedback
Content starts here

 » Table of Contents

 » Index

NAME

uwx_step() — step one frame

SYNOPSIS

#include <uwx.h> int uwx_step(struct uwx_env *env);

DESCRIPTION

uwx_step() is part of the Unwind Express Library for Integrity systems; see uwx(3X). uwx_step() steps back one frame from the current context and updates the context to reflect the state of the new frame. The return pointer becomes the new IP (instruction pointer), the previous stack pointer becomes the new stack pointer, the backing store pointer is adjusted to point to the previous frame's registers, the previous frame state becomes the new current frame marker, and all preserved registers are updated with the values they had in that frame. (If uwx_set_nofr() has been used to disable floating-point register tracking, the preserved floating-point registers will not be updated.)

Parameters

env

A pointer to an unwind environment object.

RETURN VALUE

uwx_step() returns UWX_OK on success. If the current frame is at the bottom of the call stack, it returns UWX_BOTTOM and the current context is unchanged. If the current frame is a signal frame (or some other ABI-dependent context frame), it returns UWX_ABI_FRAME and the current context is unchanged. All other status codes indicate errors; see uwx(3X) for error codes.

AUTHOR

The Unwind Express Library was developed by Hewlett-Packard.

Printable version
Privacy statement Using this site means you accept its terms Feedback to webmaster
© 1983-2007 Hewlett-Packard Development Company, L.P.