Blame SOURCES/kvm-block-rbd-add-deprecation-documentation-for-filename.patch

ae23c9
From 5c520d5572b0c7974bc71e89d5d5a77d9d0d9284 Mon Sep 17 00:00:00 2001
ae23c9
From: John Snow <jsnow@redhat.com>
ae23c9
Date: Wed, 10 Oct 2018 20:30:15 +0100
ae23c9
Subject: [PATCH 3/4] block/rbd: add deprecation documentation for filename
ae23c9
 keyvalue pairs
ae23c9
ae23c9
RH-Author: John Snow <jsnow@redhat.com>
ae23c9
Message-id: <20181010203015.11719-5-jsnow@redhat.com>
ae23c9
Patchwork-id: 82625
ae23c9
O-Subject: [RHEL8/rhel qemu-kvm PATCH 4/4] block/rbd: add deprecation documentation for filename keyvalue pairs
ae23c9
Bugzilla: 1635585
ae23c9
RH-Acked-by: Markus Armbruster <armbru@redhat.com>
ae23c9
RH-Acked-by: Stefan Hajnoczi <stefanha@redhat.com>
ae23c9
RH-Acked-by: Thomas Huth <thuth@redhat.com>
ae23c9
ae23c9
From: Jeff Cody <jcody@redhat.com>
ae23c9
ae23c9
Signed-off-by: Jeff Cody <jcody@redhat.com>
ae23c9
Message-id: 647f5b5ab7efd8bf567a504c832b1d2d6f719b23.1536704901.git.jcody@redhat.com
ae23c9
Signed-off-by: Jeff Cody <jcody@redhat.com>
ae23c9
(cherry picked from commit 3bebd37e04f972775b1ece1bdda95451bc9fb14c)
ae23c9
Signed-off-by: John Snow <jsnow@redhat.com>
ae23c9
Signed-off-by: Danilo C. L. de Paula <ddepaula@redhat.com>
ae23c9
ae23c9
Conflicts:
ae23c9
  qemu-deprecated.texi: not yet factored out as of 2.12.0;
ae23c9
                        docs added to qemu-doc.texi instead.
ae23c9
Signed-off-by: John Snow <jsnow@redhat.com>
ae23c9
---
ae23c9
 qemu-doc.texi | 15 +++++++++++++++
ae23c9
 1 file changed, 15 insertions(+)
ae23c9
ae23c9
diff --git a/qemu-doc.texi b/qemu-doc.texi
ae23c9
index 985e0f2..0013170 100644
ae23c9
--- a/qemu-doc.texi
ae23c9
+++ b/qemu-doc.texi
ae23c9
@@ -2982,6 +2982,21 @@ The ``xlnx-zcu102'' machine has the same features and capabilites in QEMU.
ae23c9
 In order to prevent QEMU from automatically opening an image's backing
ae23c9
 chain, use ``"backing": null'' instead.
ae23c9
 
ae23c9
+@subsubsection rbd keyvalue pair encoded filenames: "" (since 3.1.0)
ae23c9
+
ae23c9
+Options for ``rbd'' should be specified according to its runtime options,
ae23c9
+like other block drivers.  Legacy parsing of keyvalue pair encoded
ae23c9
+filenames is useful to open images with the old format for backing files;
ae23c9
+These image files should be updated to use the current format.
ae23c9
+
ae23c9
+Example of legacy encoding:
ae23c9
+
ae23c9
+@code{json:@{"file.driver":"rbd", "file.filename":"rbd:rbd/name"@}}
ae23c9
+
ae23c9
+The above, converted to the current supported format:
ae23c9
+
ae23c9
+@code{json:@{"file.driver":"rbd", "file.pool":"rbd", "file.image":"name"@}}
ae23c9
+
ae23c9
 @node License
ae23c9
 @appendix License
ae23c9
 
ae23c9
-- 
ae23c9
1.8.3.1
ae23c9