lttng-relayd(8)
===============
-:revdate: 30 April 2021
+:revdate: 14 June 2021
:daemon-bin-name: lttng-relayd
:daemon-ini-section: relayd
writes it to the local file system. The relay daemon also accepts LTTng
live connections from compatible readers (for example,
man:babeltrace2(1)); this is the recommended approach to read trace data
-while the remote tracing session is active.
+while the remote recording session is active.
By default, a relay daemon listens on all network interfaces to receive
trace data, but only on `localhost` for LTTng live connections. Override
the listening URLs with the option:--control-port, option:--data-port,
-and option:--live-port options (see the <<url-format,URL format>>
+and option:--live-port options (see the ``<<url-format,URL format>>''
section below). For example, use the
option:--live-port=+tcp://0.0.0.0:{default_network_viewer_port}+ option
to make a relay daemon listen to LTTng live connections on all network
* Its configuration.
+
-See the <<cfg,Daemon configuration>> section above.
+See the ``<<cfg,Daemon configuration>>'' section above.
-* The tracing session configuration of the connected peer.
+* The recording session configuration of the connected peer.
* The LTTng session daemon (see man:lttng-sessiond(8)) version
of the connected peer.
Hostname of the connected peer.
'SESSION'::
- Tracing session name.
+ Recording session name.
'DATETIME'::
- Unique tracing session date/time.
+ Unique recording session date/time.
'TRACEDIR'::
Custom trace directory path ('TRACEDIR' part of the argument of the
[verse]
'BASE'/'HOSTNAME'/'TRACEDIR'
-With the option:--group-output-by-session option (tracing session grouping)::
+With the option:--group-output-by-session option (recording session grouping)::
Without a custom trace directory:::
'SESSIONDV' is at least{nbsp}2.4::::
+
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).
Output
~~~~~~
-See the <<output-directory,Output directory>> section above to learn
+See the ``<<output-directory,Output directory>>'' section above to learn
more.
option:-p, option:--group-output-by-host::
strategy, but this may change in the future.
option:-s, option:--group-output-by-session::
- Group the written trace directories by tracing session name instead
- of by hostname.
+ Group the written trace directories by recording session name
+ instead of by hostname.
option:-o 'DIR', option:--output='DIR'::
Set the base output directory of the written trace directories to
Ports
~~~~~
-See the <<url-format,URL format>> section above to learn more about the
-syntax of the 'URL' argument of the following options.
+See the ``<<url-format,URL format>>'' section above to learn more about
+the syntax of the 'URL' argument of the following options.
option:-C 'URL', option:--control-port='URL'::
Listen to control data on URL 'URL'.
Show version and quit.
-ENVIRONMENT VARIABLES
----------------------
+EXIT STATUS
+-----------
+*0*::
+ Success
+
+*1*::
+ Error
+
+*3*::
+ Fatal error
+
+
+ENVIRONMENT
+-----------
`LTTNG_ABORT_ON_ERROR`::
Set to `1` to abort the process after the first error is
encountered.
NOTE: `$LTTNG_HOME` defaults to `$HOME`.
-EXIT STATUS
------------
-*0*::
- Success
-
-*1*::
- Error
-
-*3*::
- Fatal error
-
-
include::common-footer.txt[]
SEE ALSO
--------
+man:babeltrace2(1),
man:lttng(1),
-man:lttng-sessiond(8),
-man:babeltrace2(1)
+man:lttng-sessiond(8)