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)
36 command which belong to:
38 With the option:--session='SESSION' option::
39 The tracing session named 'SESSION'.
41 Without the option:--session option::
42 The current tracing session (see man:lttng-concepts(7) to learn more
43 about the current tracing session).
45 With the option:--channel='CHANNEL' option::
46 The channel named 'CHANNEL'.
48 Without the option:--channel option::
49 The channel named `channel0`.
51 See man:lttng-concepts(7) to learn more about recording event rules.
53 As of LTTng{nbsp}{lttng_version}, the `disable-event` command can only
54 find recording event rules to disable by their instrumentation point
55 type and event name conditions. Therefore, you cannot disable recording
56 event rules having a specific instrumentation point log level condition,
59 With the option:--kernel option and no instrumentation point type
60 condition option, the `disable-event` command disables one or more Linux
61 kernel recording event rules regardless of their instrumentation point
64 List the recording event rules of a given tracing session
65 and/or channel with the man:lttng-list(1) command.
67 Without the option:--all-events option, the `disable-event` command
68 disables one recording event rule per 'NAME' argument. 'NAME' is the
69 exact event name condition pattern of the recording event rule to
70 disable, as listed in the output of `lttng list` (see
73 You may disable an enabled recording event rule regardless of the
74 activity (started or stopped) of its tracing session (see
75 man:lttng-start(1) and man:lttng-stop(1)).
77 See the <<examples,EXAMPLES>> section below for usage examples.
80 include::common-lttng-cmd-options-head.txt[]
87 option:-j, option:--jul::
88 Disable recording event rules in the `java.util.logging` (JUL)
91 option:-k, option:--kernel::
92 Disable recording event rules in the Linux kernel domain.
94 option:-l, option:--log4j::
95 Disable recording event rules in the Apache log4j domain.
97 option:-p, option:--python::
98 Disable recording event rules in the Python domain.
100 option:-u, option:--userspace::
101 Disable recording event rules in the user space tracing domain.
106 option:-c 'CHANNEL', option:--channel='CHANNEL'::
107 Disable recording event rules attached to the channel named
108 'CHANNEL' instead of `channel0`.
110 option:-s 'SESSION', option:--session='SESSION'::
111 Disable recording event rules in the tracing session named 'SESSION'
112 instead of the current tracing session.
115 Instrumentation point type condition
116 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
120 Only disable recording event rules which match Linux kretprobe
123 Only available with the option:--kernel option.
126 Only disable recording event rules which match Linux kprobe events.
128 Only available with the option:--kernel option.
131 Only disable recording event rules which match Linux system call
134 Only available with the option:--kernel option.
136 option:--tracepoint::
137 Only disable recording event rules which match:
140 With the option:--kernel or option:--userspace option:::
141 LTTng tracepoint events.
142 With the option:--jul, option:--log4j, or option:--python option:::
149 option:-a, option:--all-events::
150 Disable recording event rules regardless of their event name
154 include::common-lttng-cmd-help-options.txt[]
157 include::common-lttng-cmd-after-options.txt[]
163 .Disable all Linux kernel tracepoint recording event rules in the default channel of the current tracing session.
165 See the option:--all-events option.
169 $ lttng disable-event --kernel --tracepoint --all-events
173 .Disable specific Apache log4j recording event rules in the default channel of a specific tracing session.
175 See the option:--session option.
179 $ lttng disable-event --session=my-session --log4j \
180 MySingleton,MyProxy,MyFacade
184 .Disable all user space recording event rules in a specific channel of the current tracing session.
186 See the option:--channel option.
190 $ lttng disable-event --channel=my-channel --userspace \
195 .Disable specific Linux kernel system call recording event rules in the default channel of the current tracing session.
199 $ lttng disable-event --kernel --syscall pipe2,eventfd
204 include::common-footer.txt[]
210 man:lttng-enable-event(1),
212 man:lttng-concepts(7)