[lttng-tools.git] / doc / man / lttng-remove-trigger.1.txt

lttng-remove-trigger(1)
=======================
:revdate: 17 May 2021


NAME
----
lttng-remove-trigger - Remove an LTTng trigger


SYNOPSIS
--------
[verse]
*lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *remove-trigger* [option:--owner-uid='UID'] 'NAME'


DESCRIPTION
-----------
The `lttng remove-trigger` command removes the trigger named 'NAME'.

See man:lttng-concepts(7) to learn more about LTTng triggers.

List the triggers of your Unix user, or of all users if your
Unix user is `root`, with the man:lttng-list-triggers(1) command.

The `remove-trigger` command removes a trigger which belong to your Unix
user. If your Unix user is `root`, you can remove the trigger of another
user with the option:--owner-uid option.

See the ``<<examples,EXAMPLES>>'' section below for usage examples.


OPTIONS
-------
Identification
~~~~~~~~~~~~~~
option:--owner-uid='UID'::
    Remove the trigger named 'NAME' of the Unix user having the user ID
    'UID'.
+
You may only use this option if your Unix user is `root`.


include::common-lttng-cmd-help-options.txt[]


include::common-lttng-cmd-after-options.txt[]


[[examples]]
EXAMPLES
--------
.Remove a trigger.
====
[role="term"]
----
$ lttng remove-trigger my-trigger
----
====

.Remove a trigger as another Unix user.
====
The command line below removes a trigger as the `mireille` Unix user.

Your Unix user must be `root` to use the option:--owner-uid option.

[role="term"]
----
$ lttng remove-trigger --owner-uid=$(id --user mireille) \
                       my-trigger
----
====


include::common-footer.txt[]


SEE ALSO
--------
man:lttng(1),
man:lttng-add-trigger(1),
man:lttng-list-triggers(1),
man:lttng-concepts(7)
Commit	Line	Data
	1	lttng-remove-trigger(1)
	2	=======================
	3	:revdate: 17 May 2021
	4
	5
	6	NAME
	7	----
	8	lttng-remove-trigger - Remove an LTTng trigger
	9
	10
	11	SYNOPSIS
	12	--------
	13	[verse]
	14	lttng ['linkgenoptions:(GENERAL OPTIONS)'] remove-trigger [option:--owner-uid='UID'] 'NAME'
	15
	16
	17	DESCRIPTION
	18	-----------
	19	The `lttng remove-trigger` command removes the trigger named 'NAME'.
	20
	21	See man:lttng-concepts(7) to learn more about LTTng triggers.
	22
	23	List the triggers of your Unix user, or of all users if your
	24	Unix user is `root`, with the man:lttng-list-triggers(1) command.
	25
	26	The `remove-trigger` command removes a trigger which belong to your Unix
	27	user. If your Unix user is `root`, you can remove the trigger of another
	28	user with the option:--owner-uid option.
	29
	30	See the ``<<examples,EXAMPLES>>'' section below for usage examples.
	31
	32
	33	OPTIONS
	34	-------
	35	Identification
	36	~~~~~~~~~~~~~~
	37	option:--owner-uid='UID'::
	38	Remove the trigger named 'NAME' of the Unix user having the user ID
	39	'UID'.
	40	+
	41	You may only use this option if your Unix user is `root`.
	42
	43
	44	include::common-lttng-cmd-help-options.txt[]
	45
	46
	47	include::common-lttng-cmd-after-options.txt[]
	48
	49
	50	[[examples]]
	51	EXAMPLES
	52	--------
	53	.Remove a trigger.
	54	====
	55	[role="term"]
	56	----
	57	$ lttng remove-trigger my-trigger
	58	----
	59	====
	60
	61	.Remove a trigger as another Unix user.
	62	====
	63	The command line below removes a trigger as the `mireille` Unix user.
	64
	65	Your Unix user must be `root` to use the option:--owner-uid option.
	66
	67	[role="term"]
	68	----
	69	$ lttng remove-trigger --owner-uid=$(id --user mireille) \
	70	my-trigger
	71	----
	72	====
	73
	74
	75	include::common-footer.txt[]
	76
	77
	78	SEE ALSO
	79	--------
	80	man:lttng(1),
	81	man:lttng-add-trigger(1),
	82	man:lttng-list-triggers(1),
	83	man:lttng-concepts(7)