uwx_get_reg(3X) 														   uwx_get_reg(3X)

NAME

       uwx_get_reg() - read a register from current frame's context

SYNOPSIS


DESCRIPTION

       is  part  of  the Unwind Express Library for Integrity systems; see uwx(3X).  reads the value of a register from the context of the current
       frame.

   Parameters
       env     A pointer to an unwind environment object.

       regid   An identifier for the register to be read.  This parameter must be one of the following values:
	       The instruction pointer (IP).

	       The stack pointer (SP).

	       The backing store pointer (BSP).
		      This value defines the point in the backing store where the current frame's GR32 would be saved.

	       The current frame marker (CFM) and epilogue counter (ar.ec),
		      combined into one register as they are stored in ar.pfs.

	       The return pointer (RP, the previous frame's IP).

	       The previous stack pointer (PSP, the previous frame's SP).

	       The previous frame state (PFS, the previous frame's CFM and ar.ec).
		      Note that this is not necessarily the same as as the previous frame's state may have been  saved	to  a  different  register
		      prior  to  making  a  function call.  Asking for this register will locate the true previous frame state, whether it is cur-
		      rently in ar.pfs or saved in a different register.

	       Predicate registers PR0-PR63.
		      Only the preserved predicates have meaningful values.

	       The NaT bits for GR4-7 in the current frame.

	       The RSE NaT collection register (ar.rnat).

	       The User NaT collection register (ar.unat).

	       The floating-point status register (ar.fpsr).

	       The loop counter register (ar.lc).

	       The previous function state register (ar.pfs).
		      Note that this is not necessarily the same as UWX_REG_PFS, as the previous frame's state may have been saved to a  different
		      register	prior to making a function call.  Asking for this register will return the contents of the ar.pfs register for the
		      current frame.

	       General register
		      GRx.  Only registers GR4-GR7 (the preserved GRs) and GR32-GR127 (the stacked GRs) may be read.

	       Branch register
		      BRx.  Only registers BR1-BR5 (the preserved BRs) may be read.

	       Floating-point register
		      GRx.  Only registers FR2-FR5 and FR16-31 (the preserved FRs) may be read.

       valp    Pointer to the return buffer where the value is written.  The buffer must be 16 bytes long for floating-point values,  or  8  bytes
	       long for all other values.

RETURN VALUE

       returns on success.  See uwx(3X) for error codes.

AUTHOR

       The Unwind Express Library was developed by Hewlett-Packard.

SEE ALSO

       uwx(3X),  uwx_add_to_bsp(3X),  uwx_find_source_info(3X),  uwx_find_symbol(3X),  uwx_free(3X),  uwx_get_abi_context_code(3X),  uwx_get_func-
       start(3X), uwx_get_module_info(3X), uwx_get_nat(3X),  uwx_get_source_info(3X),  uwx_get_sym_info(3X),  uwx_init(3X),  uwx_init_context(3X),
       uwx_register_alloc_cb(3X), uwx_register_callbacks(3X), uwx_release_symbol_cache(3X), uwx_self_do_context_frame(3X), uwx_self_free_info(3X),
       uwx_self_init_context(3X), uwx_self_init_info(3X), uwx_set_nofr(3X), uwx_set_remote(3X), uwx_step(3X), uwx_step_inline(3X).

							      Integrity Systems Only						   uwx_get_reg(3X)