X-Git-Url: http://git.liburcu.org/?a=blobdiff_plain;ds=sidebyside;f=README;h=901e17514c85d06fa81b4e4280fefa905a2e28b1;hb=1ea2c2dfbd051d7ab86a2161b48aa8e4a2f2b5e2;hp=a2d115b19c52eb0ebc40a754b80c3a5cd5bbb853;hpb=b58d53c07101121581b372c763f36972bd3bf79a;p=lttng-ust.git

diff --git a/README b/README
index a2d115b1..901e1751 100644
--- a/README
+++ b/README
@@ -38,6 +38,27 @@ INSTALLATION INSTRUCTIONS:
   the configure script, to generate it.
 
 
+USAGE:
+
+  - Create an instrumentation header following the tracepoint examples.
+    (see tracepoint.h and tests/hello/tp.h).
+  - Link application with -lust.
+  - (TODO: start tracing with the "lttng" command from lttng-tools)
+
+ENVIRONMENT VARIABLES:
+
+  - libust debug can be activated by setting the environment variable
+    "UST_DEBUG" when launching the application. It can also be enabled
+    at compile-time by compiling libust with -DUST_DEBUG.
+
+  - The environment variable "UST_REGISTER_TIMEOUT" can be used to
+    specify how long the applications should wait for sessiond
+    "registration done" command before proceeding to execute the main
+    program. The default is 3000ms (3 seconds). The timeout value is
+    specified in milliseconds. The value 0 means "don't wait". The value
+    -1 means "wait forever".
+
+
 TRACE VIEWER:
 
   LTTV is used for viewing UST traces. LTTV may be obtained at
@@ -101,3 +122,4 @@ PACKAGE CONTENTS:
 
   - java
     A simple library that uses JNI to allow tracing in java programs.
+    See java/README for build instructions.