- * Event rule conditions allows an action to be taken whenever an event matching
- * the event rule is hit by the tracers.
+ * On event conditions allows an action to be taken whenever an event matching
+ * the on event is hit by the tracers.
* This is done via the capture descriptor.
*
* Note: the dynamic runtime capture of payload is only available for the
* This is done via the capture descriptor.
*
* Note: the dynamic runtime capture of payload is only available for the
*
* Returns a new condition on success, NULL on failure. This condition must be
* destroyed using lttng_condition_destroy().
*/
*
* Returns a new condition on success, NULL on failure. This condition must be
* destroyed using lttng_condition_destroy().
*/
*
* The caller does not assume the ownership of the returned rule. The
* rule shall only be used for the duration of the condition's
*
* The caller does not assume the ownership of the returned rule. The
* rule shall only be used for the duration of the condition's
* Returns LTTNG_CONDITION_STATUS_OK and a pointer to the condition's rule
* on success, LTTNG_CONDITION_STATUS_INVALID if an invalid
* parameter is passed. */
* Returns LTTNG_CONDITION_STATUS_OK and a pointer to the condition's rule
* on success, LTTNG_CONDITION_STATUS_INVALID if an invalid
* parameter is passed. */
-extern enum lttng_condition_status lttng_condition_event_rule_get_rule(
- const struct lttng_condition *condition,
+extern enum lttng_condition_status lttng_condition_on_event_get_rule(
+ const struct lttng_condition *condition,
* allow users to query a number of properties resulting from the evaluation
* of a condition which evaluated to true.
*
* allow users to query a number of properties resulting from the evaluation
* of a condition which evaluated to true.
*
* TEMPORARY - The name of the triggers associated with the condition.
* TODO - The captured event payload if any
*/
/*
* TEMPORARY - The name of the triggers associated with the condition.
* TODO - The captured event payload if any
*/
/*
*
* Returns LTTNG_EVALUATION_STATUS_OK on success and a trigger name
* or LTTNG_EVALUATION_STATUS_INVALID if
* an invalid parameter is passed.
*/
extern enum lttng_evaluation_status
*
* Returns LTTNG_EVALUATION_STATUS_OK on success and a trigger name
* or LTTNG_EVALUATION_STATUS_INVALID if
* an invalid parameter is passed.
*/
extern enum lttng_evaluation_status
* `LTTNG_EVALUATION_STATUS_INVALID`:
* * `evaluation` is `NULL`.
* * The type of the condition of `evaluation` is not
* `LTTNG_EVALUATION_STATUS_INVALID`:
* * `evaluation` is `NULL`.
* * The type of the condition of `evaluation` is not
* * The condition of `evaluation` has no capture descriptors.
* * `field_val` is `NULL`.
*/
extern enum lttng_evaluation_status
* * The condition of `evaluation` has no capture descriptors.
* * `field_val` is `NULL`.
*/
extern enum lttng_evaluation_status
const struct lttng_evaluation *evaluation,
const struct lttng_event_field_value **field_val);
/*
* Appends (transfering the ownership) the capture descriptor `expr` to
const struct lttng_evaluation *evaluation,
const struct lttng_event_field_value **field_val);
/*
* Appends (transfering the ownership) the capture descriptor `expr` to
* `LTTNG_CONDITION_STATUS_INVALID`:
* * `condition` is `NULL`.
* * The type of `condition` is not
* `LTTNG_CONDITION_STATUS_INVALID`:
* * `condition` is `NULL`.
* * The type of `condition` is not
struct lttng_condition *condition,
struct lttng_event_expr *expr);
/*
struct lttng_condition *condition,
struct lttng_event_expr *expr);
/*
* `LTTNG_CONDITION_STATUS_INVALID`:
* * `condition` is `NULL`.
* * The type of `condition` is not
* `LTTNG_CONDITION_STATUS_INVALID`:
* * `condition` is `NULL`.
* * The type of `condition` is not
* `condition` at the index `index`, or `NULL` if:
*
* * `condition` is `NULL`.
* * The type of `condition` is not
* `condition` at the index `index`, or `NULL` if:
*
* * `condition` is `NULL`.
* * The type of `condition` is not
* * `index` is greater than or equal to the number of capture
* descriptors in `condition` (as returned by
* * `index` is greater than or equal to the number of capture
* descriptors in `condition` (as returned by