lttng-sessiond(8)
=================
-:revdate: 21 April 2021
+:revdate: 14 June 2021
:daemon-bin-name: lttng-sessiond
:daemon-ini-section: sessiond
An LTTng session daemon, `lttng-sessiond`, is a program which:
-* Manages tracing sessions (see man:lttng-concepts(7) to learn more
- about tracing sessions).
+* Manages recording sessions (see man:lttng-concepts(7) to learn more
+ about recording sessions).
* Controls the various components (like tracers and consumer daemons) of
LTTng.
[[load]]
-Tracing session configuration loading
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-When the session daemon starts, it loads tracing session configurations
-from:
+Recording session configuration loading
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+When the session daemon starts, it loads recording session
+configurations from:
Without the option:--load option::
In this order:
. All the files in +{system_sessions_auto_dir}+.
--
+
-`lttng-sessiond` only loads tracing configuration files from the
-directories above if its UID and their UID are the same.
+`lttng-sessiond` only loads recording session configuration files from
+the directories above if its UID and their UID are the same.
With the option:--load='PATH' option::
'PATH' is a directory:::
addition to the default configuration files and the command-line
options.
+
-See the <<cfg,Daemon configuration>> section above.
+See the ``<<cfg,Daemon configuration>>'' section above.
option:-d, option:--daemonize::
Start as a Unix daemon and close file descriptors (console).
and, therefore, control LTTng kernel tracing.
option:-l 'PATH', option:--load='PATH'::
- Load tracing session configurations from 'PATH', either a directory
- or a file, instead of loading them from the default search
+ Load recording session configurations from 'PATH', either a
+ directory or a file, instead of loading them from the default search
directories.
+
-See the <<load,Tracing session configuration loading>> section above.
+See the ``<<load,Recording session configuration loading>>'' section
+above.
option:-S, option:--sig-parent::
Send the `USR1` signal to the parent process to notify readiness.
Set to `0` or `-1` to use the timeout of the operating system (default).
`LTTNG_SESSION_CONFIG_XSD_PATH`::
- Tracing session configuration XML schema definition (XSD) path.
+ Recording session configuration XML schema definition (XSD) path.
FILES
man:lttng-create(1) command.
`$LTTNG_HOME/.lttng/sessions/auto`::
- Directory from which `lttng-sessiond` loads Unix user tracing
+ Directory from which `lttng-sessiond` loads Unix user recording
session configurations when starting.
+
-See the <<load,Tracing session configuration loading>> section above to
-learn more.
+See the ``<<load,Recording session configuration loading>>'' section
+above to learn more.
+{system_sessions_auto_dir}+::
- Directory from which `lttng-sessiond` loads system-wide tracing
+ Directory from which `lttng-sessiond` loads system-wide recording
session configurations when starting.
+
-See the <<load,Tracing session configuration loading>> section above to
-learn more.
+See the ``<<load,Recording session configuration loading>>'' section
+above to learn more.
`$LTTNG_HOME/.lttng/lttng.conf`::
Unix user's LTTng daemon INI configuration file.
+
-See the <<cfg,Daemon configuration>> section above to learn more.
+See the ``<<cfg,Daemon configuration>>'' section above to learn more.
+{system_lttng_conf}+::
System-wide LTTng daemon INI configuration file.
+
-See the <<cfg,Daemon configuration>> section above to learn more.
+See the ``<<cfg,Daemon configuration>>'' section above to learn more.
NOTE: `$LTTNG_HOME` defaults to `$HOME`.