lttng-enable-channel(1)
=======================
+:revdate: 9 November 2018
NAME
The `lttng enable-channel` command can create a new channel, or enable
one or more existing and disabled ones.
-A channel is the owner of sub-buffers holding recorded events. Event,
-rules, when created using man:lttng-enable-event(1), are always
+A channel is the owner of sub-buffers holding recorded events. Recording
+event rules, when created using man:lttng-enable-event(1), are always
assigned to a channel. When creating a new channel, many parameters
related to those sub-buffers can be fine-tuned. They are described in
the subsections below.
no space left in the last file, _trace file rotation_ happens: the first
file is cleared and new sub-buffers containing events are written there.
+LTTng does not guarantee that you can view the trace of an active
+tracing session before you run the man:lttng-stop(1) command, even
+with multiple trace files, because LTTng could overwrite them at any
+moment, or some of them could be incomplete. You can archive a
+tracing session's current trace chunk while the tracing session is
+active to obtain an unmanaged and self-contained LTTng trace: see
+the man:lttng-rotate(1) and man:lttng-enable-rotation(1) commands.
+
include::common-cmd-options-head.txt[]