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