Implement source plugin base

[babeltrace.git] / include / babeltrace / plugin / plugin-system.h

diff --git a/include/babeltrace/plugin/plugin-system.h b/include/babeltrace/plugin/plugin-system.h
index 92d81d5a13ebcda6fb5fe9c5985aec897f5bef8f..b8aa4a3b94da63ac4b5ab0889f92adcfedcd9b38 100644 (file)
--- a/include/babeltrace/plugin/plugin-system.h
+++ b/include/babeltrace/plugin/plugin-system.h
@@ -37,15 +37,11 @@ extern "C" {
 #endif
 
 /**
+ * Plug-in private data deallocation function type.
  *
+ * @param plugin       Plug-in instance
  */
-typedef void (*bt_plugin_destroy_cb)(struct bt_plugin *);
-
-/**
- *
- */
-typedef void (*bt_plugin_set_error_stream_cb)(struct bt_plugin *,
-               FILE *error_stream);
+typedef void (*bt_plugin_destroy_cb)(struct bt_plugin *plugin);
 
 /**
  * Get a plug-in's private (implementation) data.
@@ -55,16 +51,8 @@ typedef void (*bt_plugin_set_error_stream_cb)(struct bt_plugin *,
  */
 extern void *bt_plugin_get_private_data(struct bt_plugin *plugin);
 
-/**
- * Set a callback permiting the registration of an error stream.
- *
- * @param plugin       Plug-in to which the callback should be registered
- * @param cb           Error stream registration callback
- */
-extern int bt_plugin_set_error_stream_cb(struct bt_plugin *plugin,
-               bt_plugin_set_error_stream_cb cb);
-
-/* Plug-in initialization functions */
+       
+/** Plug-in initialization functions */
 /**
  * Allocate a source plug-in.
  *
@@ -91,8 +79,10 @@ extern struct bt_plugin *bt_plugin_sink_create(const char *name,
                void *private_data, bt_plugin_destroy_func destroy_func,
                bt_plugin_sink_handle_notification_cb notification_cb);
 
+
+/** Notification iterator functions */
 /**
- * Allocate an notification iterator.
+ * Allocate a notification iterator.
  *
  * @param plugin               Plug-in instance
  * @param next_cb              Callback advancing to the next notification
@@ -104,6 +94,16 @@ extern struct bt_notification_iterator *bt_notification_iterator_create(
                bt_notification_iterator_next_cb next_cb,
                bt_notification_iterator_get_notification_cb notification_cb);
 
+/**
+ * Set an iterator's private data.
+ *
+ * @param plugin               Plug-in instance on which to iterate
+ * @param data                 Iterator private data
+ * @returns                    One of #bt_notification_iterator_status values
+ */
+extern enum bt_notification_iterator_status *bt_notification_iterator_create(
+               struct bt_plugin *plugin, void *data);
+
 #ifdef __cplusplus
 }
 #endif