Fix: Allow the addition of environment fields to a frozen trace
[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)
24a3136a 52 python headers (optional)
94a6cea3 53 (Debian/Ubuntu : python3-dev)
24a3136a
DS
54 swig >= 2.0 (optional)
55 (Debian/Ubuntu : swig2.0)
e0275755 56 python >= 3.0 (optional)
9872e818 57 (Debian/Ubuntu : python3)
4f5f37d9
PP
58 sphinx >= 1.2 (optional)
59 (Debian/Ubuntu : python3-sphinx)
24a3136a 60
94a6cea3
JG
61 If you want Python bindings, run ./configure --enable-python-bindings.
62 Please note that some distributions will need the following
63 environment variables set before running configure:
64
65 export PYTHON="python3"
66 export PYTHON_CONFIG="/usr/bin/python3-config"
5c9abf1b
MD
67
68For developers using the git tree:
efc652bd
MD
69
70This source tree is based on the autotools suite from GNU to simplify
71portability. Here are some things you should have on your system in order to
72compile the git repository tree :
73
76fb4848 74- GNU autotools (automake >=1.10, autoconf >=2.50, autoheader >=2.50)
efc652bd 75 (make sure your system wide "automake" points to a recent version!)
0f71b863 76- GNU Libtool >=2.2
efc652bd 77 (for more information, go to http://www.gnu.org/software/autoconf/)
5e7e97cb
MD
78- Flex >=2.5.35.
79- Bison >=2.4.
efc652bd
MD
80
81If you get the tree from the repository, you will need to use the "bootstrap"
82script in the root of the tree. It calls all the GNU tools needed to prepare the
83tree configuration.
db96f222
MD
84
85Running "make check": bash is required.
This page took 0.034672 seconds and 4 git commands to generate.