uwx_get_reg(3X)uwx_get_reg(3X)NAMEuwx_get_reg() - read a register from current frame's context
SYNOPSISDESCRIPTION
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 differ‐
ent register prior to making a function call. Asking
for this register will locate the true previous frame
state, whether it is currently 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 ALSOuwx(3X), uwx_add_to_bsp(3X), uwx_find_source_info(3X), uwx_find_sym‐
bol(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_call‐
backs(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)
