doc/man: lttng(1) command pages: always include `common-footer.txt`
[lttng-tools.git] / doc / man / lttng-set-session.1.txt
index 068a66f336e1ef40249369075ae85ccbfdca6648..21663ddc3095b218ee32bb48db3cc6f1ab245472 100644 (file)
@@ -1,6 +1,6 @@
 lttng-set-session(1)
 ====================
-:revdate: 7 April 2016
+:revdate: 29 April 2021
 
 
 NAME
@@ -16,27 +16,33 @@ SYNOPSIS
 
 DESCRIPTION
 -----------
-The `lttng set-session` command sets the current tracing session.
+The `lttng set-session` command sets the current tracing session of your
+Unix user to the tracing session named 'SESSION'.
 
-'SESSION' is the name of an existing tracing session. `lttng list`
-outputs all the existing tracing sessions (see man:lttng-list(1)).
+See man:lttng-concepts(7) to learn more about the current tracing session.
 
-The current tracing session is used by default when a session can be
-specified in other commands. See man:lttng-create(1) for more
-information about the current tracing session.
+The `set-session` command effectively updates the `$LTTNG_HOME/.lttngrc`
+file.
 
+List the tracing sessions of your Unix user, or of all users if
+your Unix user is `root`, within the connected session daemon with the
+man:lttng-list(1) command.
 
-include::common-cmd-options-head.txt[]
 
+include::common-lttng-cmd-options-head.txt[]
 
-include::common-cmd-help-options.txt[]
 
+include::common-lttng-cmd-help-options.txt[]
 
-include::common-cmd-footer.txt[]
+
+include::common-lttng-cmd-after-options.txt[]
+
+
+include::common-footer.txt[]
 
 
 SEE ALSO
 --------
+man:lttng(1),
 man:lttng-create(1),
-man:lttng-destroy(1),
-man:lttng(1)
+man:lttng-concepts(7)
This page took 0.023472 seconds and 4 git commands to generate.