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

ManualsBrandsHP ManualsSoftwareHP-UX Reference Manuals

_UNW_getGR(3X) _UNW_getGR(3X)

(Itanium(R)-based System Only)

NAME

_UNW_getGR(), _UNW_getGR_NaT(), _UNW_getFR(), _UNW_getBR(), _UNW_getAR(), _UNW_getPR(),

_UNW_getPreds(), _UNW_getIP(), _UNW_getCFM(), _UNW_getAlertCode(), _UNW_clearAlertCode(),

_UNW_getKernelSavedContext() - 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 ﬁeld contains the register value and the structure’s NaT ﬁeld

contains the register NaT bit.

_UNW_getFR() returns the value of a numbered ﬂoating 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 ﬁrst_container and second_container ﬁelds contain the two consecutive

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 regis-

ter 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.

_UNW_clearAlertCode() clears any ‘‘client needs to know’’ return code in the _Unwind_Context

object pointed to by parameter p.

HP-UX 11i Version 2: December 2007 Update − 1 − Hewlett-Packard Company 75