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