- * The position returned by this function needs to be freed by
- * babeltrace_iter_free_pos after use.
- */
-struct babeltrace_iter_pos *
- babeltrace_iter_get_pos(struct babeltrace_iter *iter);
-
-/*
- * babeltrace_iter_free_pos - Free the position.
- */
-void babeltrace_iter_free_pos(struct babeltrace_iter_pos *pos);
-
-/*
- * babeltrace_iter_seek_pos - Seek the trace collection to the position.
- */
-int babeltrace_iter_seek_pos(struct babeltrace_iter *iter,
- struct babeltrace_iter_pos *pos);
-
-/*
- * babeltrace_iter_seek_time: Seek the trace collection to the given timestamp.
+ * @iter: trace collection iterator (input)
+ * @event: event to target. 0 for all events.
+ * @private_data: private data pointer to pass to the callback
+ * @flags: specific flags controlling the behavior of this callback
+ * (or'd).
+ *
+ * @callback: function pointer to call
+ * @depends: struct bt_dependency detailing the required computation results.
+ * Ends with 0.
+ * @weak_depends: struct bt_dependency detailing the optional computation
+ * results that can be optionally consumed by this
+ * callback.
+ * @provides: struct bt_dependency detailing the computation results
+ * provided by this callback.
+ * Ends with 0.
+ *
+ * "depends", "weak_depends" and "provides" memory is handled by the
+ * babeltrace library after this call succeeds or fails. These objects
+ * can still be used by the caller until the babeltrace iterator is
+ * destroyed, but they belong to the babeltrace library.