lttng-remove-trigger(1)

1LTTNG-REMOVE-TRIGG(1)            LTTng Manual            LTTNG-REMOVE-TRIGG(1)
2
3
4

NAME

6       lttng-remove-trigger - Remove an LTTng trigger
7

SYNOPSIS

9       lttng [GENERAL OPTIONS] remove-trigger [--owner-uid=UID] NAME
10

DESCRIPTION

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

OPTIONS

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

EXIT STATUS

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

ENVIRONMENT

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

FILES

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

EXAMPLES

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

RESOURCES

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

COPYRIGHT

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

THANKS

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