lib: bt_object_{get,put}_ref(): accept a `const` parameter
[babeltrace.git] / include / babeltrace / plugin / plugin-internal.h
index 8249d1004db10c68cf7a268d7882c3f69baf344d..7ca57ba9a34a6e0446952e36302e174862c20a53 100644 (file)
@@ -2,8 +2,6 @@
 #define BABELTRACE_PLUGIN_PLUGIN_INTERNAL_H
 
 /*
- * BabelTrace - Plug-in Internal
- *
  * Copyright 2015 Jérémie Galarneau <jeremie.galarneau@efficios.com>
  *
  * Author: Jérémie Galarneau <jeremie.galarneau@efficios.com>
  */
 
 #include <babeltrace/babeltrace-internal.h>
+#include <babeltrace/graph/component-class-internal.h>
+#include <babeltrace/plugin/plugin.h>
 #include <babeltrace/plugin/plugin-dev.h>
+#include <babeltrace/plugin/plugin-so-internal.h>
 #include <babeltrace/object-internal.h>
+#include <babeltrace/object.h>
 #include <babeltrace/types.h>
+#include <babeltrace/assert-internal.h>
 #include <glib.h>
 
 enum bt_plugin_type {
@@ -41,10 +44,11 @@ enum bt_plugin_type {
 struct bt_plugin {
        struct bt_object base;
        enum bt_plugin_type type;
-       bt_bool frozen;
 
-       /* Array of pointers to bt_component_class (owned by this) */
-       GPtrArray *comp_classes;
+       /* Arrays of `struct bt_component_class *` (owned by this) */
+       GPtrArray *src_comp_classes;
+       GPtrArray *flt_comp_classes;
+       GPtrArray *sink_comp_classes;
 
        /* Info (owned by this) */
        struct {
@@ -59,12 +63,12 @@ struct bt_plugin {
                        unsigned int patch;
                        GString *extra;
                } version;
-               bt_bool path_set;
-               bt_bool name_set;
-               bt_bool author_set;
-               bt_bool license_set;
-               bt_bool description_set;
-               bt_bool version_set;
+               bool path_set;
+               bool name_set;
+               bool author_set;
+               bool license_set;
+               bool description_set;
+               bool version_set;
        } info;
 
        /* Value depends on the specific plugin type */
@@ -79,44 +83,93 @@ struct bt_plugin_set {
        GPtrArray *plugins;
 };
 
+static inline
+const char *bt_plugin_status_string(enum bt_plugin_status status)
+{
+       switch (status) {
+       case BT_PLUGIN_STATUS_OK:
+               return "BT_PLUGIN_STATUS_OK";
+       case BT_PLUGIN_STATUS_ERROR:
+               return "BT_PLUGIN_STATUS_ERROR";
+       case BT_PLUGIN_STATUS_NOMEM:
+               return "BT_PLUGIN_STATUS_NOMEM";
+       default:
+               return "(unknown)";
+       }
+}
+
+static inline
+const char *bt_plugin_type_string(enum bt_plugin_type type)
+{
+       switch (type) {
+       case BT_PLUGIN_TYPE_SO:
+               return "BT_PLUGIN_TYPE_SO";
+       case BT_PLUGIN_TYPE_PYTHON:
+               return "BT_PLUGIN_TYPE_PYTHON";
+       default:
+               return "(unknown)";
+       }
+}
+
 static inline
 void bt_plugin_destroy(struct bt_object *obj)
 {
        struct bt_plugin *plugin;
 
-       assert(obj);
+       BT_ASSERT(obj);
        plugin = container_of(obj, struct bt_plugin, base);
+       BT_LIB_LOGD("Destroying plugin object: %!+l", plugin);
 
        if (plugin->destroy_spec_data) {
                plugin->destroy_spec_data(plugin);
        }
 
-       if (plugin->comp_classes) {
-               g_ptr_array_free(plugin->comp_classes, TRUE);
+       if (plugin->src_comp_classes) {
+               BT_LOGD_STR("Putting source component classes.");
+               g_ptr_array_free(plugin->src_comp_classes, TRUE);
+               plugin->src_comp_classes = NULL;
+       }
+
+       if (plugin->flt_comp_classes) {
+               BT_LOGD_STR("Putting filter component classes.");
+               g_ptr_array_free(plugin->flt_comp_classes, TRUE);
+               plugin->flt_comp_classes = NULL;
+       }
+
+       if (plugin->sink_comp_classes) {
+               BT_LOGD_STR("Putting sink component classes.");
+               g_ptr_array_free(plugin->sink_comp_classes, TRUE);
+               plugin->sink_comp_classes = NULL;
        }
 
        if (plugin->info.name) {
                g_string_free(plugin->info.name, TRUE);
+               plugin->info.name = NULL;
        }
 
        if (plugin->info.path) {
                g_string_free(plugin->info.path, TRUE);
+               plugin->info.path = NULL;
        }
 
        if (plugin->info.description) {
                g_string_free(plugin->info.description, TRUE);
+               plugin->info.description = NULL;
        }
 
        if (plugin->info.author) {
                g_string_free(plugin->info.author, TRUE);
+               plugin->info.author = NULL;
        }
 
        if (plugin->info.license) {
                g_string_free(plugin->info.license, TRUE);
+               plugin->info.license = NULL;
        }
 
        if (plugin->info.version.extra) {
                g_string_free(plugin->info.version.extra, TRUE);
+               plugin->info.version.extra = NULL;
        }
 
        g_free(plugin);
@@ -127,56 +180,85 @@ struct bt_plugin *bt_plugin_create_empty(enum bt_plugin_type type)
 {
        struct bt_plugin *plugin = NULL;
 
+       BT_LOGD("Creating empty plugin object: type=%s",
+               bt_plugin_type_string(type));
+
        plugin = g_new0(struct bt_plugin, 1);
        if (!plugin) {
+               BT_LOGE_STR("Failed to allocate one plugin.");
                goto error;
        }
 
-       bt_object_init(plugin, bt_plugin_destroy);
+       bt_object_init_shared(&plugin->base, bt_plugin_destroy);
        plugin->type = type;
 
-       /* Create empty array of component classes */
-       plugin->comp_classes =
-               g_ptr_array_new_with_free_func((GDestroyNotify) bt_put);
-       if (!plugin->comp_classes) {
+       /* Create empty arrays of component classes */
+       plugin->src_comp_classes =
+               g_ptr_array_new_with_free_func(
+                       (GDestroyNotify) bt_object_put_ref);
+       if (!plugin->src_comp_classes) {
+               BT_LOGE_STR("Failed to allocate a GPtrArray.");
+               goto error;
+       }
+
+       plugin->flt_comp_classes =
+               g_ptr_array_new_with_free_func(
+                       (GDestroyNotify) bt_object_put_ref);
+       if (!plugin->flt_comp_classes) {
+               BT_LOGE_STR("Failed to allocate a GPtrArray.");
+               goto error;
+       }
+
+       plugin->sink_comp_classes =
+               g_ptr_array_new_with_free_func(
+                       (GDestroyNotify) bt_object_put_ref);
+       if (!plugin->sink_comp_classes) {
+               BT_LOGE_STR("Failed to allocate a GPtrArray.");
                goto error;
        }
 
        /* Create empty info */
        plugin->info.name = g_string_new(NULL);
        if (!plugin->info.name) {
+               BT_LOGE_STR("Failed to allocate a GString.");
                goto error;
        }
 
        plugin->info.path = g_string_new(NULL);
        if (!plugin->info.path) {
+               BT_LOGE_STR("Failed to allocate a GString.");
                goto error;
        }
 
        plugin->info.description = g_string_new(NULL);
        if (!plugin->info.description) {
+               BT_LOGE_STR("Failed to allocate a GString.");
                goto error;
        }
 
        plugin->info.author = g_string_new(NULL);
        if (!plugin->info.author) {
+               BT_LOGE_STR("Failed to allocate a GString.");
                goto error;
        }
 
        plugin->info.license = g_string_new(NULL);
        if (!plugin->info.license) {
+               BT_LOGE_STR("Failed to allocate a GString.");
                goto error;
        }
 
        plugin->info.version.extra = g_string_new(NULL);
        if (!plugin->info.version.extra) {
+               BT_LOGE_STR("Failed to allocate a GString.");
                goto error;
        }
 
+       BT_LIB_LOGD("Created empty plugin object: %!+l", plugin);
        goto end;
 
 error:
-       BT_PUT(plugin);
+       BT_OBJECT_PUT_REF_AND_RESET(plugin);
 
 end:
        return plugin;
@@ -185,54 +267,63 @@ end:
 static inline
 void bt_plugin_set_path(struct bt_plugin *plugin, const char *path)
 {
-       assert(plugin);
-       assert(path);
+       BT_ASSERT(plugin);
+       BT_ASSERT(path);
        g_string_assign(plugin->info.path, path);
        plugin->info.path_set = BT_TRUE;
+       BT_LIB_LOGV("Set plugin's path: %![plugin-]+l, path=\"%s\"",
+               plugin, path);
 }
 
 static inline
 void bt_plugin_set_name(struct bt_plugin *plugin, const char *name)
 {
-       assert(plugin);
-       assert(name);
+       BT_ASSERT(plugin);
+       BT_ASSERT(name);
        g_string_assign(plugin->info.name, name);
        plugin->info.name_set = BT_TRUE;
+       BT_LIB_LOGV("Set plugin's name: %![plugin-]+l, name=\"%s\"",
+               plugin, name);
 }
 
 static inline
 void bt_plugin_set_description(struct bt_plugin *plugin,
                const char *description)
 {
-       assert(plugin);
-       assert(description);
+       BT_ASSERT(plugin);
+       BT_ASSERT(description);
        g_string_assign(plugin->info.description, description);
        plugin->info.description_set = BT_TRUE;
+       BT_LIB_LOGV("Set plugin's description: %![plugin-]+l", plugin);
 }
 
 static inline
 void bt_plugin_set_author(struct bt_plugin *plugin, const char *author)
 {
-       assert(plugin);
-       assert(author);
+       BT_ASSERT(plugin);
+       BT_ASSERT(author);
        g_string_assign(plugin->info.author, author);
        plugin->info.author_set = BT_TRUE;
+       BT_LIB_LOGV("Set plugin's author: %![plugin-]+l, author=\"%s\"",
+               plugin, author);
 }
 
 static inline
 void bt_plugin_set_license(struct bt_plugin *plugin, const char *license)
 {
-       assert(plugin);
-       assert(license);
+       BT_ASSERT(plugin);
+       BT_ASSERT(license);
        g_string_assign(plugin->info.license, license);
        plugin->info.license_set = BT_TRUE;
+       BT_LIB_LOGV("Set plugin's path: %![plugin-]+l, license=\"%s\"",
+               plugin, license);
 }
 
 static inline
 void bt_plugin_set_version(struct bt_plugin *plugin, unsigned int major,
                unsigned int minor, unsigned int patch, const char *extra)
 {
-       assert(plugin);
+       BT_ASSERT(plugin);
        plugin->info.version.major = major;
        plugin->info.version.minor = minor;
        plugin->info.version.patch = patch;
@@ -242,13 +333,46 @@ void bt_plugin_set_version(struct bt_plugin *plugin, unsigned int major,
        }
 
        plugin->info.version_set = BT_TRUE;
+       BT_LIB_LOGV("Set plugin's version: %![plugin-]+l, "
+               "major=%u, minor=%u, patch=%u, extra=\"%s\"",
+               plugin, major, minor, patch, extra);
 }
 
 static inline
-void bt_plugin_freeze(struct bt_plugin *plugin)
+enum bt_plugin_status bt_plugin_add_component_class(
+       struct bt_plugin *plugin, struct bt_component_class *comp_class)
 {
-       assert(plugin);
-       plugin->frozen = BT_TRUE;
+       GPtrArray *comp_classes;
+
+       BT_ASSERT(plugin);
+       BT_ASSERT(comp_class);
+
+       switch (comp_class->type) {
+       case BT_COMPONENT_CLASS_TYPE_SOURCE:
+               comp_classes = plugin->src_comp_classes;
+               break;
+       case BT_COMPONENT_CLASS_TYPE_FILTER:
+               comp_classes = plugin->flt_comp_classes;
+               break;
+       case BT_COMPONENT_CLASS_TYPE_SINK:
+               comp_classes = plugin->sink_comp_classes;
+               break;
+       default:
+               abort();
+       }
+
+       /* Add new component class */
+       bt_object_get_ref(comp_class);
+       g_ptr_array_add(comp_classes, comp_class);
+
+       /* Special case for a shared object plugin */
+       if (plugin->type == BT_PLUGIN_TYPE_SO) {
+               bt_plugin_so_on_add_component_class(plugin, comp_class);
+       }
+
+       BT_LIB_LOGD("Added component class to plugin: "
+               "%![plugin-]+l, %![cc-]+C", plugin, comp_class);
+       return BT_PLUGIN_STATUS_OK;
 }
 
 static
@@ -261,7 +385,10 @@ void bt_plugin_set_destroy(struct bt_object *obj)
                return;
        }
 
+       BT_LOGD("Destroying plugin set: addr=%p", plugin_set);
+
        if (plugin_set->plugins) {
+               BT_LOGD_STR("Putting plugins.");
                g_ptr_array_free(plugin_set->plugins, TRUE);
        }
 
@@ -277,15 +404,19 @@ struct bt_plugin_set *bt_plugin_set_create(void)
                goto end;
        }
 
-       bt_object_init(plugin_set, bt_plugin_set_destroy);
+       BT_LOGD_STR("Creating empty plugin set.");
+       bt_object_init_shared(&plugin_set->base, bt_plugin_set_destroy);
 
        plugin_set->plugins = g_ptr_array_new_with_free_func(
-               (GDestroyNotify) bt_put);
+               (GDestroyNotify) bt_object_put_ref);
        if (!plugin_set->plugins) {
-               BT_PUT(plugin_set);
+               BT_LOGE_STR("Failed to allocate a GPtrArray.");
+               BT_OBJECT_PUT_REF_AND_RESET(plugin_set);
                goto end;
        }
 
+       BT_LOGD("Created empty plugin set: addr=%p", plugin_set);
+
 end:
        return plugin_set;
 }
@@ -294,24 +425,13 @@ static inline
 void bt_plugin_set_add_plugin(struct bt_plugin_set *plugin_set,
                struct bt_plugin *plugin)
 {
-       assert(plugin_set);
-       assert(plugin);
-       g_ptr_array_add(plugin_set->plugins, bt_get(plugin));
-}
-
-static inline
-const char *bt_plugin_status_string(enum bt_plugin_status status)
-{
-       switch (status) {
-       case BT_PLUGIN_STATUS_OK:
-               return "BT_PLUGIN_STATUS_OK";
-       case BT_PLUGIN_STATUS_ERROR:
-               return "BT_PLUGIN_STATUS_ERROR";
-       case BT_PLUGIN_STATUS_NOMEM:
-               return "BT_PLUGIN_STATUS_NOMEM";
-       default:
-               return "(unknown)";
-       }
+       BT_ASSERT(plugin_set);
+       BT_ASSERT(plugin);
+       bt_object_get_ref(plugin);
+       g_ptr_array_add(plugin_set->plugins, plugin);
+       BT_LIB_LOGV("Added plugin to plugin set: "
+               "plugin-set-addr=%p, %![plugin-]+l",
+               plugin_set, plugin);
 }
 
 #endif /* BABELTRACE_PLUGIN_PLUGIN_INTERNAL_H */
This page took 0.029682 seconds and 4 git commands to generate.