io: add ability to associate an error with a task

[qemu.git] / include / io / task.h

diff --git a/include/io/task.h b/include/io/task.h
index ece1372781833e3ae8439fbfeb9c862e7c12cd94..47daba961bf14db165356bf4a110dca893c3244e 100644 (file)
--- a/include/io/task.h
+++ b/include/io/task.h
@@ -239,6 +239,38 @@ void qio_task_abort(QIOTask *task,
                     Error *err);
 
 
+/**
+ * qio_task_set_error:
+ * @task: the task struct
+ * @err: pointer to the error, or NULL
+ *
+ * Associate an error with the task, which can later
+ * be retrieved with the qio_task_propagate_error()
+ * method. This method takes ownership of @err, so
+ * it is not valid to access it after this call
+ * completes. If @err is NULL this is a no-op. If
+ * this is call multiple times, only the first
+ * provided @err will be recorded, later ones will
+ * be discarded and freed.
+ */
+void qio_task_set_error(QIOTask *task,
+                        Error *err);
+
+
+/**
+ * qio_task_propagate_error:
+ * @task: the task struct
+ * @errp: pointer to a NULL-initialized error object
+ *
+ * Propagate the error associated with @task
+ * into @errp.
+ *
+ * Returns: true if an error was propagated, false otherwise
+ */
+bool qio_task_propagate_error(QIOTask *task,
+                              Error **errp);
+
+
 /**
  * qio_task_set_result_pointer:
  * @task: the task struct