From: Eric Blake <eblake@redhat.com>
To: Kevin Wolf <kwolf@redhat.com>
Cc: pkrempa@redhat.com, ehabkost@redhat.com, qemu-block@nongnu.org,
libvir-list@redhat.com, armbru@redhat.com, qemu-devel@nongnu.org,
its@irrelevant.dk, pbonzini@redhat.com
Subject: Re: [PATCH 11/11] Deprecate stable non-JSON -device and -object
Date: Fri, 24 Sep 2021 14:02:03 -0500 [thread overview]
Message-ID: <20210924190203.igztisq2k5o2rs5y@redhat.com> (raw)
In-Reply-To: <20210924090427.9218-12-kwolf@redhat.com>
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
next prev parent reply other threads:[~2021-09-24 19:08 UTC|newest]
Thread overview: 49+ messages / expand[flat|nested] mbox.gz Atom feed top
2021-09-24 9:04 [PATCH 00/11] qdev: Add JSON -device and fix QMP device_add Kevin Wolf
2021-09-24 9:04 ` [PATCH 01/11] qom: Reduce use of error_propagate() Kevin Wolf
2021-09-24 13:23 ` Vladimir Sementsov-Ogievskiy
2021-09-24 14:04 ` Markus Armbruster
2021-09-24 18:14 ` Eric Blake
2021-09-24 9:04 ` [PATCH 02/11] iotests/245: Fix type for iothread property Kevin Wolf
2021-09-24 13:33 ` Vladimir Sementsov-Ogievskiy
2021-09-24 9:04 ` [PATCH 03/11] iotests/051: Fix typo Kevin Wolf
2021-09-24 13:35 ` Vladimir Sementsov-Ogievskiy
2021-09-24 9:04 ` [PATCH 04/11] qdev: Avoid using string visitor for properties Kevin Wolf
2021-09-24 18:40 ` Eric Blake
2021-09-24 9:04 ` [PATCH 05/11] qdev: Make DeviceState.id independent of QemuOpts Kevin Wolf
2021-09-24 14:02 ` Vladimir Sementsov-Ogievskiy
2021-09-24 15:10 ` Kevin Wolf
2021-09-24 15:14 ` Vladimir Sementsov-Ogievskiy
2021-09-24 9:04 ` [PATCH 06/11] qdev: Add Error parameter to qdev_set_id() Kevin Wolf
2021-09-24 14:09 ` Vladimir Sementsov-Ogievskiy
2021-09-27 10:33 ` Damien Hedde
2021-10-05 11:09 ` Kevin Wolf
2021-09-24 9:04 ` [PATCH 07/11] qemu-option: Allow deleting opts during qemu_opts_foreach() Kevin Wolf
2021-09-24 14:14 ` Vladimir Sementsov-Ogievskiy
2021-09-24 9:04 ` [PATCH 08/11] qdev: Base object creation on QDict rather than QemuOpts Kevin Wolf
2021-09-24 18:53 ` Eric Blake
2021-09-24 9:04 ` [PATCH 09/11] qdev: Avoid QemuOpts in QMP device_add Kevin Wolf
2021-09-24 18:56 ` Eric Blake
2021-09-27 11:06 ` Damien Hedde
2021-09-27 11:39 ` Kevin Wolf
2021-10-05 14:37 ` Kevin Wolf
2021-10-05 15:52 ` Damien Hedde
2021-10-05 17:33 ` Kevin Wolf
2021-10-06 8:21 ` Juan Quintela
2021-10-06 9:20 ` Laurent Vivier
2021-10-06 10:53 ` Kevin Wolf
2021-10-06 11:09 ` Laurent Vivier
2021-10-01 14:42 ` Peter Krempa
2021-10-04 12:18 ` Damien Hedde
2021-10-04 14:22 ` Kevin Wolf
2021-09-24 9:04 ` [PATCH 10/11] vl: Enable JSON syntax for -device Kevin Wolf
2021-09-24 19:00 ` Eric Blake
2021-09-24 9:04 ` [PATCH 11/11] Deprecate stable non-JSON -device and -object Kevin Wolf
2021-09-24 19:02 ` Eric Blake [this message]
2021-09-27 8:15 ` Paolo Bonzini
2021-09-27 8:21 ` Daniel P. Berrangé
2021-09-27 10:17 ` Kevin Wolf
2021-09-27 10:37 ` Daniel P. Berrangé
2021-09-27 9:00 ` Peter Maydell
2021-09-27 11:27 ` Kevin Wolf
2021-09-27 12:52 ` Peter Maydell
2021-09-27 16:10 ` Kevin Wolf
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20210924190203.igztisq2k5o2rs5y@redhat.com \
--to=eblake@redhat.com \
--cc=armbru@redhat.com \
--cc=ehabkost@redhat.com \
--cc=its@irrelevant.dk \
--cc=kwolf@redhat.com \
--cc=libvir-list@redhat.com \
--cc=pbonzini@redhat.com \
--cc=pkrempa@redhat.com \
--cc=qemu-block@nongnu.org \
--cc=qemu-devel@nongnu.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.