HP-UX Reference (11i v2 04/09) - 3 Library Functions N-Z (vol 7)

u
uc_access(3) uc_access(3)
(Itanium(R)-based platforms only)
__uc_set_grs()
Overwrites the saved values of the Static General Registers in the range
first through
first + count-1 inclusive, with the contents of the first
count elements of the values[]
array, and overwrites the corresponding NaT bits with bits from the
NaT argument. Only
Static General Registers (GR1-GR31) may be written with this interface. Stacked General
Registers (GR32-GR127) must be written to the RSE backing store, or the RSE Backing Store
overflow area. (See
__uc_set_rsebs()
below.)
The NaT bits corresponding to the specified General Registers must be in the corresponding
bits of NaT. e.g. the NaT bit for GR5 will be overwritten with
NaT&(1<<5).
If the context was created in a syscall, an attempt to write scratch registers (GR2, GR3 and
GR14-GR31) will return [EINVAL].
__uc_get_frs()
Returns (in the values[] array) the saved values of the Floating-Point Registers in the
range first through first + count-
1 inclusive.
If the context was created in a syscall, scratch registers (FR6-FR15 and FR32-FR127) will read
as
0.0.
__uc_set_frs()
Overwrites the saved values of the Floating-Point Registers in the range
first through
first + count-1 inclusive, with the contents of the first count elements of the
values[]
array.
If the context was created in a syscall, an attempt to write scratch registers (FR6-FR15 and
FR32-FR127) will return [EINVAL]. An attempt to set bits {127:82} of an FP value will return
[EINVAL].
__uc_get_prs()
Returns (in the location referenced by the values argument) the saved values of the Predi-
cate Registers.
If the context was created in a syscall, scratch predicates (PR6-PR15) will read as
0
.
__uc_set_prs()
Overwrites the saved values of the Predicate Registers with
values.
If the context was created in a syscall, an attempt to set scratch predicates (PR6-PR15) will
return [EINVAL].
Attempts to clear PR[0] will be silently ignored.
__uc_get_brs()
Returns (in the values[] array) the saved values of the Branch Registers in the range
first through first + count-1 inclusive.
If the context was created in a syscall, scratch registers (BR6-BR7) will read as
0
.
__uc_set_brs()
Overwrites the saved values of the Branch Registers in the range first through first +
count-1 inclusive, with the contents of the first count elements of the values[] array.
If the context was created in a syscall, an attempt to write scratch registers (BR6-BR7) will
return [EINVAL].
__uc_get_ip()
Returns (in the value argument) the saved value of the Instruction Pointer Register.
If the context was created while handling an interruption,
value will be that of the next
instruction to execute. The instruction slot will be indicated by a value of 0, 1 or 2 in the low-
order 2 bits of the value. For traps and interrupts, it will point to the next instruction. For
faults, it will point to the faulting instruction. If the context was created in a syscall, value
will be the return pointer from the system call. The low-order 2 bits of the value will be 0.
__uc_set_ip()
Overwrites the saved value of the Instruction Pointer Register with value.
If the context was created while handling an interruption, the instruction slot indicated by the
2 low-order bits of
value will be the next instruction to execute. If the context was created in
a syscall, an attempt to set the instruction slot to a non-zero value will return [EINVAL].
HP-UX 11i Version 2: September 2004 − 3 − Hewlett-Packard Company Section 3−−1127