X-Git-Url: http://git.efficios.com/?a=blobdiff_plain;f=doc%2Fman%2Flttng-disable-channel.1.txt;h=164dfdd2f987431a5af2bb4b5c6838d0decbaa30;hb=188419c4eee5d623605d6c7bd797c18ae8564647;hp=2470c23564fef7c66f24ea0e4412f84b88dabe73;hpb=4bf0a3323200d6a657c6b50953f7ee1aba74a09f;p=lttng-tools.git diff --git a/doc/man/lttng-disable-channel.1.txt b/doc/man/lttng-disable-channel.1.txt index 2470c2356..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 ---- @@ -10,43 +10,51 @@ lttng-disable-channel - Disable LTTng channels SYNOPSIS -------- [verse] -*lttng* ['GENERAL OPTIONS'] *disable-channel* (option:--kernel | option:--userspace) +*lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *disable-channel* (option:--kernel | option:--userspace) [option:--session='SESSION'] 'CHANNEL'[,'CHANNEL']... DESCRIPTION ----------- The `lttng disable-channel` command disables one or more channels -previously enabled by the linklttng: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 linklttng: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 -------- -linklttng:lttng-disable-channel(1), -linklttng:lttng(1) +man:lttng(1), +man:lttng-concepts(7), +man:lttng-enable-channel(1)