HP-UX 11i Version 1.5 Release Notes, September 2001

Programming
New Unwind Library
Chapter 7 107
The set of text error messages produced by the unwind library has been
replaced with the enumeration _UNW_ReturnCode in the
/usr/include/unwind.h header file. This allows programatic operation
of the unwinder.
NOTE The U_STACK_TRACE() function is unchanged. It is the most commonly
used and least architecturally dependent interface into the unwinder. A
large percentage of customers who use Unwind only use
U_STACK_TRACE().
Unwind Library Name Changes
HP-UX 11i Version 1.5 (B.11.20) includes both 32 and 64 bit versions of
the unwind library. The 32 bit version is at
/usr/lib/hpux32/libunwind.so.1
and linked to
/usr/lib/hpux32/libunwind.so
The 64 bit version is at
/usr/lib/hpux64/libunwind.so.1
and linked to
/usr/lib/hpux64/libunwind.so
To prevent link line compatibility issues during a port from PA to IPF,
/usr/lib/hpux32/libcl.so and /usr/lib/hpux64/libcl.so each list
the appropriate libunwind.so as a dependency. Also, libcl.so lists the
appropriate Fortran I/O support library as a dependency.
Unwind Library Compatibility
Developers writing stack unwind routines should be aware of the
following porting compatibility issues:
• Applications which used the PA unwind library (in libcl) to perform
analysis when encountering an exception or a breakpoint (as in a
debugger) and which used entry points other than
U_STACK_TRACE() will need to change calls to the unwinder and
interpret the return codes in the enumeration _UNW_ReturnCode.