Add trimmer plug-in skeleton

[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 e471a0dd0c382293dd27605954e98b6117e66ba1..1ec7a08c40f269a513e2950408d5f1db086b9c46 100644 (file)
--- a/include/babeltrace/plugin/plugin-system.h
+++ b/include/babeltrace/plugin/plugin-system.h
@@ -266,6 +266,17 @@ typedef struct bt_notification *(*bt_notification_iterator_get_cb)(
 typedef enum bt_notification_iterator_status (*bt_notification_iterator_next_cb)(
                struct bt_notification_iterator *iterator);
 
+/**
+ * Function advancing an iterator's position to a given time (relative to Epoch).
+ *
+ * @param iterator     Notification iterator instance
+ * @param time         Time at which to seek, expressed in ns since Epoch
+ * @returns            One of #bt_notification_iterator_status values
+ */
+typedef enum bt_notification_iterator_status
+               (*bt_notification_iterator_seek_time_cb)(
+               struct bt_notification_iterator *iterator, int64_t time);
+
 /**
  * Function cleaning-up an iterator's private data on destruction.
  *
@@ -296,6 +307,18 @@ extern enum bt_notification_iterator_status
 bt_notification_iterator_set_next_cb(struct bt_notification_iterator *iterator,
                bt_notification_iterator_next_cb next);
 
+/**
+ * Set an iterator's "seek_time" callback which sets the iterator's position to
+ *     provided time (in ns since Epoch).
+ *
+ * @param iterator     Notification iterator instance
+ * @param seek_timetime        Iterator "seek_time" callback
+ * @returns            One of #bt_notification_iterator_status values
+ */
+extern enum bt_notification_iterator_status
+bt_notification_iterator_set_seek_time_cb(struct bt_notification_iterator *iterator,
+               bt_notification_iterator_seek_time_cb seek_time);
+
 /**
  * Set an iterator's "destroy" callback.
  *