| 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) |