mirror of
https://github.com/tobast/libunwind-eh_elf.git
synced 2024-11-28 18:07:37 +01:00
Update for release of v0.95.
(Logical change 1.131)
This commit is contained in:
parent
2dcaa68adb
commit
ef00f9586c
1 changed files with 46 additions and 8 deletions
54
README
54
README
|
@ -1,10 +1,12 @@
|
||||||
-*- mode: Outline -*-
|
-*- mode: Outline -*-
|
||||||
|
|
||||||
This is version 0.92 of the unwind library. At the moment, only the
|
This is version 0.95 of the unwind library. At the moment, only the
|
||||||
IA-64 Linux (IPF Linux) platform is fully supported. Some very basic
|
IA-64 Linux (IPF Linux) platform is fully supported. Some very basic
|
||||||
support for x86 exists also. However, the x86 support is based purely
|
support for x86 and HP-UX/IPF exists also. However, the x86 support
|
||||||
on the frame-chain and does not use unwind information, so its utility
|
is based purely on the frame-chain and does not use unwind
|
||||||
is limited.
|
information, so its utility is limited. Similarly, the HP-UX/IPF
|
||||||
|
support is incomplete, though it is sufficient to do a basic
|
||||||
|
backtrace. unw_resume() is not supported, however.
|
||||||
|
|
||||||
* General Build Instructions
|
* General Build Instructions
|
||||||
|
|
||||||
|
@ -31,7 +33,9 @@ September 2003, this appears to be a common problem for Debian
|
||||||
option "--disable-__thread".
|
option "--disable-__thread".
|
||||||
|
|
||||||
|
|
||||||
* Building with Intel ECC
|
* Building with Intel compiler
|
||||||
|
|
||||||
|
** Up to version 7
|
||||||
|
|
||||||
To build libunwind with the Intel Electron compiler (ECC), it is
|
To build libunwind with the Intel Electron compiler (ECC), it is
|
||||||
recommended to run configure like this:
|
recommended to run configure like this:
|
||||||
|
@ -47,23 +51,41 @@ called "__dummy" in the declaration of "struct ia64_fpreg". Without
|
||||||
that member, variables of type unw_context_t won't be aligned
|
that member, variables of type unw_context_t won't be aligned
|
||||||
properly.
|
properly.
|
||||||
|
|
||||||
|
** Version 8 and later
|
||||||
|
|
||||||
|
Starting with version 8, the preferred name for the IA-64 Intel
|
||||||
|
compiler is "icc" (same name as on x86). Thus, the configure-line
|
||||||
|
should look like this:
|
||||||
|
|
||||||
|
$ ./configure CC=icc CXX=icc CCAS=gcc
|
||||||
|
|
||||||
* Building on HP-UX
|
* Building on HP-UX
|
||||||
|
|
||||||
For the time being, libunwind must be built with GCC 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.
|
Unfortunately, gcc-3.0 and gcc-3.2 ship with a bad version of
|
||||||
The workaround for this is:
|
sys/types.h. The workaround for this is:
|
||||||
|
|
||||||
$ mkdir $top_dir/include/sys
|
$ mkdir $top_dir/include/sys
|
||||||
$ cp /usr/include/sys/types.h $top_dir/include/sys
|
$ cp /usr/include/sys/types.h $top_dir/include/sys
|
||||||
|
|
||||||
|
Apart from this glitch, libunwind should configure and install on
|
||||||
|
HP-UX like this:
|
||||||
|
|
||||||
|
$ ./configure CFLAGS="-g -O2 -mlp64"
|
||||||
|
|
||||||
|
Caveat: Unwinding of 32-bit (ILP32) binaries is not supported
|
||||||
|
at the moment.
|
||||||
|
|
||||||
* Regression Testing
|
* Regression Testing
|
||||||
|
|
||||||
After building the library, you can run a set of regression tests with:
|
After building the library, you can run a set of regression tests with:
|
||||||
|
|
||||||
$ make check
|
$ make check
|
||||||
|
|
||||||
|
** Expected results on IA-64 Linux
|
||||||
|
|
||||||
Unless you have a very recent C library and compiler installed, it is
|
Unless you have a very recent C library and compiler installed, it is
|
||||||
currently expected to have the following tests fail:
|
currently expected to have the following tests fail on IA-64 Linux:
|
||||||
|
|
||||||
Gtest-init (should pass starting with glibc-2.3.x/gcc-3.4)
|
Gtest-init (should pass starting with glibc-2.3.x/gcc-3.4)
|
||||||
Ltest-init (should pass starting with glibc-2.3.x/gcc-3.4)
|
Ltest-init (should pass starting with glibc-2.3.x/gcc-3.4)
|
||||||
|
@ -75,6 +97,22 @@ or C libraries, it just means that for certain corner cases, unwinding
|
||||||
will fail. Since they're corner cases, it is not likely for
|
will fail. Since they're corner cases, it is not likely for
|
||||||
applications to trigger them.
|
applications to trigger them.
|
||||||
|
|
||||||
|
** Expected results on x86 Linux
|
||||||
|
|
||||||
|
The following tests are expected to fail on x86 Linux:
|
||||||
|
|
||||||
|
test-proc-info (x86 unwinder doesn't use unwind-info yet)
|
||||||
|
Gtest-exc (unw_resume() not implmented yet)
|
||||||
|
Ltest-exc (unw_resume() not implmented yet)
|
||||||
|
test-setjmp (unw_resume() not implmented yet)
|
||||||
|
|
||||||
|
** Expected results on HP-UX
|
||||||
|
|
||||||
|
"make check" is currently unsupported for HP-UX. The only test
|
||||||
|
programs that are known to work at this time are tests/bt (which
|
||||||
|
produces various backtraces) and tests/Gperf-simple, which does some
|
||||||
|
simple performance measurements.
|
||||||
|
|
||||||
* Contacting the Developers
|
* Contacting the Developers
|
||||||
|
|
||||||
Please direct all questions regarding this library to:
|
Please direct all questions regarding this library to:
|
||||||
|
|
Loading…
Reference in a new issue