Add a seperate sqfs_block_processor_sync function

This function waits for all pending blocks to be written to disk, but
doesn't flush the fragment block, so processing can continue afterwards
as if nothing happened.

Signed-off-by: David Oberhollenzer <david.oberhollenzer@sigma-star.at>

1 files changed, 17 insertions, 0 deletions

diff --git a/include/sqfs/block_processor.h b/include/sqfs/block_processor.h
index cef4459..6945633 100644
--- a/include/sqfs/block_processor.h
+++ b/include/sqfs/block_processor.h
@@ -198,11 +198,28 @@ SQFS_API int sqfs_block_processor_append(sqfs_block_processor_t *proc,
 SQFS_API int sqfs_block_processor_end_file(sqfs_block_processor_t *proc);
 
 /**
+ * @brief Wait for the in-flight data blocks to finish.
+ *
+ * @memberof sqfs_block_processor_t
+ *
+ * @param proc A pointer to a block processor object.
+ *
+ * @return Zero on success, an @ref E_SQFS_ERROR value on failure. The failure
+ *         return value can either be an error encountered during enqueueing,
+ *         processing or writing to disk.
+ */
+SQFS_API int sqfs_block_processor_sync(sqfs_block_processor_t *proc);
+
+/**
  * @brief Wait for the in-flight data blocks to finish and finally flush the
  *        current fragment block.
  *
  * @memberof sqfs_block_processor_t
  *
+ * This does essentially the same as @ref sqfs_block_processor_sync, but after
+ * syncing, it also flushes the current fragment block, even if it isn't full
+ * yet and waits for it to be completed as well.
+ *
  * @param proc A pointer to a block processor object.
  *
  * @return Zero on success, an @ref E_SQFS_ERROR value on failure. The failure