Rename: bt_put(), bt_get() -> bt_object_put_ref(), bt_object_get_ref()
[babeltrace.git] / include / babeltrace / plugin / plugin-internal.h
index 93c9c525e98544ffa0bf84ad6ba43568f834bd78..b9579ff8b73eed1b52e1b5322c04baf2981c7b44 100644 (file)
@@ -1,8 +1,8 @@
-#ifndef BABELTRACE_PLUGIN_INTERNAL_H
-#define BABELTRACE_PLUGIN_INTERNAL_H
+#ifndef BABELTRACE_PLUGIN_PLUGIN_INTERNAL_H
+#define BABELTRACE_PLUGIN_PLUGIN_INTERNAL_H
 
 /*
- * BabelTrace - Plug-in internal
+ * BabelTrace - Plug-in Internal
  *
  * Copyright 2015 Jérémie Galarneau <jeremie.galarneau@efficios.com>
  *
  */
 
 #include <babeltrace/babeltrace-internal.h>
+#include <babeltrace/plugin/plugin.h>
+#include <babeltrace/plugin/plugin-dev.h>
+#include <babeltrace/object-internal.h>
+#include <babeltrace/types.h>
+#include <babeltrace/assert-internal.h>
 #include <glib.h>
 
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-struct bt_notification;
+enum bt_plugin_type {
+       BT_PLUGIN_TYPE_SO = 0,
+       BT_PLUGIN_TYPE_PYTHON = 1,
+};
 
 struct bt_plugin {
-       GString *name;
+       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;
 
-       /* Plug-in specific callbacks */
-       bt_plugin_destroy_cb destroy;
-       bt_plugin_set_error_stream_cb set_error_stream;
+       /* Info (owned by this) */
+       struct {
+               GString *path;
+               GString *name;
+               GString *author;
+               GString *license;
+               GString *description;
+               struct {
+                       unsigned int major;
+                       unsigned int minor;
+                       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;
+       } info;
+
+       /* Value depends on the specific plugin type */
+       void *spec_data;
+       void (*destroy_spec_data)(struct bt_plugin *);
 };
 
-#ifdef __cplusplus
+struct bt_plugin_set {
+       struct bt_object base;
+
+       /* Array of struct bt_plugin * */
+       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;
+
+       BT_ASSERT(obj);
+       plugin = container_of(obj, struct bt_plugin, base);
+       BT_LOGD("Destroying plugin object: addr=%p, name=\"%s\"",
+               plugin, plugin->info.name ? plugin->info.name->str : NULL);
+
+       if (plugin->destroy_spec_data) {
+               plugin->destroy_spec_data(plugin);
+       }
+
+       if (plugin->comp_classes) {
+               BT_LOGD_STR("Putting component classes.");
+               g_ptr_array_free(plugin->comp_classes, TRUE);
+       }
+
+       if (plugin->info.name) {
+               g_string_free(plugin->info.name, TRUE);
+       }
+
+       if (plugin->info.path) {
+               g_string_free(plugin->info.path, TRUE);
+       }
+
+       if (plugin->info.description) {
+               g_string_free(plugin->info.description, TRUE);
+       }
+
+       if (plugin->info.author) {
+               g_string_free(plugin->info.author, TRUE);
+       }
+
+       if (plugin->info.license) {
+               g_string_free(plugin->info.license, TRUE);
+       }
+
+       if (plugin->info.version.extra) {
+               g_string_free(plugin->info.version.extra, TRUE);
+       }
+
+       g_free(plugin);
+}
+
+static inline
+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_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_object_put_ref);
+       if (!plugin->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_LOGD("Created empty plugin object: type=%s, addr=%p",
+               bt_plugin_type_string(type), plugin);
+       goto end;
+
+error:
+       BT_OBJECT_PUT_REF_AND_RESET(plugin);
+
+end:
+       return plugin;
+}
+
+static inline
+void bt_plugin_set_path(struct bt_plugin *plugin, const char *path)
+{
+       BT_ASSERT(plugin);
+       BT_ASSERT(path);
+       g_string_assign(plugin->info.path, path);
+       plugin->info.path_set = BT_TRUE;
+       BT_LOGV("Set plugin's path: addr=%p, name=\"%s\", path=\"%s\"",
+               plugin, bt_plugin_get_name(plugin), path);
+}
+
+static inline
+void bt_plugin_set_name(struct bt_plugin *plugin, const char *name)
+{
+       BT_ASSERT(plugin);
+       BT_ASSERT(name);
+       g_string_assign(plugin->info.name, name);
+       plugin->info.name_set = BT_TRUE;
+       BT_LOGV("Set plugin's name: addr=%p, name=\"%s\"",
+               plugin, name);
+}
+
+static inline
+void bt_plugin_set_description(struct bt_plugin *plugin,
+               const char *description)
+{
+       BT_ASSERT(plugin);
+       BT_ASSERT(description);
+       g_string_assign(plugin->info.description, description);
+       plugin->info.description_set = BT_TRUE;
+       BT_LOGV("Set plugin's description: addr=%p, name=\"%s\"",
+               plugin, bt_plugin_get_name(plugin));
+}
+
+static inline
+void bt_plugin_set_author(struct bt_plugin *plugin, const char *author)
+{
+       BT_ASSERT(plugin);
+       BT_ASSERT(author);
+       g_string_assign(plugin->info.author, author);
+       plugin->info.author_set = BT_TRUE;
+       BT_LOGV("Set plugin's author: addr=%p, name=\"%s\", author=\"%s\"",
+               plugin, bt_plugin_get_name(plugin), author);
+}
+
+static inline
+void bt_plugin_set_license(struct bt_plugin *plugin, const char *license)
+{
+       BT_ASSERT(plugin);
+       BT_ASSERT(license);
+       g_string_assign(plugin->info.license, license);
+       plugin->info.license_set = BT_TRUE;
+       BT_LOGV("Set plugin's path: addr=%p, name=\"%s\", license=\"%s\"",
+               plugin, bt_plugin_get_name(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)
+{
+       BT_ASSERT(plugin);
+       plugin->info.version.major = major;
+       plugin->info.version.minor = minor;
+       plugin->info.version.patch = patch;
+
+       if (extra) {
+               g_string_assign(plugin->info.version.extra, extra);
+       }
+
+       plugin->info.version_set = BT_TRUE;
+       BT_LOGV("Set plugin's version: addr=%p, name=\"%s\", "
+               "major=%u, minor=%u, patch=%u, extra=\"%s\"",
+               plugin, bt_plugin_get_name(plugin),
+               major, minor, patch, extra);
+}
+
+static inline
+void bt_plugin_freeze(struct bt_plugin *plugin)
+{
+       BT_ASSERT(plugin);
+
+       if (plugin->frozen) {
+               return;
+       }
+
+       BT_LOGD("Freezing plugin: addr=%p, name=\"%s\", path=\"%s\"",
+               plugin, bt_plugin_get_name(plugin),
+               bt_plugin_get_path(plugin));
+       plugin->frozen = BT_TRUE;
+}
+
+static
+void bt_plugin_set_destroy(struct bt_object *obj)
+{
+       struct bt_plugin_set *plugin_set =
+               container_of(obj, struct bt_plugin_set, base);
+
+       if (!plugin_set) {
+               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);
+       }
+
+       g_free(plugin_set);
+}
+
+static inline
+struct bt_plugin_set *bt_plugin_set_create(void)
+{
+       struct bt_plugin_set *plugin_set = g_new0(struct bt_plugin_set, 1);
+
+       if (!plugin_set) {
+               goto end;
+       }
+
+       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_object_put_ref);
+       if (!plugin_set->plugins) {
+               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;
+}
+
+static inline
+void bt_plugin_set_add_plugin(struct bt_plugin_set *plugin_set,
+               struct bt_plugin *plugin)
+{
+       BT_ASSERT(plugin_set);
+       BT_ASSERT(plugin);
+       g_ptr_array_add(plugin_set->plugins, bt_object_get_ref(plugin));
+       BT_LOGV("Added plugin to plugin set: "
+               "plugin-set-addr=%p, plugin-addr=%p, plugin-name=\"%s\", "
+               "plugin-path=\"%s\"",
+               plugin_set, plugin, bt_plugin_get_name(plugin),
+               bt_plugin_get_path(plugin));
 }
-#endif
 
-#endif /* BABELTRACE_PLUGIN_INTERNAL_H */
+#endif /* BABELTRACE_PLUGIN_PLUGIN_INTERNAL_H */
This page took 0.026157 seconds and 4 git commands to generate.