1LTTNG-REMOVE-TRIGG(1) LTTng Manual LTTNG-REMOVE-TRIGG(1)
2
3
4
6 lttng-remove-trigger - Remove an LTTng trigger
7
9 lttng [GENERAL OPTIONS] remove-trigger [--owner-uid=UID] NAME
10
12 The lttng remove-trigger command removes the trigger named NAME.
13
14 See lttng-concepts(7) to learn more about LTTng triggers.
15
16 List the triggers of your Unix user, or of all users if your Unix user
17 is root, with the lttng-list-triggers(1) command.
18
19 The remove-trigger command removes a trigger which belong to your Unix
20 user. If your Unix user is root, you can remove the trigger of another
21 user with the --owner-uid option.
22
23 See the “EXAMPLES” section below for usage examples.
24
26 Identification
27 --owner-uid=UID
28 Remove the trigger named NAME of the Unix user having the user ID
29 UID.
30
31 You may only use this option if your Unix user is root.
32
33 Program information
34 -h, --help
35 Show help.
36
37 This option attempts to launch /usr/bin/man to view this manual
38 page. Override the manual pager path with the LTTNG_MAN_BIN_PATH
39 environment variable.
40
41 --list-options
42 List available command options and quit.
43
45 0
46 Success
47
48 1
49 Command error
50
51 2
52 Undefined command
53
54 3
55 Fatal error
56
57 4
58 Command warning (something went wrong during the command)
59
61 LTTNG_ABORT_ON_ERROR
62 Set to 1 to abort the process after the first error is encountered.
63
64 LTTNG_HOME
65 Path to the LTTng home directory.
66
67 Defaults to $HOME.
68
69 Useful when the Unix user running the commands has a non-writable
70 home directory.
71
72 LTTNG_MAN_BIN_PATH
73 Absolute path to the manual pager to use to read the LTTng
74 command-line help (with lttng-help(1) or with the --help option)
75 instead of /usr/bin/man.
76
77 LTTNG_SESSION_CONFIG_XSD_PATH
78 Path to the directory containing the session.xsd recording session
79 configuration XML schema.
80
81 LTTNG_SESSIOND_PATH
82 Absolute path to the LTTng session daemon binary (see lttng-
83 sessiond(8)) to spawn from the lttng-create(1) command.
84
85 The --sessiond-path general option overrides this environment
86 variable.
87
89 $LTTNG_HOME/.lttngrc
90 Unix user’s LTTng runtime configuration.
91
92 This is where LTTng stores the name of the Unix user’s current
93 recording session between executions of lttng(1). lttng-create(1)
94 and lttng-set-session(1) set the current recording session.
95
96 $LTTNG_HOME/lttng-traces
97 Default output directory of LTTng traces in local and snapshot
98 modes.
99
100 Override this path with the --output option of the lttng-create(1)
101 command.
102
103 $LTTNG_HOME/.lttng
104 Unix user’s LTTng runtime and configuration directory.
105
106 $LTTNG_HOME/.lttng/sessions
107 Default directory containing the Unix user’s saved recording
108 session configurations (see lttng-save(1) and lttng-load(1)).
109
110 /usr/local/etc/lttng/sessions
111 Directory containing the system-wide saved recording session
112 configurations (see lttng-save(1) and lttng-load(1)).
113
114 Note
115 $LTTNG_HOME defaults to the value of the HOME environment variable.
116
118 Example 1. Remove a trigger.
119
120 $ lttng remove-trigger my-trigger
121
122 Example 2. Remove a trigger as another Unix user.
123
124 The command line below removes a trigger as the mireille Unix user.
125
126 Your Unix user must be root to use the --owner-uid option.
127
128 $ lttng remove-trigger --owner-uid=$(id --user mireille) \
129 my-trigger
130
132 • LTTng project website <https://lttng.org>
133
134 • LTTng documentation <https://lttng.org/docs>
135
136 • LTTng bug tracker <https://bugs.lttng.org>
137
138 • Git repositories <https://git.lttng.org>
139
140 • GitHub organization <https://github.com/lttng>
141
142 • Continuous integration <https://ci.lttng.org/>
143
144 • Mailing list <https://lists.lttng.org/> for support and
145 development: lttng-dev@lists.lttng.org
146
147 • IRC channel <irc://irc.oftc.net/lttng>: #lttng on irc.oftc.net
148
150 This program is part of the LTTng-tools project.
151
152 LTTng-tools is distributed under the GNU General Public License
153 version 2 <http://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html>.
154 See the LICENSE <https://github.com/lttng/lttng-
155 tools/blob/master/LICENSE> file for details.
156
158 Special thanks to Michel Dagenais and the DORSAL laboratory
159 <http://www.dorsal.polymtl.ca/> at École Polytechnique de Montréal for
160 the LTTng journey.
161
162 Also thanks to the Ericsson teams working on tracing which helped us
163 greatly with detailed bug reports and unusual test cases.
164
166 lttng(1), lttng-add-trigger(1), lttng-list-triggers(1), lttng-
167 concepts(7)
168
169
170
171LTTng 2.13.7 17 May 2021 LTTNG-REMOVE-TRIGG(1)