[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [PATCH 11/11] Deprecate stable non-JSON -device and -object
From: |
Eric Blake |
Subject: |
Re: [PATCH 11/11] Deprecate stable non-JSON -device and -object |
Date: |
Fri, 24 Sep 2021 14:02:03 -0500 |
User-agent: |
NeoMutt/20210205-773-8890a5 |
On Fri, Sep 24, 2021 at 11:04:27AM +0200, Kevin Wolf wrote:
> We want to switch both from QemuOpts to the keyval parser in the future,
> which results in some incompatibilities, mainly around list handling.
> Mark the non-JSON version of both as unstable syntax so that management
> tools switch to JSON and we can later make the change without breaking
> things.
>
> Signed-off-by: Kevin Wolf <kwolf@redhat.com>
> ---
> docs/about/deprecated.rst | 11 +++++++++++
> 1 file changed, 11 insertions(+)
Reviewed-by: Eric Blake <eblake@redhat.com>
>
> diff --git a/docs/about/deprecated.rst b/docs/about/deprecated.rst
> index 3c2be84d80..42f6a478fb 100644
> --- a/docs/about/deprecated.rst
> +++ b/docs/about/deprecated.rst
> @@ -160,6 +160,17 @@ Use ``-display sdl`` instead.
>
> Use ``-display curses`` instead.
>
> +Stable non-JSON ``-device`` and ``-object`` syntax (since 6.2)
> +''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
> +
> +If you rely on a stable interface for ``-device`` and ``-object`` that
> doesn't
> +change incompatibly between QEMU versions (e.g. because you are using the
> QEMU
> +command line as a machine interface in scripts rather than interactively),
> use
> +JSON syntax for these options instead.
> +
> +There is no intention to remove support for non-JSON syntax entirely, but
> +future versions may change the way to spell some options.
> +
>
> Plugin argument passing through ``arg=<string>`` (since 6.1)
> ''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
> --
> 2.31.1
>
--
Eric Blake, Principal Software Engineer
Red Hat, Inc. +1-919-301-3266
Virtualization: qemu.org | libvirt.org
- [PATCH 08/11] qdev: Base object creation on QDict rather than QemuOpts, (continued)
- [PATCH 08/11] qdev: Base object creation on QDict rather than QemuOpts, Kevin Wolf, 2021/09/24
- [PATCH 07/11] qemu-option: Allow deleting opts during qemu_opts_foreach(), Kevin Wolf, 2021/09/24
- [PATCH 06/11] qdev: Add Error parameter to qdev_set_id(), Kevin Wolf, 2021/09/24
- [PATCH 10/11] vl: Enable JSON syntax for -device, Kevin Wolf, 2021/09/24
- [PATCH 11/11] Deprecate stable non-JSON -device and -object, Kevin Wolf, 2021/09/24
- Re: [PATCH 11/11] Deprecate stable non-JSON -device and -object, Peter Maydell, 2021/09/27
[PATCH 09/11] qdev: Avoid QemuOpts in QMP device_add, Kevin Wolf, 2021/09/24