From 437afa719f5e777dac77827298c443f450e0903e Mon Sep 17 00:00:00 2001 From: Philippe Proulx Date: Tue, 13 Nov 2018 12:48:52 -0500 Subject: [PATCH 1/1] lttng-enable-rotation.1.txt: --timer option should be fairly precise MIME-Version: 1.0 Content-Type: text/plain; charset=utf8 Content-Transfer-Encoding: 8bit Signed-off-by: Philippe Proulx Signed-off-by: Jérémie Galarneau --- doc/man/lttng-enable-rotation.1.txt | 20 ++++++++++++-------- 1 file changed, 12 insertions(+), 8 deletions(-) diff --git a/doc/man/lttng-enable-rotation.1.txt b/doc/man/lttng-enable-rotation.1.txt index 37c9e2c7b..e8970cd97 100644 --- a/doc/man/lttng-enable-rotation.1.txt +++ b/doc/man/lttng-enable-rotation.1.txt @@ -32,14 +32,18 @@ without a unit suffix). For both option:--timer and option:--size options, LTTng checks the schedule condition periodically using the monitor timers of the tracing -session's channels. This means that, with the option:--timer option, the -automatic rotation can occur when the elapsed time since the last -automatic rotation is greater than 'PERIOD', and with the option:--size -option, the automatic rotation can occur when the size of the flushed -part of the current trace chunk is greater than 'SIZE'. Therefore the -'PERIOD' and 'SIZE' arguments are approximations. See the -nloption:--monitor-timer option in man:lttng-enable-channel(1) for more -information about the monitor timer. +session's channels (see the nloption:--monitor-timer option of the +man:lttng-enable-channel(1) command). This means that: + +* With the option:--timer option, the automatic rotation can occur when + the elapsed time since the last automatic rotation is slightly greater + than 'PERIOD'. The exact precision is governed by the monitor timer's + precision, which relies on the precision of the platform's + implementation of POSIX timers. + +* With the option:--size option, the automatic rotation can occur when + the size of the flushed part of the current trace chunk is greater + than 'SIZE'. You can combine the option:--timer and option:--size options. -- 2.34.1