On 06/02/2026 13:04, Marc-André Lureau wrote:

Hi

On Thu, Feb 5, 2026 at 8:19 PM Mark Cave-Ayland
<[email protected]> wrote:

On 04/02/2026 12:27, Marc-André Lureau wrote:

Hi Mark

On Tue, Feb 3, 2026 at 7:49 PM Mark Cave-Ayland
<[email protected]> wrote:

On 23/01/2026 07:49, [email protected] wrote:

From: Marc-André Lureau <[email protected]>

Signed-off-by: Marc-André Lureau <[email protected]>
---
    qemu-options.hx | 22 +++++++++++++++-------
    1 file changed, 15 insertions(+), 7 deletions(-)

diff --git a/qemu-options.hx b/qemu-options.hx
index 455b8be8903..732934a6fa8 100644
--- a/qemu-options.hx
+++ b/qemu-options.hx
@@ -896,11 +896,16 @@ DEF("audiodev", HAS_ARG, QEMU_OPTION_audiodev,
        QEMU_ARCH_ALL)
    SRST
    ``-audiodev [driver=]driver,id=id[,prop[=value][,...]]``
-    Adds a new audio backend driver identified by id. There are global
-    and driver specific properties. Some values can be set differently
-    for input and output, they're marked with ``in|out.``. You can set
-    the input's property with ``in.prop`` and the output's property with
-    ``out.prop``. For example:
+    Adds a new audio backend driver identified by id.
+
+    If no audio backend is specified, QEMU will attempt to select a
+    default one. The ``-display`` option may influence which backend is
+    selected.
+
+    There are global and driver specific properties. Some values can be
+    set differently for input and output, they're marked with ``in|out.``.
+    You can set the input's property with ``in.prop`` and the output's
+    property with ``out.prop``. For example:

        ::

@@ -2172,8 +2177,11 @@ DEF("display", HAS_ARG, QEMU_OPTION_display,
        , QEMU_ARCH_ALL)
    SRST
    ``-display type``
-    Select type of display to use. Use ``-display help`` to list the available
-    display types. Valid values for type are
+    Select type of display to use. This may also influence the default
+    audio backend selection.
+
+    Use ``-display help`` to list the available display types. Valid values
+    for type are

        ``spice-app[,gl=on|off]``
            Start QEMU as a Spice server and launch the default Spice client

The documentation changes look fine in terms of describing how one
option may influence the other, however there is no explicit mention in
the documentation that selecting a dbus display with no audio backend
will also use dbus for audio.

Is it possible to mention this somewhere? Otherwise someone would have
to go digging through the code to figure this out.

would something like that help?

@@ -2191,6 +2192,9 @@ SRST
       ``dbus``
           Export the display over D-Bus interfaces. (Since 7.0)

+        When no audio backend is specified, the dbus audio backend is used
+        by default.
+

That definitely helps. Is it possible to tweak the wording to something
along the lines of:

If no audio backend is specified and the dbus display backend is
specified, the dbus audio backend is used by default.


ok

Another question: is there any documentation for -audiodev dbus and its
properties anywhere at all? I had a look at
https://urldefense.proofpoint.com/v2/url?u=https-3A__qemu.readthedocs.io_en_master_system_invocation.html&d=DwIFaQ&c=s883GpUCOChKOHiocYtGcg&r=c23RpsaH4D2MKyD3EPJTDa0BAxz6tV8aUJqVSoytEiY&m=YVTDyodBF4JmdX2qwmxSr6fpEy1WbzwM7Ovk8-n_tAoAcJd6plea1zQTWirWJSgL&s=PSJ5e8WKwy1qjmONVgXjGeBQJi2e0gzgIP5I95felxE&e=
  but I can't
see an entry for it in the audiodev section anywhere?

Good catch, what about?:

+``-audiodev dbus,id=id[,prop[=value][,...]]``
+    Creates a D-Bus backend. It must be associated with the display
+    (as ``-display dbus,audiodev=id``). (Since 7.0)
+
+    D-Bus specific options are:
+
+    ``nsamples``
+        Number of samples per read/write (default to 480, 10ms at 48kHz)
+        (Since 10.0)

Looks good to me - feel free to add a:

Reviewed-by: Mark Cave-Ayland <[email protected]>


ATB,

Mark.


Reply via email to