1LTTNG-DISABLE-EVEN(1) LTTng Manual LTTNG-DISABLE-EVEN(1)
2
6 lttng-disable-event - Disable LTTng event rules
7
9 lttng [GENERAL OPTIONS] disable-event
10 (--kernel [--probe | --function | --syscall] |
11 --userspace | --jul | --log4j | --python)
12 [--session=SESSION] [--channel=CHANNEL]
13 (--all-events | EVENT[,EVENT]...)
14
16 The lttng disable-event command disables one or more event rules
17 previously enabled by the lttng-enable-event(1) command.
18 Event rules are always assigned to a channel when they are created. If
20 the --channel option is omitted, the default channel named channel0 is
21 used.
22 If the --session option is omitted, the chosen channel is picked from
24 the current tracing session.
25 If the --all-events option is used, all the existing event rules of the
27 chosen domain are disabled. Otherwise, at least one event rule to
28 disable named EVENT must be specified.
29 With the --kernel option, the event source type can be specified using
31 one of the --tracepoint, --probe, --function, or --syscall options. See
32 lttng-enable-event(1) for more details about event source types.
33 Events can be disabled while tracing is active (use lttng-start(1) to
35 make a tracing session active).
36
38 General options are described in lttng(1).
39 Domain
41 One of:
42 -j, --jul
44 Disable event rules in the java.util.logging (JUL) domain.
45 -k, --kernel
47 Disable event rules in the Linux kernel domain.
48 -l, --log4j
50 Disable event rules in the Apache log4j domain.
51 -p, --python
53 Disable event rules in the Python domain.
54 -u, --userspace
56 Disable event rules in the user space domain.
57 Target
59 -c CHANNEL, --channel=CHANNEL
60 Disable event rules in the channel named CHANNEL instead of the
61 default channel name channel0.
62 -s SESSION, --session=SESSION
64 Disable event rules in the tracing session named SESSION instead of
65 the current tracing session.
66 Event source type
68 One of:
69 --function
71 Linux kernel kretprobe. Only available with the --kernel domain
72 option.
73 --probe
75 Linux kernel kprobe. Only available with the --kernel domain
76 option.
77 --syscall
79 Linux kernel system call. Only available with the --kernel domain
80 option.
81 --tracepoint
83 Linux kernel or application tracepoint. Only available with the
84 --kernel domain option (default Linux kernel domain event source
85 type).
86 Disabling
88 -a, --all-events
89 Disable all enabled event rules in the chosen tracing session,
90 tracing domain, and channel.
91 Program information
93 -h, --help
94 Show command help.
95 This option, like lttng-help(1), attempts to launch /usr/bin/man to
97 view the command’s man page. The path to the man pager can be
98 overridden by the LTTNG_MAN_BIN_PATH environment variable.
99 --list-options
101 List available command options.
102
104 LTTNG_ABORT_ON_ERROR
105 Set to 1 to abort the process after the first error is encountered.
106 LTTNG_HOME
108 Overrides the $HOME environment variable. Useful when the user
109 running the commands has a non-writable home directory.
110 LTTNG_MAN_BIN_PATH
112 Absolute path to the man pager to use for viewing help information
113 about LTTng commands (using lttng-help(1) or lttng COMMAND --help).
114 LTTNG_SESSION_CONFIG_XSD_PATH
116 Path in which the session.xsd session configuration XML schema may
117 be found.
118 LTTNG_SESSIOND_PATH
120 Full session daemon binary path.
121 The --sessiond-path option has precedence over this environment
123 variable.
124 Note that the lttng-create(1) command can spawn an LTTng session daemon
126 automatically if none is running. See lttng-sessiond(8) for the
127 environment variables influencing the execution of the session daemon.
128
130 $LTTNG_HOME/.lttngrc
131 User LTTng runtime configuration.
132 This is where the per-user current tracing session is stored
134 between executions of lttng(1). The current tracing session can be
135 set with lttng-set-session(1). See lttng-create(1) for more
136 information about tracing sessions.
137 $LTTNG_HOME/lttng-traces
139 Default output directory of LTTng traces. This can be overridden
140 with the --output option of the lttng-create(1) command.
141 $LTTNG_HOME/.lttng
143 User LTTng runtime and configuration directory.
144 $LTTNG_HOME/.lttng/sessions
146 Default location of saved user tracing sessions (see lttng-save(1)
147 and lttng-load(1)).
148 /usr/local/etc/lttng/sessions
150 System-wide location of saved tracing sessions (see lttng-save(1)
151 and lttng-load(1)).
152 Note
154 $LTTNG_HOME defaults to $HOME when not explicitly set.
155
157 0
158 Success
159 1
161 Command error
162 2
164 Undefined command
165 3
167 Fatal error
168 4
170 Command warning (something went wrong during the command)
171
173 If you encounter any issue or usability problem, please report it on
174 the LTTng bug tracker <https://bugs.lttng.org/projects/lttng-tools>.
175
177 · LTTng project website <https://lttng.org>
178 · LTTng documentation <https://lttng.org/docs>
180 · Git repositories <http://git.lttng.org>
182 · GitHub organization <http://github.com/lttng>
184 · Continuous integration <http://ci.lttng.org/>
186 · Mailing list <http://lists.lttng.org> for support and development:
188 lttng-dev@lists.lttng.org
189 · IRC channel <irc://irc.oftc.net/lttng>: #lttng on irc.oftc.net
191
193 This program is part of the LTTng-tools project.
194 LTTng-tools is distributed under the GNU General Public License version
196 2 <http://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html>. See the
197 LICENSE <https://github.com/lttng/lttng-tools/blob/master/LICENSE> file
198 for details.
199
201 Special thanks to Michel Dagenais and the DORSAL laboratory
202 <http://www.dorsal.polymtl.ca/> at École Polytechnique de Montréal for
203 the LTTng journey.
204 Also thanks to the Ericsson teams working on tracing which helped us
206 greatly with detailed bug reports and unusual test cases.
207
209 lttng-enable-event(1), lttng(1)
210LTTng 2.11.1 28 November 2016 LTTNG-DISABLE-EVEN(1)