Commit e4c7ebde64 for qemu.org
commit e4c7ebde643811e8dc1f640b50f37ad0a0dd1dac
Author: uchouT <i@uchout.moe>
Date: Sat May 9 17:48:01 2026 +0800
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>
diff --git a/qemu-options.hx b/qemu-options.hx
index 5387bcd751..96ae41f787 100644
--- a/qemu-options.hx
+++ b/qemu-options.hx
@@ -4077,6 +4077,9 @@ DEF("chardev", HAS_ARG, QEMU_OPTION_chardev,
#if defined(CONFIG_SPICE)
"-chardev spicevmc,id=id,name=name[,debug=debug][,logfile=PATH][,logappend=on|off]\n"
"-chardev spiceport,id=id,name=name[,debug=debug][,logfile=PATH][,logappend=on|off]\n"
+#endif
+#if defined(CONFIG_DBUS_DISPLAY)
+ "-chardev dbus,id=id,name=name[,mux=on|off][,logfile=PATH][,logappend=on|off]\n"
#endif
, QEMU_ARCH_ALL
)
@@ -4088,8 +4091,8 @@ The general form of a character device option is:
Backend is one of: ``null``, ``socket``, ``udp``, ``msmouse``, ``hub``,
``vc``, ``ringbuf``, ``file``, ``pipe``, ``console``, ``serial``,
``pty``, ``stdio``, ``braille``, ``parallel``,
- ``spicevmc``, ``spiceport``. The specific backend will determine the
- applicable options.
+ ``spicevmc``, ``spiceport``, ``dbus``. The specific backend will
+ determine the applicable options.
Use ``-chardev help`` to print all available chardev backend types.
@@ -4408,6 +4411,15 @@ The available backends are:
Connect to a spice port, allowing a Spice client to handle the
traffic identified by a name (preferably a fqdn).
+
+``-chardev dbus,id=id,name=name``
+ ``dbus`` is only available when D-Bus display support is built in.
+
+ ``name`` name of the chardev as exported on the D-Bus display
+ interface
+
+ Export the character device on the D-Bus display interface, so that
+ a D-Bus client can connect to it.
ERST
DEFHEADING()