lttng-remove-trigger(1): add usage examples

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

diff --git a/doc/man/lttng-remove-trigger.1.txt b/doc/man/lttng-remove-trigger.1.txt
index 016b5271ac0139e1bb47899715c4ba5b05f7b3fe..1f5285d2f6b0191447674db3901a8d668b0316cb 100644 (file)
--- 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: 29 April 2021
+:revdate: 17 May 2021
 
 
 NAME
@@ -27,6 +27,8 @@ 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
 -------
@@ -45,6 +47,31 @@ 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[]