LTTNG USERSPACE TRACER (UST)
----------------------------
-For the UST manual, see: http://lttng.org/files/ust/manual/ust.html
+UST web site and manual: http://lttng.org/ust
Updated versions of this package may be found at:
+ * Website: http://lttng.org/ust
* Releases: http://lttng.org/files/ust/releases
* GitWeb: http://git.dorsal.polymtl.ca (project: ust)
* Git: git://git.dorsal.polymtl.ca/git/ust.git
-
PREREQUISITES:
- liburcu
-
Userspace RCU library, by Mathieu Desnoyers and Paul E. McKenney
- * Releases: http://lttng.org/files/ust/releases
- * GitWeb: http://lttng.org/cgi-bin/gitweb.cgi?p=userspace-rcu.git;a=summary
- * Git: git://lttng.org/userspace-rcu.git
-
- -> This release was tested with liburcu v0.4.1
-
-
- - libkcompat
-
- Linux kernel userspace compatibility library.
- (Provides userspace ports of some kernel APIs.)
- * Releases: http://lttng.org/files/ust/releases
- * GitWeb: http://git.dorsal.polymtl.ca (project: libkcompat)
- * Git: git://git.dorsal.polymtl.ca/git/libkcompat.git
- -> This release was tested with libkcompat v0.1
+ -> This release was tested with liburcu v0.5.4
+ * Debian/Ubuntu package: liburcu-dev
+ * Website: http://lttng.org/urcu
+ * Releases: http://lttng.org/files/urcu
+ * GitWeb: http://lttng.org/cgi-bin/gitweb.cgi?p=userspace-rcu.git;a=summary
+ * Git: git://lttng.org/userspace-rcu.git
INSTALLATION INSTRUCTIONS:
- - Download, compile and install liburcu and libkcompat.
+ - Download, compile and install liburcu.
- In this package's tree, run ./configure.
- Run make.
- Run make install.
- Run ldconfig.
- See the manual for usage instructions.
+ If compiling from the git repository, run ./bootstrap before running
+ the configure script, to generate it.
TRACE VIEWER:
LTTV is used for viewing UST traces. LTTV may be obtained at
http://lttng.org in the Downloads section.
- This release has been tested with LTTV 0.12.30.
+ This release has been tested with LTTV 0.12.32.
PACKAGE CONTENTS:
A program to control the tracing of userspace applications. It can list
markers, start the tracing, stop the tracing, enable/disable markers, etc.
- - ustd
+ - include
+ The public header files that will be installed on the system.
+
+ - ust-consumerd
The daemon that collects trace data and writes it to the disk.
- doc
The documentation.
- - hello
- An example application that uses the userspace tracer.
+ - tests
+ Various test programs
- - libmallocwrap
+ - libustinstr-malloc
An example library that can be LD_PRELOAD'ed to instrument calls to malloc()
in any program without need to recompile it.
- - libinterfork
+ - libustfork
A library that is LD_PRELOAD'ed, and that hijacks calls to several system
- calls in order to trace across these calls.
+ calls in order to trace across these calls. It _has_ to be LD_PRELOAD'ed
+ in order to hijack calls. In contrast, libust may be linked at build time.
+
+ - libustctl
+ A library to control tracing in other processes. Used by ustctl.
+
+ - libustcomm
+ A static library shared between libust, ust-consumerd and libustctl, that
+ provides functions that allow these components to communicate together.
+
+ - libustconsumer
+ A library to create ust consumers by registering callbacks, used by
+ ust-consumerd.
+
+ - snprintf
+ An asynchronous signal-safe version of snprintf.
+
+ - java
+ A simple library that uses JNI to allow tracing in java programs.