[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [RFC PATCH] qemu-options: try and clarify preferred block semantics
From: |
Peter Maydell |
Subject: |
Re: [RFC PATCH] qemu-options: try and clarify preferred block semantics |
Date: |
Mon, 22 Aug 2022 11:42:34 +0100 |
On Fri, 19 Aug 2022 at 19:10, Alex Bennée <alex.bennee@linaro.org> wrote:
>
> 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>
> Cc: qemu-block@nongnu.org
> Cc: Kevin Wolf <kwolf@redhat.com>
> Cc: Hanna Reitz <hreitz@redhat.com>
> Cc: Daniel P. Berrange <berrange@redhat.com>
> Cc: Thomas Huth <thuth@redhat.com>
> ---
> qemu-options.hx | 13 +++++++++++++
> 1 file changed, 13 insertions(+)
>
> diff --git a/qemu-options.hx b/qemu-options.hx
> index 3f23a42fa8..d57239d364 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.
"options, "
> +
> +The recommended modern way to describe disks is to use combination of
"a combination"
> +``-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.
thanks
-- PMM