Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (H-K)
Guardian Procedure Calls Reference Manual—522629-013
7-31
HIST_INIT_ Procedure
workspace input, output
INT .EXT:ref:(HISTWORKSPACE_TEMPLATE)
identifies the workspace area to be initialized by this procedure with information
that establishes how the stack trace will proceed. This area must be allocated
before you call this procedure. The address of this workspace area is passed to
subsequent calls to the HIST_FORMAT_ and HIST_GETPRIOR_ procedures.
version input
INT(32):value
identifies the version of the structure and literal declarations used to compile the
caller.
HistVersion1 is a literal value defined in HHISTRY to identify the initial
version.
options input
INT:value
controls the initialization process and subsequent trace.
The type of context must be specified as one of the following:
<13:15> =0 HO_Init_Here
starts a trace of the current stack with the context of this call to
HIST_INIT_. The
context parameter is ignored in this case.
1 HO_Init_uContext
uses the uContext structure whose address is passed in the
context parameter. A uContext structure is a structure of type
UCONTEXT_T that is passed to a signal handler installed by the
SIGACTION_INIT_ or SIGACTION_SUPPLANT_ procedure.
HIST_INIT_ initializes the trace at the point where the signal was
generated. See “Protected contexts” under “Considerations” for
more information.
2HO_Init_JmpBuf
uses the context saved in a native jump buffer to start tracing at
the point of a call to the SETJMP_ or SIGSETJMP_ procedure that
filled the jump buffer. The address of the buffer is passed to
HIST_INIT_ in the
context parameter.
3 HO_Init_31Regs
is reserved for HP use.
4 HO_Init_Address
uses a 32-bit native address for the context. This address is
passed to the HIST_INIT_ procedure in the
context parameter.