X-Git-Url: https://git.lttng.org/?p=lttng-tools.git;a=blobdiff_plain;f=include%2Flttng%2Flttng.h;h=9e2d4d129894878631d38452f05bc5ffc25c946a;hp=0a12d9be75e4b97be6728bad11727105f4e68b8c;hb=178191b3899f114001f000c2e7f46909969f9c6f;hpb=38ee087f699718e57d1bc5614c2f79c3c30ccca9 diff --git a/include/lttng/lttng.h b/include/lttng/lttng.h index 0a12d9be7..9e2d4d129 100644 --- a/include/lttng/lttng.h +++ b/include/lttng/lttng.h @@ -511,14 +511,14 @@ extern int lttng_enable_event(struct lttng_handle *handle, /* * Apply a filter expression to an event. * - * If event_name is NULL, the filter is applied to all events of the channel. + * If event is NULL, the filter is applied to all events of the channel. * If channel_name is NULL, a lookup of the event's channel is done. * If both are NULL, the filter is applied to all events of all channels. */ extern int lttng_set_event_filter(struct lttng_handle *handle, - const char *event_name, - const char *channel_name, + struct lttng_event *event, const char *channel_name, const char *filter_expression); + /* * Create or enable a channel. * The channel name cannot be NULL. @@ -594,13 +594,15 @@ extern int lttng_health_check(enum lttng_health_component c); /* * For a given session name, this call checks if the data is ready to be read - * or is still being extracted by the consumer(s) hence not ready to be used by - * any readers. + * or is still being extracted by the consumer(s) (pending) hence not ready to + * be used by any readers. * - * Return 0 if the data is _NOT_ available else 1 if the data is ready. On - * error, a negative value is returned and readable by lttng_strerror(). + * Return 0 if there is _no_ data pending in the buffers thus having a + * guarantee that the data can be read safely. Else, return 1 if there is still + * traced data is pending. On error, a negative value is returned and readable + * by lttng_strerror(). */ -extern int lttng_data_available(const char *session_name); +extern int lttng_data_pending(const char *session_name); #ifdef __cplusplus }