Update some manual pages for LTTng-tools 2.13

[lttng-tools.git] / doc / man / lttng-load.1.txt

diff --git a/doc/man/lttng-load.1.txt b/doc/man/lttng-load.1.txt
index ec8741b079fa908e5354768203dde55c07c2f5f7..253b86d3ccdc605e23dc80d9084dc44a824d6401 100644 (file)
--- a/doc/man/lttng-load.1.txt
+++ b/doc/man/lttng-load.1.txt
@@ -1,5 +1,6 @@
 lttng-load(1)
 =============
 lttng-load(1)
 =============

+:revdate: 28 November 2016

 
 
 NAME
 
 
 NAME


@@ -10,7 +11,8 @@ lttng-load - Load LTTng tracing session configurations
 SYNOPSIS
 --------
 [verse]
 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
 
 
 DESCRIPTION


@@ -21,8 +23,8 @@ tracing sessions from files.
 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
 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.
 
 Once one or more tracing session configurations are loaded, they appear
 exactly as they were saved from the user's point of view.


@@ -54,6 +56,9 @@ If the input path is a *file*, then:
 * 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 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.
 
 By default, existing tracing sessions are not overwritten when loading:
 the command fails. The option:--force option can be used to allow this.
 


@@ -67,11 +72,27 @@ option:-a, option:--all::
 option:-f, option:--force::
     Overwrite existing tracing sessions when loading.
 
 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.
 
     Load tracing session configurations from 'PATH', either a directory
     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[]
 
 
 include::common-cmd-help-options.txt[]