X-Git-Url: http://git.lttng.org/?a=blobdiff_plain;f=README;h=71bae95b6d62303a9261a754dbefc44c3897a008;hb=refs%2Fheads%2Fstable-2.1;hp=8193c6603837940ffc2cade120ef4dc867b638fe;hpb=a025b017d398818300ad45c92284116d64c56fc1;p=lttng-ust.git diff --git a/README b/README index 8193c660..71bae95b 100644 --- a/README +++ b/README @@ -16,7 +16,7 @@ PREREQUISITES: - liburcu Userspace RCU library, by Mathieu Desnoyers and Paul E. McKenney - -> This release depends on liburcu v0.6.6 + -> This release depends on liburcu v0.7.2 * Debian/Ubuntu package: liburcu-dev * Website: http://lttng.org/urcu @@ -24,6 +24,9 @@ PREREQUISITES: * GitWeb: http://lttng.org/cgi-bin/gitweb.cgi?p=userspace-rcu.git;a=summary * Git: git://lttng.org/userspace-rcu.git + - libuuid (for Linux) + * Debian/Ubuntu package: libuuid1, uuid-dev + For developers using the git tree: This source tree is based on the autotools suite from GNU to simplify @@ -71,11 +74,11 @@ USAGE: - If building the provider directly into the application, link the application with "-llttng-ust". - If building a static library for the provider, link the static - library with "-lllttng-ust". + library with "-llttng-ust". - Include the tracepoint provider header into all C files using the provider. - Example: - tests/hello/ hello.c tp.c ust_tests_hello.h Makefile.example.* + - tests/hello/ hello.c tp.c ust_tests_hello.h Makefile.example.* 2) Compile the Tracepoint Provider separately from the application, using dynamic linking: @@ -97,6 +100,10 @@ USAGE: - Enable instrumentation and control tracing with the "lttng" command from lttng-tools. See lttng-tools doc/quickstart.txt. + - Note about dlclose() usage: it is not safe to use dlclose on a + provider shared object that is being actively used for tracing due + to a lack of reference counting from lttng-ust to the used shared + object. ENVIRONMENT VARIABLES: @@ -113,6 +120,10 @@ ENVIRONMENT VARIABLES: recommended for applications with time constraints on the process startup time. + - The compilation flag "-DLTTNG_UST_DEBUG_VALGRIND" should be enabled + at build time to allow liblttng-ust to be used with valgrind + (side-effect: disables per-cpu buffering). + TRACE VIEWER: