X-Git-Url: https://git.lttng.org/?a=blobdiff_plain;f=src%2Fbin%2Flttng-relayd%2Fviewer-session.h;h=cbf4aa157dcfff4c8071ca3792191a8988a8e199;hb=87250ba19aec78f36e301494a03f5678fcb6fbb4;hp=ebde2dd1dbfc77cfb08c541f898ed89f76253138;hpb=ab5be9fa2eb5ba9600a82cd18fd3cfcbac69169a;p=lttng-tools.git

diff --git a/src/bin/lttng-relayd/viewer-session.h b/src/bin/lttng-relayd/viewer-session.h
index ebde2dd1d..cbf4aa157 100644
--- a/src/bin/lttng-relayd/viewer-session.h
+++ b/src/bin/lttng-relayd/viewer-session.h
@@ -30,7 +30,29 @@ struct relay_viewer_session {
 	 */
 	struct cds_list_head session_list;	/* RCU list. */
 	pthread_mutex_t session_list_lock;	/* Protects list updates. */
-	/* Once set, the current trace chunk of a viewer must not change. */
+	/*
+	 * The viewer session's current trace chunk is initially set, when
+	 * a viewer attaches to the viewer session, to a copy the corresponding
+	 * relay_session's current trace chunk.
+	 *
+	 * A live session always attempts to "catch-up" to the newest available
+	 * trace chunk. This means that when a viewer reaches the end of a
+	 * trace chunk, the viewer session may not transition to the "next" one:
+	 * it jumps to the most recent trace chunk available (the one being
+	 * produced by the relay_session). Hence, if the producer performs
+	 * multiple rotations before a viewer completes the consumption of a
+	 * trace chunk, it will skip over those "intermediary" trace chunks.
+	 *
+	 * A viewer session updates its current trace chunk when:
+	 *   1) new viewer streams are created,
+	 *   2) a new index is requested,
+	 *   3) metadata is requested.
+	 *
+	 * Hence, as a general principle, the viewer session will reference the
+	 * most recent trace chunk available _even if its streams do not point to
+	 * it_. It indicates which trace chunk viewer streams should transition
+	 * to when the end of their current trace chunk is reached.
+	 */
 	struct lttng_trace_chunk *current_trace_chunk;
 };