1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
|
-*- mode: Outline -*-
This is version 0.97 of the unwind library. At the moment, only the
IA-64 Linux (IPF Linux) platform is fully supported. Some basic
support for x86 and HP-UX/IPF exists also. However, the x86 support
is based mostly on the frame-chain and does not reliably use unwind
information yet, 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.
* Important GCC v3.4.0 Caveat
GCC v3.4.0 breaks C++ ABI compatibility and because of that, libunwind
cannot easily be used as the unwinder for GCC v3.4.0. The GCC
developers are aware of the problem [1] and the expectation is that
the problem will be fixed with GCC v3.4.1. In the meantime, it may be
best to avoid using GCC v3.4.0.
[1] http://gcc.gnu.org/ml/gcc/2004-04/msg00989.html
* General Build Instructions
In general, this library can be built and installed with the following
commands:
$ ./configure
$ make
$ make install prefix=PREFIX
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.
* Building with Intel compiler
** Up to version 7
To build libunwind with the Intel Electron compiler (ECC), it is
recommended to run configure like this:
$ ./configure CC=ecc CXX=ecc CCAS=gcc CCASFLAGS=-g \
LDFLAGS="-L$PWD/src/.libs"
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.
** 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 CFLAGS="-g -O3 -ip" CXX=icc CCAS=gcc CCASFLAGS=-g \
LDFLAGS="-L$PWD/src/.libs"
* Building on HP-UX
For the time being, libunwind must be built with GCC on HP-UX.
Unfortunately, gcc-3.0 and gcc-3.2 ship 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
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
After building the library, you can run a set of regression tests with:
$ make check
** Expected results on IA-64 Linux
Unless you have a very recent C library and compiler installed, it is
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)
Ltest-init (should pass starting with glibc-2.3.x/gcc-3.4)
test-ptrace (should pass starting with glibc-2.3.x/gcc-3.4)
run-ia64-test-dyn1 (should pass starting with glibc-2.3.x)
This does not mean that libunwind cannot be used with older compilers
or C libraries, it just means that for certain corner cases, unwinding
will fail. Since they're corner cases, it is not likely for
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.
* Performance Testing
This distribution includes a few simple performance tests which give
some idea of the basic cost of various libunwind operations. After
building the library, you can run these tests with the following
commands:
$ cd tests
$ make perf
* Contacting the Developers
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.
|
