From: Philippe Proulx Date: Fri, 15 Nov 2019 22:09:05 +0000 (-0500) Subject: babeltrace2-source.ctf.fs(7): document the overlapping snapshot feature X-Git-Tag: v2.0.0-rc3~1 X-Git-Url: http://git.efficios.com/?p=babeltrace.git;a=commitdiff_plain;h=e3db68eb7db94d272c7f83f7d0735fb9eff15027 babeltrace2-source.ctf.fs(7): document the overlapping snapshot feature Signed-off-by: Philippe Proulx Change-Id: I482a366679f65a577cb7081ce46736ab484858c3 Reviewed-on: https://review.lttng.org/c/babeltrace/+/2395 --- diff --git a/doc/man/babeltrace2-source.ctf.fs.7.txt b/doc/man/babeltrace2-source.ctf.fs.7.txt index f05a4d10..fe3ff322 100644 --- a/doc/man/babeltrace2-source.ctf.fs.7.txt +++ b/doc/man/babeltrace2-source.ctf.fs.7.txt @@ -67,6 +67,14 @@ More than one physical CTF data stream file can support a single logical CTF data stream (LTTng's trace file rotation and tracing session rotation can cause this). +If two or more data stream files contain the same packets, a +compcls:source.ctf.fs message iterator reads each of them only once so +that it never emits duplicated messages. This feature makes it possible, +for example, to open overlapping +https://lttng.org/docs/#doc-taking-a-snapshot[LTTng snapshots] with a +single compcls:source.ctf.fs component and silently discard the +duplicated packets. + === Trace quirks