X-Git-Url: https://git.lttng.org/?a=blobdiff_plain;f=README;h=a68e8707183a3e8a0456c0ac7499d262b84137e8;hb=d6322067aa791234d0d81e1a6b03b445635d5f65;hp=47904d4922ac6144a41fcfa1353c2aec5b21002f;hpb=0207cc51527316a3cff9c713615413cb026bc637;p=ust.git

diff --git a/README b/README
index 47904d4..a68e870 100644
--- a/README
+++ b/README
@@ -1,51 +1,84 @@
-LTTNG USERSPACE TRACER
+LTTNG USERSPACE TRACER (UST)
+----------------------------
+
+UST web site and manual: http://lttng.org/ust
 
 Updated versions of this package may be found at:
-	git://git.dorsal.polymtl.ca/git/ust.git
 
-Dependencies:
+  * 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
+
+
+
+INSTALLATION INSTRUCTIONS:
+
+  - Download, compile and install liburcu and libkcompat.
+  - In this package's tree, run ./configure.
+  - Run make.
+  - Run make install.
+  - Run ldconfig.
+  - See the manual for usage instructions.
+
+
+
+TRACE VIEWER:
 
-- liburcu
-  Userspace RCU library, by Mathieu Desnoyers and Paul E. McKenney
-   * http://ltt.polymtl.ca/cgi-bin/gitweb.cgi?p=userspace-rcu.git;a=summary
-   * git://lttng.org/userspace-rcu.git
+  LTTV is used for viewing UST traces. LTTV may be obtained at
+  http://lttng.org in the Downloads section.
 
-- libkcompat
-  Linux kernel userspace compatibility library.
-   * http://git.dorsal.polymtl.ca
-   * git://git.dorsal.polymtl.ca/git/libkcompat.git
+  This release has been tested with LTTV 0.12.30.
 
-Installation instruction:
 
-- Download, compile and install liburcu and libkcompat.
-- In this package's tree, run ./configure.
-- Run make.
-- Run make install.
-- Run ldconfig.
-- See the manual in the doc/ directory for usage instructions.
+PACKAGE CONTENTS:
 
-Package contents:
+  This package contains the following elements.
 
-- libust
-  The actual userspace tracing library that must be linked to the
-  instrumented programs.
+  - libust
+    The actual userspace tracing library that must be linked to the
+    instrumented programs.
 
-- ustctl
-  A program to control the tracing of userspace applications. It can list
-  markers, start the tracing, stop the tracing, enable/disable markers, etc.
+  - ustctl
+    A program to control the tracing of userspace applications. It can list
+    markers, start the tracing, stop the tracing, enable/disable markers, etc.
 
-- ustd
-  The daemon that collects trace data and writes it to the disk.
+  - ustd
+    The daemon that collects trace data and writes it to the disk.
 
-- Documentation
+  - doc
+    The documentation.
 
-- hello
-  An example application that uses the userspace tracer.
+  - hello
+    An example application that uses the userspace tracer.
 
-- libmallocwrap
-  An example library that can be LD_PRELOAD'ed to instrument calls to malloc()
-  in any program without need to recompile it.
+  - libmallocwrap
+    An example library that can be LD_PRELOAD'ed to instrument calls to malloc()
+    in any program without need to recompile it.
 
-- libinterfork
-  A library that is LD_PRELOAD'ed, and that hijacks calls to several system
-  calls in order to trace across these calls.
+  - libinterfork
+    A library that is LD_PRELOAD'ed, and that hijacks calls to several system
+    calls in order to trace across these calls.