HP-UX Reference (11i v2 07/12) - 3 Library Functions A-M (vol 6)

_
_UNW_currentContext(3X) _UNW_currentContext(3X)
(Itanium(R)-based System Only)
NAME
_UNW_currentContext(), _UNW_clear(), _UNW_jmpbufContext(), _UNW_setAR(), _UNW_setBR(),
_UNW_setCFM(), _UNW_setFR(), _UNW_setGR(), _UNW_setGR_NaT(), _UNW_setIP(), _UNW_setPR(),
_UNW_setPreds(), _UNW_GR_PhysicalNumber(), _UNW_FR_PhysicalNumber(),
_UNW_PR_PhysicalNumber(), _UNW_step() - manipulate values in unwind library data structure
SYNOPSIS
#include <unwind.h>
_UNW_ReturnCode _UNW_currentContext(_Unwind_Context* p);
_UNW_ReturnCode _UNW_clear(_Unwind_Context* p);
_UNW_ReturnCode _UNW_jmpbufContext(_Unwind_Context* p,
jmp_buf env);
_UNW_ReturnCode _UNW_setGR(_Unwind_Context* p,
uint32_t num,
uint64_t value);
_UNW_ReturnCode _UNW_setGR_NaT(_Unwind_Context* p,
uint32_t num,
uint64_t value,
_UNW_Boolean NaTval);
_UNW_ReturnCode _UNW_setFR(_Unwind_Context* p,
uint32_t num,
uint64_t first_container,
uint64_t second_container);
_UNW_ReturnCode _UNW_setBR(_Unwind_Context* p,
uint32_t num,
uint64_t value);
_UNW_ReturnCode _UNW_setAR(_Unwind_Context* p,
_UNW_AppReg num,
uint64_t value);
_UNW_ReturnCode _UNW_setPR(_Unwind_Context* p,
uint32_t num,
_UNW_Boolean value);
_UNW_ReturnCode _UNW_setPreds(_Unwind_Context* p, uint64_t value);
_UNW_ReturnCode _UNW_setIP(_Unwind_Context* p, uint64_t value);
_UNW_ReturnCode _UNW_setCFM(_Unwind_Context* p, uint64_t value);
uint32_t _UNW_GR_PhysicalNumber(_Unwind_Context* p, uint32_t logical_num);
uint32_t _UNW_FR_PhysicalNumber(_Unwind_Context* p, uint32_t logical_num);
uint32_t _UNW_PR_PhysicalNumber(_Unwind_Context* p, uint32_t logical_num);
_UNW_ReturnCode _UNW_step(_Unwind_Context* p);
DESCRIPTION
_UNW_currentContext() initializes the _Unwind_Context
object to describe the processor state
of the procedure which is calling
_UNW_currentContext— in other words, the processor state of "self."
_UNW_jmpbufContext() initializes the _Unwind_Context
object to describe the processor state
captured in a
jmp_buf by a call to setjmp(3C).
_UNW_clear() resets the _Unwind_Context object to the "just constructed" condition. All register
values in the _Unwind_Context are invalidated. The unwind library is placed in the Init state mean-
ing the client can now use the _UNW_set routines to initialize values in the
_Unwind_Context. The
Init state is discussed further in unwind(5).
_UNW_setGR() initializes the value of numbered general register num to value in the
_Unwind_Context pointed to by parameter p. The NAT bit for the register is set to _UNW_FALSE .
70 Hewlett-Packard Company − 1 − HP-UX 11i Version 2: December 2007 Update