U_STACK_TRACE(3X)U_STACK_TRACE(3X)NAME
U_STACK_TRACE(), _UNW_STACK_TRACE() - produce a trace back of the procedure call stack using the unwind library
SYNOPSIS DESCRIPTION
prints a formatted stack trace to standard error. produces a formatted stack trace on the output stream indicated by parameter out_file.
The stream must be a writable stream for output to be produced.
APPLICATION USAGE
and are thread-safe. They are not async-cancel-safe because they make use of which is not async-cancel-safe. A cancellation point may
occur when a thread is executing
RETURN VALUE
None
ERRORS
can fail to give the entire stack back trace under the following conditions:
o Low memory conditions. The unwind library is not able to allocate enough memory to perform the tasks of tracking back over the stack or
of looking up symbols names associated with instruction pointer addresses encountered.
o Executables and shared libraries that fail to conform to the Runtime Architecture for Itanium-based systems. For example, they may have
invalid, incomplete, or missing unwind tables; or invalid or incorrect unwind information blocks.
EXAMPLES
Given the following C program:
Compiling and executing the program produces output similar to this:
AUTHOR
was developed by HP.
SEE ALSO _UNW_createContextForSelf(3X), _UNW_currentContext(3X), _UNW_getGR(3X), unwind(5).
Itanium(R)-based System Only U_STACK_TRACE(3X)
Check Out this Related Man Page
_UNW_getGR(3X)_UNW_getGR(3X)NAME
_UNW_getGR(), _UNW_getAR(), _UNW_getAlertCode(), _UNW_getBR(), _UNW_getCFM(), _UNW_getFR(), _UNW_getGR_NaT(), _UNW_getIP(), _UNW_getKernel-
SavedContext(), _UNW_getPR(), _UNW_getPreds(), _UNW_clearAlertCode() - query values in unwind library data structure
SYNOPSIS DESCRIPTION
returns the value of a numbered general register num in the object pointed to by parameter p.
returns the value and NaT bit of a numbered general register num in the object pointed to by parameter p. The values are returned via a
structure of type The structure's value field contains the register value and the structure's NaT field contains the register NaT bit.
returns the value of a numbered floating point register num in the object pointed to by parameter p. The values are returned via a struc-
ture of type The structure's first_container and second_container fields contain the two consecutive double words of the Floating point
register Spill/Fill memory format. See
returns the value of a numbered branch register num in the object pointed to by parameter p.
returns the value of an enumerated application register num in the object pointed to by parameter p. The enumeration type is used for
accessing application registers.
returns the value of a numbered predicate register num in the object pointed to by parameter p.
returns the value of all predicate registers in the object pointed to by parameter p. The returned value contains the value of each predi-
cate register in the bit corresponding to the predicate register number -- for instance, bit 63 contains the value for predicate register
63.
returns the contents of the instruction pointer in the object pointed to by parameter p.
returns the contents of the current frame marker in the object pointed to by parameter p.
returns the most recently encountered "client needs to know" return code. If no "client needs to know" conditions have been encountered,
returns "Client needs to know" return codes are all of the enumerators in the enumeration with the exception of
clears any "client needs to know" return code in the object pointed to by parameter p.
provides the means for a tool such as a kernel debugger to obtain some of the information it needs about a kernel interruption. The values
are returned via a structure of type structure from which the client can obtain the two fields, and of the format P10 unwind descriptor.
For more detail, refer to unwind(5) and to
RETURN VALUE
Except for the register value query functions (which are functions with prefix return the requested values on successful completion or a
value equivalent to 0 otherwise.
returns values from the enumeration See on unwind(5).
returns on successful completion. Otherwise returns when is not in one of the following states: Init, User_Interrupted_Frame, User_Send-
sig_Frame, Kernel_Bottom_Frame, Frame.
EXAMPLES
Tead the value of General Register 5 in this procedure frame's context; check for range errors, query errors, etc.; then finally clear the
alert code:
WARNINGS
See the table in unwind(5), section subsection which lists when the values returned by the query functions are guaranteed to reflect the
actual register values of the given procedure's processor state. Scratch register values, for example, are valid only after crossing a
stack frame associated with an interruption. See "Chapter 5: Register Usage".
AUTHOR
and were developed by HP.
SEE ALSO U_STACK_TRACE(3X), _UNW_createContextForSelf(3X), _UNW_currentContext(3X), unwind(5).
Integrity Systems Only _UNW_getGR(3X)