X-Git-Url: https://git.lttng.org/?a=blobdiff_plain;f=include%2Flttng%2Fevent-rule%2Ftracepoint.h;h=f6e8d81823a1e49b80bd30a13c5994a5351d4625;hb=cade690d4a2d1c398be9a519295de5b959c3f8bc;hp=e24b0fbe103e986ba7551c094c38d604d606ca6e;hpb=6d420eff669a3de55be3ee348f88a4e244b78ecf;p=lttng-tools.git diff --git a/include/lttng/event-rule/tracepoint.h b/include/lttng/event-rule/tracepoint.h index e24b0fbe1..f6e8d8182 100644 --- a/include/lttng/event-rule/tracepoint.h +++ b/include/lttng/event-rule/tracepoint.h @@ -10,6 +10,7 @@ #include #include +#include #include #ifdef __cplusplus @@ -19,6 +20,8 @@ extern "C" { /* * Create a newly allocated tracepoint event rule. * + * The default pattern is '*'. + * * Returns a new event rule on success, NULL on failure. This event rule must be * destroyed using lttng_event_rule_destroy(). */ @@ -26,18 +29,18 @@ extern struct lttng_event_rule *lttng_event_rule_tracepoint_create( enum lttng_domain_type domain); /* - * Set the pattern of a tracepoint event rule. + * Set the name pattern of a tracepoint event rule. * * Pattern can contain wildcard '*'. See man lttng-enable-event. * * Return LTTNG_EVENT_RULE_STATUS_OK on success, LTTNG_EVENT_RULE_STATUS_INVALID * if invalid parameters are passed. */ -extern enum lttng_event_rule_status lttng_event_rule_tracepoint_set_pattern( +extern enum lttng_event_rule_status lttng_event_rule_tracepoint_set_name_pattern( struct lttng_event_rule *rule, const char *pattern); /* - * Get the pattern of a tracepoint event rule. + * Get the name pattern of a tracepoint event rule. * * The caller does not assume the ownership of the returned pattern. The * pattern shall only only be used for the duration of the event rule's @@ -48,7 +51,7 @@ extern enum lttng_event_rule_status lttng_event_rule_tracepoint_set_pattern( * parameter is passed, or LTTNG_EVENT_RULE_STATUS_UNSET if a pattern * was not set prior to this call. */ -extern enum lttng_event_rule_status lttng_event_rule_tracepoint_get_pattern( +extern enum lttng_event_rule_status lttng_event_rule_tracepoint_get_name_pattern( const struct lttng_event_rule *rule, const char **pattern); /* @@ -90,61 +93,36 @@ extern enum lttng_event_rule_status lttng_event_rule_tracepoint_get_filter( const struct lttng_event_rule *rule, const char **expression); /* - * Set the single log level of a tracepoint event rule. + * Set the log level rule of a tracepoint event rule. * - * Return LTTNG_EVENT_RULE_STATUS_OK on success, LTTNG_EVENT_RULE_STATUS_INVALID - * if invalid parameters are passed. - */ -extern enum lttng_event_rule_status lttng_event_rule_tracepoint_set_log_level( - struct lttng_event_rule *rule, int level); - -/* - * Set the log level range lower bound of a tracepoint event rule. + * The log level rule is copied internally. * * Return LTTNG_EVENT_RULE_STATUS_OK on success, LTTNG_EVENT_RULE_STATUS_INVALID * if invalid parameters are passed. */ extern enum lttng_event_rule_status -lttng_event_rule_tracepoint_set_log_level_range_lower_bound( - struct lttng_event_rule *rule, int level); +lttng_event_rule_tracepoint_set_log_level_rule(struct lttng_event_rule *rule, + const struct lttng_log_level_rule *log_level_rule); /* - * Set the log level to all of a tracepoint event rule. + * Get the log level rule of a tracepoint event rule. * - * Return LTTNG_EVENT_RULE_STATUS_OK on success, LTTNG_EVENT_RULE_STATUS_INVALID - * if invalid parameters are passed. - */ -extern enum lttng_event_rule_status -lttng_event_rule_tracepoint_set_log_level_all(struct lttng_event_rule *rule); - -/* - * Get the log level type of a tracepoint event rule. + * The caller does not assume the ownership of the returned log level rule. The + * log level rule shall only only be used for the duration of the event rule's + * lifetime, or before a different log level rule is set. * - * Returns LTTNG_EVENT_RULE_STATUS_OK and sets the log level type output + * Returns LTTNG_EVENT_RULE_STATUS_OK and sets the log level rule output * parameter on success, LTTNG_EVENT_RULE_STATUS_INVALID if an invalid parameter - * is passed, or LTTNG_EVENT_RULE_STATUS_UNSET if a log level was not set prior + * is passed, or LTTNG_EVENT_RULE_STATUS_UNSET if a log level rule was not set prior * to this call. */ extern enum lttng_event_rule_status -lttng_event_rule_tracepoint_get_log_level_type( +lttng_event_rule_tracepoint_get_log_level_rule( const struct lttng_event_rule *rule, - enum lttng_loglevel_type *type); - -/* - * Get the log level of a tracepoint event rule. - * - * For range log level , the lower bound log level is returned. - * - * Returns LTTNG_EVENT_RULE_STATUS_OK and sets the log level output parameter - * on success, LTTNG_EVENT_RULE_STATUS_INVALID if an invalid parameter is - * passed, or LTTNG_EVENT_RULE_STATUS_UNSET if a log level was not set prior to - * this call. - */ -extern enum lttng_event_rule_status lttng_event_rule_tracepoint_get_log_level( - const struct lttng_event_rule *rule, int *level); + const struct lttng_log_level_rule **log_level_rule); /* - * Add an exclusion to the set of exclusion of an event rule. + * Add a name pattern exclusion to the set of name pattern exclusion of an event rule. * * The passed exclusion will be copied to the event_rule. * @@ -153,30 +131,30 @@ extern enum lttng_event_rule_status lttng_event_rule_tracepoint_get_log_level( * LTTNG_EVENT_RULE_STATUS_UNSUPPORTED if this property is not supported by the * domain. */ -extern enum lttng_event_rule_status lttng_event_rule_tracepoint_add_exclusion( +extern enum lttng_event_rule_status lttng_event_rule_tracepoint_add_name_pattern_exclusion( struct lttng_event_rule *rule, const char *exclusion); /* - * Get the exclusions property count of an event rule. + * Get the name pattern exclusions property count of an event rule. * * Returns LTTNG_EVENT_RULE_STATUS_OK and sets the count output parameter * on success, LTTNG_EVENT_RULE_STATUS_INVALID if an invalid parameter is * passed. */ extern enum lttng_event_rule_status -lttng_event_rule_tracepoint_get_exclusions_count( +lttng_event_rule_tracepoint_get_name_pattern_exclusion_count( const struct lttng_event_rule *rule, unsigned int *count); /* - * Get the event rule exclusion at the given index. + * Get the pattern name exclusion at the given index. * * Returns LTTNG_EVENT_RULE_STATUS_OK and sets the exclusion output parameter * on success, LTTNG_EVENT_RULE_STATUS_INVALID if an invalid parameter is * passed. */ extern enum lttng_event_rule_status -lttng_event_rule_tracepoint_get_exclusion_at_index( +lttng_event_rule_tracepoint_get_name_pattern_exclusion_at_index( const struct lttng_event_rule *rule, unsigned int index, const char **exclusion);