From 739588ff50f96ac255a99a82a55e90d60e4ae601 Mon Sep 17 00:00:00 2001 From: Arkadiusz Szczepkowicz Date: Mon, 22 Jul 2024 15:43:20 +0200 Subject: [PATCH] #2187: Add a note to the documentation about incomplete notes --- docs/md/trace.md | 11 ++++++++++- src/vt/trace/trace_lite.h | 3 +++ 2 files changed, 13 insertions(+), 1 deletion(-) diff --git a/docs/md/trace.md b/docs/md/trace.md index 0b3e0f0367..d8e3eb363d 100644 --- a/docs/md/trace.md +++ b/docs/md/trace.md @@ -19,4 +19,13 @@ In order to customize when tracing is enabled and disabled, a trace specification file can be passed to \vt via a command-line flag: `--vt_trace_spec --vt_trace_spec_file=filename.spec`. -For details about vt's Specification File see \ref spec-file \ No newline at end of file +For details about vt's Specification File see \ref spec-file + +\section incremental-tracing Incremental Trace Output + +The trace events can be configured to be saved to the file in the incremental matter. +To configure the interval of the flushes use the `--vt_trace_flush_size=X` parameter. +The `X` stands for the number of trace events before the next flush. + +\note The incremental flushing will be blocked in the case of an incomplete user notes. +In that scenario there will be no output to the files. All trace events will be kept in memory and will be tried to be flushed on the next interval if the incomplete notes where closed. diff --git a/src/vt/trace/trace_lite.h b/src/vt/trace/trace_lite.h index 7952d3f835..748a30a2a5 100644 --- a/src/vt/trace/trace_lite.h +++ b/src/vt/trace/trace_lite.h @@ -236,6 +236,9 @@ struct TraceLite { /** * \brief Flush traces to file * + * \note The flush will be blocked when having an incomplete user notes. + * In that case method will not flush any traces. + * * \param[in] useGlobalSync whether a global sync should be invoked before * flushing output */