Update version to 0.16
[ust.git] / README
CommitLineData
1af1f1db
PMF
1LTTNG USERSPACE TRACER (UST)
2----------------------------
3
cb974fbd 4UST web site and manual: http://lttng.org/ust
2615de09 5
0207cc51 6Updated versions of this package may be found at:
0207cc51 7
8f03ca96 8 * Website: http://lttng.org/ust
2a93485b 9 * Releases: http://lttng.org/files/ust/releases
03be2f30
YB
10 * GitWeb: http://git.lttng.org (project: ust)
11 * Git: git://git.lttng.org/ust.git
2615de09 12
2615de09 13
2a93485b 14PREREQUISITES:
6514bc5d 15
2a93485b 16 - liburcu
2a93485b 17 Userspace RCU library, by Mathieu Desnoyers and Paul E. McKenney
2615de09 18
5296e06c 19 -> This release depends on liburcu v0.6.6
2615de09 20
8f03ca96
PMF
21 * Debian/Ubuntu package: liburcu-dev
22 * Website: http://lttng.org/urcu
23 * Releases: http://lttng.org/files/urcu
24 * GitWeb: http://lttng.org/cgi-bin/gitweb.cgi?p=userspace-rcu.git;a=summary
25 * Git: git://lttng.org/userspace-rcu.git
cbccb4a9 26
2a93485b 27
5de791bd 28INSTALLATION INSTRUCTIONS:
2a93485b 29
7066ec32 30 - Download, compile and install liburcu.
2a93485b
PMF
31 - In this package's tree, run ./configure.
32 - Run make.
33 - Run make install.
34 - Run ldconfig.
937e29d7 35 - See the manual for usage instructions.
2a93485b 36
1ffa770b
PMF
37 If compiling from the git repository, run ./bootstrap before running
38 the configure script, to generate it.
2a93485b
PMF
39
40
5de791bd
PMF
41TRACE VIEWER:
42
43 LTTV is used for viewing UST traces. LTTV may be obtained at
44 http://lttng.org in the Downloads section.
45
ec3e0940 46 This release has been tested with LTTV 0.12.32.
5de791bd
PMF
47
48
13ef5c0e
MD
49CONTACT:
50
51 Maintainer: Mathieu Desnoyers <mathieu.desnoyers@efficios.com>
52 Mailing list: ltt-dev@lists.casi.polymtl.ca
53
54
2a93485b
PMF
55PACKAGE CONTENTS:
56
5de791bd
PMF
57 This package contains the following elements.
58
2a93485b
PMF
59 - libust
60 The actual userspace tracing library that must be linked to the
61 instrumented programs.
62
63 - ustctl
64 A program to control the tracing of userspace applications. It can list
65 markers, start the tracing, stop the tracing, enable/disable markers, etc.
66
56097329
PMF
67 - include
68 The public header files that will be installed on the system.
69
9dc7b7ff 70 - ust-consumerd
2a93485b
PMF
71 The daemon that collects trace data and writes it to the disk.
72
1af1f1db
PMF
73 - doc
74 The documentation.
2a93485b 75
a4c5d022
PMF
76 - tests
77 Various test programs
2a93485b 78
7066ec32 79 - libustinstr-malloc
2a93485b
PMF
80 An example library that can be LD_PRELOAD'ed to instrument calls to malloc()
81 in any program without need to recompile it.
82
7066ec32 83 - libustfork
2a93485b 84 A library that is LD_PRELOAD'ed, and that hijacks calls to several system
1ffa770b
PMF
85 calls in order to trace across these calls. It _has_ to be LD_PRELOAD'ed
86 in order to hijack calls. In contrast, libust may be linked at build time.
a4c5d022 87
2298f329 88 - libustctl
a4c5d022
PMF
89 A library to control tracing in other processes. Used by ustctl.
90
91 - libustcomm
2298f329 92 A static library shared between libust, ust-consumerd and libustctl, that
9dc7b7ff
NC
93 provides functions that allow these components to communicate together.
94
95 - libustconsumer
96 A library to create ust consumers by registering callbacks, used by
97 ust-consumerd.
a4c5d022
PMF
98
99 - snprintf
100 An asynchronous signal-safe version of snprintf.
101
102 - java
103 A simple library that uses JNI to allow tracing in java programs.
This page took 0.059697 seconds and 4 git commands to generate.