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