X-Git-Url: http://git.efficios.com/?a=blobdiff_plain;f=include%2Fbabeltrace%2Fplugin%2Fplugin.h;h=0e0bc8da54068df2fba76327ed2826e3a2b8b8f2;hb=a8ff38ef4b08728cd1bb93ae66a888dfbda4fbb2;hp=a8aada4eb3eadf8884437154bd0ee116e192db7c;hpb=b5c2631a3e78fbd0f7c1548cdf9618ac73012c22;p=babeltrace.git

diff --git a/include/babeltrace/plugin/plugin.h b/include/babeltrace/plugin/plugin.h
index a8aada4e..0e0bc8da 100644
--- a/include/babeltrace/plugin/plugin.h
+++ b/include/babeltrace/plugin/plugin.h
@@ -1,10 +1,11 @@
-#ifndef BABELTRACE_PLUGIN_H
-#define BABELTRACE_PLUGIN_H
+#ifndef BABELTRACE_PLUGIN_PLUGIN_H
+#define BABELTRACE_PLUGIN_PLUGIN_H
 
 /*
- * BabelTrace - Plug-in
+ * BabelTrace - Babeltrace Plug-in Interface
  *
- * Copyright 2015 Jérémie Galarneau <jeremie.galarneau@efficios.com>
+ * Copyright 2016 Jérémie Galarneau <jeremie.galarneau@efficios.com>
+ * Copyright 2017 Philippe Proulx <pproulx@efficios.com>
  *
  * Author: Jérémie Galarneau <jeremie.galarneau@efficios.com>
  *
@@ -27,52 +28,106 @@
  * SOFTWARE.
  */
 
-#include <stdint.h>
+#include <stddef.h>
+#include <stdbool.h>
+#include <babeltrace/graph/component-class.h>
 
 #ifdef __cplusplus
 extern "C" {
 #endif
 
 struct bt_plugin;
-struct bt_notification;
-
-enum bt_plugin_type {
-	BT_PLUGIN_TYPE_UNKNOWN = -1,
-	/* A source plug-in is a notification generator. */
-	BT_PLUGIN_TYPE_SOURCE = 0,
-	/* A sink plug-in handles incoming notifications. */
-	BT_PLUGIN_TYPE_SINK = 1,
-	/* A filter plug-in implements both SOURCE and SINK interfaces. */
-	BT_PLUGIN_TYPE_FILTER = 2,
+struct bt_plugin_set;
+struct bt_component_class;
+
+/**
+ * Status code. Errors are always negative.
+ */
+enum bt_plugin_status {
+	/** No error, okay. */
+	BT_PLUGIN_STATUS_OK =		0,
+	/** General error. */
+	BT_PLUGIN_STATUS_ERROR =	-1,
+	/** Memory allocation failure. */
+	BT_PLUGIN_STATUS_NOMEM =	-4,
 };
 
-typedef void (*bt_plugin_destroy_func)(struct bt_plugin *);
+extern struct bt_plugin *bt_plugin_find(const char *plugin_name);
+
+extern struct bt_component_class *bt_plugin_find_component_class(
+		const char *plugin_name, const char *component_class_name,
+		enum bt_component_class_type component_class_type);
+
+extern struct bt_plugin_set *bt_plugin_create_all_from_file(const char *path);
+
+extern struct bt_plugin_set *bt_plugin_create_all_from_dir(const char *path,
+		bool recurse);
+
+extern struct bt_plugin_set *bt_plugin_create_all_from_static(void);
+
+/**
+ * Get the name of a plug-in.
+ *
+ * @param plugin	An instance of a plug-in
+ * @returns		Plug-in name or NULL on error
+ */
+extern const char *bt_plugin_get_name(struct bt_plugin *plugin);
+
+/**
+ * Get the name of a plug-in's author.
+ *
+ * @param plugin	An instance of a plug-in
+ * @returns		Plug-in author or NULL on error
+ */
+extern const char *bt_plugin_get_author(struct bt_plugin *plugin);
+
+/**
+ * Get the license of a plug-in.
+ *
+ * @param plugin	An instance of a plug-in
+ * @returns		Plug-in license or NULL on error
+ */
+extern const char *bt_plugin_get_license(struct bt_plugin *plugin);
 
 /**
- * Plug-in discovery functions.
+ * Get the decription of a plug-in.
  *
- * The Babeltrace plug-in architecture mandates that a given plug-in shared
- * object only define one plug-in. These functions are used to query a about
- * shared object about its attributes.
+ * @param plugin	An instance of a plug-in
+ * @returns		Plug-in description or NULL if none is available
+ */
+extern const char *bt_plugin_get_description(struct bt_plugin *plugin);
+
+/**
+ * Get the path of a plug-in.
  *
- * The functions marked as mandatory MUST be exported by the shared object
- * to be considered a valid plug-in.
+ * @param plugin	An instance of a plug-in
+ * @returns		Plug-in path or NULL on error
  */
-/* Plug-in discovery functions... find a better name */
-enum bt_plugin_type bt_plugin_lib_get_type(void);
-const char *bt_plugin_lib_get_format_name(void);
+extern const char *bt_plugin_get_path(struct bt_plugin *plugin);
+
+extern enum bt_plugin_status bt_plugin_get_version(struct bt_plugin *plugin,
+		unsigned int *major, unsigned int *minor, unsigned int *patch,
+		const char **extra);
+
+extern int bt_plugin_get_component_class_count(struct bt_plugin *plugin);
+
+extern struct bt_component_class *bt_plugin_get_component_class(
+		struct bt_plugin *plugin, size_t index);
+
+extern
+struct bt_component_class *bt_plugin_get_component_class_by_name_and_type(
+		struct bt_plugin *plugin, const char *name,
+		enum bt_component_class_type type);
 
-/* TODO: document mandatory fields and their expected types */
-struct bt_plugin *bt_plugin_create(struct bt_ctf_field *params);
-void *bt_plugin_get_user_data(struct bt_plugin *plugin);
-int bt_plugin_set_error_stream(struct bt_plugin *plugin, FILE *error_stream);
+extern
+int bt_plugin_set_get_plugin_count(struct bt_plugin_set *plugin_set);
 
-/* Refcounting */
-void bt_plugin_get(struct bt_plugin *plugin);
-void bt_plugin_put(struct bt_plugin *plugin);
+extern
+struct bt_plugin *bt_plugin_set_get_plugin(struct bt_plugin_set *plugin_set,
+		unsigned int index);
 
 #ifdef __cplusplus
 }
 #endif
 
-#endif /* BABELTRACE_PLUGIN_H */
+#endif /* BABELTRACE_PLUGIN_PLUGIN_H */