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 recording session named 'SESSION'.
41 Without the option:--session option::
42 The current recording session (see man:lttng-concepts(7) to learn
43 more about the current recording 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 If there's more than one channel for the selected recording session and
52 domain, the `disable-event` command fails.
54 See man:lttng-concepts(7) to learn more about recording event rules.
56 As of LTTng{nbsp}{lttng_version}, the `disable-event` command can only
57 find recording event rules to disable by their instrumentation point
58 type and event name conditions. Therefore, you cannot disable recording
59 event rules having a specific instrumentation point log level condition,
62 With the option:--kernel option and no instrumentation point type
63 condition option, the `disable-event` command disables one or more Linux
64 kernel recording event rules regardless of their instrumentation point
67 List the recording event rules of a given recording session
68 and/or channel with the man:lttng-list(1) command.
70 Without the option:--all-events option, the `disable-event` command
71 disables one recording event rule per 'NAME' argument. 'NAME' is the
72 exact event name condition pattern of the recording event rule to
73 disable, as listed in the output of `lttng list` (see
76 You may disable an enabled recording event rule regardless of the
77 activity (started or stopped) of its recording session (see
78 man:lttng-start(1) and man:lttng-stop(1)).
80 See the ``<<examples,EXAMPLES>>'' section below for usage examples.
83 include::common-lttng-cmd-options-head.txt[]
90 option:-j, option:--jul::
91 Disable recording event rules in the `java.util.logging` (JUL)
94 option:-k, option:--kernel::
95 Disable recording event rules in the Linux kernel domain.
97 option:-l, option:--log4j::
98 Disable recording event rules in the Apache log4j domain.
100 option:-p, option:--python::
101 Disable recording event rules in the Python domain.
103 option:-u, option:--userspace::
104 Disable recording event rules in the user space tracing domain.
109 option:-c 'CHANNEL', option:--channel='CHANNEL'::
110 Disable recording event rules attached to the channel named
111 'CHANNEL' instead of `channel0`.
113 option:-s 'SESSION', option:--session='SESSION'::
114 Disable recording event rules in the recording session named
115 'SESSION' instead of the current recording session.
118 Instrumentation point type condition
119 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
123 Only disable recording event rules which match Linux kretprobe
126 Only available with the option:--kernel option.
129 Only disable recording event rules which match Linux kprobe events.
131 Only available with the option:--kernel option.
134 Only disable recording event rules which match Linux system call
137 Only available with the option:--kernel option.
139 option:--tracepoint::
140 Only disable recording event rules which match:
143 With the option:--kernel or option:--userspace option:::
144 LTTng tracepoint events.
145 With the option:--jul, option:--log4j, or option:--python option:::
152 option:-a, option:--all-events::
153 Disable recording event rules regardless of their event name
157 include::common-lttng-cmd-help-options.txt[]
160 include::common-lttng-cmd-after-options.txt[]
166 .Disable all Linux kernel tracepoint recording event rules in the default channel of the current recording session.
168 See the option:--all-events option.
172 $ lttng disable-event --kernel --tracepoint --all-events
176 .Disable specific Apache log4j recording event rules in the default channel of a specific recording session.
178 See the option:--session option.
182 $ lttng disable-event --session=my-session --log4j \
183 MySingleton,MyProxy,MyFacade
187 .Disable all user space recording event rules in a specific channel of the current recording session.
189 See the option:--channel option.
193 $ lttng disable-event --channel=my-channel --userspace \
198 .Disable specific Linux kernel system call recording event rules in the default channel of the current recording session.
202 $ lttng disable-event --kernel --syscall pipe2,eventfd
207 include::common-footer.txt[]
213 man:lttng-enable-event(1),
215 man:lttng-concepts(7)