X-Git-Url: https://git.lttng.org/?a=blobdiff_plain;f=doc%2Fman%2Flttng-snapshot.1.txt;h=9d5b313a8e4ac230fea1a8da15437be530eba1ef;hb=adc4b5c84ab187cafb8b5368bdfd4b6be5b1faf5;hp=a749e1c02e99629945da9a76631459e1a65fd0f1;hpb=59b19c3c82a824b602b4e3cd70e1cb22448fcb9d;p=lttng-tools.git diff --git a/doc/man/lttng-snapshot.1.txt b/doc/man/lttng-snapshot.1.txt index a749e1c02..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 ~~~~~~~~~~~~~~~~ @@ -85,9 +91,10 @@ Taking a snapshot ~~~~~~~~~~~~~~~~~ Taking a snapshot of the current tracing session is as easy as: ---------------------- -lttng snapshot record ---------------------- +[role="term"] +---- +$ lttng snapshot record +---- This writes the snapshot files to the configured output. It is possible to use a custom, unregistered output at record time using the same