_UNW_getGR.3x (2010 09)
_
_UNW_getGR(3X) _UNW_getGR(3X)
(Integrity Systems Only)
NAME
_UNW_getGR(), _UNW_getAR(), _UNW_getAlertCode(), _UNW_getBR(), _UNW_getCFM(),
_UNW_getFR(), _UNW_getGR_NaT(), _UNW_getIP(), _UNW_getKernelSavedContext(), _UNW_getPR(),
_UNW_getPreds(), _UNW_clearAlertCode() - query values in unwind library data structure
SYNOPSIS
#include <unwind.h>
uint64_t _UNW_getGR(_Unwind_Context* p, uint32_t num);
_UNW_GR_Value _UNW_getGR_NaT(_Unwind_Context* p, uint32_t num);
_UNW_FR_Value _UNW_getFR(_Unwind_Context* p, uint32_t num);
uint64_t _UNW_getBR(_Unwind_Context* p, uint32_t num);
_UNW_getAR(_Unwind_Context* p, _UNW_AppReg num);
_UNW_Boolean _UNW_getPR(_Unwind_Context* p, uint32_t num);
uint64_t _UNW_getPreds(_Unwind_Context* p);
uint64_t _UNW_getIP(_Unwind_Context* p);
uint64_t _UNW_getCFM(_Unwind_Context* p);
_UNW_ReturnCode _UNW_getAlertCode(const _Unwind_Context *p);
void _UNW_clearAlertCode(_Unwind_Context *p);
DESCRIPTION
_UNW_getGR() returns the value of a numbered general register num in the _Unwind_Context
object pointed to by parameter p.
_UNW_getGR_NaT() returns the value and NaT bit of a numbered general register num in the
_Unwind_Context object pointed to by parameter p. The values are returned via a structure of type
_UNW_GR_Value. The structure’s value field contains the register value and the structure’s NaT field
contains the register NaT bit.
_UNW_getFR() returns the value of a numbered floating point register num in the
_Unwind_Context object pointed to by parameter p. The values are returned via a structure of type
_UNW_FR_Value. The structure’s first_container and second_container fields contain the two consecu-
tive double words of the Floating point register Spill/Fill memory format. See Intel IA-64 Architecture
Software Developer’s Manual , Volume 1: IA-64 Application Architecture , Section 5.3: Floating Point
Instructions .
_UNW_getBR() returns the value of a numbered branch register num in the _Unwind_Context
object pointed to by parameter p.
_UNW_getAR() returns the value of an enumerated application register num in the
_Unwind_Context object pointed to by parameter p. The enumeration type _UNW_AppReg is used
for accessing application registers.
_UNW_getPR() returns the value of a numbered predicate register num in the _Unwind_Context
object pointed to by parameter p.
_UNW_getPreds() returns the value of all predicate registers in the _Unwind_Context
object
pointed to by parameter p. The returned value contains the value of each predicate register in the bit
corresponding to the predicate register number — for instance, bit 63 contains the value for predicate
register 63.
getIP() returns the contents of the instruction pointer in the _Unwind_Context object pointed to by
parameter p.
getCFM() returns the contents of the current frame marker in the _Unwind_Context object pointed
to by parameter p.
_UNW_getAlertCode() returns the most recently encountered "client needs to know" return code. If
no "client needs to know" conditions have been encountered, _UNW_getAlertCode() returns
_UNW_OK. "Client needs to know" return codes are all of the enumerators in the enumeration
_UNW_ReturnCode with the exception of _UNW_OK.
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1