_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 structures 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 structures 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

Summary of content (2 pages)