X-Git-Url: http://git.liburcu.org/?a=blobdiff_plain;f=README;h=dadcd1f5ac5f91975d904cf6d6644c460fe1c0e0;hb=64bf51a6c36687bb8fe5e60a8a5d46cb00e73a47;hp=a6487335df11f3779a3ff890cc48394c42847b4a;hpb=05dc3c14f07ce9f9e9bbecdb66390a658946a6dd;p=lttng-ust.git diff --git a/README b/README index a6487335..dadcd1f5 100644 --- a/README +++ b/README @@ -1,12 +1,11 @@ LTTNG USERSPACE TRACER (LTTng-UST) ---------------------------- -UST web site: http://lttng.org/lttng2.0 +UST web site: http://lttng.org Updated versions of this package may be found at: - * Website: http://lttng.org/lttng2.0 - * Releases: http://lttng.org/files/lttng-ust + * Releases: http://lttng.org/download * GitWeb: http://git.lttng.org (project: lttng-ust) * Git: git://git.lttng.org/lttng-ust.git @@ -24,10 +23,6 @@ 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 - * Fedora package: libuuid-devel - For developers using the git tree: This source tree is based on the autotools suite from GNU to simplify @@ -38,6 +33,8 @@ compile the git repository tree : (make sure your system wide "automake" points to a recent version!) - GNU Libtool >=2.2 (for more information, go to http://www.gnu.org/software/autoconf/) +- Perl (optional) + Needed for make check and tests. If you get the tree from the repository, you will need to use the "bootstrap" script in the root of the tree. It calls all the GNU tools needed to prepare the @@ -75,11 +72,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: @@ -101,6 +98,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: @@ -124,7 +125,7 @@ ENVIRONMENT VARIABLES: TRACE VIEWER: - Use babeltrace for viewing traces generated by LTTng UST 2.0. + Use babeltrace for viewing traces generated by LTTng UST 2.x. See http://lttng.org for download.