doc/man: create lttng-load(1) and update/fix content
authorPhilippe Proulx <>
Wed, 11 Nov 2015 20:36:33 +0000 (15:36 -0500)
committerJérémie Galarneau <>
Thu, 17 Mar 2016 21:56:20 +0000 (17:56 -0400)
Signed-off-by: Philippe Proulx <>
Signed-off-by: Jérémie Galarneau <>
doc/man/lttng-load.1.txt [new file with mode: 0644]

index ea104b3118acb37b0fd32efbb27887739a284756..6e34f5bb3af755ac89fb5164e05cef7826fc6b13 100644 (file)
@@ -12,7 +12,8 @@ MAN1_NAMES = \
        lttng-create \
        lttng-destroy \
        lttng-set-session \
-       lttng-save
+       lttng-save \
+       lttng-load
 MAN1_NO_ASCIIDOC_NAMES = lttng-crash
diff --git a/doc/man/lttng-load.1.txt b/doc/man/lttng-load.1.txt
new file mode 100644 (file)
index 0000000..11ab2f6
--- /dev/null
@@ -0,0 +1,73 @@
+lttng-load - Load LTTng tracing session configurations
+*lttng* ['GENERAL OPTIONS'] *load* [option:--force] [option:--input-path='PATH'] ['SESSION']
+The `lttng load` command loads the configurations of one or more
+tracing sessions from files.
+The `lttng load` command is used in conjunction with the
+linklttng: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.
+Once one or more tracing session configurations are loaded, they appear
+exactly as they were saved from the user's point of view.
+The default input path is `$LTTNG_HOME/.lttng/sessions`
+(`$LTTNG_HOME` defaults to `$HOME`). The input path can be
+overridden with the option:--input-path option.
+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 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.
+By default, existing tracing sessions are not overwritten when loading;
+the command fails. The option:--force option can be used to allow this.
+option:-a, option:--all::
+    Load all tracing session configurations (default).
+option:-f, option:--force::
+    Overwrite existing tracing sessions when loading.
+option:-i, option:--input-path='PATH'::
+    Set input path to 'PATH', either a directory or a file, in which
+    tracing session configurations are searched for.
This page took 0.034484 seconds and 4 git commands to generate.