3 :revdate: 21 April 2021
8 lttng-disable-event - Disable LTTng recording event rules
13 Disable one or more recording event rules matching Linux kernel
17 *lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *disable-event* option:--kernel
18 [option:--tracepoint | option:--syscall | option:--probe | option:--function]
19 (option:--all-events | 'NAME'[,'NAME']...)
20 [option:--session='SESSION'] [option:--channel='CHANNEL']
22 Disable one or more recording event rules matching user space
23 tracepoint or Java/Python logging events:
26 *lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *disable-event*
27 (option:--userspace | option:--jul | option:--log4j | option:--python) [option:--tracepoint]
28 (option:--all-events | 'NAME'[,'NAME']...)
29 [option:--session='SESSION'] [option:--channel='CHANNEL']
34 The `lttng disable-event` command disables one or more enabled recording
35 event rules previously created with the man:lttng-enable-event(1)
38 As of LTTng{nbsp}{lttng_version}, the `disable-event` command can only
39 find recording event rules to disable by their instrumentation point
40 type and event name conditions. Therefore, you cannot disable recording
41 event rules having a specific instrumentation point log level condition,
44 List the existing recording event rules of a given tracing session
45 and/or channel with the man:lttng-list(1) command.
47 Without the option:--all-events option, the `disable-event` command
48 disables one recording event rule per 'NAME' argument. 'NAME' is the
49 exact event name condition pattern of the recording event rule to
50 disable, as listed in the output of `lttng list` (see
53 Without the option:--channel option, the `disable-event` command selects
54 the channel named `channel0`.
56 Without the option:--session option, the `disable-event` command selects
57 the current tracing session (see man:lttng-create(1) and
58 man:lttng-set-session(1) to learn more about the current tracing
61 You may disable an enabled recording event rule regardless of the
62 activity (started or stopped) of its tracing session (see
63 man:lttng-start(1) and man:lttng-stop(1)).
66 include::common-cmd-options-head.txt[]
73 option:-j, option:--jul::
74 Disable recording event rules in the `java.util.logging` (JUL)
77 option:-k, option:--kernel::
78 Disable recording event rules in the Linux kernel domain.
80 option:-l, option:--log4j::
81 Disable recording event rules in the Apache log4j domain.
83 option:-p, option:--python::
84 Disable recording event rules in the Python domain.
86 option:-u, option:--userspace::
87 Disable recording event rules in the user space tracing domain.
92 option:-c 'CHANNEL', option:--channel='CHANNEL'::
93 Disable recording event rules attached to the channel named
94 'CHANNEL' instead of `channel0`.
96 option:-s 'SESSION', option:--session='SESSION'::
97 Disable recording event rules in the tracing session named 'SESSION'
98 instead of the current tracing session.
101 Instrumentation point type condition
102 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
106 Only disable recording event rules which match Linux kretprobe
109 Only available with the option:--kernel option.
112 Only disable recording event rules which match Linux kprobe events.
114 Only available with the option:--kernel option.
117 Only disable recording event rules which match Linux system call
120 Only available with the option:--kernel option.
122 option:--tracepoint::
123 Only disable recording event rules which match:
126 With the option:--kernel or option:--userspace option:::
127 LTTng tracepoint events.
128 With the option:--jul, option:--log4j, or option:--python option:::
132 As of LTTng{nbsp}{lttng_version}, this is the default instrumentation
133 point type condition option, but this may change in the future.
138 option:-a, option:--all-events::
139 Disable recording event rules regardless of their event name
143 include::common-cmd-help-options.txt[]
146 include::common-cmd-footer.txt[]
152 man:lttng-enable-event(1),