Document libbabeltrace2's C API

[babeltrace.git] / src / lib / graph / component.h

diff --git a/src/lib/graph/component.h b/src/lib/graph/component.h
index 285a8e9a74ffe24fb932cd68e7d5c08182aa5951..0925d5f265140321c200c17724e68a87c7b14029 100644 (file)
--- a/src/lib/graph/component.h
+++ b/src/lib/graph/component.h
@@ -25,11 +25,14 @@
  */
 
 #include "common/macros.h"
-#include <babeltrace2/graph/component-const.h>
+#include <babeltrace2/graph/component.h>
+#include <babeltrace2/graph/component-class.h>
 #include "lib/object.h"
 #include <babeltrace2/types.h>
+#include <babeltrace2/logging.h>
 #include "common/assert.h"
 #include <glib.h>
+#include <stdbool.h>
 #include <stdio.h>
 
 #include "component-class.h"
@@ -49,6 +52,7 @@ struct bt_component {
        struct bt_object base;
        struct bt_component_class *class;
        GString *name;
+       bt_logging_level log_level;
 
        /*
         * Internal destroy function specific to a source, filter, or
@@ -72,21 +76,18 @@ struct bt_component {
 static inline
 struct bt_graph *bt_component_borrow_graph(struct bt_component *comp)
 {
-       BT_ASSERT(comp);
+       BT_ASSERT_DBG(comp);
        return (void *) bt_object_borrow_parent(&comp->base);
 }
 
 BT_HIDDEN
 int bt_component_create(struct bt_component_class *component_class,
-               const char *name, struct bt_component **component);
+               const char *name, bt_logging_level log_level,
+               struct bt_component **component);
 
 BT_HIDDEN
-enum bt_self_component_status bt_component_accept_port_connection(
-               struct bt_component *component, struct bt_port *self_port,
-               struct bt_port *other_port);
-
-BT_HIDDEN
-enum bt_self_component_status bt_component_port_connected(
+enum bt_component_class_port_connected_method_status
+bt_component_port_connected(
                struct bt_component *comp,
                struct bt_port *self_port, struct bt_port *other_port);
 
@@ -117,12 +118,12 @@ struct bt_port_output *bt_component_borrow_output_port_by_name(
                struct bt_component *comp, const char *name);
 
 BT_HIDDEN
-enum bt_self_component_status bt_component_add_input_port(
+enum bt_self_component_add_port_status bt_component_add_input_port(
                struct bt_component *component, const char *name,
                void *user_data, struct bt_port **port);
 
 BT_HIDDEN
-enum bt_self_component_status bt_component_add_output_port(
+enum bt_self_component_add_port_status bt_component_add_output_port(
                struct bt_component *component, const char *name,
                void *user_data, struct bt_port **port);
 
@@ -138,26 +139,4 @@ BT_HIDDEN
 void bt_component_remove_destroy_listener(struct bt_component *component,
                bt_component_destroy_listener_func func, void *data);
 
-static inline
-const char *bt_self_component_status_string(
-               enum bt_self_component_status status)
-{
-       switch (status) {
-       case BT_SELF_COMPONENT_STATUS_OK:
-               return "BT_SELF_COMPONENT_STATUS_OK";
-       case BT_SELF_COMPONENT_STATUS_END:
-               return "BT_SELF_COMPONENT_STATUS_END";
-       case BT_SELF_COMPONENT_STATUS_AGAIN:
-               return "BT_SELF_COMPONENT_STATUS_AGAIN";
-       case BT_SELF_COMPONENT_STATUS_REFUSE_PORT_CONNECTION:
-               return "BT_SELF_COMPONENT_STATUS_REFUSE_PORT_CONNECTION";
-       case BT_SELF_COMPONENT_STATUS_ERROR:
-               return "BT_SELF_COMPONENT_STATUS_ERROR";
-       case BT_SELF_COMPONENT_STATUS_NOMEM:
-               return "BT_SELF_COMPONENT_STATUS_NOMEM";
-       default:
-               return "(unknown)";
-       }
-}
-
 #endif /* BABELTRACE_GRAPH_COMPONENT_INTERNAL_H */