qapi/char: Deprecate backend type "memory"

It's an alias for "ringbuf" we kept for backward compatibility; see
commit 3a1da42eb3 (qapi: Rename ChardevBackend member "memory" to
"ringbuf").  Deprecation is long overdue.

Signed-off-by: Markus Armbruster <armbru@redhat.com>
Message-ID: <20240203080228.2766159-5-armbru@redhat.com>
Reviewed-by: Marc-André Lureau <marcandre.lureau@redhat.com>
Reviewed-by: Ján Tomko <jtomko@redhat.com>
Reviewed-by: Eric Blake <eblake@redhat.com>
This commit is contained in:
Markus Armbruster 2024-02-03 09:02:28 +01:00
parent 563799f6c0
commit b04c12282b
2 changed files with 13 additions and 3 deletions

View file

@ -380,6 +380,14 @@ Specifying the iSCSI password in plain text on the command line using the
used instead, to refer to a ``--object secret...`` instance that provides used instead, to refer to a ``--object secret...`` instance that provides
a password via a file, or encrypted. a password via a file, or encrypted.
Character device options
''''''''''''''''''''''''
Backend ``memory`` (since 9.0)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
``memory`` is a deprecated synonym for ``ringbuf``.
CPU device properties CPU device properties
''''''''''''''''''''' '''''''''''''''''''''

View file

@ -468,6 +468,10 @@
# #
# @memory: Since 1.5 # @memory: Since 1.5
# #
# Features:
#
# @deprecated: Member @memory is deprecated. Use @ringbuf instead.
#
# Since: 1.4 # Since: 1.4
## ##
{ 'enum': 'ChardevBackendKind', { 'enum': 'ChardevBackendKind',
@ -492,8 +496,7 @@
{ 'name': 'dbus', 'if': 'CONFIG_DBUS_DISPLAY' }, { 'name': 'dbus', 'if': 'CONFIG_DBUS_DISPLAY' },
'vc', 'vc',
'ringbuf', 'ringbuf',
# next one is just for compatibility { 'name': 'memory', 'features': [ 'deprecated' ] } ] }
'memory' ] }
## ##
# @ChardevFileWrapper: # @ChardevFileWrapper:
@ -642,7 +645,6 @@
'if': 'CONFIG_DBUS_DISPLAY' }, 'if': 'CONFIG_DBUS_DISPLAY' },
'vc': 'ChardevVCWrapper', 'vc': 'ChardevVCWrapper',
'ringbuf': 'ChardevRingbufWrapper', 'ringbuf': 'ChardevRingbufWrapper',
# next one is just for compatibility
'memory': 'ChardevRingbufWrapper' } } 'memory': 'ChardevRingbufWrapper' } }
## ##