[verse]
*lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *add-trigger* [--id ID]
- [--fire-every N] [--fire-once-after N]
--condition CONDITION-NAME CONDITION-ARGS
--action ACTION-NAME ACTION-ARGS
[--action ACTION-NAME ACTION-ARGS]...
have to be active for the conditions to be met, and triggers are
independent from tracing sessions.
-By default, a trigger fires every time its condition is met. The
-'--fire-every' and '--fire-once-after' options can be used to change
-this mode.
-
The syntax by which conditions and actions are specified is described
below.
The available conditions are:
-Event rule: `on-event [event rule arguments]`::
+Event rule: `event-rule-matches [event rule arguments]`::
This type of condition is met when the tracer encounters an event
- matching the given even rule. The arguments describing the event
+ matching the given event rule. The arguments describing the event
rule are the same as those describing the event rules of the
man:lttng-enable-event(1) command, with these exceptions:
~~~~~~~~~~~~~~~~~~
A capture expression can be specified with the option:--capture option when
-creating a new on-event condition. If the capture expression corresponds with an
-event's field when tracing, the runtime dynamic value corresponding to the
-capture expression is captured.
+creating a new event-rule-matches condition. If the capture expression
+corresponds with an event's field when tracing, the runtime dynamic value
+corresponding to the capture expression is captured.
NOTE: Make sure to **single-quote** the capture expression when running
the command from a shell, as capture expressions typically include