/* Forward declarations */
struct bt_iter;
-struct ctf_stream_event;
-struct ctf_stream;
struct bt_saved_pos;
struct bt_iter_pos {
* The position returned by this function needs to be freed by
* bt_iter_free_pos after use.
*/
-struct bt_iter_pos *
- bt_iter_get_pos(struct bt_iter *iter);
+struct bt_iter_pos *bt_iter_get_pos(struct bt_iter *iter);
/*
* bt_iter_free_pos - Free the position.
/*
* bt_iter_set_pos: move the iterator to a given position.
*
- * Return EOF if position is after the last event of the trace collection.
- * Return other negative value for other errors.
+ * On error, the stream_heap is reinitialized and returned empty.
+ *
* Return 0 for success.
+ *
+ * Return EOF if the position requested is after the last event of the
+ * trace collection.
+ * Return -EINVAL when called with invalid parameter.
+ * Return -ENOMEM if the stream_heap could not be properly initialized.
*/
-int bt_iter_set_pos(struct bt_iter *iter,
- const struct bt_iter_pos *pos);
+int bt_iter_set_pos(struct bt_iter *iter, const struct bt_iter_pos *pos);
/*
- * bt_iter_read_event: Read the iterator's current event data.
+ * bt_iter_create_time_pos: create a position based on time
*
- * @iter: trace collection iterator (input)
- * @stream: stream containing event at current position (output)
- * @event: current event (output)
- * Return 0 on success, negative error value on error.
+ * This function allocates and returns a new bt_iter_pos (which must be freed
+ * with bt_iter_free_pos) to be able to restore an iterator position based on a
+ * timestamp.
*/
-int bt_iter_read_event(struct bt_iter *iter,
- struct ctf_stream **stream,
- struct ctf_stream_event **event);
+struct bt_iter_pos *bt_iter_create_time_pos(struct bt_iter *iter,
+ uint64_t timestamp);
#endif /* _BABELTRACE_ITERATOR_H */