X-Git-Url: https://git.lttng.org/?p=lttng-tools.git;a=blobdiff_plain;f=include%2Flttng%2Fsession.h;h=395df32450889d806aa0efd805a7a2cd67f4c219;hp=6c54d7e4f5e55fc5fe4dde03ff8a4812e5411a97;hb=780d4bb8ec9b4fa0ffd6d1ba2a2aa5d2f812611f;hpb=b178f53e90c376dd44b020535c32649edef8f80e diff --git a/include/lttng/session.h b/include/lttng/session.h index 6c54d7e4f..395df3245 100644 --- a/include/lttng/session.h +++ b/include/lttng/session.h @@ -1,5 +1,6 @@ /* * Copyright (C) 2014 - David Goulet + * Copyright (C) 2019 - Jérémie Galarneau * * This library is free software; you can redistribute it and/or modify it * under the terms of the GNU Lesser General Public License, version 2.1 only, @@ -23,6 +24,7 @@ extern "C" { #endif struct lttng_session_descriptor; +struct lttng_destruction_handle; /* * Basic session information. @@ -132,6 +134,21 @@ extern int lttng_create_session_live(const char *name, const char *url, */ extern int lttng_destroy_session(const char *name); +/* + * Destroy a tracing session. + * + * Performs the same function as lttng_destroy_session(), but provides + * an lttng_destruction_handle which can be used to wait for the completion + * of the session's destruction. The lttng_destroy_handle can also be used + * obtain the status and archive location of any implicit session + * rotation that may have occured during the session's destruction. + * + * Returns LTTNG_OK on success. The returned handle is owned by the caller + * and must be free'd using lttng_destruction_handle_destroy(). + */ +extern enum lttng_error_code lttng_destroy_session_ext(const char *session_name, + struct lttng_destruction_handle **handle); + /* * Behaves exactly like lttng_destroy_session but does not wait for data * availability.