9ae3a8
From 1a7d0d17b3b2aeae3c48895ee60da17e3ee27f32 Mon Sep 17 00:00:00 2001
9ae3a8
From: Max Reitz <mreitz@redhat.com>
9ae3a8
Date: Fri, 24 Oct 2014 08:18:00 +0200
9ae3a8
Subject: [PATCH 12/19] qemu-img: fix rebase src_cache option documentation
9ae3a8
9ae3a8
Message-id: <1414138680-19600-5-git-send-email-mreitz@redhat.com>
9ae3a8
Patchwork-id: 61865
9ae3a8
O-Subject: [RHEL-7.1 qemu-kvm PATCH v2 4/4] qemu-img: fix rebase src_cache option documentation
9ae3a8
Bugzilla: 1138691
9ae3a8
RH-Acked-by: Laszlo Ersek <lersek@redhat.com>
9ae3a8
RH-Acked-by: Markus Armbruster <armbru@redhat.com>
9ae3a8
RH-Acked-by: Kevin Wolf <kwolf@redhat.com>
9ae3a8
9ae3a8
From: Stefan Hajnoczi <stefanha@redhat.com>
9ae3a8
9ae3a8
The src_cache option (-T) specifies the cache mode for backing files.
9ae3a8
It applies both the image's old backing file as well as the new backing
9ae3a8
file:
9ae3a8
9ae3a8
  ret = bdrv_open(&bs_old_backing, backing_name, NULL, NULL, src_flags,
9ae3a8
                  old_backing_drv, &local_err);
9ae3a8
  if (ret) {
9ae3a8
      ...
9ae3a8
  }
9ae3a8
  if (out_baseimg[0]) {
9ae3a8
      bs_new_backing = bdrv_new("new_backing", &error_abort);
9ae3a8
      ret = bdrv_open(&bs_new_backing, out_baseimg, NULL, NULL, src_flags,
9ae3a8
                      new_backing_drv, &local_err);
9ae3a8
      if (ret) {
9ae3a8
          ...
9ae3a8
      }
9ae3a8
  }
9ae3a8
9ae3a8
The documentation only mentions the new backing file but it really
9ae3a8
applies to both.
9ae3a8
9ae3a8
Suggested-by: Jeff Nelson <jenelson@redhat.com>
9ae3a8
Signed-off-by: Stefan Hajnoczi <stefanha@redhat.com>
9ae3a8
Reviewed-by: Max Reitz <mreitz@redhat.com>
9ae3a8
(cherry picked from commit 3ba6796d080a90440573ef29d657e4902be7e238)
9ae3a8
9ae3a8
Signed-off-by: Max Reitz <mreitz@redhat.com>
9ae3a8
Signed-off-by: Miroslav Rezanina <mrezanin@redhat.com>
9ae3a8
---
9ae3a8
 qemu-img.texi | 2 +-
9ae3a8
 1 file changed, 1 insertion(+), 1 deletion(-)
9ae3a8
9ae3a8
diff --git a/qemu-img.texi b/qemu-img.texi
9ae3a8
index 4b7a331..5f99ebb 100644
9ae3a8
--- a/qemu-img.texi
9ae3a8
+++ b/qemu-img.texi
9ae3a8
@@ -314,7 +314,7 @@ string), then the image is rebased onto no backing file (i.e. it will exist
9ae3a8
 independently of any backing file).
9ae3a8
 
9ae3a8
 @var{cache} specifies the cache mode to be used for @var{filename}, whereas
9ae3a8
-@var{src_cache} specifies the cache mode for reading the new backing file.
9ae3a8
+@var{src_cache} specifies the cache mode for reading backing files.
9ae3a8
 
9ae3a8
 There are two different modes in which @code{rebase} can operate:
9ae3a8
 @table @option
9ae3a8
-- 
9ae3a8
1.8.3.1
9ae3a8