X-Git-Url: https://git.lttng.org/?p=lttng-tools.git;a=blobdiff_plain;f=doc%2Fman%2Flttng-load.1.txt;h=ec8741b079fa908e5354768203dde55c07c2f5f7;hp=b0241b61cb6ba2df0d670c374786b0b14d6c44dc;hb=77c44a1d884e139000a22f1b5f35243ac44017e4;hpb=7c1a4458be934fec31aa27a0eb52e4d0b8cb3803 diff --git a/doc/man/lttng-load.1.txt b/doc/man/lttng-load.1.txt index b0241b61c..ec8741b07 100644 --- a/doc/man/lttng-load.1.txt +++ b/doc/man/lttng-load.1.txt @@ -27,23 +27,34 @@ and more. 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. @@ -57,8 +68,9 @@ option:-f, option:--force:: 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[]