2003-03-28 08:43:22 +01:00
|
|
|
-*- mode: Outline -*-
|
|
|
|
|
|
|
|
|
|
This is version 0.92 of the unwind library. At the moment, only the
|
|
|
|
|
IA-64 Linux (IPF Linux) platform is fully supported. Some very basic
|
|
|
|
|
support for x86 exists also. However, the x86 support is based purely
|
|
|
|
|
on the frame-chain and does not use unwind information, so its utility
|
|
|
|
|
is limited.
|
|
|
|
|
|
|
|
|
|
* General Build Instructions
|
|
|
|
|
|
|
|
|
|
In general, this library can be built and installed with the following
|
|
|
|
|
commands:
|
2002-02-16 00:22:05 +01:00
|
|
|
|
2002-02-23 21:27:03 +01:00
|
|
|
$ ./configure
|
2002-02-16 00:22:05 +01:00
|
|
|
$ make
|
|
|
|
|
$ make install prefix=PREFIX
|
|
|
|
|
|
2002-02-23 21:27:03 +01:00
|
|
|
where PREFIX is the installation prefix. By default, a prefix of
|
|
|
|
|
/usr/local is used, such that libunwind.a is installed in
|
|
|
|
|
/usr/local/lib and unwind.h is installed in /usr/local/include. For
|
|
|
|
|
testing, you may want to use a prefix of /usr/local instead.
|
2002-02-16 00:22:05 +01:00
|
|
|
|
2003-03-28 08:43:22 +01:00
|
|
|
* Building with Intel ECC
|
|
|
|
|
|
|
|
|
|
To build libunwind with the Intel Electron compiler (ECC), it is
|
|
|
|
|
recommended to run configure like this:
|
|
|
|
|
|
|
|
|
|
$ ./configure CC=ecc CXX=ecc CCAS=gcc
|
|
|
|
|
|
|
|
|
|
The reason for this is that ECC uses the Intel assembler, which
|
|
|
|
|
doesn't grok some of the IA-64 assembly code in the "tests" directory.
|
|
|
|
|
|
|
|
|
|
For an ECC-built version of libunwind to work properly, you also need
|
|
|
|
|
to ensure that /usr/include/asm/fpu.h contains a "long double" member
|
|
|
|
|
called "__dummy" in the declaration of "struct ia64_fpreg". Without
|
|
|
|
|
that member, variables of type unw_context_t won't be aligned
|
|
|
|
|
properly.
|
|
|
|
|
|
2003-04-03 09:59:15 +02:00
|
|
|
* Building on HP-UX
|
|
|
|
|
|
|
|
|
|
For the time being, libunwind must be built with GCC on HP-UX.
|
|
|
|
|
Unfortunately, gcc-3.0 ships with a bad version of sys/types.h.
|
|
|
|
|
The workaround for this is:
|
|
|
|
|
|
|
|
|
|
$ mkdir $top_dir/include/sys
|
|
|
|
|
$ cp /usr/include/sys/types.h $top_dir/include/sys
|
|
|
|
|
|
2003-03-28 08:43:22 +01:00
|
|
|
* Regression Testing
|
|
|
|
|
|
|
|
|
|
After building the library, you can run a set of regression tests with:
|
|
|
|
|
|
|
|
|
|
$ make check
|
|
|
|
|
|
|
|
|
|
Unless you have a very recent library and compiler installed, it is
|
|
|
|
|
currently expected to have the following tests fail:
|
|
|
|
|
|
|
|
|
|
Gtest-init (should work with glibc-2.3.1)
|
|
|
|
|
Ltest-init (should work with glibc-2.3.1)
|
|
|
|
|
test-ptrace (should work with glibc-2.3.1)
|
|
|
|
|
run-ia64-test-dyn1 (should work with glibc-2.3.1)
|
|
|
|
|
|
|
|
|
|
* Contacting the Developers
|
|
|
|
|
|
2002-02-16 00:22:05 +01:00
|
|
|
Please direct all questions regarding this library to:
|
|
|
|
|
|
|
|
|
|
libunwind@linux.hpl.hp.com
|
|
|
|
|
|
|
|
|
|
For spam protection, you'll have to subscribe to this list before
|
|
|
|
|
posting a question. You can do this by sending a mail to
|
|
|
|
|
libunwind-request@linux.hpl.hp.com with a body of:
|
|
|
|
|
|
|
|
|
|
subscribe libunwind
|
|
|
|
|
|
|
|
|
|
Note: the host that is running this list is behind a firewall, so
|
|
|
|
|
you'll not be able to use the Web interface to manage your
|
|
|
|
|
subscription. Send a mail containing "help" to
|
|
|
|
|
libunwind-request@linux.hpl.hp.com for information on how to manage
|
|
|
|
|
your subscription via email.
|
