SYNOPSIS
--------
[verse]
-*lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *add-trigger* [option:--name='NAME'] [option:--owner-id='UID']
+*lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *add-trigger* [option:--name='NAME'] [option:--owner-uid='UID']
option:--condition='CONDTYPE' ['CONDARGS']
option:--action='ACTTYPE' ['ACTARGS'] [option:--action='ACTTYPE' ['ACTARGS']]...
The `add-trigger` command adds a trigger for your Unix user. If your
Unix user is `root`, you can add the trigger as another user with the
-option:--owner-id option.
+option:--owner-uid option.
Specify the condition of the trigger to add with a <<cond-spec,condition
specifier>> and its actions with one or more <<action-spec,action
Common action options (as of LTTng{nbsp}{lttng_version}):
nloption:--rate-policy='POLICY'::
- Set the rate policy of the action to 'POLICY'.
+ Set the rate policy of the action to 'POLICY' instead of
+ `every:1` (always execute).
+
A trigger which ``fires'' (its condition is satisfied) leads to an
execution request for each of its actions, in order. An execution
become an actual execution when{nbsp}__C__ satisfies the rate policy
of{nbsp}__A__.
+
-The default action rate policy is `every:1` (always execute{nbsp}__A__).
-Use this option to specify another rate policy.
-+
'POLICY' is one of:
+
--
In other words, execute{nbsp}__A__ every 'COUNT' execution requests.
--
+
+'COUNT' must be an integer greater than{nbsp}0.
++
As of LTTng{nbsp}{lttng_version}, you can use this option with any
action type, but new action types in the future may not support it.
Set the unique name of the trigger to add to 'NAME' instead of the
`add-trigger` command automatically assigning one.
-option:--owner-id='UID'::
+option:--owner-uid='UID'::
Add the trigger as the Unix user having the user ID 'UID'.
+
You may only use this option if your Unix user is `root`.