aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorKevin Wolf <kwolf@redhat.com>2012-08-16 10:56:35 +0200
committerKevin Wolf <kwolf@redhat.com>2012-08-17 21:29:15 +0200
commit48467328c6dccc9c7be6628ed0ef0810f83be2a9 (patch)
treeadd18f65f9cde9cdd960d84e5e8082ff4fe82372
parent65bd155c7356d448ffee7f89149c4d473076b0ba (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>
-rw-r--r--qemu-img.texi10
1 files changed, 10 insertions, 0 deletions
diff --git a/qemu-img.texi b/qemu-img.texi
index 77c6d0b6b0..6b42e35fe7 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: