| | 1 | lttng-disable-channel(1) |
| | 2 | ======================== |
| | 3 | :revdate: 14 June 2021 |
| | 4 | |
| | 5 | |
| | 6 | NAME |
| | 7 | ---- |
| | 8 | lttng-disable-channel - Disable LTTng channels |
| | 9 | |
| | 10 | |
| | 11 | SYNOPSIS |
| | 12 | -------- |
| | 13 | [verse] |
| | 14 | *lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *disable-channel* (option:--kernel | option:--userspace) |
| | 15 | [option:--session='SESSION'] 'CHANNEL'[,'CHANNEL']... |
| | 16 | |
| | 17 | |
| | 18 | DESCRIPTION |
| | 19 | ----------- |
| | 20 | The `lttng disable-channel` command disables one or more channels |
| | 21 | previously enabled with the man:lttng-enable-channel(1) command |
| | 22 | which belong to: |
| | 23 | |
| | 24 | With the option:--session='SESSION' option:: |
| | 25 | The recording session named 'SESSION'. |
| | 26 | |
| | 27 | Without the option:--session option:: |
| | 28 | The current recording session (see man:lttng-concepts(7) to learn |
| | 29 | more about the current recording session). |
| | 30 | |
| | 31 | See man:lttng-concepts(7) to learn more about channels. |
| | 32 | |
| | 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 |
| | 37 | channel once its recording session has been started (see |
| | 38 | man:lttng-start(1)) at least once. |
| | 39 | |
| | 40 | See the ``<<examples,EXAMPLES>>'' section below for usage examples. |
| | 41 | |
| | 42 | |
| | 43 | include::common-lttng-cmd-options-head.txt[] |
| | 44 | |
| | 45 | |
| | 46 | Tracing domain |
| | 47 | ~~~~~~~~~~~~~~ |
| | 48 | One of: |
| | 49 | |
| | 50 | option:-k, option:--kernel:: |
| | 51 | Disable one or more Linux kernel channels. |
| | 52 | |
| | 53 | option:-u, option:--userspace:: |
| | 54 | Disable one or more user space channels. |
| | 55 | |
| | 56 | |
| | 57 | Recording target |
| | 58 | ~~~~~~~~~~~~~~~~ |
| | 59 | option:-s 'SESSION', option:--session='SESSION':: |
| | 60 | Disable one or more channels of the recording session named |
| | 61 | 'SESSION' instead of the current recording session. |
| | 62 | |
| | 63 | |
| | 64 | include::common-lttng-cmd-help-options.txt[] |
| | 65 | |
| | 66 | |
| | 67 | include::common-lttng-cmd-after-options.txt[] |
| | 68 | |
| | 69 | |
| | 70 | [[examples]] |
| | 71 | EXAMPLES |
| | 72 | -------- |
| | 73 | .Disable one Linux kernel channel of the current recording session. |
| | 74 | ==== |
| | 75 | [role="term"] |
| | 76 | ---- |
| | 77 | $ lttng disable-channel --kernel my-channel |
| | 78 | ---- |
| | 79 | ==== |
| | 80 | |
| | 81 | .Disable two user space channels of a specific recording session. |
| | 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 | |
| | 93 | include::common-footer.txt[] |
| | 94 | |
| | 95 | |
| | 96 | SEE ALSO |
| | 97 | -------- |
| | 98 | man:lttng(1), |
| | 99 | man:lttng-enable-channel(1), |
| | 100 | man:lttng-concepts(7) |
projects / lttng-tools.git / blame_incremental