Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (H-K)
Guardian Procedure Calls Reference Manual—522629-013
7-14
HIST_FORMAT_ Procedure
If a larger set of RISC registers is being displayed because of
the HF_Context or HF_Registers options, the
HF_LocLineRISC information is redundant and not shown.
HF_LocLineTNS For procedures executing in TNS or accelerated mode, shows
the values of P, E, L, and S (when available), in octal.
HF_Name Shows the procedure name if available. If the name is not
available, the action depends upon the rest of the
FormatSelect field. If no other option is set (other than
HF_Parent), HIST_FORMAT_ returns 0 and nothing is
formatted for display. In this special case, you can change
FormatSelect and call HIST_FORMAT_ again without
causing a HIST_BAD_FORMAT_CALL error.
If any other option is set in
FormatSelect, the code address
is displayed instead of the unavailable name.
HF_Offset Shows the offset from the beginning of the procedure of the
current program location, if it is available and nonzero.
HF_Parent Shows the name of the parent procedure for any
subprocedure, in addition to the subprocedure name, in the
form PROC.SUBPROC. This option is effective only if the
HF_Name option is also set. By itself, HF_Name causes only
.SUBPROC to be shown.
This option supports code that is displaying a single context
(as from a signal handler) without tracing the stack. In a stack
trace, the parent name typically appears later in the trace.
HF_Registers Shows all the RISC registers for which the value is known. In
general, the complete set is known only when initiating (or
continuing) a trace from a uContext structure (that is, the
HIST_INIT_ procedure was called with
options.<13:15> set
to HO_Init_uContext). Otherwise, only those registers whose
values are still known are displayed; these registers include
the save registers (s0 through s8), which are saved by the
called procedure if used, the stack pointer (sp) and program
counter (pc), which revert to their original values when a
procedure exits, and the global pointer (gp), which is not
changed.
•
The following literals define combinations of other HF_* literals:
HF_base = HF_Name + HF_Offset + HF_CodeSpace
HF_trace = HF_base + HF_Gaps
HF_withContext = HF_trace + HF_Context + HF_Context_TNS
HF_full = HF_withContext + HF_Registers