lttng-create(1)
===============
-:revdate: 3 May 2021
+:revdate: 12 May 2021
NAME
recover the latest recorded trace data when the system reboots after a
crash with the man:lttng-crash(1) utility.
-By default, the `create` command automatically spawns a session daemon
-for your Unix user if none is currently running. Override the path of
-the session daemon binary to spawn with the general
-genoption:--sessiond-path option. Avoid automatically spawning a session
-daemon with the general genoption:--no-sessiond option.
+By default, the `create` command automatically spawns:
+
+* A session daemon for your Unix user if none is currently running.
++
+Override the path of the session daemon binary to spawn with the
+general genoption:--sessiond-path option.
++
+Avoid automatically spawning a session daemon with the general
+genoption:--no-sessiond option.
+
+* A relay daemon (see man:lttng-relayd(8)) if all the following
+ statements are true:
++
+--
+* You specify the option:--live option.
+
+* You don't specify any of the option:--set-url, option:--ctrl-url, or
+ option:--data-url options.
+
+* No relay daemon is currently listening for TCP connections on
+ +127.0.0.1:{default_network_viewer_port}+ (default LTTng live reader
+ connection address and port).
+--
++
+In this case, the `create` command spawns a relay daemon as such:
++
+[verse]
+*lttng-relayd* nloption:--live-port=**tcp://localhost:{default_network_viewer_port}**
+{nbsp}
++
+Override the path of the relay daemon binary to spawn with the general
+genoption:--relayd-path option.
On success, the `create` command sets the current tracing session (see
man:lttng-concepts(7) to learn more) to the created tracing session.
daemon (see the nloption:--output option of man:lttng-relayd(8)).
-include::common-cmd-options-head.txt[]
+include::common-lttng-cmd-options-head.txt[]
Mode selection
after creating the tracing session.
-include::common-cmd-help-options.txt[]
+include::common-lttng-cmd-help-options.txt[]
+
+include::common-lttng-cmd-after-options.txt[]
-include::common-cmd-footer.txt[]
+
+include::common-footer.txt[]
SEE ALSO
--------
man:lttng(1),
-man:lttng-concepts(7),
man:lttng-destroy(1),
man:lttng-enable-channel(1),
-man:lttng-list(8),
-man:lttng-relayd(8),
+man:lttng-list(1),
man:lttng-rotate(1),
man:lttng-save(1),
-man:lttng-sessiond(8),
man:lttng-set-session(1),
man:lttng-start(1),
-man:lttng-status(8),
-man:lttng-track(1)
+man:lttng-status(1),
+man:lttng-track(1),
+man:lttng-concepts(7),
+man:lttng-relayd(8),
+man:lttng-sessiond(8)