X-Git-Url: https://git.lttng.org/?p=lttng-tools.git;a=blobdiff_plain;f=doc%2Fman%2Flttng-load.1.txt;h=042dbda3d91392808fe0a140b6e323dc7653502c;hp=1435defbdd70144067cb77467627e92f63254371;hb=62482ec6cc82b5ee233683ad0a9066974b705edb;hpb=7a0f38c743c8e151886e3c1d58ba35c777c7206f diff --git a/doc/man/lttng-load.1.txt b/doc/man/lttng-load.1.txt index 1435defbd..042dbda3d 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' [option:--override-name='NAME']] DESCRIPTION @@ -38,19 +39,26 @@ 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 +using the option:--override-url and option:--override-name options. + +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 +76,22 @@ option:-i, option:--input-path='PATH':: or a file, instead of loading them from the default search directories. +option:--override-name='NAME':: + Override the name of the loaded tracing session configuration, + 'SESSION', with 'NAME'. ++ +You must specify a tracing session name to load ('SESSION') and :not: +use the option:--all option when using this option. + +option:--override-url='URL':: + Override the URL of the loaded tracing session configurations + with 'URL'. ++ +This is the equivalent of the nloption:--set-url option of +man:lttng-create(1). The validity of the URL override depends on the +type of tracing session configurations to load. This option applies to +_all_ the loaded tracing session configurations. + include::common-cmd-help-options.txt[]