From: Philippe Proulx Date: Fri, 9 Nov 2018 15:28:49 +0000 (-0500) Subject: doc/man: add links between man pages about session rotation X-Git-Tag: v2.12.0-rc1~750 X-Git-Url: https://git.lttng.org./?a=commitdiff_plain;h=d539dc8934ba1c7c18323a0fcef16f9f51b96993;p=lttng-tools.git doc/man: add links between man pages about session rotation Signed-off-by: Philippe Proulx Signed-off-by: Jérémie Galarneau --- diff --git a/doc/man/lttng-enable-channel.1.txt b/doc/man/lttng-enable-channel.1.txt index 95e62e6f1..f3328648a 100644 --- a/doc/man/lttng-enable-channel.1.txt +++ b/doc/man/lttng-enable-channel.1.txt @@ -245,12 +245,12 @@ no space left in the last file, _trace file rotation_ happens: the first file is cleared and new sub-buffers containing events are written there. LTTng does not guarantee that you can view the trace of an active -tracing session (before you run the man:lttng-stop(1) command), even +tracing session before you run the man:lttng-stop(1) command, even with multiple trace files, because LTTng could overwrite them at any moment, or some of them could be incomplete. You can archive a tracing session's current trace chunk while the tracing session is active to obtain an unmanaged and self-contained LTTng trace: see -man:lttng-rotate(1) and man:lttng-enable-rotation(1). +the man:lttng-rotate(1) and man:lttng-enable-rotation(1) commands. include::common-cmd-options-head.txt[] diff --git a/doc/man/lttng-snapshot.1.txt b/doc/man/lttng-snapshot.1.txt index ac4bebfd7..9d5b313a8 100644 --- a/doc/man/lttng-snapshot.1.txt +++ b/doc/man/lttng-snapshot.1.txt @@ -45,13 +45,19 @@ of a given tracing session. When a snapshot is taken, the memory dump is sent to the registered snapshot outputs. The tracing session should be created in _snapshot mode_ to make sure -taking snapshots is allowed. This is done at tracing session creation -time using the man:lttng-create(1) command. +that taking snapshots is allowed. This is done at tracing session +creation time using the man:lttng-create(1) command's +nloption:--snapshot option. Note that, when a snapshot is taken, the sub-buffers are not cleared. This means that different recorded snapshots may contain the same events. +If you want, instead, to keep all the trace data, but divide it into +archived chunks which are then free to process (just like snapshots), +see the lttng-rotate(1) and lttng-enable-rotation(1) commands. Trace +chunk archives do not overlap like snapshots can. + Snapshot outputs ~~~~~~~~~~~~~~~~