diff options
| author | Alex Bennée | 2022-08-22 18:56:08 +0200 |
|---|---|---|
| committer | Alex Bennée | 2022-08-24 11:14:49 +0200 |
| commit | 5af2b0f6eace7b368ed5cad9677e3bc995b6a7e3 (patch) | |
| tree | 6cf5946e646341898195c6ff60939b0c1bc3b0ef /qemu-options.hx | |
| parent | tests/qtest/migration-test: Remove duplicated test_postcopy from the test plan (diff) | |
| download | qemu-5af2b0f6eace7b368ed5cad9677e3bc995b6a7e3.tar.gz qemu-5af2b0f6eace7b368ed5cad9677e3bc995b6a7e3.tar.xz qemu-5af2b0f6eace7b368ed5cad9677e3bc995b6a7e3.zip | |
qemu-options: try and clarify preferred block semantics
Try to correct any confusion about QEMU's Byzantine disk options by
laying out the preferred "modern" options as-per:
"<danpb> (best: -device + -blockdev, 2nd obsolete syntax: -device +
-drive, 3rd obsolete syntax: -drive, 4th obsolete syntax: -hdNN)"
Signed-off-by: Alex Bennée <alex.bennee@linaro.org>
Acked-by: Kevin Wolf <kwolf@redhat.com>
Reviewed-by: Daniel P. Berrangé <berrange@redhat.com>
Cc: qemu-block@nongnu.org
Cc: Kevin Wolf <kwolf@redhat.com>
Cc: Hanna Reitz <hreitz@redhat.com>
Cc: Thomas Huth <thuth@redhat.com>
Message-Id: <20220822165608.2980552-7-alex.bennee@linaro.org>
Diffstat (limited to 'qemu-options.hx')
| -rw-r--r-- | qemu-options.hx | 13 |
1 files changed, 13 insertions, 0 deletions
diff --git a/qemu-options.hx b/qemu-options.hx index 3f23a42fa8..31c04f7eea 100644 --- a/qemu-options.hx +++ b/qemu-options.hx @@ -1105,6 +1105,19 @@ DEFHEADING() DEFHEADING(Block device options:) +SRST +The QEMU block device handling options have a long history and +have gone through several iterations as the feature set and complexity +of the block layer have grown. Many online guides to QEMU often +reference older and deprecated options, which can lead to confusion. + +The recommended modern way to describe disks is to use a combination of +``-device`` to specify the hardware device and ``-blockdev`` to +describe the backend. The device defines what the guest sees and the +backend describes how QEMU handles the data. + +ERST + DEF("fda", HAS_ARG, QEMU_OPTION_fda, "-fda/-fdb file use 'file' as floppy disk 0/1 image\n", QEMU_ARCH_ALL) DEF("fdb", HAS_ARG, QEMU_OPTION_fdb, "", QEMU_ARCH_ALL) |