update TODO
[ust.git] / README
CommitLineData
1af1f1db
PMF
1LTTNG USERSPACE TRACER (UST)
2----------------------------
3
4For the UST manual, see: http://lttng.org/files/ust/manual/ust.html
2615de09 5
0207cc51 6Updated versions of this package may be found at:
0207cc51 7
2a93485b
PMF
8 * Releases: http://lttng.org/files/ust/releases
9 * GitWeb: http://git.dorsal.polymtl.ca (project: ust)
10 * Git: git://git.dorsal.polymtl.ca/git/ust.git
2615de09 11
2615de09 12
2615de09 13
2a93485b 14PREREQUISITES:
6514bc5d 15
2a93485b 16 - liburcu
6514bc5d 17
2a93485b
PMF
18 Userspace RCU library, by Mathieu Desnoyers and Paul E. McKenney
19 * Releases: http://lttng.org/files/ust/releases
20 * GitWeb: http://lttng.org/cgi-bin/gitweb.cgi?p=userspace-rcu.git;a=summary
21 * Git: git://lttng.org/userspace-rcu.git
2615de09 22
3c97f6b5 23 -> This release was tested with liburcu v0.4.1
2615de09 24
2615de09 25
2a93485b 26 - libkcompat
2615de09 27
2a93485b
PMF
28 Linux kernel userspace compatibility library.
29 (Provides userspace ports of some kernel APIs.)
30 * Releases: http://lttng.org/files/ust/releases
31 * GitWeb: http://git.dorsal.polymtl.ca (project: libkcompat)
32 * Git: git://git.dorsal.polymtl.ca/git/libkcompat.git
2615de09 33
1af1f1db 34 -> This release was tested with libkcompat v0.1
2615de09 35
cbccb4a9 36
2a93485b 37
5de791bd 38INSTALLATION INSTRUCTIONS:
2a93485b
PMF
39
40 - Download, compile and install liburcu and libkcompat.
41 - In this package's tree, run ./configure.
42 - Run make.
43 - Run make install.
44 - Run ldconfig.
937e29d7 45 - See the manual for usage instructions.
2a93485b
PMF
46
47
48
5de791bd
PMF
49TRACE VIEWER:
50
51 LTTV is used for viewing UST traces. LTTV may be obtained at
52 http://lttng.org in the Downloads section.
53
a0c822d0 54 This release has been tested with LTTV 0.12.30.
5de791bd
PMF
55
56
2a93485b
PMF
57PACKAGE CONTENTS:
58
5de791bd
PMF
59 This package contains the following elements.
60
2a93485b
PMF
61 - libust
62 The actual userspace tracing library that must be linked to the
63 instrumented programs.
64
65 - ustctl
66 A program to control the tracing of userspace applications. It can list
67 markers, start the tracing, stop the tracing, enable/disable markers, etc.
68
69 - ustd
70 The daemon that collects trace data and writes it to the disk.
71
1af1f1db
PMF
72 - doc
73 The documentation.
2a93485b
PMF
74
75 - hello
76 An example application that uses the userspace tracer.
77
78 - libmallocwrap
79 An example library that can be LD_PRELOAD'ed to instrument calls to malloc()
80 in any program without need to recompile it.
81
82 - libinterfork
83 A library that is LD_PRELOAD'ed, and that hijacks calls to several system
84 calls in order to trace across these calls.
This page took 0.03558 seconds and 4 git commands to generate.