X-Git-Url: http://git.lttng.org./?a=blobdiff_plain;ds=sidebyside;f=doc%2Fman%2Flttng-load.1.txt;h=10f893e5370daf0b0623584258053ea241d89672;hb=20290f25a4224913da313547d6aba427195c0752;hp=1435defbdd70144067cb77467627e92f63254371;hpb=7a0f38c743c8e151886e3c1d58ba35c777c7206f;p=lttng-tools.git diff --git a/doc/man/lttng-load.1.txt b/doc/man/lttng-load.1.txt index 1435defbd..10f893e53 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'] [option:--override-name='NAME'] ['SESSION'] DESCRIPTION @@ -38,19 +39,35 @@ 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. + +option:--override-name:: + Set the session name to NAME. This option is invalid in combination with + the --all option. + +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 +85,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[]