Doc: Add elfutils to README
[babeltrace.git] / README
CommitLineData
d79865b9 1BabelTrace - Trace Format Babel Tower
d79865b9
MD
2
3This project provides trace read and write libraries, as well as a trace
4converter. A plugin can be created for any trace format to allow its conversion
5to/from another trace format.
efc652bd 6
f5f66f74
MD
7The main format expected to be converted to/from is the Common Trace
8Format (CTF). The latest version of the CTF specification can be found at:
9
10 git tree: git://git.efficios.com/ctf.git
11 gitweb: http://git.efficios.com/?p=ctf.git
12
d8ff4d5c
MD
13The CE Workgroup of the Linux Foundation, Ericsson, and EfficiOS have
14sponsored this work.
15
e67a221d
MD
16The current maintainers are:
17 Jérémie Galarneau <jeremie.galarneau@efficios.com>
18 Mathieu Desnoyers <mathieu.desnoyers@efficios.com>
19
20Questions should be addressed to this mailing list:
21 lttng-dev@lists.lttng.org
22
f5f66f74 23
5c9abf1b
MD
24BUILDING
25--------
efc652bd 26
5c9abf1b
MD
27 ./bootstrap (skip if using tarball)
28 ./configure
29 make
30 make install
5d2e189a 31 ldconfig
5c9abf1b 32
e67a221d 33
5c9abf1b
MD
34DEPENDENCIES
35------------
36
37To compile Babeltrace, you will need:
38
39 gcc 3.2 or better
5c9abf1b
MD
40 libc6 development librairies
41 (Debian : libc6, libc6-dev)
42 (Fedora : glibc, glibc)
0da4d788
MD
43 glib 2.22 or better development libraries
44 (Debian : libglib2.0-0, libglib2.0-dev)
45 (Fedora : glib2, glib2-devel)
ce8e64d5
MD
46 uuid development libraries
47 (Debian : uuid-dev)
48 (Fedora : uuid-devel)
8479699f 49 libpopt >= 1.13 development libraries
0da4d788 50 (Debian : libpopt-dev)
16b695f5 51 (Fedora : popt)
f5c538c0
MJ
52 elfutils development libraries (optional)
53 (Debian : libelf-dev, libdw-dev)
54 (Fedora : elfutils-devel, elfutils-libelf-devel)
24a3136a 55 python headers (optional)
94a6cea3 56 (Debian/Ubuntu : python3-dev)
24a3136a
DS
57 swig >= 2.0 (optional)
58 (Debian/Ubuntu : swig2.0)
e0275755 59 python >= 3.0 (optional)
9872e818 60 (Debian/Ubuntu : python3)
4f5f37d9
PP
61 sphinx >= 1.2 (optional)
62 (Debian/Ubuntu : python3-sphinx)
24a3136a 63
94a6cea3
JG
64 If you want Python bindings, run ./configure --enable-python-bindings.
65 Please note that some distributions will need the following
66 environment variables set before running configure:
67
68 export PYTHON="python3"
69 export PYTHON_CONFIG="/usr/bin/python3-config"
5c9abf1b
MD
70
71For developers using the git tree:
efc652bd
MD
72
73This source tree is based on the autotools suite from GNU to simplify
74portability. Here are some things you should have on your system in order to
75compile the git repository tree :
76
76fb4848 77- GNU autotools (automake >=1.10, autoconf >=2.50, autoheader >=2.50)
efc652bd 78 (make sure your system wide "automake" points to a recent version!)
0f71b863 79- GNU Libtool >=2.2
efc652bd 80 (for more information, go to http://www.gnu.org/software/autoconf/)
5e7e97cb
MD
81- Flex >=2.5.35.
82- Bison >=2.4.
efc652bd
MD
83
84If you get the tree from the repository, you will need to use the "bootstrap"
85script in the root of the tree. It calls all the GNU tools needed to prepare the
86tree configuration.
db96f222
MD
87
88Running "make check": bash is required.
This page took 0.034365 seconds and 4 git commands to generate.