Fix: build: libcommon fd-tracker dependency is not available
[lttng-tools.git] / doc / man / lttng-disable-channel.1.txt
1 lttng-disable-channel(1)
2 ========================
3 :revdate: 17 May 2021
4
5 NAME
6 ----
7 lttng-disable-channel - Disable LTTng channels
8
9
10 SYNOPSIS
11 --------
12 [verse]
13 *lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *disable-channel* (option:--kernel | option:--userspace)
14 [option:--session='SESSION'] 'CHANNEL'[,'CHANNEL']...
15
16
17 DESCRIPTION
18 -----------
19 The `lttng disable-channel` command disables one or more channels
20 previously enabled with the man:lttng-enable-channel(1) command
21 which belong to:
22
23 With the option:--session='SESSION' option::
24 The tracing session named 'SESSION'.
25
26 Without the option:--session option::
27 The current tracing session (see man:lttng-concepts(7) to learn more
28 about the current tracing session).
29
30 See man:lttng-concepts(7) to learn more about channels.
31
32 The `disable-channel` command disables one channel per 'CHANNEL'
33 argument.
34
35 As of LTTng{nbsp}{lttng_version}, you may :not: enable a disabled
36 channel once its tracing session has been started (see
37 man:lttng-start(1)) at least once.
38
39 See the <<examples,EXAMPLES>> section below for usage examples.
40
41
42 include::common-lttng-cmd-options-head.txt[]
43
44
45 Tracing domain
46 ~~~~~~~~~~~~~~
47 One of:
48
49 option:-k, option:--kernel::
50 Disable one or more Linux kernel channels.
51
52 option:-u, option:--userspace::
53 Disable one or more user space channels.
54
55
56 Recording target
57 ~~~~~~~~~~~~~~~~
58 option:-s 'SESSION', option:--session='SESSION'::
59 Disable one or more channels of the tracing session named 'SESSION'
60 instead of the current tracing session.
61
62
63 include::common-lttng-cmd-help-options.txt[]
64
65
66 include::common-lttng-cmd-after-options.txt[]
67
68
69 [[examples]]
70 EXAMPLES
71 --------
72 .Disable one Linux kernel channel of the current tracing session.
73 ====
74 [role="term"]
75 ----
76 $ lttng disable-channel --kernel my-channel
77 ----
78 ====
79
80 .Disable two user space channels of a specific tracing session.
81 ====
82 See the option:--session option.
83
84 [role="term"]
85 ----
86 $ lttng disable-channel --kernel --session=my-session \
87 little,box
88 ----
89 ====
90
91
92 include::common-footer.txt[]
93
94
95 SEE ALSO
96 --------
97 man:lttng(1),
98 man:lttng-enable-channel(1),
99 man:lttng-concepts(7)
This page took 0.031312 seconds and 4 git commands to generate.