X-Git-Url: https://git.lttng.org/?a=blobdiff_plain;f=doc%2Fman%2Flttng-remove-trigger.1.txt;h=6bec8c55519713d4747a2c9fdd3af150734213d2;hb=da39b67ce2828bfc63a02db969048bfe1abd4ca0;hp=a0dfb570953b73a96fe12282a1bfe576f1eb86c7;hpb=484b2a0cbefcf0c7072622a5a411ea5ed849da28;p=lttng-tools.git diff --git a/doc/man/lttng-remove-trigger.1.txt b/doc/man/lttng-remove-trigger.1.txt index a0dfb5709..6bec8c555 100644 --- a/doc/man/lttng-remove-trigger.1.txt +++ b/doc/man/lttng-remove-trigger.1.txt @@ -1,6 +1,6 @@ lttng-remove-trigger(1) ======================= -:revdate: 5 March 2021 +:revdate: 17 May 2021 NAME @@ -11,42 +11,73 @@ lttng-remove-trigger - Remove an LTTng trigger SYNOPSIS -------- [verse] -*lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *remove-trigger* [option:--owner-id='UID'] 'NAME' +*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-add-trigger(1) to learn more about LTTng triggers. +See man:lttng-concepts(7) to learn more about LTTng triggers. -List the available triggers and their name with the -man:lttng-list-triggers(1) command. +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-id option. +user with the option:--owner-uid option. + +See the ``<>'' section below for usage examples. OPTIONS ------- Identification ~~~~~~~~~~~~~~ -option:--owner-id='UID':: +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-cmd-help-options.txt[] +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-cmd-footer.txt[] +include::common-footer.txt[] SEE ALSO -------- +man:lttng(1), man:lttng-add-trigger(1), man:lttng-list-triggers(1), -man:lttng(1) +man:lttng-concepts(7)