From: Philippe Proulx Date: Tue, 13 Nov 2018 17:48:52 +0000 (-0500) Subject: lttng-enable-rotation.1.txt: --timer option should be fairly precise X-Git-Tag: v2.12.0-rc1~747 X-Git-Url: https://git.lttng.org./?a=commitdiff_plain;h=437afa719f5e777dac77827298c443f450e0903e;p=lttng-tools.git lttng-enable-rotation.1.txt: --timer option should be fairly precise Signed-off-by: Philippe Proulx Signed-off-by: Jérémie Galarneau --- 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.