Once one or more tracing session configurations are loaded, they appear
exactly as they were saved from the user's point of view.
-The default input path is `$LTTNG_HOME/.lttng/sessions`
-(`$LTTNG_HOME` defaults to `$HOME`). The input path can be
-overridden with the option:--input-path option.
-
-If the input path is a directory, then if 'SESSION' is specified, the
-tracing session configuration named 'SESSION' is searched in all the
-files of this directory and loaded if found. If 'SESSION' is not
-specified, the option:--all option is implicit: all the tracing session
-configurations found in all the files in this directory are loaded.
-
-If the input path is a file, then if 'SESSION' is specified, the tracing
-session configuration named 'SESSION' is searched in this file and
-loaded if found. If 'SESSION' is not specified, the option:--all option
-is implicit: all the tracing session configurations found in this file
-are loaded.
-
-By default, existing tracing sessions are not overwritten when loading;
+The following directories are searched, non-recursively, in this order
+for configuration files:
+
+. `$LTTNG_HOME/.lttng/sessions` (`$LTTNG_HOME` defaults to `$HOME`)
+. +{system_sessions_dir}+
+
+The input path can be overridden with the option:--input-path option.
+When this option is specified, the default directories are :not:
+searched for configuration files. When it's not specified, _both_
+default directories are searched for configuration files.
+
+If the input path is a *directory*, then:
+
+* If 'SESSION' is specified, the tracing session configuration named
+ 'SESSION' is searched for in all the files of this directory and
+ loaded if found.
+* If 'SESSION' is not specified, the option:--all option is implicit:
+ all the tracing session configurations found in all the files in this
+ directory are loaded.
+
+If the input path is a *file*, then:
+
+* If 'SESSION' is specified, the tracing session configuration named
+ 'SESSION' is searched for in this file and loaded if found.
+* If 'SESSION' is not specified, the option:--all option is implicit:
+ all the tracing session configurations found in this file are loaded.
+
+By default, existing tracing sessions are not overwritten when loading:
the command fails. The option:--force option can be used to allow this.
Overwrite existing tracing sessions when loading.
option:-i, option:--input-path='PATH'::
- Set input path to 'PATH', either a directory or a file, in which
- tracing session configurations are searched for.
+ Load tracing session configurations from 'PATH', either a directory
+ or a file, instead of loading them from the default search
+ directories.
include::common-cmd-help-options.txt[]