X-Git-Url: http://git.liburcu.org/?a=blobdiff_plain;f=doc%2Fman%2Flttng-ust.3.txt;h=7a23943daf9eb134f46dba17459a120fcaf3d219;hb=30e43da7276e68767cc901491d899fd360b016f7;hp=ff0e14f75ca6b86002c979ecbb2d86c228f884fd;hpb=2b4444ce6a9fa02ae46a67085c17aef55dc85941;p=lttng-ust.git diff --git a/doc/man/lttng-ust.3.txt b/doc/man/lttng-ust.3.txt index ff0e14f7..7a23943d 100644 --- a/doc/man/lttng-ust.3.txt +++ b/doc/man/lttng-ust.3.txt @@ -758,7 +758,7 @@ LTTng-UST state dump ~~~~~~~~~~~~~~~~~~~~ If an application that uses `liblttng-ust` becomes part of a tracing session, information about its currently loaded shared objects, their -build IDs, and their debug link informations are emitted as events +build IDs, and their debug link information are emitted as events by the tracer. The following LTTng-UST state dump events exist and must be enabled @@ -1088,23 +1088,24 @@ int main(int argc, char* argv[]) ENVIRONMENT VARIABLES --------------------- -`LTTNG_UST_DEBUG`:: - Activate `liblttng-ust` debug and error output. - -`LTTNG_UST_REGISTER_TIMEOUT`:: - Specify how long the applications should wait for the - _registration done_ session daemon command before proceeding to - execute the main program (milliseconds). +`LTTNG_HOME`:: + Alternative user's home directory. This variable is useful when the + user running the instrumented application has a non-writable home + directory. + -The value 0 means _do not wait_. The value -1 means _wait forever_. -Setting this environment variable to 0 is recommended for applications -with time constraints on the process startup time. -+ -Default: {lttng_ust_register_timeout}. +Unix sockets used for the communication between `liblttng-ust` and the +LTTng session and consumer daemons (part of the LTTng-tools project) +are located in a specific directory under `$LTTNG_HOME` (or `$HOME` if +`$LTTNG_HOME` is not set). -`LTTNG_UST_WITHOUT_BADDR_STATEDUMP`:: - Prevent `liblttng-ust` from performing a base address state dump - (see the <> section above). +`LTTNG_UST_CLOCK_PLUGIN`:: + Path to the shared object which acts as the clock override plugin. + An example of such a plugin can be found in the LTTng-UST + documentation under + https://github.com/lttng/lttng-ust/tree/master/doc/examples/clock-override[`examples/clock-override`]. + +`LTTNG_UST_DEBUG`:: + Activates `liblttng-ust`'s debug and error output if set to `1`. `LTTNG_UST_GETCPU_PLUGIN`:: Path to the shared object which acts as the `getcpu()` override @@ -1112,11 +1113,20 @@ Default: {lttng_ust_register_timeout}. documentation under https://github.com/lttng/lttng-ust/tree/master/doc/examples/getcpu-override[`examples/getcpu-override`]. -`LTTNG_UST_CLOCK_PLUGIN`:: - Path to the shared object which acts as the clock override plugin. - An example of such a plugin can be found in the LTTng-UST - documentation under - https://github.com/lttng/lttng-ust/tree/master/doc/examples/clock-override[`examples/clock-override`]. +`LTTNG_UST_REGISTER_TIMEOUT`:: + Waiting time for the _registration done_ session daemon command + before proceeding to execute the main program (milliseconds). ++ +The value `0` means _do not wait_. The value `-1` means _wait forever_. +Setting this environment variable to `0` is recommended for applications +with time constraints on the process startup time. ++ +Default: {lttng_ust_register_timeout}. + +`LTTNG_UST_WITHOUT_BADDR_STATEDUMP`:: + Prevents `liblttng-ust` from performing a base address state dump + (see the <> section above) if + set to `1`. include::common-footer.txt[]