Commit | Line | Data |
---|---|---|
4bf0a332 | 1 | lttng-disable-channel(1) |
4605890e | 2 | ======================== |
3f483870 | 3 | :revdate: 17 May 2021 |
4bf0a332 PP |
4 | |
5 | NAME | |
6 | ---- | |
7 | lttng-disable-channel - Disable LTTng channels | |
8 | ||
9 | ||
10 | SYNOPSIS | |
11 | -------- | |
12 | [verse] | |
ce19b9ed | 13 | *lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *disable-channel* (option:--kernel | option:--userspace) |
4bf0a332 PP |
14 | [option:--session='SESSION'] 'CHANNEL'[,'CHANNEL']... |
15 | ||
16 | ||
17 | DESCRIPTION | |
18 | ----------- | |
19 | The `lttng disable-channel` command disables one or more channels | |
188419c4 PP |
20 | previously enabled with the man:lttng-enable-channel(1) command |
21 | which belong to: | |
4bf0a332 | 22 | |
188419c4 PP |
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. | |
4bf0a332 | 31 | |
484b2a0c PP |
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 ben started (see | |
37 | man:lttng-start(1)) at least once. | |
4bf0a332 | 38 | |
3f483870 PP |
39 | See the <<examples,EXAMPLES>> section below for usage examples. |
40 | ||
4bf0a332 | 41 | |
55e06994 | 42 | include::common-lttng-cmd-options-head.txt[] |
4bf0a332 PP |
43 | |
44 | ||
484b2a0c PP |
45 | Tracing domain |
46 | ~~~~~~~~~~~~~~ | |
4bf0a332 PP |
47 | One of: |
48 | ||
49 | option:-k, option:--kernel:: | |
484b2a0c | 50 | Disable one or more Linux kernel channels. |
4bf0a332 PP |
51 | |
52 | option:-u, option:--userspace:: | |
484b2a0c | 53 | Disable one or more user space channels. |
4bf0a332 PP |
54 | |
55 | ||
188419c4 PP |
56 | Recording target |
57 | ~~~~~~~~~~~~~~~~ | |
59b19c3c | 58 | option:-s 'SESSION', option:--session='SESSION':: |
484b2a0c | 59 | Disable one or more channels of the tracing session named 'SESSION' |
4bf0a332 PP |
60 | instead of the current tracing session. |
61 | ||
62 | ||
55e06994 | 63 | include::common-lttng-cmd-help-options.txt[] |
4bf0a332 PP |
64 | |
65 | ||
55e06994 PP |
66 | include::common-lttng-cmd-after-options.txt[] |
67 | ||
68 | ||
3f483870 PP |
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 | ||
55e06994 | 92 | include::common-footer.txt[] |
4bf0a332 PP |
93 | |
94 | ||
95 | SEE ALSO | |
96 | -------- | |
484b2a0c | 97 | man:lttng(1), |
21b35b3a PP |
98 | man:lttng-enable-channel(1), |
99 | man:lttng-concepts(7) |