NAME
----
-lttng-enable-rotation - Set a tracing session's automatic rotation schedule
+lttng-enable-rotation - Set a tracing session's rotation schedule
SYNOPSIS
DESCRIPTION
-----------
-The `lttng enable-rotation` command sets an automatic rotation schedule
-for the current tracing session, or for the tracing session named
-'SESSION' if provided. See man:lttng-rotate(1) for more information
-about the concepts of a tracing session _rotation_ and a _trace chunk_.
+The `lttng enable-rotation` command sets a rotation schedule for the
+current tracing session, or for the tracing session named 'SESSION' if
+provided. See man:lttng-rotate(1) for more information about the
+concepts of a tracing session _rotation_ and a _trace chunk_.
With the option:--timer option, the rotation schedule is set so that an
automatic rotation occurs at least every 'PERIOD' (microseconds without
information about the monitor timer.
The naming convention of a trace chunk archive which an automatic
-rotation creates is the same as with the manual rotation command,
+rotation creates is the same as with the immediate rotation command,
man:lttng-rotate(1).
-For a given tracing session, you cannot set multiple automatic rotation
-schedules with the option:--timer or the option:--size option.
-
-You can unset an automatic rotation schedule with the
-man:lttng-disable-rotation(1) command.
+You can unset a rotation schedule with the man:lttng-disable-rotation(1)
+command.
See <<limitations,LIMITATIONS>> for important limitations regarding
this command.
include::common-cmd-options-head.txt[]
-Automatic rotation schedule condition
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Rotation schedule condition
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
One of:
option:--size='SIZE'::
- Set an automatic rotation schedule so that an automatic rotation
- occurs every time the total size of the flushed part of the current
- trace chunk is at least 'SIZE' bytes. The `k` (kiB), `M` (MiB), and
- `G` (GiB) suffixes are supported.
+ Set a rotation schedule so that an automatic rotation occurs every
+ time the total size of the flushed part of the current trace chunk
+ is at least 'SIZE' bytes. The `k` (kiB), `M` (MiB), and `G` (GiB)
+ suffixes are supported.
option:--timer='PERIOD'::
- Set an automatic rotation schedule so that an automatic rotation
- occurs at least every 'PERIOD' microseconds. The
- `ms` (milliseconds), `s` (seconds), `m` (minutes), and `h` (hours)
- suffixes are supported.
+ Set a rotation schedule so that an automatic rotation occurs at
+ least every 'PERIOD' microseconds. The `ms` (milliseconds), `s`
+ (seconds), `m` (minutes), and `h` (hours) suffixes are supported.
Target
~~~~~~
option:-s 'SESSION', option:--session='SESSION'::
- Set an automatic rotation schedule for the tracing session named
- 'SESSION' instead of the current tracing session.
+ Set a rotation schedule for the tracing session named 'SESSION'
+ instead of the current tracing session.
include::common-cmd-help-options.txt[]