lttng-live: fix diagram
[lttng-docs.git] / contents / using-lttng / controlling-tracing / taking-a-snapshot.md
index fd6ef22bcdc048b1e9ced662618bec7051c959d7..0a4ccf3cd1beb44a1140f9e0a94e03db18b9b550 100644 (file)
@@ -17,7 +17,7 @@ events with the newest. At any time, either when the tracers are started
 or stopped, you may take a snapshot of those sub-buffers.
 
 There is no difference between the format of a normal trace file and the
 or stopped, you may take a snapshot of those sub-buffers.
 
 There is no difference between the format of a normal trace file and the
-format of a snapshot: viewers of LTTng traces will also support LTTng
+format of a snapshot: viewers of LTTng traces also support LTTng
 snapshots. By default, snapshots are written to disk, but they may also
 be sent over the network.
 
 snapshots. By default, snapshots are written to disk, but they may also
 be sent over the network.
 
@@ -28,9 +28,11 @@ lttng create --snapshot my-snapshot-session
 </pre>
 
 Next, enable channels, events and add context to channels as usual.
 </pre>
 
 Next, enable channels, events and add context to channels as usual.
-Once a tracing session is created in snapshot mode, channels will be
-forced to use the overwrite mode (`--overwrite` option of the
-`enable-channel` command) and have an `mmap()` channel type
+Once a tracing session is created in snapshot mode, channels are
+forced to use the
+[overwrite](#doc-channel-overwrite-mode-vs-discard-mode) mode
+(`--overwrite` option of the `enable-channel` command; also called
+_flight recorder mode_) and have an `mmap()` channel type
 (`--output mmap`).
 
 Start tracing. When you're ready to take a snapshot, do:
 (`--output mmap`).
 
 Start tracing. When you're ready to take a snapshot, do:
@@ -39,7 +41,7 @@ Start tracing. When you're ready to take a snapshot, do:
 lttng snapshot record --name my-snapshot
 </pre>
 
 lttng snapshot record --name my-snapshot
 </pre>
 
-This will record a snapshot named `my-snapshot` of all channels of
+This records a snapshot named `my-snapshot` of all channels of
 all domains of the current tracing session. By default, snapshots files
 are recorded in the path returned by `lttng snapshot list-output`. You
 may change this path or decide to send snapshots over the network
 all domains of the current tracing session. By default, snapshots files
 are recorded in the path returned by `lttng snapshot list-output`. You
 may change this path or decide to send snapshots over the network
@@ -64,5 +66,5 @@ taking it with the `--max-size` option:
 lttng snapshot record --name my-snapshot --max-size 2M
 </pre>
 
 lttng snapshot record --name my-snapshot --max-size 2M
 </pre>
 
-Older recorded events will be discarded in order to respect this
+Older recorded events are discarded in order to respect this
 maximum size.
 maximum size.
This page took 0.033956 seconds and 4 git commands to generate.