-Creation modes
-~~~~~~~~~~~~~~
-There are three tracing session modes:
-
-Normal mode::
- Traces the local system and writes the trace to the local
- file system. The option:--output option specifies the trace path.
- If omitted, the trace is written in the `$LTTNG_HOME/lttng-traces`
- directory (`$LTTNG_HOME` defaults to `$HOME`). The file system
- output can be disabled using the option:--no-output option.
-
-Snapshot mode::
- Traces the local system without writing the trace to the local file
- system (implicit option:--no-output option). Channels are automatically
- configured to be snapshot-ready on creation (see
- man:lttng-enable-channel(1)). The man:lttng-snapshot(1)
- command is used to take snapshots of the current ring buffers.
- The option:--set-url, or option:--ctrl-url and option:--data-url
- options set the default snapshot output destination.
-
-Live mode::
- Traces the local system, sending trace data to an LTTng relay daemon
- over the network (see man:lttng-relayd(8)). The
- option:--set-url, or option:--ctrl-url and option:--data-url options
- set the trace output destination. The live output URLs cannot use
- the `file://` protocol (see URL format below).
+* 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 recording session (see
+man:lttng-concepts(7) to learn more) to the created recording session.
+
+See the ``<<examples,EXAMPLES>>'' section below for usage examples.
+
+Show the status of the current recording session with the
+man:lttng-status(1) command.
+
+List the recording 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.
+
+Start and stop a recording session with the man:lttng-start(1) and
+man:lttng-stop(1) commands.
+
+Save and load a recording session with the man:lttng-save(1) and
+man:lttng-load(1) commands.
+
+Allow and disallow specific processes to record events with the
+man:lttng-track(1) and man:lttng-untrack(1) commands.
+
+Archive the current trace chunk of (rotate) a recording session with the
+man:lttng-rotate(1) command.
+
+Destroy a recording session with the man:lttng-destroy(1) command.
+
+
+[[modes]]
+Recording session modes
+~~~~~~~~~~~~~~~~~~~~~~~
+As documented in man:lttng-concepts(7), LTTng offers four recording
+session modes:
+
+[[local-mode]]Local mode::
+ Write the trace data to the local file system.
++
+The trace data output directory is:
++
+With the option:--no-output option:::
+ None: the file system output is disabled.
+
+With the option:--output='DIR' or option:--set-url=++file://++__DIR__ option:::
+ The directory 'DIR'.
+
+Otherwise:::
+ A subdirectory, under the `$LTTNG_HOME/lttng-traces` (`$LTTNG_HOME`
+ defaults to `$HOME`) directory, of which the name contains the
+ recording session name and the date/time.
+
+[[network-streaming-mode]]Network streaming mode::
+ Send the trace data over the network to a listening relay daemon
+ (see man:lttng-relayd(8)).
++
+Set the trace output destination with the option:--set-url option, or
+with the option:--ctrl-url and option:--data-url options (see the
+``<<url-format,URL format>>'' section below).
+
+[[snapshot-mode]]Snapshot mode (option:--snapshot option)::
+ Only write the trace data to the local file system or send it to a
+ listening relay daemon (man:lttng-relayd(8)) when LTTng takes a
+ snapshot (see the man:lttng-snapshot(1) command).
++
+With this mode, LTTng:
++
+With the option:--no-output option:::
+ Does :not: add any snapshot output to the created recording
+ session.
+
+With the option:--output option, the option:--set-url option, or the option:--ctrl-url and option:--data-url options:::
+ Adds a snapshot output named `snapshot-1` using the provided
+ path or URL(s) to the created recording session.
+
+Otherwise:::
+ Adds an automatic snapshot output named `snapshot-1` to the created
+ recording session.
++
+The automatic snapshot output is a subdirectory, under the
+`$LTTNG_HOME/lttng-traces` (`$LTTNG_HOME` defaults to `$HOME`)
+directory, of which the name contains the recording session name and the
+date/time.
+
+[[live-mode]]Live mode (option:--live option)::
+ Send the trace data over the network to a listening relay daemon
+ (see man:lttng-relayd(8)) for live reading.
++
+Set the trace output destination with the option:--set-url='URL' option,
+or with the option:--ctrl-url='URL' and option:--data-url='URL' options
+(see the ``<<url-format,URL format>>'' section below). 'URL' may :not:
+start with `file://`.