[PATCH 0/2] block: commit/stream: Allow users to request only format driver names in backing file format

[PATCH 0/2] block: commit/stream: Allow users to request only format driver names in backing file format

[Peter Krempa]

Please see patches for rationale.

Libvirt patches using this new flag will be posted soon-ish (after
cleanup).

Peter Krempa (2):
  block: commit: Allow users to request only format driver names in
    backing file format
  block: stream: Allow users to request only format driver names in
    backing file format

 block.c                                | 37 +++++++++++++++++++++-----
 block/commit.c                         |  6 ++++-
 block/monitor/block-hmp-cmds.c         |  2 +-
 block/stream.c                         | 10 ++++++-
 blockdev.c                             | 13 +++++++++
 include/block/block-global-state.h     |  3 ++-
 include/block/block_int-common.h       |  4 ++-
 include/block/block_int-global-state.h |  6 +++++
 qapi/block-core.json                   | 22 +++++++++++++--
 tests/unit/test-bdrv-drain.c           |  3 ++-
 10 files changed, 91 insertions(+), 15 deletions(-)

-- 
2.43.0

[PATCH 1/2] block: commit: Allow users to request only format driver names in backing file format

[Peter Krempa]

Introduce a new flag 'backing_file_format_no_protocol' for the
block-commit QMP command which instructs the internals to use 'raw'
instead of the protocol driver in case when a image is used without a
dummy 'raw' wrapper.

The flag is designed such that it can be always asserted by management
tools even when there isn't any update to backing files.

The flag will be used by libvirt so that the backing images still
reference the proper format even when libvirt will stop using the dummy
raw driver (raw driver with no other config). Libvirt needs this so that
the images stay compatible with older libvirt versions which didn't
expect that a protocol driver name can appear in the backing file format
field.

Signed-off-by: Peter Krempa <pkrempa@redhat.com>
---
 block.c                                | 37 +++++++++++++++++++++-----
 block/commit.c                         |  6 ++++-
 blockdev.c                             |  6 +++++
 include/block/block-global-state.h     |  3 ++-
 include/block/block_int-common.h       |  4 ++-
 include/block/block_int-global-state.h |  3 +++
 qapi/block-core.json                   | 11 +++++++-
 tests/unit/test-bdrv-drain.c           |  3 ++-
 8 files changed, 61 insertions(+), 12 deletions(-)

diff --git a/block.c b/block.c
index bfb0861ec6..986a529941 100644
--- a/block.c
+++ b/block.c
@@ -1309,11 +1309,14 @@ static void bdrv_backing_detach(BdrvChild *c)
 }

 static int bdrv_backing_update_filename(BdrvChild *c, BlockDriverState *base,
-                                        const char *filename, Error **errp)
+                                        const char *filename,
+                                        bool backing_file_format_no_protocol,
+                                        Error **errp)
 {
     BlockDriverState *parent = c->opaque;
     bool read_only = bdrv_is_read_only(parent);
     int ret;
+    const char *format_name;
     GLOBAL_STATE_CODE();

     if (read_only) {
@@ -1323,9 +1326,23 @@ static int bdrv_backing_update_filename(BdrvChild *c, BlockDriverState *base,
         }
     }

-    ret = bdrv_change_backing_file(parent, filename,
-                                   base->drv ? base->drv->format_name : "",
-                                   false);
+    if (base->drv) {
+        /*
+         * If the new base image doesn't have a format driver layer, which we
+         * detect by the fact that @base is a protocol driver, we record
+         * 'raw' as the format instead of putting the protocol name as the
+         * backing format
+         */
+        if (backing_file_format_no_protocol && base->drv->protocol_name) {
+            format_name = "raw";
+        } else {
+            format_name = base->drv->format_name;
+        }
+    } else {
+        format_name = "";
+    }
+
+    ret = bdrv_change_backing_file(parent, filename, format_name, false);
     if (ret < 0) {
         error_setg_errno(errp, -ret, "Could not update backing file link");
     }
@@ -1479,10 +1496,14 @@ static void GRAPH_WRLOCK bdrv_child_cb_detach(BdrvChild *child)
 }

 static int bdrv_child_cb_update_filename(BdrvChild *c, BlockDriverState *base,
-                                         const char *filename, Error **errp)
+                                         const char *filename,
+                                         bool backing_file_format_no_protocol,
+                                         Error **errp)
 {
     if (c->role & BDRV_CHILD_COW) {
-        return bdrv_backing_update_filename(c, base, filename, errp);
+        return bdrv_backing_update_filename(c, base, filename,
+                                            backing_file_format_no_protocol,
+                                            errp);
     }
     return 0;
 }
@@ -5961,7 +5982,8 @@ void bdrv_unfreeze_backing_chain(BlockDriverState *bs, BlockDriverState *base)
  *
  */
 int bdrv_drop_intermediate(BlockDriverState *top, BlockDriverState *base,
-                           const char *backing_file_str)
+                           const char *backing_file_str,
+                           bool backing_file_format_no_protocol)
 {
     BlockDriverState *explicit_top = top;
     bool update_inherits_from;
@@ -6027,6 +6049,7 @@ int bdrv_drop_intermediate(BlockDriverState *top, BlockDriverState *base,

         if (c->klass->update_filename) {
             ret = c->klass->update_filename(c, base, backing_file_str,
+                                            backing_file_format_no_protocol,
                                             &local_err);
             if (ret < 0) {
                 /*
diff --git a/block/commit.c b/block/commit.c
index 69cc75be0c..5a584b712e 100644
--- a/block/commit.c
+++ b/block/commit.c
@@ -42,6 +42,7 @@ typedef struct CommitBlockJob {
     bool base_read_only;
     bool chain_frozen;
     char *backing_file_str;
+    bool backing_file_format_no_protocol;
 } CommitBlockJob;

 static int commit_prepare(Job *job)
@@ -61,7 +62,8 @@ static int commit_prepare(Job *job)
     /* FIXME: bdrv_drop_intermediate treats total failures and partial failures
      * identically. Further work is needed to disambiguate these cases. */
     return bdrv_drop_intermediate(s->commit_top_bs, s->base_bs,
-                                  s->backing_file_str);
+                                  s->backing_file_str,
+                                  s->backing_file_format_no_protocol);
 }

 static void commit_abort(Job *job)
@@ -254,6 +256,7 @@ void commit_start(const char *job_id, BlockDriverState *bs,
                   BlockDriverState *base, BlockDriverState *top,
                   int creation_flags, int64_t speed,
                   BlockdevOnError on_error, const char *backing_file_str,
+                  bool backing_file_format_no_protocol,
                   const char *filter_node_name, Error **errp)
 {
     CommitBlockJob *s;
@@ -408,6 +411,7 @@ void commit_start(const char *job_id, BlockDriverState *bs,
     blk_set_disable_request_queuing(s->top, true);

     s->backing_file_str = g_strdup(backing_file_str);
+    s->backing_file_format_no_protocol = backing_file_format_no_protocol;
     s->on_error = on_error;

     trace_commit_start(bs, base, top, s);
diff --git a/blockdev.c b/blockdev.c
index 4c1177e8db..038031bb03 100644
--- a/blockdev.c
+++ b/blockdev.c
@@ -2555,6 +2555,8 @@ void qmp_block_commit(const char *job_id, const char *device,
                       const char *top_node,
                       const char *top,
                       const char *backing_file,
+                      bool has_backing_file_format_no_protocol,
+                      bool backing_file_format_no_protocol,
                       bool has_speed, int64_t speed,
                       bool has_on_error, BlockdevOnError on_error,
                       const char *filter_node_name,
@@ -2585,6 +2587,9 @@ void qmp_block_commit(const char *job_id, const char *device,
     if (has_auto_dismiss && !auto_dismiss) {
         job_flags |= JOB_MANUAL_DISMISS;
     }
+    if (!has_backing_file_format_no_protocol) {
+        backing_file_format_no_protocol = false;
+    }

     /* Important Note:
      *  libvirt relies on the DeviceNotFound error class in order to probe for
@@ -2727,6 +2732,7 @@ void qmp_block_commit(const char *job_id, const char *device,
         }
         commit_start(job_id, bs, base_bs, top_bs, job_flags,
                      speed, on_error, backing_file,
+                     backing_file_format_no_protocol,
                      filter_node_name, &local_err);
     }
     if (local_err != NULL) {
diff --git a/include/block/block-global-state.h b/include/block/block-global-state.h
index 6b21fbc73f..b7aec4cd30 100644
--- a/include/block/block-global-state.h
+++ b/include/block/block-global-state.h
@@ -145,7 +145,8 @@ int GRAPH_RDLOCK bdrv_make_empty(BdrvChild *c, Error **errp);

 void bdrv_register(BlockDriver *bdrv);
 int bdrv_drop_intermediate(BlockDriverState *top, BlockDriverState *base,
-                           const char *backing_file_str);
+                           const char *backing_file_str,
+                           bool backing_file_format_no_protocol);

 BlockDriverState * GRAPH_RDLOCK
 bdrv_find_overlay(BlockDriverState *active, BlockDriverState *bs);
diff --git a/include/block/block_int-common.h b/include/block/block_int-common.h
index 4e31d161c5..e08204dec6 100644
--- a/include/block/block_int-common.h
+++ b/include/block/block_int-common.h
@@ -985,7 +985,9 @@ struct BdrvChildClass {
      * can update its reference.
      */
     int (*update_filename)(BdrvChild *child, BlockDriverState *new_base,
-                           const char *filename, Error **errp);
+                           const char *filename,
+                           bool backing_file_format_no_protocol,
+                           Error **errp);

     bool (*change_aio_ctx)(BdrvChild *child, AioContext *ctx,
                            GHashTable *visited, Transaction *tran,
diff --git a/include/block/block_int-global-state.h b/include/block/block_int-global-state.h
index ef31c58bb3..4f253ff362 100644
--- a/include/block/block_int-global-state.h
+++ b/include/block/block_int-global-state.h
@@ -82,6 +82,8 @@ void stream_start(const char *job_id, BlockDriverState *bs,
  * @speed: The maximum speed, in bytes per second, or 0 for unlimited.
  * @on_error: The action to take upon error.
  * @backing_file_str: String to use as the backing file in @top's overlay
+ * @backing_file_format_no_protocol: Use format name instead of potental
+ *                                   protocol name as backing image format
  * @filter_node_name: The node name that should be assigned to the filter
  * driver that the commit job inserts into the graph above @top. NULL means
  * that a node name should be autogenerated.
@@ -92,6 +94,7 @@ void commit_start(const char *job_id, BlockDriverState *bs,
                   BlockDriverState *base, BlockDriverState *top,
                   int creation_flags, int64_t speed,
                   BlockdevOnError on_error, const char *backing_file_str,
+                  bool backing_file_format_no_protocol,
                   const char *filter_node_name, Error **errp);
 /**
  * commit_active_start:
diff --git a/qapi/block-core.json b/qapi/block-core.json
index ca390c5700..367e896905 100644
--- a/qapi/block-core.json
+++ b/qapi/block-core.json
@@ -1810,6 +1810,14 @@
 #     Care should be taken when specifying the string, to specify a
 #     valid filename or protocol.  (Since 2.1)
 #
+# @backing-file-format-no-protocol: If true always use a 'format' driver name
+#     for the 'backing file format' field if updating the image header of the
+#     overlay of 'top'. Otherwise the real name of the driver of the backing
+#     image may be used which may be a protocol driver.
+#
+#     Can be used also when no image header will be updated.
+#     (default: false; since: 8.2)
+#
 # @speed: the maximum speed, in bytes per second
 #
 # @on-error: the action to take on an error.  'ignore' means that the
@@ -1856,7 +1864,8 @@
             '*base': { 'type': 'str', 'features': [ 'deprecated' ] },
             '*top-node': 'str',
             '*top': { 'type': 'str', 'features': [ 'deprecated' ] },
-            '*backing-file': 'str', '*speed': 'int',
+            '*backing-file': 'str', '*backing-file-format-no-protocol': 'bool',
+            '*speed': 'int',
             '*on-error': 'BlockdevOnError',
             '*filter-node-name': 'str',
             '*auto-finalize': 'bool', '*auto-dismiss': 'bool' },
diff --git a/tests/unit/test-bdrv-drain.c b/tests/unit/test-bdrv-drain.c
index 704d1a3f36..422f0c7cd8 100644
--- a/tests/unit/test-bdrv-drain.c
+++ b/tests/unit/test-bdrv-drain.c
@@ -1638,6 +1638,7 @@ static const BlockJobDriver test_simple_job_driver = {
 static int drop_intermediate_poll_update_filename(BdrvChild *child,
                                                   BlockDriverState *new_base,
                                                   const char *filename,
+                                                  bool backing_file_format_no_protocol,
                                                   Error **errp)
 {
     /*
@@ -1749,7 +1750,7 @@ static void test_drop_intermediate_poll(void)
     job->should_complete = true;

     g_assert(!job_has_completed);
-    ret = bdrv_drop_intermediate(chain[1], chain[0], NULL);
+    ret = bdrv_drop_intermediate(chain[1], chain[0], NULL, false);
     aio_poll(qemu_get_aio_context(), false);
     g_assert(ret == 0);
     g_assert(job_has_completed);
-- 
2.43.0

Re: [PATCH 1/2] block: commit: Allow users to request only format driver names in backing file format

[Vladimir Sementsov-Ogievskiy]

On 24.11.23 17:52, Peter Krempa wrote:
> Introduce a new flag 'backing_file_format_no_protocol' for the
> block-commit QMP command which instructs the internals to use 'raw'
> instead of the protocol driver in case when a image is used without a
> dummy 'raw' wrapper.
> 
> The flag is designed such that it can be always asserted by management
> tools even when there isn't any update to backing files.
> 
> The flag will be used by libvirt so that the backing images still
> reference the proper format even when libvirt will stop using the dummy
> raw driver (raw driver with no other config). Libvirt needs this so that
> the images stay compatible with older libvirt versions which didn't
> expect that a protocol driver name can appear in the backing file format
> field.
> 
> Signed-off-by: Peter Krempa <pkrempa@redhat.com>
> ---
>   block.c                                | 37 +++++++++++++++++++++-----
>   block/commit.c                         |  6 ++++-
>   blockdev.c                             |  6 +++++
>   include/block/block-global-state.h     |  3 ++-
>   include/block/block_int-common.h       |  4 ++-
>   include/block/block_int-global-state.h |  3 +++
>   qapi/block-core.json                   | 11 +++++++-
>   tests/unit/test-bdrv-drain.c           |  3 ++-
>   8 files changed, 61 insertions(+), 12 deletions(-)
> 
> diff --git a/block.c b/block.c
> index bfb0861ec6..986a529941 100644
> --- a/block.c
> +++ b/block.c
> @@ -1309,11 +1309,14 @@ static void bdrv_backing_detach(BdrvChild *c)
>   }
> 
>   static int bdrv_backing_update_filename(BdrvChild *c, BlockDriverState *base,
> -                                        const char *filename, Error **errp)
> +                                        const char *filename,
> +                                        bool backing_file_format_no_protocol,
> +                                        Error **errp)
>   {
>       BlockDriverState *parent = c->opaque;
>       bool read_only = bdrv_is_read_only(parent);
>       int ret;
> +    const char *format_name;
>       GLOBAL_STATE_CODE();
> 
>       if (read_only) {
> @@ -1323,9 +1326,23 @@ static int bdrv_backing_update_filename(BdrvChild *c, BlockDriverState *base,
>           }
>       }
> 
> -    ret = bdrv_change_backing_file(parent, filename,
> -                                   base->drv ? base->drv->format_name : "",
> -                                   false);
> +    if (base->drv) {
> +        /*
> +         * If the new base image doesn't have a format driver layer, which we
> +         * detect by the fact that @base is a protocol driver, we record
> +         * 'raw' as the format instead of putting the protocol name as the
> +         * backing format
> +         */
> +        if (backing_file_format_no_protocol && base->drv->protocol_name) {
> +            format_name = "raw";
> +        } else {
> +            format_name = base->drv->format_name;
> +        }
> +    } else {
> +        format_name = "";
> +    }
> +
> +    ret = bdrv_change_backing_file(parent, filename, format_name, false);
>       if (ret < 0) {
>           error_setg_errno(errp, -ret, "Could not update backing file link");
>       }
> @@ -1479,10 +1496,14 @@ static void GRAPH_WRLOCK bdrv_child_cb_detach(BdrvChild *child)
>   }
> 
>   static int bdrv_child_cb_update_filename(BdrvChild *c, BlockDriverState *base,
> -                                         const char *filename, Error **errp)
> +                                         const char *filename,
> +                                         bool backing_file_format_no_protocol,
> +                                         Error **errp)
>   {
>       if (c->role & BDRV_CHILD_COW) {
> -        return bdrv_backing_update_filename(c, base, filename, errp);
> +        return bdrv_backing_update_filename(c, base, filename,
> +                                            backing_file_format_no_protocol,
> +                                            errp);
>       }
>       return 0;
>   }
> @@ -5961,7 +5982,8 @@ void bdrv_unfreeze_backing_chain(BlockDriverState *bs, BlockDriverState *base)
>    *
>    */
>   int bdrv_drop_intermediate(BlockDriverState *top, BlockDriverState *base,
> -                           const char *backing_file_str)
> +                           const char *backing_file_str,
> +                           bool backing_file_format_no_protocol)
>   {
>       BlockDriverState *explicit_top = top;
>       bool update_inherits_from;
> @@ -6027,6 +6049,7 @@ int bdrv_drop_intermediate(BlockDriverState *top, BlockDriverState *base,
> 
>           if (c->klass->update_filename) {
>               ret = c->klass->update_filename(c, base, backing_file_str,
> +                                            backing_file_format_no_protocol,
>                                               &local_err);
>               if (ret < 0) {
>                   /*
> diff --git a/block/commit.c b/block/commit.c
> index 69cc75be0c..5a584b712e 100644
> --- a/block/commit.c
> +++ b/block/commit.c
> @@ -42,6 +42,7 @@ typedef struct CommitBlockJob {
>       bool base_read_only;
>       bool chain_frozen;
>       char *backing_file_str;
> +    bool backing_file_format_no_protocol;
>   } CommitBlockJob;
> 
>   static int commit_prepare(Job *job)
> @@ -61,7 +62,8 @@ static int commit_prepare(Job *job)
>       /* FIXME: bdrv_drop_intermediate treats total failures and partial failures
>        * identically. Further work is needed to disambiguate these cases. */
>       return bdrv_drop_intermediate(s->commit_top_bs, s->base_bs,
> -                                  s->backing_file_str);
> +                                  s->backing_file_str,
> +                                  s->backing_file_format_no_protocol);
>   }
> 
>   static void commit_abort(Job *job)
> @@ -254,6 +256,7 @@ void commit_start(const char *job_id, BlockDriverState *bs,
>                     BlockDriverState *base, BlockDriverState *top,
>                     int creation_flags, int64_t speed,
>                     BlockdevOnError on_error, const char *backing_file_str,
> +                  bool backing_file_format_no_protocol,
>                     const char *filter_node_name, Error **errp)
>   {
>       CommitBlockJob *s;
> @@ -408,6 +411,7 @@ void commit_start(const char *job_id, BlockDriverState *bs,
>       blk_set_disable_request_queuing(s->top, true);
> 
>       s->backing_file_str = g_strdup(backing_file_str);
> +    s->backing_file_format_no_protocol = backing_file_format_no_protocol;
>       s->on_error = on_error;
> 
>       trace_commit_start(bs, base, top, s);
> diff --git a/blockdev.c b/blockdev.c
> index 4c1177e8db..038031bb03 100644
> --- a/blockdev.c
> +++ b/blockdev.c
> @@ -2555,6 +2555,8 @@ void qmp_block_commit(const char *job_id, const char *device,
>                         const char *top_node,
>                         const char *top,
>                         const char *backing_file,
> +                      bool has_backing_file_format_no_protocol,
> +                      bool backing_file_format_no_protocol,
>                         bool has_speed, int64_t speed,
>                         bool has_on_error, BlockdevOnError on_error,
>                         const char *filter_node_name,
> @@ -2585,6 +2587,9 @@ void qmp_block_commit(const char *job_id, const char *device,
>       if (has_auto_dismiss && !auto_dismiss) {
>           job_flags |= JOB_MANUAL_DISMISS;
>       }
> +    if (!has_backing_file_format_no_protocol) {
> +        backing_file_format_no_protocol = false;
> +    }
> 
>       /* Important Note:
>        *  libvirt relies on the DeviceNotFound error class in order to probe for
> @@ -2727,6 +2732,7 @@ void qmp_block_commit(const char *job_id, const char *device,
>           }
>           commit_start(job_id, bs, base_bs, top_bs, job_flags,
>                        speed, on_error, backing_file,
> +                     backing_file_format_no_protocol,
>                        filter_node_name, &local_err);
>       }
>       if (local_err != NULL) {
> diff --git a/include/block/block-global-state.h b/include/block/block-global-state.h
> index 6b21fbc73f..b7aec4cd30 100644
> --- a/include/block/block-global-state.h
> +++ b/include/block/block-global-state.h
> @@ -145,7 +145,8 @@ int GRAPH_RDLOCK bdrv_make_empty(BdrvChild *c, Error **errp);
> 
>   void bdrv_register(BlockDriver *bdrv);
>   int bdrv_drop_intermediate(BlockDriverState *top, BlockDriverState *base,
> -                           const char *backing_file_str);
> +                           const char *backing_file_str,
> +                           bool backing_file_format_no_protocol);
> 
>   BlockDriverState * GRAPH_RDLOCK
>   bdrv_find_overlay(BlockDriverState *active, BlockDriverState *bs);
> diff --git a/include/block/block_int-common.h b/include/block/block_int-common.h
> index 4e31d161c5..e08204dec6 100644
> --- a/include/block/block_int-common.h
> +++ b/include/block/block_int-common.h
> @@ -985,7 +985,9 @@ struct BdrvChildClass {
>        * can update its reference.
>        */
>       int (*update_filename)(BdrvChild *child, BlockDriverState *new_base,
> -                           const char *filename, Error **errp);
> +                           const char *filename,
> +                           bool backing_file_format_no_protocol,
> +                           Error **errp);
> 
>       bool (*change_aio_ctx)(BdrvChild *child, AioContext *ctx,
>                              GHashTable *visited, Transaction *tran,
> diff --git a/include/block/block_int-global-state.h b/include/block/block_int-global-state.h
> index ef31c58bb3..4f253ff362 100644
> --- a/include/block/block_int-global-state.h
> +++ b/include/block/block_int-global-state.h
> @@ -82,6 +82,8 @@ void stream_start(const char *job_id, BlockDriverState *bs,
>    * @speed: The maximum speed, in bytes per second, or 0 for unlimited.
>    * @on_error: The action to take upon error.
>    * @backing_file_str: String to use as the backing file in @top's overlay
> + * @backing_file_format_no_protocol: Use format name instead of potental
> + *                                   protocol name as backing image format
>    * @filter_node_name: The node name that should be assigned to the filter
>    * driver that the commit job inserts into the graph above @top. NULL means
>    * that a node name should be autogenerated.
> @@ -92,6 +94,7 @@ void commit_start(const char *job_id, BlockDriverState *bs,
>                     BlockDriverState *base, BlockDriverState *top,
>                     int creation_flags, int64_t speed,
>                     BlockdevOnError on_error, const char *backing_file_str,
> +                  bool backing_file_format_no_protocol,
>                     const char *filter_node_name, Error **errp);
>   /**
>    * commit_active_start:
> diff --git a/qapi/block-core.json b/qapi/block-core.json
> index ca390c5700..367e896905 100644
> --- a/qapi/block-core.json
> +++ b/qapi/block-core.json
> @@ -1810,6 +1810,14 @@
>   #     Care should be taken when specifying the string, to specify a
>   #     valid filename or protocol.  (Since 2.1)
>   #
> +# @backing-file-format-no-protocol: If true always use a 'format' driver name
> +#     for the 'backing file format' field if updating the image header of the
> +#     overlay of 'top'. Otherwise the real name of the driver of the backing
> +#     image may be used which may be a protocol driver.
> +#
> +#     Can be used also when no image header will be updated.
> +#     (default: false; since: 8.2)
> +#

Hi Peter.

Hmm. Could this just be @backing-file-format ?

As I understand, finally, that's just a string which we are going to put into qcow2 metadata.
And from qcow2 point of view, it's rather strange to set backing_file_format="raw" for backing image which is actually "qcow2". "raw" say nothing to the reader and may be even misleading. Same for qemu, this seems just a strange thing.

Also, what I dislike, that new feature sounds like hardcoded "raw" is the only format driver. If go this way, more honest name would be @backing-file-raw.

And, if we allow user to give any backing-file name to be written into qcow2 metadata after the operation, why not just allow to set any backing-file-name as well?

So, I think simple @backing-file-format argument, allowing to set any string as backing format is a better concept.


Moreover: in BlockdevCreateOptionsQcow2 we have backing-file and backing-fmt options. So I think, we should follow this and name the new option for block-job @backing-fmt.


>   # @speed: the maximum speed, in bytes per second
>   #
>   # @on-error: the action to take on an error.  'ignore' means that the
> @@ -1856,7 +1864,8 @@
>               '*base': { 'type': 'str', 'features': [ 'deprecated' ] },
>               '*top-node': 'str',
>               '*top': { 'type': 'str', 'features': [ 'deprecated' ] },
> -            '*backing-file': 'str', '*speed': 'int',
> +            '*backing-file': 'str', '*backing-file-format-no-protocol': 'bool',
> +            '*speed': 'int',
>               '*on-error': 'BlockdevOnError',
>               '*filter-node-name': 'str',
>               '*auto-finalize': 'bool', '*auto-dismiss': 'bool' },
> diff --git a/tests/unit/test-bdrv-drain.c b/tests/unit/test-bdrv-drain.c
> index 704d1a3f36..422f0c7cd8 100644
> --- a/tests/unit/test-bdrv-drain.c
> +++ b/tests/unit/test-bdrv-drain.c
> @@ -1638,6 +1638,7 @@ static const BlockJobDriver test_simple_job_driver = {
>   static int drop_intermediate_poll_update_filename(BdrvChild *child,
>                                                     BlockDriverState *new_base,
>                                                     const char *filename,
> +                                                  bool backing_file_format_no_protocol,
>                                                     Error **errp)
>   {
>       /*
> @@ -1749,7 +1750,7 @@ static void test_drop_intermediate_poll(void)
>       job->should_complete = true;
> 
>       g_assert(!job_has_completed);
> -    ret = bdrv_drop_intermediate(chain[1], chain[0], NULL);
> +    ret = bdrv_drop_intermediate(chain[1], chain[0], NULL, false);
>       aio_poll(qemu_get_aio_context(), false);
>       g_assert(ret == 0);
>       g_assert(job_has_completed);

-- 
Best regards,
Vladimir

Re: [PATCH 1/2] block: commit: Allow users to request only format driver names in backing file format

[Peter Krempa]

On Tue, Nov 28, 2023 at 20:10:10 +0300, Vladimir Sementsov-Ogievskiy wrote:
> On 24.11.23 17:52, Peter Krempa wrote:
> > Introduce a new flag 'backing_file_format_no_protocol' for the
> > block-commit QMP command which instructs the internals to use 'raw'
> > instead of the protocol driver in case when a image is used without a
> > dummy 'raw' wrapper.
> > 
> > The flag is designed such that it can be always asserted by management
> > tools even when there isn't any update to backing files.
> > 
> > The flag will be used by libvirt so that the backing images still
> > reference the proper format even when libvirt will stop using the dummy
> > raw driver (raw driver with no other config). Libvirt needs this so that
> > the images stay compatible with older libvirt versions which didn't
> > expect that a protocol driver name can appear in the backing file format
> > field.
> > 
> > Signed-off-by: Peter Krempa <pkrempa@redhat.com>
> > ---

[...]

> > diff --git a/qapi/block-core.json b/qapi/block-core.json
> > index ca390c5700..367e896905 100644
> > --- a/qapi/block-core.json
> > +++ b/qapi/block-core.json
> > @@ -1810,6 +1810,14 @@
> >   #     Care should be taken when specifying the string, to specify a
> >   #     valid filename or protocol.  (Since 2.1)
> >   #
> > +# @backing-file-format-no-protocol: If true always use a 'format' driver name
> > +#     for the 'backing file format' field if updating the image header of the
> > +#     overlay of 'top'. Otherwise the real name of the driver of the backing
> > +#     image may be used which may be a protocol driver.
> > +#
> > +#     Can be used also when no image header will be updated.
> > +#     (default: false; since: 8.2)
> > +#
> 
> Hi Peter.

Hi,

Firstly to be honest, I consider the fact that qemu can put a protocol
driver into the header field named "backing file format" to be a bug.
After discussion with Kevin I understand the rationale of doing so, but
nevertheless, a backing protocol name is not a format and should have
had it's own header field.

> Hmm. Could this just be @backing-file-format ?

I don't really care too deeply about the name.

Calling it just @backing-file-format though would imply (as you write
below) that as argument the string to write into the metadata. More on
that below.

> As I understand, finally, that's just a string which we are going to put into qcow2 metadata.

Yes.

> And from qcow2 point of view, it's rather strange to set backing_file_format="raw" for backing image which is actually "qcow2".

Indeed, that would be wrong, but this is _NOT_ what this patch
actually does.

This patch ensures that only a *format* driver name is ever written to
the backing image. It overrides the fact that a *protocol* driver name
would be written into the field if the tail of the backing chain is a
raw image, which was instantiated in qemu without the dummy 'raw' driver
on top.

Since a raw driver with no configuration simply passes request to the
*protocol* driver below it it's not needed in most configs. In fact as
stefanha figured out a long time ago it's just simpy overhead.

We need a format name in the backing file format field as libvirt
assumed for a very long time that such a field would contain only format
drivers, and since I want to remove the overhead of the 'raw' driver I
need to ensure that images won't break for older libvirt.

>"raw" say nothing to the reader and may be even misleading. Same for qemu, this seems just a strange thing.
> 
> Also, what I dislike, that new feature sounds like hardcoded "raw" is the only format driver. If go this way, more honest name would be @backing-file-raw.

Once again, that is not what's happening here. The field enables that
only a *format* driver is used. This is only a problem when the final
image is raw, but without the dummy 'raw' driver on top of it. Thus
that's the reason the workaround only ever writes 'raw' into it.
Otherwise the proper format name is in the 'driver' field already and is
not overwritten.

> And, if we allow user to give any backing-file name to be written into qcow2 metadata after the operation, why not just allow to set any backing-file-name as well?

This IMO makes no sense to allow, but based on the reimagined design of
the 'backing file /format/' field it might appear that it does.

'block-commit' and 'block-stream, can't change the format of any of the
images, they simply move data, thus for any non-raw image in a chain it
must still use actual format name. Only place it makes sense is in the
same cases when the code in this patch triggers.

And then it still doesn't make sense to write anything besides:
1) The actual *format* of the image (thus 'raw')
2) The protocol driver of the last image (e.g. NBD)

But since 'block-stream'/'block-commit' don't move the image to any
other storage, allowing the user to write any other protocol also
doesn't make any sense to write any other protocol.

Thus the two cases above are the only sane, this patch allows that 1) is
written into the image.

> So, I think simple @backing-file-format argument, allowing to set any string as backing format is a better concept.

While libvirt certainly has the data to do so, as noted in the paragraph
above it doesn't IMO make sense to allow write any arbitrary driver name
there.

And with design like this it allows libvirt to unconditionally use the
flag without thinking too much about what is the correct value.

> Moreover: in BlockdevCreateOptionsQcow2 we have backing-file and backing-fmt options. So I think, we should follow this and name the new option for block-job @backing-fmt.

This is different, you are creating an image and declaring it's backing
image format. With 'block-stream' and 'block-commit' the format of the
backing image won't change, just data will be shuffled around. 

Re: [PATCH 1/2] block: commit: Allow users to request only format driver names in backing file format

[Vladimir Sementsov-Ogievskiy]

On 29.11.23 00:58, Peter Krempa wrote:
> On Tue, Nov 28, 2023 at 20:10:10 +0300, Vladimir Sementsov-Ogievskiy wrote:
>> On 24.11.23 17:52, Peter Krempa wrote:
>>> Introduce a new flag 'backing_file_format_no_protocol' for the
>>> block-commit QMP command which instructs the internals to use 'raw'
>>> instead of the protocol driver in case when a image is used without a
>>> dummy 'raw' wrapper.
>>>
>>> The flag is designed such that it can be always asserted by management
>>> tools even when there isn't any update to backing files.
>>>
>>> The flag will be used by libvirt so that the backing images still
>>> reference the proper format even when libvirt will stop using the dummy
>>> raw driver (raw driver with no other config). Libvirt needs this so that
>>> the images stay compatible with older libvirt versions which didn't
>>> expect that a protocol driver name can appear in the backing file format
>>> field.
>>>
>>> Signed-off-by: Peter Krempa <pkrempa@redhat.com>
>>> ---
> 
> [...]
> 
>>> diff --git a/qapi/block-core.json b/qapi/block-core.json
>>> index ca390c5700..367e896905 100644
>>> --- a/qapi/block-core.json
>>> +++ b/qapi/block-core.json
>>> @@ -1810,6 +1810,14 @@
>>>    #     Care should be taken when specifying the string, to specify a
>>>    #     valid filename or protocol.  (Since 2.1)
>>>    #
>>> +# @backing-file-format-no-protocol: If true always use a 'format' driver name
>>> +#     for the 'backing file format' field if updating the image header of the
>>> +#     overlay of 'top'. Otherwise the real name of the driver of the backing
>>> +#     image may be used which may be a protocol driver.
>>> +#
>>> +#     Can be used also when no image header will be updated.
>>> +#     (default: false; since: 8.2)
>>> +#
>>
>> Hi Peter.
> 
> Hi,
> 
> Firstly to be honest, I consider the fact that qemu can put a protocol
> driver into the header field named "backing file format" to be a bug.
> After discussion with Kevin I understand the rationale of doing so, but
> nevertheless, a backing protocol name is not a format and should have
> had it's own header field.
> 
>> Hmm. Could this just be @backing-file-format ?
> 
> I don't really care too deeply about the name.
> 
> Calling it just @backing-file-format though would imply (as you write
> below) that as argument the string to write into the metadata. More on
> that below.
> 
>> As I understand, finally, that's just a string which we are going to put into qcow2 metadata.
> 
> Yes.
> 
>> And from qcow2 point of view, it's rather strange to set backing_file_format="raw" for backing image which is actually "qcow2".
> 
> Indeed, that would be wrong, but this is _NOT_ what this patch
> actually does.

Oh, right. Somehow I was confused. That was bad idea to review in the evening(

> 
> This patch ensures that only a *format* driver name is ever written to
> the backing image. It overrides the fact that a *protocol* driver name
> would be written into the field if the tail of the backing chain is a
> raw image, which was instantiated in qemu without the dummy 'raw' driver
> on top.

Yes, right, I understand. How could I think that we are going to write "raw" instead of "qcow2", I can't say now)

> 
> Since a raw driver with no configuration simply passes request to the
> *protocol* driver below it it's not needed in most configs. In fact as
> stefanha figured out a long time ago it's just simpy overhead.

I have always keep that in mind, but never really care. Cool that you rework it.

> 
> We need a format name in the backing file format field as libvirt
> assumed for a very long time that such a field would contain only format
> drivers, and since I want to remove the overhead of the 'raw' driver I
> need to ensure that images won't break for older libvirt.
> 
>> "raw" say nothing to the reader and may be even misleading. Same for qemu, this seems just a strange thing.
>>
>> Also, what I dislike, that new feature sounds like hardcoded "raw" is the only format driver. If go this way, more honest name would be @backing-file-raw.
> 
> Once again, that is not what's happening here. The field enables that
> only a *format* driver is used. This is only a problem when the final
> image is raw, but without the dummy 'raw' driver on top of it. Thus
> that's the reason the workaround only ever writes 'raw' into it.
> Otherwise the proper format name is in the 'driver' field already and is
> not overwritten.

OK

> 
>> And, if we allow user to give any backing-file name to be written into qcow2 metadata after the operation, why not just allow to set any backing-file-name as well?
> 
> This IMO makes no sense to allow, but based on the reimagined design of
> the 'backing file /format/' field it might appear that it does.
> 
> 'block-commit' and 'block-stream, can't change the format of any of the
> images, they simply move data, thus for any non-raw image in a chain it
> must still use actual format name. Only place it makes sense is in the
> same cases when the code in this patch triggers.
> 
> And then it still doesn't make sense to write anything besides:
> 1) The actual *format* of the image (thus 'raw')
> 2) The protocol driver of the last image (e.g. NBD)
> 
> But since 'block-stream'/'block-commit' don't move the image to any
> other storage, allowing the user to write any other protocol also
> doesn't make any sense to write any other protocol.
> 
> Thus the two cases above are the only sane, this patch allows that 1) is
> written into the image.
> 
>> So, I think simple @backing-file-format argument, allowing to set any string as backing format is a better concept.
> 
> While libvirt certainly has the data to do so, as noted in the paragraph
> above it doesn't IMO make sense to allow write any arbitrary driver name
> there.
> 
> And with design like this it allows libvirt to unconditionally use the
> flag without thinking too much about what is the correct value.
> 
>> Moreover: in BlockdevCreateOptionsQcow2 we have backing-file and backing-fmt options. So I think, we should follow this and name the new option for block-job @backing-fmt.
> 
> This is different, you are creating an image and declaring it's backing
> image format. With 'block-stream' and 'block-commit' the format of the
> backing image won't change, just data will be shuffled around.
> 

OK, right, I understand now, thanks for comprehensive explanation.

-- 
Best regards,
Vladimir

Re: [PATCH 1/2] block: commit: Allow users to request only format driver names in backing file format

[Vladimir Sementsov-Ogievskiy]

On 24.11.23 17:52, Peter Krempa wrote:
> Introduce a new flag 'backing_file_format_no_protocol' for the
> block-commit QMP command which instructs the internals to use 'raw'
> instead of the protocol driver in case when a image is used without a
> dummy 'raw' wrapper.
> 
> The flag is designed such that it can be always asserted by management
> tools even when there isn't any update to backing files.
> 
> The flag will be used by libvirt so that the backing images still
> reference the proper format even when libvirt will stop using the dummy
> raw driver (raw driver with no other config). Libvirt needs this so that
> the images stay compatible with older libvirt versions which didn't
> expect that a protocol driver name can appear in the backing file format
> field.
> 
> Signed-off-by: Peter Krempa<pkrempa@redhat.com>

Reviewed-by: Vladimir Sementsov-Ogievskiy <vsementsov@yandex-team.ru>

-- 
Best regards,
Vladimir

[PATCH 2/2] block: stream: Allow users to request only format driver names in backing file format

[Peter Krempa]

Introduce a new flag 'backing_file_format_no_protocol' for the
block-commit QMP command which instructs the internals to use 'raw'
instead of the protocol driver in case when a image is used without a
dummy 'raw' wrapper.

The flag is designed such that it can be always asserted by management
tools even when there isn't any update to backing files.

The flag will be used by libvirt so that the backing images still
reference the proper format even when libvirt will stop using the dummy
raw driver (raw driver with no other config). Libvirt needs this so that
the images stay compatible with older libvirt versions which didn't
expect that a protocol driver name can appear in the backing file format
field.

Signed-off-by: Peter Krempa <pkrempa@redhat.com>
---
 block/monitor/block-hmp-cmds.c         |  2 +-
 block/stream.c                         | 10 +++++++++-
 blockdev.c                             |  7 +++++++
 include/block/block_int-global-state.h |  3 +++
 qapi/block-core.json                   | 11 ++++++++++-
 5 files changed, 30 insertions(+), 3 deletions(-)

diff --git a/block/monitor/block-hmp-cmds.c b/block/monitor/block-hmp-cmds.c
index c729cbf1eb..28e708a981 100644
--- a/block/monitor/block-hmp-cmds.c
+++ b/block/monitor/block-hmp-cmds.c
@@ -509,7 +509,7 @@ void hmp_block_stream(Monitor *mon, const QDict *qdict)
     const char *base = qdict_get_try_str(qdict, "base");
     int64_t speed = qdict_get_try_int(qdict, "speed", 0);

-    qmp_block_stream(device, device, base, NULL, NULL, NULL,
+    qmp_block_stream(device, device, base, NULL, NULL, NULL, false, false,
                      qdict_haskey(qdict, "speed"), speed,
                      true, BLOCKDEV_ON_ERROR_REPORT, NULL,
                      false, false, false, false, &error);
diff --git a/block/stream.c b/block/stream.c
index 01fe7c0f16..42befd6b1d 100644
--- a/block/stream.c
+++ b/block/stream.c
@@ -39,6 +39,7 @@ typedef struct StreamBlockJob {
     BlockDriverState *target_bs;
     BlockdevOnError on_error;
     char *backing_file_str;
+    bool backing_file_format_no_protocol;
     bool bs_read_only;
 } StreamBlockJob;

@@ -95,7 +96,12 @@ static int stream_prepare(Job *job)
         if (unfiltered_base) {
             base_id = s->backing_file_str ?: unfiltered_base->filename;
             if (unfiltered_base->drv) {
-                base_fmt = unfiltered_base->drv->format_name;
+                if (s->backing_file_format_no_protocol &&
+                    unfiltered_base->drv->protocol_name) {
+                    base_fmt = "raw";
+                } else {
+                    base_fmt = unfiltered_base->drv->format_name;
+                }
             }
         }

@@ -247,6 +253,7 @@ static const BlockJobDriver stream_job_driver = {

 void stream_start(const char *job_id, BlockDriverState *bs,
                   BlockDriverState *base, const char *backing_file_str,
+                  bool backing_file_format_no_protocol,
                   BlockDriverState *bottom,
                   int creation_flags, int64_t speed,
                   BlockdevOnError on_error,
@@ -398,6 +405,7 @@ void stream_start(const char *job_id, BlockDriverState *bs,
     s->base_overlay = base_overlay;
     s->above_base = above_base;
     s->backing_file_str = g_strdup(backing_file_str);
+    s->backing_file_format_no_protocol = backing_file_format_no_protocol;
     s->cor_filter_bs = cor_filter_bs;
     s->target_bs = bs;
     s->bs_read_only = bs_read_only;
diff --git a/blockdev.c b/blockdev.c
index 038031bb03..dc477c4f7e 100644
--- a/blockdev.c
+++ b/blockdev.c
@@ -2408,6 +2408,8 @@ void qmp_block_stream(const char *job_id, const char *device,
                       const char *base,
                       const char *base_node,
                       const char *backing_file,
+                      bool has_backing_file_format_no_protocol,
+                      bool backing_file_format_no_protocol,
                       const char *bottom,
                       bool has_speed, int64_t speed,
                       bool has_on_error, BlockdevOnError on_error,
@@ -2443,6 +2445,10 @@ void qmp_block_stream(const char *job_id, const char *device,
         return;
     }

+    if (!has_backing_file_format_no_protocol) {
+        backing_file_format_no_protocol = false;
+    }
+
     if (!has_on_error) {
         on_error = BLOCKDEV_ON_ERROR_REPORT;
     }
@@ -2531,6 +2537,7 @@ void qmp_block_stream(const char *job_id, const char *device,
     }

     stream_start(job_id, bs, base_bs, backing_file,
+                 backing_file_format_no_protocol,
                  bottom_bs, job_flags, has_speed ? speed : 0, on_error,
                  filter_node_name, &local_err);
     if (local_err) {
diff --git a/include/block/block_int-global-state.h b/include/block/block_int-global-state.h
index 4f253ff362..4301061048 100644
--- a/include/block/block_int-global-state.h
+++ b/include/block/block_int-global-state.h
@@ -46,6 +46,8 @@
  * flatten the whole backing file chain onto @bs.
  * @backing_file_str: The file name that will be written to @bs as the
  * the new backing file if the job completes. Ignored if @base is %NULL.
+ * @backing_file_format_no_protocol: Use format name instead of potental
+ *                                   protocol name as backing image format
  * @creation_flags: Flags that control the behavior of the Job lifetime.
  *                  See @BlockJobCreateFlags
  * @speed: The maximum speed, in bytes per second, or 0 for unlimited.
@@ -64,6 +66,7 @@
  */
 void stream_start(const char *job_id, BlockDriverState *bs,
                   BlockDriverState *base, const char *backing_file_str,
+                  bool backing_file_format_no_protocol,
                   BlockDriverState *bottom,
                   int creation_flags, int64_t speed,
                   BlockdevOnError on_error,
diff --git a/qapi/block-core.json b/qapi/block-core.json
index 367e896905..796cc582d5 100644
--- a/qapi/block-core.json
+++ b/qapi/block-core.json
@@ -2829,6 +2829,13 @@
 #     Care should be taken when specifying the string, to specify a
 #     valid filename or protocol.  (Since 2.1)
 #
+# @backing-file-format-no-protocol: If true always use a 'format' driver name
+#     for the 'backing file format' field if updating the image header of 'top'.
+#     Otherwise the real name of the driver of the backing
+#     image may be used which may be a protocol driver.
+#
+#     (default: false; since: 8.2)
+#
 # @speed: the maximum speed, in bytes per second
 #
 # @on-error: the action to take on an error (default report). 'stop'
@@ -2867,7 +2874,9 @@
 ##
 { 'command': 'block-stream',
   'data': { '*job-id': 'str', 'device': 'str', '*base': 'str',
-            '*base-node': 'str', '*backing-file': 'str', '*bottom': 'str',
+            '*base-node': 'str', '*backing-file': 'str',
+            '*backing-file-format-no-protocol': 'bool',
+            '*bottom': 'str',
             '*speed': 'int', '*on-error': 'BlockdevOnError',
             '*filter-node-name': 'str',
             '*auto-finalize': 'bool', '*auto-dismiss': 'bool' },
-- 
2.43.0

Re: [PATCH 2/2] block: stream: Allow users to request only format driver names in backing file format

[Vladimir Sementsov-Ogievskiy]

On 24.11.23 17:52, Peter Krempa wrote:
> Introduce a new flag 'backing_file_format_no_protocol' for the
> block-commit QMP command which instructs the internals to use 'raw'
> instead of the protocol driver in case when a image is used without a
> dummy 'raw' wrapper.
> 
> The flag is designed such that it can be always asserted by management
> tools even when there isn't any update to backing files.
> 
> The flag will be used by libvirt so that the backing images still
> reference the proper format even when libvirt will stop using the dummy
> raw driver (raw driver with no other config). Libvirt needs this so that
> the images stay compatible with older libvirt versions which didn't
> expect that a protocol driver name can appear in the backing file format
> field.
> 
> Signed-off-by: Peter Krempa <pkrempa@redhat.com>
> ---
>   block/monitor/block-hmp-cmds.c         |  2 +-
>   block/stream.c                         | 10 +++++++++-
>   blockdev.c                             |  7 +++++++
>   include/block/block_int-global-state.h |  3 +++
>   qapi/block-core.json                   | 11 ++++++++++-
>   5 files changed, 30 insertions(+), 3 deletions(-)
> 
> diff --git a/block/monitor/block-hmp-cmds.c b/block/monitor/block-hmp-cmds.c
> index c729cbf1eb..28e708a981 100644
> --- a/block/monitor/block-hmp-cmds.c
> +++ b/block/monitor/block-hmp-cmds.c
> @@ -509,7 +509,7 @@ void hmp_block_stream(Monitor *mon, const QDict *qdict)
>       const char *base = qdict_get_try_str(qdict, "base");
>       int64_t speed = qdict_get_try_int(qdict, "speed", 0);
> 
> -    qmp_block_stream(device, device, base, NULL, NULL, NULL,
> +    qmp_block_stream(device, device, base, NULL, NULL, NULL, false, false,

that should be

+    qmp_block_stream(device, device, base, NULL, NULL, false, false, NULL,


( definitely we lack named arguments of python in C :)


with that fixed:
Reviewed-by: Vladimir Sementsov-Ogievskiy <vsementsov@yandex-team.ru>

>                        qdict_haskey(qdict, "speed"), speed,
>                        true, BLOCKDEV_ON_ERROR_REPORT, NULL,
>                        false, false, false, false, &error);

...

> --- a/blockdev.c
> +++ b/blockdev.c
> @@ -2408,6 +2408,8 @@ void qmp_block_stream(const char *job_id, const char *device,
>                         const char *base,
>                         const char *base_node,
>                         const char *backing_file,
> +                      bool has_backing_file_format_no_protocol,
> +                      bool backing_file_format_no_protocol,
>                         const char *bottom,
>                         bool has_speed, int64_t speed,
>                         bool has_on_error, BlockdevOnError on_error,

-- 
Best regards,
Vladimir

Re: [PATCH 0/2] block: commit/stream: Allow users to request only format driver names in backing file format

[Vladimir Sementsov-Ogievskiy]

On 24.11.23 17:52, Peter Krempa wrote:
> Please see patches for rationale.
> 
> Libvirt patches using this new flag will be posted soon-ish (after
> cleanup).
> 
> Peter Krempa (2):
>    block: commit: Allow users to request only format driver names in
>      backing file format
>    block: stream: Allow users to request only format driver names in
>      backing file format
> 
>   block.c                                | 37 +++++++++++++++++++++-----
>   block/commit.c                         |  6 ++++-
>   block/monitor/block-hmp-cmds.c         |  2 +-
>   block/stream.c                         | 10 ++++++-
>   blockdev.c                             | 13 +++++++++
>   include/block/block-global-state.h     |  3 ++-
>   include/block/block_int-common.h       |  4 ++-
>   include/block/block_int-global-state.h |  6 +++++
>   qapi/block-core.json                   | 22 +++++++++++++--
>   tests/unit/test-bdrv-drain.c           |  3 ++-
>   10 files changed, 91 insertions(+), 15 deletions(-)
> 

Now seems good to me. Still:

1. Will need to update "since: 8.2" to 9, right?

2. Probably, use some shorter name... But I don't have good suggestion. Wouldn't that become a longest name in QAPI?)

-- 
Best regards,
Vladimir