U_STACK_TRACE(3X)U_STACK_TRACE(3X)NAMEU_STACK_TRACE(), _UNW_STACK_TRACE() - produce a trace back of the pro‐
cedure call stack using the unwind library
SYNOPSISDESCRIPTION
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 condi‐
tions:
· 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.
· 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 incor‐
rect 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)