+// SPDX-FileCopyrightText: 2016 Philippe Proulx <pproulx@efficios.com>
+// SPDX-License-Identifier: CC-BY-4.0
+//
lttng-ust(3)
============
:object-type: library
ENVIRONMENT VARIABLES
---------------------
+`LTTNG_UST_APP_PATH`::
+ Path under which unix sockets used for the communication between
+ the application (tracee) instrumented with `liblttng-ust` and the
+ LTTng session and consumer daemons (part of the LTTng-tools project)
+ are located. When `$LTTNG_UST_APP_PATH` is specified, only this path
+ is considered for connecting to a session daemon. The
+ `$LTTNG_UST_APP_PATH` target directory must exist and be accessible
+ by the user before the application is executed for tracing to work.
+ Setting this environment variable disables connection to root and
+ per-user session daemons.
+
`LTTNG_HOME`::
Alternative user's home directory. This variable is useful when the
user running the instrumented application has a non-writable home
- directory.
-+
-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).
+ directory. This path is where unix sockets for communication with
+ the per-user session daemon are located.
`LTTNG_UST_ALLOW_BLOCKING`::
If set, allow the application to retry event tracing when there's
WARNING: Setting this environment variable may significantly
affect application timings.
+`LTTNG_UST_ABORT_ON_CRITICAL`::
+ If set, abort the instrumented application on a critical error message.
+
`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