diff options
| author |   Kevin Wolf <kwolf@redhat.com> | 2012-08-16 10:56:35 +0200 |
|---|---|---|
| committer |   Michael Roth <mdroth@linux.vnet.ibm.com> | 2012-08-28 01:50:01 -0500 |
| commit | f946f010f5f7d6b13bf6acabffebe093b1c9949c (patch) | |
| tree | 96b8541500881eaae6aedd783876ce8c515a36ed | |
| parent | d438650fa512f944ca4af1a08ab132712c50b684 (diff) | |
Documentation: Warn against qemu-img on active image
People have repeatedly expected that you can do things like snapshotting
an image with qemu-img while a qemu instance is running. Maybe we need
to consider locking the files while they are in use, but having a
warning in the qemu-img manpage is doable for 1.2 and can't hurt anyway.
Signed-off-by: Kevin Wolf <kwolf@redhat.com>
(cherry picked from commit 48467328c6dccc9c7be6628ed0ef0810f83be2a9)
Signed-off-by: Michael Roth <mdroth@linux.vnet.ibm.com>
| -rw-r--r-- | qemu-img.texi | 10 |
1 files changed, 10 insertions, 0 deletions
diff --git a/qemu-img.texi b/qemu-img.texi index 9cee2eaa6..482c21b39 100644 --- a/qemu-img.texi +++ b/qemu-img.texi @@ -4,6 +4,16 @@ usage: qemu-img command [command options] @c man end @end example +@c man begin DESCRIPTION +qemu-img allows you to create, convert and modify images offline. It can handle +all image formats supported by QEMU. + +@b{Warning:} Never use qemu-img to modify images in use by a running virtual +machine or any other process; this may destroy the image. Also, be aware that +querying an image that is being modified by another process may encounter +inconsistent state. +@c man end + @c man begin OPTIONS The following commands are supported: |