|
 |
7711c0 |
From 627a30ded957f715a9832e8fe93feb3f03575095 Mon Sep 17 00:00:00 2001
|
|
|
7711c0 |
From: John Snow <jsnow@redhat.com>
|
|
|
7711c0 |
Date: Wed, 27 Mar 2019 17:22:21 +0100
|
|
|
7711c0 |
Subject: [PATCH 082/163] nbd: Document timeline of various features
|
|
|
7711c0 |
|
|
|
7711c0 |
RH-Author: John Snow <jsnow@redhat.com>
|
|
|
7711c0 |
Message-id: <20190327172308.31077-9-jsnow@redhat.com>
|
|
|
7711c0 |
Patchwork-id: 85169
|
|
|
7711c0 |
O-Subject: [RHEL-7.7 qemu-kvm-rhev PATCH 08/55] nbd: Document timeline of various features
|
|
|
7711c0 |
Bugzilla: 1691009
|
|
|
7711c0 |
RH-Acked-by: Stefan Hajnoczi <stefanha@redhat.com>
|
|
|
7711c0 |
RH-Acked-by: Max Reitz <mreitz@redhat.com>
|
|
|
7711c0 |
RH-Acked-by: Miroslav Rezanina <mrezanin@redhat.com>
|
|
|
7711c0 |
|
|
|
7711c0 |
From: Eric Blake <eblake@redhat.com>
|
|
|
7711c0 |
|
|
|
7711c0 |
It can be useful to figure out which NBD protocol features are
|
|
|
7711c0 |
exposed by a server, as well as what features a client will
|
|
|
7711c0 |
take advantage of if available, for a given qemu release. It's
|
|
|
7711c0 |
not always precise to base features on version numbers (thanks
|
|
|
7711c0 |
to downstream backports), but any documentation is better than
|
|
|
7711c0 |
making users search through git logs themselves.
|
|
|
7711c0 |
|
|
|
7711c0 |
This patch originally stemmed from a request to document that
|
|
|
7711c0 |
pristine 3.0 has a known bug where NBD_OPT_LIST_META_CONTEXT
|
|
|
7711c0 |
with 0 queries forgot to advertise an available
|
|
|
7711c0 |
"qemu:dirty-bitmap" context, but documenting bugs like this (or
|
|
|
7711c0 |
the fact that 3.0 also botched NBD_CMD_CACHE) gets to be too
|
|
|
7711c0 |
much details, especially since buggy releases will be less
|
|
|
7711c0 |
likely connection targets over time. Instead, I chose to just
|
|
|
7711c0 |
remind users to check stable release branches.
|
|
|
7711c0 |
|
|
|
7711c0 |
Suggested-by: Vladimir Sementsov-Ogievskiy <vsementsov@virtuozzo.com>
|
|
|
7711c0 |
Signed-off-by: Eric Blake <eblake@redhat.com>
|
|
|
7711c0 |
Message-Id: <20181215135324.152629-3-eblake@redhat.com>
|
|
|
7711c0 |
Reviewed-by: Richard W.M. Jones <rjones@redhat.com>
|
|
|
7711c0 |
Reviewed-by: Vladimir Sementsov-Ogievskiy <vsementsov@virtuozzo.com>
|
|
|
7711c0 |
(cherry picked from commit ba2d3b3ab217784822e4232f0acd71fc523d571f)
|
|
|
7711c0 |
Signed-off-by: John Snow <jsnow@redhat.com>
|
|
|
7711c0 |
Signed-off-by: Miroslav Rezanina <mrezanin@redhat.com>
|
|
|
7711c0 |
---
|
|
|
7711c0 |
docs/interop/nbd.txt | 19 ++++++++++++++++++-
|
|
|
7711c0 |
1 file changed, 18 insertions(+), 1 deletion(-)
|
|
|
7711c0 |
|
|
|
7711c0 |
diff --git a/docs/interop/nbd.txt b/docs/interop/nbd.txt
|
|
|
7711c0 |
index 77b5f45..fc64473 100644
|
|
|
7711c0 |
--- a/docs/interop/nbd.txt
|
|
|
7711c0 |
+++ b/docs/interop/nbd.txt
|
|
|
7711c0 |
@@ -15,7 +15,6 @@ Qemu supports the "base:allocation" metadata context as defined in the
|
|
|
7711c0 |
NBD protocol specification, and also defines an additional metadata
|
|
|
7711c0 |
namespace "qemu".
|
|
|
7711c0 |
|
|
|
7711c0 |
-
|
|
|
7711c0 |
== "qemu" namespace ==
|
|
|
7711c0 |
|
|
|
7711c0 |
The "qemu" namespace currently contains only one type of context,
|
|
|
7711c0 |
@@ -36,3 +35,21 @@ in addition to "qemu:dirty-bitmap:<dirty-bitmap-export-name>":
|
|
|
7711c0 |
namespace.
|
|
|
7711c0 |
* "qemu:dirty-bitmap:" - returns list of all available dirty-bitmap
|
|
|
7711c0 |
metadata contexts.
|
|
|
7711c0 |
+
|
|
|
7711c0 |
+= Features by version =
|
|
|
7711c0 |
+
|
|
|
7711c0 |
+The following list documents which qemu version first implemented
|
|
|
7711c0 |
+various features (both as a server exposing the feature, and as a
|
|
|
7711c0 |
+client taking advantage of the feature when present), to make it
|
|
|
7711c0 |
+easier to plan for cross-version interoperability. Note that in
|
|
|
7711c0 |
+several cases, the initial release containing a feature may require
|
|
|
7711c0 |
+additional patches from the corresponding stable branch to fix bugs in
|
|
|
7711c0 |
+the operation of that feature.
|
|
|
7711c0 |
+
|
|
|
7711c0 |
+* 2.6: NBD_OPT_STARTTLS with TLS X.509 Certificates
|
|
|
7711c0 |
+* 2.8: NBD_CMD_WRITE_ZEROES
|
|
|
7711c0 |
+* 2.10: NBD_OPT_GO, NBD_INFO_BLOCK
|
|
|
7711c0 |
+* 2.11: NBD_OPT_STRUCTURED_REPLY
|
|
|
7711c0 |
+* 2.12: NBD_CMD_BLOCK_STATUS for "base:allocation"
|
|
|
7711c0 |
+* 3.0: NBD_OPT_STARTTLS with TLS Pre-Shared Keys (PSK),
|
|
|
7711c0 |
+NBD_CMD_BLOCK_STATUS for "qemu:dirty-bitmap:", NBD_CMD_CACHE
|
|
|
7711c0 |
--
|
|
|
7711c0 |
1.8.3.1
|
|
|
7711c0 |
|