X-Git-Url: http://git.efficios.com/?a=blobdiff_plain;f=doc%2Fman%2Flttng-disable-channel.1.txt;h=164dfdd2f987431a5af2bb4b5c6838d0decbaa30;hb=188419c4eee5d623605d6c7bd797c18ae8564647;hp=1218739f3f3b521eb311610511f3717e0140d13e;hpb=7c1a4458be934fec31aa27a0eb52e4d0b8cb3803;p=lttng-tools.git diff --git a/doc/man/lttng-disable-channel.1.txt b/doc/man/lttng-disable-channel.1.txt index 1218739f3..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 -~~~~~~ -option:-s, option:--session='SESSION':: - Disable channels in the tracing session named 'SESSION' +Recording target +~~~~~~~~~~~~~~~~ +option:-s 'SESSION', option:--session='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)