_UNW_getGR(3X) _UNW_getGR(3X)
NAME
_UNW_getGR(), _UNW_getAR(), _UNW_getAlertCode(), _UNW_getBR(), _UNW_getCFM(), _UNW_getFR(), _UNW_getGR_NaT(), _UNW_getIP(), _UNW_getKernel-
SavedContext(), _UNW_getPR(), _UNW_getPreds(), _UNW_clearAlertCode() - query values in unwind library data structure
SYNOPSIS
DESCRIPTION
returns the value of a numbered general register num in the object pointed to by parameter p.
returns the value and NaT bit of a numbered general register num in the object pointed to by parameter p. The values are returned via a
structure of type The structure's value field contains the register value and the structure's NaT field contains the register NaT bit.
returns the value of a numbered floating point register num in the object pointed to by parameter p. The values are returned via a struc-
ture of type The structure's first_container and second_container fields contain the two consecutive double words of the Floating point
register Spill/Fill memory format. See
returns the value of a numbered branch register num in the object pointed to by parameter p.
returns the value of an enumerated application register num in the object pointed to by parameter p. The enumeration type is used for
accessing application registers.
returns the value of a numbered predicate register num in the object pointed to by parameter p.
returns the value of all predicate registers in the object pointed to by parameter p. The returned value contains the value of each predi-
cate register in the bit corresponding to the predicate register number -- for instance, bit 63 contains the value for predicate register
63.
returns the contents of the instruction pointer in the object pointed to by parameter p.
returns the contents of the current frame marker in the object pointed to by parameter p.
returns the most recently encountered "client needs to know" return code. If no "client needs to know" conditions have been encountered,
returns "Client needs to know" return codes are all of the enumerators in the enumeration with the exception of
clears any "client needs to know" return code in the object pointed to by parameter p.
provides the means for a tool such as a kernel debugger to obtain some of the information it needs about a kernel interruption. The values
are returned via a structure of type structure from which the client can obtain the two fields, and of the format P10 unwind descriptor.
For more detail, refer to unwind(5) and to
RETURN VALUE
Except for the register value query functions (which are functions with prefix return the requested values on successful completion or a
value equivalent to 0 otherwise.
returns values from the enumeration See on unwind(5).
returns on successful completion. Otherwise returns when is not in one of the following states: Init, User_Interrupted_Frame, User_Send-
sig_Frame, Kernel_Bottom_Frame, Frame.
EXAMPLES
Tead the value of General Register 5 in this procedure frame's context; check for range errors, query errors, etc.; then finally clear the
alert code:
WARNINGS
See the table in unwind(5), section subsection which lists when the values returned by the query functions are guaranteed to reflect the
actual register values of the given procedure's processor state. Scratch register values, for example, are valid only after crossing a
stack frame associated with an interruption. See "Chapter 5: Register Usage".
AUTHOR
and were developed by HP.
SEE ALSO
U_STACK_TRACE(3X), _UNW_createContextForSelf(3X), _UNW_currentContext(3X), unwind(5).
Integrity Systems Only _UNW_getGR(3X)