qemu-options: document -chardev dbus
Document the dbus backend introduced in commit 3e301c8d7ef0 ("ui/dbus: add chardev backend & interface") Signed-off-by: uchouT <i@uchout.moe> Reviewed-by: Marc-André Lureau <marcandre.lureau@redhat.com> Message-ID: <20260509094801.111103-1-i@uchout.moe>
uchouT committed
May 9, 2026 at 17:48 UTC
e4c7ebde643811e8dc1f640b50f37ad0a0dd1dac
1 file changed
+14
-2
qemu-options.hx
+14
-2
@@ -4077,6 +4077,9 @@ DEF("chardev", HAS_ARG, QEMU_OPTION_chardev,
4077
#if defined(CONFIG_SPICE)
4078
"-chardev spicevmc,id=id,name=name[,debug=debug][,logfile=PATH][,logappend=on|off]\n"
4079
"-chardev spiceport,id=id,name=name[,debug=debug][,logfile=PATH][,logappend=on|off]\n"
4080
+#endif
4081
+#if defined(CONFIG_DBUS_DISPLAY)
4082
+ "-chardev dbus,id=id,name=name[,mux=on|off][,logfile=PATH][,logappend=on|off]\n"
4083
#endif
4084
, QEMU_ARCH_ALL
4085
)
@@ -4088,8 +4091,8 @@ The general form of a character device option is:
4091
Backend is one of: ``null``, ``socket``, ``udp``, ``msmouse``, ``hub``,
4092
``vc``, ``ringbuf``, ``file``, ``pipe``, ``console``, ``serial``,
4093
``pty``, ``stdio``, ``braille``, ``parallel``,
4091
- ``spicevmc``, ``spiceport``. The specific backend will determine the
4092
- applicable options.
4094
+ ``spicevmc``, ``spiceport``, ``dbus``. The specific backend will
4095
+ determine the applicable options.
4096
4097
Use ``-chardev help`` to print all available chardev backend types.
4098
@@ -4408,6 +4411,15 @@ The available backends are:
4411
4412
Connect to a spice port, allowing a Spice client to handle the
4413
traffic identified by a name (preferably a fqdn).
4414
+
4415
+``-chardev dbus,id=id,name=name``
4416
+ ``dbus`` is only available when D-Bus display support is built in.
4417
+
4418
+ ``name`` name of the chardev as exported on the D-Bus display
4419
+ interface
4420
+
4421
+ Export the character device on the D-Bus display interface, so that
4422
+ a D-Bus client can connect to it.
4423
ERST
4424
4425
DEFHEADING()