X-Git-Url: http://git.efficios.com/?a=blobdiff_plain;f=src%2Fplugins%2Fctf%2Flttng-live%2Flttng-live.h;h=bd5b317d96b8d96116a05ac57c285bb59d5db340;hb=e5d25da238fb586240d2899e14cca46738b1a1a8;hp=0c86a687b50c2855f33178a21d63f4829cbbee25;hpb=8d8b141db4c46135a35be19e4a1c192f6a36d67b;p=babeltrace.git

diff --git a/src/plugins/ctf/lttng-live/lttng-live.h b/src/plugins/ctf/lttng-live/lttng-live.h
index 0c86a687..bd5b317d 100644
--- a/src/plugins/ctf/lttng-live/lttng-live.h
+++ b/src/plugins/ctf/lttng-live/lttng-live.h
@@ -30,13 +30,15 @@
  */
 
 #include <stdbool.h>
+#include <stdint.h>
+
+#include <glib.h>
 
-#include "common/macros.h"
 #include <babeltrace2/babeltrace.h>
 
+#include "common/macros.h"
 #include "../common/metadata/decoder.h"
 #include "../common/msg-iter/msg-iter.h"
-
 #include "viewer-connection.h"
 
 struct lttng_live_component;
@@ -133,8 +135,6 @@ struct lttng_live_metadata {
 	uint64_t stream_id;
 	/* Weak reference. */
 	struct ctf_metadata_decoder *decoder;
-
-	bool closed;
 };
 
 struct lttng_live_trace {
@@ -189,7 +189,6 @@ struct lttng_live_session {
 };
 
 enum session_not_found_action {
-	SESSION_NOT_FOUND_ACTION_UNKNOWN,
 	SESSION_NOT_FOUND_ACTION_CONTINUE,
 	SESSION_NOT_FOUND_ACTION_FAIL,
 	SESSION_NOT_FOUND_ACTION_END,
@@ -260,7 +259,7 @@ enum lttng_live_iterator_status {
 	LTTNG_LIVE_ITERATOR_STATUS_UNSUPPORTED = -4,
 };
 
-bt_component_class_init_method_status lttng_live_component_init(
+bt_component_class_initialize_method_status lttng_live_component_init(
 		bt_self_component_source *self_comp,
 		bt_self_component_source_configuration *config,
 		const bt_value *params, void *init_method_data);
@@ -278,7 +277,7 @@ bt_component_class_message_iterator_next_method_status lttng_live_msg_iter_next(
 		bt_message_array_const msgs, uint64_t capacity,
 		uint64_t *count);
 
-bt_component_class_message_iterator_init_method_status lttng_live_msg_iter_init(
+bt_component_class_message_iterator_initialize_method_status lttng_live_msg_iter_init(
 		bt_self_message_iterator *self_msg_it,
 		bt_self_message_iterator_configuration *config,
 		bt_self_component_source *self_comp,
@@ -287,7 +286,15 @@ bt_component_class_message_iterator_init_method_status lttng_live_msg_iter_init(
 void lttng_live_msg_iter_finalize(bt_self_message_iterator *it);
 
 int lttng_live_create_viewer_session(struct lttng_live_msg_iter *lttng_live_msg_iter);
-int lttng_live_attach_session(struct lttng_live_session *session);
+
+enum lttng_live_attach_session_status {
+	LTTNG_LIVE_ATTACH_SESSION_STATUS_OK	= 0,
+	LTTNG_LIVE_ATTACH_SESSION_STATUS_ERROR	= -2,
+};
+
+enum lttng_live_attach_session_status lttng_live_attach_session(
+		struct lttng_live_session *session);
+
 int lttng_live_detach_session(struct lttng_live_session *session);
 enum lttng_live_iterator_status lttng_live_get_new_streams(
 		struct lttng_live_session *session);
@@ -297,8 +304,30 @@ int lttng_live_add_session(struct lttng_live_msg_iter *lttng_live_msg_iter,
 		const char *hostname,
 		const char *session_name);
 
-ssize_t lttng_live_get_one_metadata_packet(struct lttng_live_trace *trace,
-		FILE *fp);
+enum lttng_live_get_one_metadata_status {
+	/* The end of the metadata stream was reached. */
+	LTTNG_LIVE_GET_ONE_METADATA_STATUS_END	    = 1,
+	/* One metadata packet was received and written to file. */
+	LTTNG_LIVE_GET_ONE_METADATA_STATUS_OK	    = 0,
+	/* The metadata stream was not found on the relay. */
+	LTTNG_LIVE_GET_ONE_METADATA_STATUS_CLOSED   = -1,
+	/*
+	 * A critical error occurred when contacting the relay or while
+	 * handling its response.
+	 */
+	LTTNG_LIVE_GET_ONE_METADATA_STATUS_ERROR    = -2,
+};
+
+/*
+ * lttng_live_get_one_metadata_packet() asks the Relay Daemon for new metadata.
+ * If new metadata is received, the function writes it to the provided file
+ * handle and updates the reply_len output parameter. This function should be
+ * called in loop until _END status is received to ensure all metadata is
+ * written to the file.
+ */
+enum lttng_live_get_one_metadata_status lttng_live_get_one_metadata_packet(
+		struct lttng_live_trace *trace, FILE *fp, size_t *reply_len);
+
 enum lttng_live_iterator_status lttng_live_get_next_index(
 		struct lttng_live_msg_iter *lttng_live_msg_iter,
 		struct lttng_live_stream_iterator *stream,