X-Git-Url: https://git.liburcu.org/?a=blobdiff_plain;f=doc%2Fman%2Flttng-disable-channel.1.txt;h=164dfdd2f987431a5af2bb4b5c6838d0decbaa30;hb=26f0c7794376456fcb5b13d4eae91c0ccf0dfe66;hp=d3fe61e8145701a2357a766e52d5c81162a80f1b;hpb=59b19c3c82a824b602b4e3cd70e1cb22448fcb9d;p=lttng-tools.git diff --git a/doc/man/lttng-disable-channel.1.txt b/doc/man/lttng-disable-channel.1.txt index d3fe61e81..164dfdd2f 100644 --- a/doc/man/lttng-disable-channel.1.txt +++ b/doc/man/lttng-disable-channel.1.txt @@ -1,6 +1,6 @@ lttng-disable-channel(1) -======================= - +======================== +:revdate: 29 April 2021 NAME ---- @@ -17,36 +17,44 @@ SYNOPSIS DESCRIPTION ----------- The `lttng disable-channel` command disables one or more channels -previously enabled by the man:lttng-enable-channel(1) command. +previously enabled with the man:lttng-enable-channel(1) command +which belong to: + +With the option:--session='SESSION' option:: + The tracing session named 'SESSION'. + +Without the option:--session option:: + The current tracing session (see man:lttng-concepts(7) to learn more + about the current tracing session). + +See man:lttng-concepts(7) to learn more about channels. -A channel is always contained in a tracing session -(see man:lttng-create(1) for creating a tracing session). The -session in which a channel is disabled using `lttng disable-channel` can -be specified using the option:--session option. If the option:--session -option is omitted, the current tracing session is targeted. +The `disable-channel` command disables one channel per 'CHANNEL' +argument. -Note that re-enabling a disabled channel once its tracing session -has been active at least once is currently not supported. +As of LTTng{nbsp}{lttng_version}, you may :not: enable a disabled +channel once its tracing session has ben started (see +man:lttng-start(1)) at least once. include::common-cmd-options-head.txt[] -Domain -~~~~~~ +Tracing domain +~~~~~~~~~~~~~~ One of: option:-k, option:--kernel:: - Disable channel in the Linux kernel domain. + Disable one or more Linux kernel channels. option:-u, option:--userspace:: - Disable channel in the user space domain. + Disable one or more user space channels. -Target -~~~~~~ +Recording target +~~~~~~~~~~~~~~~~ option:-s 'SESSION', option:--session='SESSION':: - Disable channels in the tracing session named 'SESSION' + Disable one or more channels of the tracing session named 'SESSION' instead of the current tracing session. @@ -58,5 +66,6 @@ include::common-cmd-footer.txt[] SEE ALSO -------- -man:lttng-disable-channel(1), -man:lttng(1) +man:lttng(1), +man:lttng-concepts(7), +man:lttng-enable-channel(1)