From: Philippe Proulx <eeppeliteloop@gmail.com>
Date: Fri, 25 Mar 2016 02:12:57 +0000 (-0400)
Subject: doc/man: add FILES section
X-Git-Tag: v2.9.0-rc1~297
X-Git-Url: https://git.lttng.org/?p=lttng-tools.git;a=commitdiff_plain;h=900690ca9a448db68aef7115d74e7f585fb322d6

doc/man: add FILES section

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>
Signed-off-by: Jérémie Galarneau <jeremie.galarneau@efficios.com>
---

diff --git a/doc/man/common-cmd-footer.txt b/doc/man/common-cmd-footer.txt
index da241ec96..61f5bb0a1 100644
--- a/doc/man/common-cmd-footer.txt
+++ b/doc/man/common-cmd-footer.txt
@@ -25,6 +25,35 @@ linklttng:lttng-sessiond(8) for the environment variables influencing
 the execution of the session daemon.
 
 
+FILES
+-----
+`$LTTNG_HOME/.lttngrc`::
+    User LTTng runtime configuration.
++
+This is where the per-user current tracing session is stored between
+executions of linklttng:lttng(1). The current tracing session can be set
+with linklttng:lttng-set-session(1). See linklttng:lttng-create(1) for
+more information about tracing sessions.
+
+`$LTTNG_HOME/lttng-traces`::
+    Default output directory of LTTng traces. This can be overridden
+    with the nloption:--output option of the linklttng:lttng-create(1)
+    command.
+
+`$LTTNG_HOME/.lttng`::
+    User LTTng runtime and configuration directory.
+
+`$LTTNG_HOME/.lttng/sessions`::
+    Default location of saved user tracing sessions (see
+    linklttng:lttng-save(1) and linklttng:lttng-load(1)).
+
+`/etc/lttng/sessions`::
+    System-wide location of saved tracing sessions
+    (see linklttng:lttng-save(1) and linklttng:lttng-load(1)).
+
+NOTE: `$LTTNG_HOME` defaults to `$HOME` when not explicitly set.
+
+
 EXIT STATUS
 -----------
 *0*::
diff --git a/doc/man/lttng-relayd.8.txt b/doc/man/lttng-relayd.8.txt
index 32eccbeda..3f6759e16 100644
--- a/doc/man/lttng-relayd.8.txt
+++ b/doc/man/lttng-relayd.8.txt
@@ -156,6 +156,18 @@ ENVIRONMENT VARIABLES
     Path to relay daemon health's socket.
 
 
+FILES
+-----
+`$LTTNG_HOME/.lttng`::
+    User LTTng runtime and configuration directory.
+
+`$LTTNG_HOME/lttng-traces`::
+    Default output directory of LTTng traces. This can be overridden
+    with the option:--output option.
+
+NOTE: `$LTTNG_HOME` defaults to `$HOME` when not explicitly set.
+
+
 EXIT STATUS
 -----------
 *0*::
diff --git a/doc/man/lttng-sessiond.8.txt b/doc/man/lttng-sessiond.8.txt
index df119e78b..a37341520 100644
--- a/doc/man/lttng-sessiond.8.txt
+++ b/doc/man/lttng-sessiond.8.txt
@@ -261,6 +261,35 @@ The option:--kmod-probes option overrides this variable.
     Tracing session configuration XML schema definition (XSD) path.
 
 
+FILES
+-----
+`$LTTNG_HOME/.lttng`::
+    User LTTng runtime and configuration directory.
+
+`$LTTNG_HOME/lttng-traces`::
+    Default output directory of LTTng traces. This can be overridden
+    with the nloption:--output option of the linklttng:lttng-create(1)
+    command.
+
+`$LTTNG_HOME/.lttng/sessions`::
+    Default location of saved user tracing sessions (see
+    linklttng:lttng-save(1) and linklttng:lttng-load(1)).
+
+`/etc/lttng/sessions`::
+    System-wide location of saved tracing sessions
+    (see linklttng:lttng-save(1) and linklttng:lttng-load(1)).
+
+`$LTTNG_HOME/.lttng/lttng.conf`::
+    Default location of the session daemon configuration file (see the
+    option:--config option).
+
+`/etc/lttng/lttng.conf`::
+    System-wide location of the session daemon configuration file (see
+    the option:--config option).
+
+NOTE: `$LTTNG_HOME` defaults to `$HOME` when not explicitly set.
+
+
 EXIT STATUS
 -----------
 *0*::