From: Philippe Proulx Date: Fri, 23 Apr 2021 21:12:12 +0000 (-0400) Subject: lttng-add-trigger(1): clarify the `--rate-policy` documentation X-Git-Tag: v2.13.0-rc1~5 X-Git-Url: https://git.lttng.org./?a=commitdiff_plain;h=72d8cc1003406d40814ae998214813ecdf75825a;p=lttng-tools.git lttng-add-trigger(1): clarify the `--rate-policy` documentation Signed-off-by: Philippe Proulx Signed-off-by: Jérémie Galarneau Change-Id: I6144521f3186e33c52d7ac20b64cf3e8f7663a55 --- diff --git a/doc/man/lttng-add-trigger.1.txt b/doc/man/lttng-add-trigger.1.txt index e183b8c3b..e29ddf7c3 100644 --- a/doc/man/lttng-add-trigger.1.txt +++ b/doc/man/lttng-add-trigger.1.txt @@ -248,7 +248,8 @@ See below for the nloption:--rate-policy option. 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 @@ -257,9 +258,6 @@ request count{nbsp}__C__ of{nbsp}__A__. An execution request can then 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: + -- @@ -275,6 +273,8 @@ requests. 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.