lttng-disable-event(1)

1LTTNG-DISABLE-EVEN(1)            LTTng Manual            LTTNG-DISABLE-EVEN(1)
2
3
4

NAME

6       lttng-disable-event - Disable LTTng event rules
7

SYNOPSIS

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

DESCRIPTION

16       The lttng disable-event command disables one or more event rules
17       previously enabled by the lttng-enable-event(1) command.
18
19       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
23       If the --session option is omitted, the chosen channel is picked from
24       the current tracing session.
25
26       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
30       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
34       Events can be disabled while tracing is active (use lttng-start(1) to
35       make a tracing session active).
36

OPTIONS

38       General options are described in lttng(1).
39
40   Domain
41       One of:
42
43       -j, --jul
44           Disable event rules in the java.util.logging (JUL) domain.
45
46       -k, --kernel
47           Disable event rules in the Linux kernel domain.
48
49       -l, --log4j
50           Disable event rules in the Apache log4j domain.
51
52       -p, --python
53           Disable event rules in the Python domain.
54
55       -u, --userspace
56           Disable event rules in the user space domain.
57
58   Target
59       -c CHANNEL, --channel=CHANNEL
60           Disable event rules in the channel named CHANNEL instead of the
61           default channel name channel0.
62
63       -s SESSION, --session=SESSION
64           Disable event rules in the tracing session named SESSION instead of
65           the current tracing session.
66
67   Event source type
68       One of:
69
70       --function
71           Linux kernel kretprobe. Only available with the --kernel domain
72           option.
73
74       --probe
75           Linux kernel kprobe. Only available with the --kernel domain
76           option.
77
78       --syscall
79           Linux kernel system call. Only available with the --kernel domain
80           option.
81
82       --tracepoint
83           Linux kernel or application tracepoint. Only available with the
84           --kernel domain option (default Linux kernel domain event source
85           type).
86
87   Disabling
88       -a, --all-events
89           Disable all enabled event rules in the chosen tracing session,
90           tracing domain, and channel.
91
92   Program information
93       -h, --help
94           Show command help.
95
96           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
100       --list-options
101           List available command options.
102

ENVIRONMENT VARIABLES

104       LTTNG_ABORT_ON_ERROR
105           Set to 1 to abort the process after the first error is encountered.
106
107       LTTNG_HOME
108           Overrides the $HOME environment variable. Useful when the user
109           running the commands has a non-writable home directory.
110
111       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
115       LTTNG_SESSION_CONFIG_XSD_PATH
116           Path in which the session.xsd session configuration XML schema may
117           be found.
118
119       LTTNG_SESSIOND_PATH
120           Full session daemon binary path.
121
122           The --sessiond-path option has precedence over this environment
123           variable.
124
125       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

FILES

130       $LTTNG_HOME/.lttngrc
131           User LTTng runtime configuration.
132
133           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
138       $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
142       $LTTNG_HOME/.lttng
143           User LTTng runtime and configuration directory.
144
145       $LTTNG_HOME/.lttng/sessions
146           Default location of saved user tracing sessions (see lttng-save(1)
147           and lttng-load(1)).
148
149       /usr/local/etc/lttng/sessions
150           System-wide location of saved tracing sessions (see lttng-save(1)
151           and lttng-load(1)).
152
153           Note
154           $LTTNG_HOME defaults to $HOME when not explicitly set.
155

EXIT STATUS

157       0
158           Success
159
160       1
161           Command error
162
163       2
164           Undefined command
165
166       3
167           Fatal error
168
169       4
170           Command warning (something went wrong during the command)
171

BUGS

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

RESOURCES

177       ·   LTTng project website <http://lttng.org>
178
179       ·   LTTng documentation <http://lttng.org/docs>
180
181       ·   Git repositories <http://git.lttng.org>
182
183       ·   GitHub organization <http://github.com/lttng>
184
185       ·   Continuous integration <http://ci.lttng.org/>
186
187       ·   Mailing list <http://lists.lttng.org> for support and development:
188           lttng-dev@lists.lttng.org
189
190       ·   IRC channel <irc://irc.oftc.net/lttng>: #lttng on irc.oftc.net
191

COPYRIGHTS

193       This program is part of the LTTng-tools project.
194
195       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

THANKS

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
205       Also thanks to the Ericsson teams working on tracing which helped us
206       greatly with detailed bug reports and unusual test cases.
207

AUTHORS

209       LTTng-tools was originally written by Mathieu Desnoyers, Julien
210       Desfossez, and David Goulet. More people have since contributed to it.
211
212       LTTng-tools is currently maintained by Jérémie Galarneau
213       <mailto:jeremie.galarneau@efficios.com>.
214