aboutsummaryrefslogtreecommitdiff
path: root/qemu-deprecated.texi
diff options
context:
space:
mode:
authorKevin Wolf <kwolf@redhat.com>2019-08-09 11:09:21 +0200
committerKevin Wolf <kwolf@redhat.com>2019-08-16 10:25:16 +0200
commitffd8e8ffd5410ecea17c62785bf445b7ecddd8d6 (patch)
tree3670000e635382419fbc7bee20a13c1e71a53d50 /qemu-deprecated.texi
parentcf3129323f900ef5ddbccbe86e4fa801e88c566e (diff)
qemu-img convert: Deprecate using -n and -o together
bdrv_create options specified with -o have no effect when skipping image creation with -n, so this doesn't make sense. Warn against the misuse and deprecate the combination so we can make it a hard error later. Signed-off-by: Kevin Wolf <kwolf@redhat.com> Reviewed-by: Max Reitz <mreitz@redhat.com> Reviewed-by: John Snow <jsnow@redhat.com> Reviewed-by: Eric Blake <eblake@redhat.com>
Diffstat (limited to 'qemu-deprecated.texi')
-rw-r--r--qemu-deprecated.texi7
1 files changed, 7 insertions, 0 deletions
diff --git a/qemu-deprecated.texi b/qemu-deprecated.texi
index fff07bb2a3..f7680c08e1 100644
--- a/qemu-deprecated.texi
+++ b/qemu-deprecated.texi
@@ -305,6 +305,13 @@ to just export the entire image and then mount only /dev/nbd0p1 than
it is to reinvoke @command{qemu-nbd -c /dev/nbd0} limited to just a
subset of the image.
+@subsection qemu-img convert -n -o (since 4.2.0)
+
+All options specified in @option{-o} are image creation options, so
+they have no effect when used with @option{-n} to skip image creation.
+Silently ignored options can be confusing, so this combination of
+options will be made an error in future versions.
+
@section Build system
@subsection Python 2 support (since 4.1.0)