lttng-save(1)
=============


NAME
----
lttng-save - Save LTTng tracing session configurations


SYNOPSIS
--------
[verse]
*lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *save* [option:--force] [option:--output-path='PATH'] ['SESSION']


DESCRIPTION
-----------
The `lttng save` command saves the configurations of one or more
tracing sessions to files.

The `lttng save` command is used in conjunction with the
man:lttng-load(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. `lttng save` does not save tracing data, only the tracing
session parameters.

If 'SESSION' is omitted, all the existing tracing session configurations
are saved (equivalent to using the option:--all option). Otherwise,
'SESSION' is the name of an existing tracing session. `lttng list`
outputs all the existing tracing sessions (see man:lttng-list(1)).

The default output directory path is `$LTTNG_HOME/.lttng/sessions`
(`$LTTNG_HOME` defaults to `$HOME`). Each tracing session configuration
file is named `SESSION.lttng`, where `SESSION` is the original tracing
session name. The default output directory path can be overridden with
the option:--output-path option.

By default, existing tracing session configuration files are not
overwritten when saving; the command fails. The option:--force option
can be used to allow this.


include::common-cmd-options-head.txt[]


option:-a, option:--all::
    Save all tracing session configurations (default).

option:-f, option:--force::
    Overwrite existing tracing session configuration files when
    saving.

option:-o 'PATH', option:--output-path='PATH'::
    Set output directory path to 'PATH'.


include::common-cmd-help-options.txt[]


include::common-cmd-footer.txt[]


SEE ALSO
--------
man:lttng-load(1),
man:lttng(1)
