X-Git-Url: https://git.lttng.org/?p=lttng-tools.git;a=blobdiff_plain;f=include%2Flttng%2Ftrigger%2Ftrigger.h;h=a0c312ddd1e92e2efdb94c6affcbb942696198ff;hp=b8e6080d9519a7edaaab43ca291c7c45f56e685d;hb=5c504c41e4d470012cb98c849aa82086d1ba1bde;hpb=bacc41cc41d9702241e7a52617fed046ed5f5506 diff --git a/include/lttng/trigger/trigger.h b/include/lttng/trigger/trigger.h index b8e6080d9..a0c312ddd 100644 --- a/include/lttng/trigger/trigger.h +++ b/include/lttng/trigger/trigger.h @@ -9,6 +9,7 @@ #define LTTNG_TRIGGER_H #include +#include struct lttng_action; struct lttng_condition; @@ -35,6 +36,11 @@ enum lttng_trigger_status { LTTNG_TRIGGER_STATUS_PERMISSION_DENIED = -6, }; +enum lttng_trigger_firing_policy { + LTTNG_TRIGGER_FIRING_POLICY_EVERY_N = 0, + LTTNG_TRIGGER_FIRING_POLICY_ONCE_AFTER_N = 1, +}; + /* * Create a trigger object associating a condition and an action. * @@ -127,6 +133,37 @@ extern enum lttng_trigger_status lttng_trigger_get_name( extern enum lttng_trigger_status lttng_trigger_set_name( struct lttng_trigger *trigger, const char *name); +/* + * Set the trigger firing policy. + * + * This is optional. By default a trigger is set to fire each time the + * associated condition occurs. + * + * Threshold is the number of times the condition must be hit before the policy + * is enacted. + * + * Return LTTNG_TRIGGER_STATUS_OK on success, LTTNG_TRIGGER_STATUS_INVALID + * if invalid parameters are passed. + */ +extern enum lttng_trigger_status lttng_trigger_set_firing_policy( + struct lttng_trigger *trigger, + enum lttng_trigger_firing_policy policy_type, + uint64_t threshold); + +/* + * Get the trigger firing policy. + * + * Threshold is the number of time the condition must be hit before the policy is + * enacted. + * + * Return LTTNG_TRIGGER_STATUS_OK on success, LTTNG_TRIGGER_STATUS_INVALID + * if invalid parameters are passed. + */ +extern enum lttng_trigger_status lttng_trigger_get_firing_policy( + const struct lttng_trigger *trigger, + enum lttng_trigger_firing_policy *policy_type, + uint64_t *threshold); + /* * Destroy (frees) a trigger object. */