lttng-load(1)
=============
+:revdate: 28 November 2016
NAME
--------
[verse]
*lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *load* [option:--force] [option:--input-path='PATH']
- [option:--override-url='URL'] ['SESSION']
+ [option:--override-url='URL'] ['SESSION' [option:--override-name='NAME']]
DESCRIPTION
The `lttng load` command is used in conjunction with the
man:lttng-save(1) command to save and restore the complete
configurations of tracing sessions. This includes the enabled channels
-and event rules, the context added to channels, the tracing activity,
-and more.
+and recording event rules, the context added to channels, the tracing
+activity, 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.
* 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.
+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.
option:-f, option:--force::
Overwrite existing tracing sessions when loading.
-option:-i, option:--input-path='PATH'::
+option:-i 'PATH', option:--input-path='PATH'::
Load tracing session configurations from 'PATH', either a directory
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.
+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[]