X-Git-Url: https://git.lttng.org/?p=lttng-tools.git;a=blobdiff_plain;f=doc%2Fman%2Flttng-enable-channel.1.txt;h=5a7f4c55fef34c91d6973fb86f33f81072adb9ba;hp=e238830d3bc63aafb722741dcd79897e80fc7612;hb=1076f2b797d3ecfdad1e080fa6c1a3beb9a37027;hpb=b4867b3be09b040aa8da32d0fa417ff1ec2a40f9 diff --git a/doc/man/lttng-enable-channel.1.txt b/doc/man/lttng-enable-channel.1.txt index e238830d3..5a7f4c55f 100644 --- a/doc/man/lttng-enable-channel.1.txt +++ b/doc/man/lttng-enable-channel.1.txt @@ -64,17 +64,8 @@ Existing enabled channels can be disabled using linklttng:lttng-disable-channel(1). Channels of a given session can be listed using linklttng:lttng-list(1). -As of this version of LTTng, it is not possible to: - -* Reconfigure a channel once it is created. -* Re-enable a disabled channel once its tracing session has been active - at least once. -* Create a channel once its tracing session has been active - at least once. -* Create a user space channel with a given buffering scheme - (option:--buffers-uid or option:--buffers-pid options) and create - a second user space channel with a different buffering scheme in the - same tracing session. +See the <> section below for a list of +limitations of this command to consider. Event loss modes @@ -209,6 +200,7 @@ in conjunction with the option:--tracefile-size option. For example, consider this command: +[role="term"] ----------------------------------------------------- lttng enable-channel --kernel --tracefile-size=4096 \ --tracefile-count=32 my-channel @@ -352,6 +344,23 @@ option:--switch-timer='PERIODUS':: include::common-cmd-help-options.txt[] +[[limitations]] +LIMITATIONS +----------- +As of this version of LTTng, it is not possible to perform the following +actions with the `lttng enable-channel` command: + +* Reconfigure a channel once it is created. +* Re-enable a disabled channel once its tracing session has been active + at least once. +* Create a channel once its tracing session has been active + at least once. +* Create a user space channel with a given buffering scheme + (option:--buffers-uid or option:--buffers-pid options) and create + a second user space channel with a different buffering scheme in the + same tracing session. + + include::common-cmd-footer.txt[]