X-Git-Url: http://git.lttng.org/?a=blobdiff_plain;f=doc%2Fman%2Flttng-disable-channel.1.txt;h=ccfb1a9fa7e1135e680a8804401044b467b9a1f5;hb=HEAD;hp=9492a390391ab69ac856f115d2d30a1f4688ef56;hpb=af1c4164dd7bad940a84c29c2b429d76e3fc0e33;p=lttng-tools.git diff --git a/doc/man/lttng-disable-channel.1.txt b/doc/man/lttng-disable-channel.1.txt index 9492a3903..244e9c4b1 100644 --- a/doc/man/lttng-disable-channel.1.txt +++ b/doc/man/lttng-disable-channel.1.txt @@ -1,6 +1,7 @@ lttng-disable-channel(1) ======================== -:revdate: 29 April 2021 +:revdate: 14 June 2021 + NAME ---- @@ -21,11 +22,11 @@ previously enabled with the man:lttng-enable-channel(1) command which belong to: With the option:--session='SESSION' option:: - The tracing session named 'SESSION'. + The recording 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). + The current recording session (see man:lttng-concepts(7) to learn + more about the current recording session). See man:lttng-concepts(7) to learn more about channels. @@ -33,11 +34,13 @@ The `disable-channel` command disables one channel per 'CHANNEL' argument. As of LTTng{nbsp}{lttng_version}, you may :not: enable a disabled -channel once its tracing session has ben started (see +channel once its recording session has been started (see man:lttng-start(1)) at least once. +See the ``<>'' section below for usage examples. + -include::common-cmd-options-head.txt[] +include::common-lttng-cmd-options-head.txt[] Tracing domain @@ -54,14 +57,40 @@ option:-u, option:--userspace:: 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. + Disable one or more channels of the recording session named + 'SESSION' instead of the current recording session. + + +include::common-lttng-cmd-help-options.txt[] -include::common-cmd-help-options.txt[] +include::common-lttng-cmd-after-options.txt[] + + +[[examples]] +EXAMPLES +-------- +.Disable one Linux kernel channel of the current recording session. +==== +[role="term"] +---- +$ lttng disable-channel --kernel my-channel +---- +==== + +.Disable two user space channels of a specific recording session. +==== +See the option:--session option. + +[role="term"] +---- +$ lttng disable-channel --kernel --session=my-session \ + little,box +---- +==== -include::common-cmd-footer.txt[] +include::common-footer.txt[] SEE ALSO