[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Qemu-devel] [PULL 10/14] qemu-img: Document --force-share / -U
From: |
Kevin Wolf |
Subject: |
[Qemu-devel] [PULL 10/14] qemu-img: Document --force-share / -U |
Date: |
Wed, 20 Dec 2017 14:19:35 +0100 |
From: Fam Zheng <address@hidden>
Signed-off-by: Fam Zheng <address@hidden>
Reviewed-by: Stefan Hajnoczi <address@hidden>
Reviewed-by: Kashyap Chamarthy <address@hidden>
Signed-off-by: Kevin Wolf <address@hidden>
---
qemu-img.texi | 9 +++++++++
1 file changed, 9 insertions(+)
diff --git a/qemu-img.texi b/qemu-img.texi
index fdcf120f36..bc24565ae9 100644
--- a/qemu-img.texi
+++ b/qemu-img.texi
@@ -57,6 +57,15 @@ exclusive with the @var{-O} parameters. It is currently
required to also use
the @var{-n} parameter to skip image creation. This restriction may be relaxed
in a future release.
address@hidden --force-share (-U)
+
+If specified, @code{qemu-img} will open the image with shared permissions,
+which makes it less likely to conflict with a running guest's permissions due
+to image locking. For example, this can be used to get the image information
+(with 'info' subcommand) when the image is used by a running guest. Note that
+this could produce inconsistent results because of concurrent metadata changes,
+etc. This option is only allowed when opening images in read-only mode.
+
@item fmt
is the disk image format. It is guessed automatically in most cases. See below
for a description of the supported disk formats.
--
2.13.6
- [Qemu-devel] [PULL 02/14] block: Formats don't need CONSISTENT_READ with NO_IO, (continued)
- [Qemu-devel] [PULL 02/14] block: Formats don't need CONSISTENT_READ with NO_IO, Kevin Wolf, 2017/12/20
- [Qemu-devel] [PULL 03/14] iotests: fix 197 for vpc, Kevin Wolf, 2017/12/20
- [Qemu-devel] [PULL 04/14] block: Make bdrv_drain_invoke() recursive, Kevin Wolf, 2017/12/20
- [Qemu-devel] [PULL 05/14] block: Call .drain_begin only once in bdrv_drain_all_begin(), Kevin Wolf, 2017/12/20
- [Qemu-devel] [PULL 06/14] test-bdrv-drain: Test BlockDriver callbacks for drain, Kevin Wolf, 2017/12/20
- [Qemu-devel] [PULL 07/14] block: bdrv_drain_recurse(): Remove unused begin parameter, Kevin Wolf, 2017/12/20
- [Qemu-devel] [PULL 08/14] block: Don't wait for requests in bdrv_drain*_end(), Kevin Wolf, 2017/12/20
- [Qemu-devel] [PULL 09/14] block: Unify order in drain functions, Kevin Wolf, 2017/12/20
- [Qemu-devel] [PULL 12/14] qcow2: get rid of qcow2_backing_read1 routine, Kevin Wolf, 2017/12/20
- [Qemu-devel] [PULL 11/14] block: Don't acquire AioContext in hmp_qemu_io(), Kevin Wolf, 2017/12/20
- [Qemu-devel] [PULL 10/14] qemu-img: Document --force-share / -U,
Kevin Wolf <=
- [Qemu-devel] [PULL 13/14] block: Document that x-blockdev-change breaks quorum children list, Kevin Wolf, 2017/12/20
- [Qemu-devel] [PULL 14/14] nvme: Add tracing, Kevin Wolf, 2017/12/20
- Re: [Qemu-devel] [PULL 00/14] Block layer patches, Peter Maydell, 2017/12/20