_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_getK‐
ernelSavedContext(), _UNW_getPR(), _UNW_getPreds(), _UNW_clearAlert‐
Code() - query values in unwind library data structure
SYNOPSISDESCRIPTION
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 struc‐
ture 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 ALSOU_STACK_TRACE(3X), _UNW_createContextForSelf(3X), _UNW_currentCon‐
text(3X), unwind(5).
Integrity Systems Only _UNW_getGR(3X)
