X-Git-Url: https://git.lttng.org/?p=lttng-tools.git;a=blobdiff_plain;f=doc%2Fman%2Flttng-load.1.txt;h=6c565329bdaf763dd5773c5ba222a1c43f574612;hp=1435defbdd70144067cb77467627e92f63254371;hb=c4fb6ceb684b4d52a0ccef987ee89d367e5ebfc8;hpb=7a0f38c743c8e151886e3c1d58ba35c777c7206f diff --git a/doc/man/lttng-load.1.txt b/doc/man/lttng-load.1.txt index 1435defbd..6c565329b 100644 --- a/doc/man/lttng-load.1.txt +++ b/doc/man/lttng-load.1.txt @@ -10,7 +10,8 @@ lttng-load - Load LTTng tracing session configurations SYNOPSIS -------- [verse] -*lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *load* [option:--force] [option:--input-path='PATH'] ['SESSION'] +*lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *load* [option:--force] [option:--input-path='PATH'] + [option:--override-url='URL'] ['SESSION'] DESCRIPTION @@ -38,19 +39,31 @@ 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 *directory*, then: -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. +* 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. -By default, existing tracing sessions are not overwritten when loading; +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. + +Aspects of the loaded configurations can be overridden at load time. + +option:--override-url:: + Provides the equivalent of the option:--set-url option + of the (1)lttng-create command. The validity of the url override is + dependant on the type of session(s) to be loaded. Refer to (1)lttng-create for + the accepted URL format. + +By default, existing tracing sessions are not overwritten when loading: the command fails. The option:--force option can be used to allow this. @@ -68,6 +81,9 @@ option:-i, option:--input-path='PATH':: or a file, instead of loading them from the default search directories. +option:-U, option:--override-url='URL':: + Load tracing session configurations and apply an url override + while loading. Applies to all sessions loaded. include::common-cmd-help-options.txt[]