+[[output]]
+Snapshot output
+~~~~~~~~~~~~~~~
+When you take a recording session snapshot with the `record` action, LTTng
+writes the snapshot trace files to:
+
+If you specify the 'URL' non-option argument or the option:--ctrl-url and option:--data-url options::
+ The output defined by the 'URL' non-option argument or by the
+ arguments of the options.
++
+See man:lttng-create(1) for the format of 'URL'.
+
+Otherwise::
+ The snapshot output of the selected recording session.
++
+Add a snapshot output to a recording session with the `add-output`
+action. As of LTTng{nbsp}{lttng_version}, you may only add one snapshot
+output to a given recording session.
++
+When you create a snapshot mode recording session with the
+nloption:--snapshot option of the man:lttng-create(1) command, and
+without its nloption:--no-output option, the `create` command
+automatically adds a snapshot output named `snapshot-1` to the created
+recording session:
++
+--
+With its nloption:--output, nloption:--set-url, nloption:--ctrl-url, or nloption:--data-url options::
+ Equivalent to using the `add-output` action with the provided or
+ equivalent URL(s) immediately after creating the recording session.
+
+Otherwise::
+ A subdirectory, under the `$LTTNG_HOME/lttng-traces` (`$LTTNG_HOME`
+ defaults to `$HOME`) directory, of which the name contains the
+ recording session name and the date/time.
+--
++
+Show the current snapshot output of a recording session with the
+`list-output` action.
++
+Remove the snapshot output of a recording session with the
+`del-output` action.
+
+For both the `record` and `add-output` actions:
+
+* Assign a name to a snapshot output with the option:--name='NAME'
+ option.
++
+'NAME' becomes part of the snapshot trace file names which LTTng sends
+to this output.
+
+* By default, the snapshot files can be as big as the sum of the sizes
+ of all the sub-buffers of all the channels of the selected recording
+ session.
++
+Set the maximum total size of all the snapshot trace files LTTng writes
+with the option:--max-size option.
+
+
+include::common-lttng-cmd-options-head.txt[]
+
+
+Recording target
+~~~~~~~~~~~~~~~~
+option:-s 'SESSION', option:--session='SESSION'::
+ Take a snapshot of the sub-buffers of the recording session named
+ 'SESSION' instead of the current recording session.