qemu-options.hx: clarify default audio backend selection
Reviewed-by: Mark Cave-Ayland <mark.caveayland@nutanix.com> Reviewed-by: Akihiko Odaki <odaki@rsg.ci.i.u-tokyo.ac.jp> Signed-off-by: Marc-André Lureau <marcandre.lureau@redhat.com>
Marc-André Lureau committed
Dec 1, 2025 at 10:48 UTC
5ef9ae1fd5218ffe2c3d41f5ff4fe2266f9c8bea
1 file changed
+18
-7
qemu-options.hx
+18
-7
@@ -896,11 +896,16 @@ DEF("audiodev", HAS_ARG, QEMU_OPTION_audiodev,
896
QEMU_ARCH_ALL)
897
SRST
898
``-audiodev [driver=]driver,id=id[,prop[=value][,...]]``
899
- Adds a new audio backend driver identified by id. There are global
900
- and driver specific properties. Some values can be set differently
901
- for input and output, they're marked with ``in|out.``. You can set
902
- the input's property with ``in.prop`` and the output's property with
903
- ``out.prop``. For example:
899
+ Adds a new audio backend driver identified by id.
900
+
901
+ If no audio backend is specified, QEMU will attempt to select a
902
+ default one. The ``-display`` option may influence which backend is
903
+ selected.
904
+
905
+ There are global and driver specific properties. Some values can be
906
+ set differently for input and output, they're marked with ``in|out.``.
907
+ You can set the input's property with ``in.prop`` and the output's
908
+ property with ``out.prop``. For example:
909
910
::
911
@@ -2198,8 +2203,11 @@ DEF("display", HAS_ARG, QEMU_OPTION_display,
2203
, QEMU_ARCH_ALL)
2204
SRST
2205
``-display type``
2201
- Select type of display to use. Use ``-display help`` to list the available
2202
- display types. Valid values for type are
2206
+ Select type of display to use. This may also influence the default
2207
+ audio backend selection.
2208
+
2209
+ Use ``-display help`` to list the available display types. Valid values
2210
+ for type are
2211
2212
``spice-app[,gl=on|off]``
2213
Start QEMU as a Spice server and launch the default Spice client
@@ -2209,6 +2217,9 @@ SRST
2217
``dbus``
2218
Export the display over D-Bus interfaces. (Since 7.0)
2219
2220
+ If no audio backend is specified and the dbus display backend is
2221
+ specified, the dbus audio backend is used by default.
2222
+
2223
The connection is registered with the "org.qemu" name (and queued when
2224
already owned).
2225