aboutsummaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorEric Blake <eblake@redhat.com>2019-08-15 13:50:24 -0500
committerEric Blake <eblake@redhat.com>2019-09-05 15:51:55 -0500
commit61cc872456492da24e36cfbd668abfbe127c739f (patch)
tree493b9a7e237ee84a18f24f2d81c690cd7f52c450 /docs
parenteac2f39602e0423adf56be410c9a22c31fec9a81 (diff)
downloadqemu-61cc872456492da24e36cfbd668abfbe127c739f.zip
qemu-61cc872456492da24e36cfbd668abfbe127c739f.tar.gz
qemu-61cc872456492da24e36cfbd668abfbe127c739f.tar.bz2
nbd: Advertise multi-conn for shared read-only connections
The NBD specification defines NBD_FLAG_CAN_MULTI_CONN, which can be advertised when the server promises cache consistency between simultaneous clients (basically, rules that determine what FUA and flush from one client are able to guarantee for reads from another client). When we don't permit simultaneous clients (such as qemu-nbd without -e), the bit makes no sense; and for writable images, we probably have a lot more work before we can declare that actions from one client are cache-consistent with actions from another. But for read-only images, where flush isn't changing any data, we might as well advertise multi-conn support. What's more, advertisement of the bit makes it easier for clients to determine if 'qemu-nbd -e' was in use, where a second connection will succeed rather than hang until the first client goes away. This patch affects qemu as server in advertising the bit. We may want to consider patches to qemu as client to attempt parallel connections for higher throughput by spreading the load over those connections when a server advertises multi-conn, but for now sticking to one connection per nbd:// BDS is okay. See also: https://bugzilla.redhat.com/1708300 Signed-off-by: Eric Blake <eblake@redhat.com> Message-Id: <20190815185024.7010-1-eblake@redhat.com> [eblake: tweak blockdev-nbd.c to not request shared when writable, fix iotest 233] Reviewed-by: John Snow <jsnow@redhat.com>
Diffstat (limited to 'docs')
-rw-r--r--docs/interop/nbd.txt1
1 files changed, 1 insertions, 0 deletions
diff --git a/docs/interop/nbd.txt b/docs/interop/nbd.txt
index fc64473..6dfec7f 100644
--- a/docs/interop/nbd.txt
+++ b/docs/interop/nbd.txt
@@ -53,3 +53,4 @@ the operation of that feature.
* 2.12: NBD_CMD_BLOCK_STATUS for "base:allocation"
* 3.0: NBD_OPT_STARTTLS with TLS Pre-Shared Keys (PSK),
NBD_CMD_BLOCK_STATUS for "qemu:dirty-bitmap:", NBD_CMD_CACHE
+* 4.2: NBD_FLAG_CAN_MULTI_CONN for sharable read-only exports