hpux man page for _unw_stack_trace

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)