From: Philippe Proulx Date: Wed, 4 May 2016 16:39:03 +0000 (-0400) Subject: lttng-load(1): use lists to explain the input path behaviour X-Git-Tag: v2.8.0~106 X-Git-Url: https://git.lttng.org./?a=commitdiff_plain;h=6c1653cc16478fb4b29c3b0212576271b64a99a1;p=lttng-tools.git lttng-load(1): use lists to explain the input path behaviour Signed-off-by: Philippe Proulx Signed-off-by: Jérémie Galarneau --- diff --git a/doc/man/lttng-load.1.txt b/doc/man/lttng-load.1.txt index 1435defbd..ec8741b07 100644 --- a/doc/man/lttng-load.1.txt +++ b/doc/man/lttng-load.1.txt @@ -38,19 +38,23 @@ 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 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; +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.