X-Git-Url: https://git.lttng.org/?a=blobdiff_plain;f=README;h=399263d5e1e8faf8807f84e1b98c33acb36e0fe4;hb=cf12a773f3885500c37e26cf80e8ac05e1309572;hp=b09a1ab7e75259635421565a0316d7e744fc1d01;hpb=cacf036243594e11fc8a7e0f47f07af97a79042f;p=lttng-ust.git diff --git a/README b/README index b09a1ab7..399263d5 100644 --- a/README +++ b/README @@ -7,8 +7,8 @@ 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 + * GitWeb: http://git.lttng.org (project: ust) + * Git: git://git.lttng.org/ust.git PREREQUISITES: @@ -16,7 +16,7 @@ PREREQUISITES: - liburcu Userspace RCU library, by Mathieu Desnoyers and Paul E. McKenney - -> This release was tested with liburcu v0.4.6 + -> This release depends on liburcu v0.6 * Debian/Ubuntu package: liburcu-dev * Website: http://lttng.org/urcu @@ -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 -1 means "don't wait". The value + 0 means "wait forever". + + TRACE VIEWER: LTTV is used for viewing UST traces. LTTV may be obtained at @@ -46,6 +67,12 @@ TRACE VIEWER: This release has been tested with LTTV 0.12.32. +CONTACT: + + Maintainer: Mathieu Desnoyers + Mailing list: ltt-dev@lists.casi.polymtl.ca + + PACKAGE CONTENTS: This package contains the following elements.