X-Git-Url: http://git.efficios.com/?a=blobdiff_plain;f=include%2Flttng%2Flttng.h;h=0a12d9be75e4b97be6728bad11727105f4e68b8c;hb=38ee087f699718e57d1bc5614c2f79c3c30ccca9;hp=dd5d936c5faaed64910f4220e04025b691606028;hpb=03b1319df1a6c74a152d4723bf1bf9e1cdf770e1;p=lttng-tools.git diff --git a/include/lttng/lttng.h b/include/lttng/lttng.h index dd5d936c5..0a12d9be7 100644 --- a/include/lttng/lttng.h +++ b/include/lttng/lttng.h @@ -29,6 +29,10 @@ /* Error codes that can be returned by API calls */ #include +#ifdef __cplusplus +extern "C" { +#endif + /* * Event symbol length. Copied from LTTng kernel ABI. */ @@ -257,6 +261,7 @@ struct lttng_event_field { enum lttng_event_field_type type; char padding[LTTNG_EVENT_FIELD_PADDING]; struct lttng_event event; + int nowrite; }; /* @@ -467,9 +472,20 @@ extern int lttng_start_tracing(const char *session_name); /* * Stop tracing for *all* registered traces (kernel and user-space). + * + * This call will wait for data availability for each domain of the session so + * this can take an abritrary amount of time. However, when returning you have + * the guarantee that the data is ready to be read and analyse. Use the + * _no_wait call below to avoid this behavior. */ extern int lttng_stop_tracing(const char *session_name); +/* + * Behave exactly like lttng_stop_tracing but does not wait for data + * availability. + */ +extern int lttng_stop_tracing_no_wait(const char *session_name); + /* * Add context to event(s) for a specific channel (or for all). * @@ -576,4 +592,18 @@ extern int lttng_disable_consumer(struct lttng_handle *handle); */ 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. + * + * 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(). + */ +extern int lttng_data_available(const char *session_name); + +#ifdef __cplusplus +} +#endif + #endif /* LTTNG_H */