ui/dbus: add chardev backend & interface

Add a new chardev backend which allows D-Bus client to handle the
chardev stream & events.

Signed-off-by: Marc-André Lureau <marcandre.lureau@redhat.com>
Acked-by: Gerd Hoffmann <kraxel@redhat.com>
staging
Marc-André Lureau 2021-07-22 19:43:29 +04:00
parent 4085b87ff0
commit 3e301c8d7e
8 changed files with 476 additions and 0 deletions

View File

@ -43,6 +43,8 @@ typedef enum {
TCP_CHARDEV_STATE_CONNECTED,
} TCPChardevState;
typedef ChardevClass SocketChardevClass;
struct SocketChardev {
Chardev parent;
QIOChannel *ioc; /* Client I/O channel */

View File

@ -12,6 +12,11 @@
#include <gio/gio.h>
#include "qom/object.h"
#include "chardev/char.h"
#include "qemu/notify.h"
#include "qemu/typedefs.h"
/* glib/gio 2.68 */
#define DBUS_METHOD_INVOCATION_HANDLED TRUE
#define DBUS_METHOD_INVOCATION_UNHANDLED FALSE

View File

@ -358,6 +358,20 @@
'base': 'ChardevCommon',
'if': 'CONFIG_SPICE' }
##
# @ChardevDBus:
#
# Configuration info for DBus chardevs.
#
# @name: name of the channel (following docs/spice-port-fqdn.txt)
#
# Since: 7.0
##
{ 'struct': 'ChardevDBus',
'data': { 'name': 'str' },
'base': 'ChardevCommon',
'if': 'CONFIG_DBUS_DISPLAY' }
##
# @ChardevVC:
#
@ -422,6 +436,7 @@
# @spicevmc: Since 1.5
# @spiceport: Since 1.5
# @qemu-vdagent: Since 6.1
# @dbus: Since 7.0
# @vc: v1.5
# @ringbuf: Since 1.6
# @memory: Since 1.5
@ -447,6 +462,7 @@
{ 'name': 'spicevmc', 'if': 'CONFIG_SPICE' },
{ 'name': 'spiceport', 'if': 'CONFIG_SPICE' },
{ 'name': 'qemu-vdagent', 'if': 'CONFIG_SPICE_PROTOCOL' },
{ 'name': 'dbus', 'if': 'CONFIG_DBUS_DISPLAY' },
'vc',
'ringbuf',
# next one is just for compatibility
@ -535,6 +551,15 @@
'data': { 'data': 'ChardevQemuVDAgent' },
'if': 'CONFIG_SPICE_PROTOCOL' }
##
# @ChardevDBusWrapper:
#
# Since: 7.0
##
{ 'struct': 'ChardevDBusWrapper',
'data': { 'data': 'ChardevDBus' },
'if': 'CONFIG_DBUS_DISPLAY' }
##
# @ChardevVCWrapper:
#
@ -582,6 +607,8 @@
'if': 'CONFIG_SPICE' },
'qemu-vdagent': { 'type': 'ChardevQemuVDAgentWrapper',
'if': 'CONFIG_SPICE_PROTOCOL' },
'dbus': { 'type': 'ChardevDBusWrapper',
'if': 'CONFIG_DBUS_DISPLAY' },
'vc': 'ChardevVCWrapper',
'ringbuf': 'ChardevRingbufWrapper',
# next one is just for compatibility

296
ui/dbus-chardev.c 100644
View File

@ -0,0 +1,296 @@
/*
* QEMU DBus display
*
* Copyright (c) 2021 Marc-André Lureau <marcandre.lureau@redhat.com>
*
* Permission is hereby granted, free of charge, to any person obtaining a copy
* of this software and associated documentation files (the "Software"), to deal
* in the Software without restriction, including without limitation the rights
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
* copies of the Software, and to permit persons to whom the Software is
* furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in
* all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
* THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
* THE SOFTWARE.
*/
#include "qemu/osdep.h"
#include "trace.h"
#include "qapi/error.h"
#include "qemu/config-file.h"
#include "qemu/option.h"
#include <gio/gunixfdlist.h>
#include "dbus.h"
static char *
dbus_display_chardev_path(DBusChardev *chr)
{
return g_strdup_printf(DBUS_DISPLAY1_ROOT "/Chardev_%s",
CHARDEV(chr)->label);
}
static void
dbus_display_chardev_export(DBusDisplay *dpy, DBusChardev *chr)
{
g_autoptr(GDBusObjectSkeleton) sk = NULL;
g_autofree char *path = dbus_display_chardev_path(chr);
if (chr->exported) {
return;
}
sk = g_dbus_object_skeleton_new(path);
g_dbus_object_skeleton_add_interface(
sk, G_DBUS_INTERFACE_SKELETON(chr->iface));
g_dbus_object_manager_server_export(dpy->server, sk);
chr->exported = true;
}
static void
dbus_display_chardev_unexport(DBusDisplay *dpy, DBusChardev *chr)
{
g_autofree char *path = dbus_display_chardev_path(chr);
if (!chr->exported) {
return;
}
g_dbus_object_manager_server_unexport(dpy->server, path);
chr->exported = false;
}
static int
dbus_display_chardev_foreach(Object *obj, void *data)
{
DBusDisplay *dpy = DBUS_DISPLAY(data);
if (!CHARDEV_IS_DBUS(obj)) {
return 0;
}
dbus_display_chardev_export(dpy, DBUS_CHARDEV(obj));
return 0;
}
static void
dbus_display_on_notify(Notifier *notifier, void *data)
{
DBusDisplay *dpy = container_of(notifier, DBusDisplay, notifier);
DBusDisplayEvent *event = data;
switch (event->type) {
case DBUS_DISPLAY_CHARDEV_OPEN:
dbus_display_chardev_export(dpy, event->chardev);
break;
case DBUS_DISPLAY_CHARDEV_CLOSE:
dbus_display_chardev_unexport(dpy, event->chardev);
break;
}
}
void
dbus_chardev_init(DBusDisplay *dpy)
{
dpy->notifier.notify = dbus_display_on_notify;
dbus_display_notifier_add(&dpy->notifier);
object_child_foreach(container_get(object_get_root(), "/chardevs"),
dbus_display_chardev_foreach, dpy);
}
static gboolean
dbus_chr_register(
DBusChardev *dc,
GDBusMethodInvocation *invocation,
GUnixFDList *fd_list,
GVariant *arg_stream,
QemuDBusDisplay1Chardev *object)
{
g_autoptr(GError) err = NULL;
int fd;
fd = g_unix_fd_list_get(fd_list, g_variant_get_handle(arg_stream), &err);
if (err) {
g_dbus_method_invocation_return_error(
invocation,
DBUS_DISPLAY_ERROR,
DBUS_DISPLAY_ERROR_FAILED,
"Couldn't get peer FD: %s", err->message);
return DBUS_METHOD_INVOCATION_HANDLED;
}
if (qemu_chr_add_client(CHARDEV(dc), fd) < 0) {
g_dbus_method_invocation_return_error(invocation,
DBUS_DISPLAY_ERROR,
DBUS_DISPLAY_ERROR_FAILED,
"Couldn't register FD!");
close(fd);
return DBUS_METHOD_INVOCATION_HANDLED;
}
g_object_set(dc->iface,
"owner", g_dbus_method_invocation_get_sender(invocation),
NULL);
qemu_dbus_display1_chardev_complete_register(object, invocation, NULL);
return DBUS_METHOD_INVOCATION_HANDLED;
}
static gboolean
dbus_chr_send_break(
DBusChardev *dc,
GDBusMethodInvocation *invocation,
QemuDBusDisplay1Chardev *object)
{
qemu_chr_be_event(CHARDEV(dc), CHR_EVENT_BREAK);
qemu_dbus_display1_chardev_complete_send_break(object, invocation);
return DBUS_METHOD_INVOCATION_HANDLED;
}
static void
dbus_chr_open(Chardev *chr, ChardevBackend *backend,
bool *be_opened, Error **errp)
{
ERRP_GUARD();
DBusChardev *dc = DBUS_CHARDEV(chr);
DBusDisplayEvent event = {
.type = DBUS_DISPLAY_CHARDEV_OPEN,
.chardev = dc,
};
g_autoptr(ChardevBackend) be = NULL;
g_autoptr(QemuOpts) opts = NULL;
dc->iface = qemu_dbus_display1_chardev_skeleton_new();
g_object_set(dc->iface, "name", backend->u.dbus.data->name, NULL);
g_object_connect(dc->iface,
"swapped-signal::handle-register",
dbus_chr_register, dc,
"swapped-signal::handle-send-break",
dbus_chr_send_break, dc,
NULL);
dbus_display_notify(&event);
be = g_new0(ChardevBackend, 1);
opts = qemu_opts_create(qemu_find_opts("chardev"), NULL, 0, &error_abort);
qemu_opt_set(opts, "server", "on", &error_abort);
qemu_opt_set(opts, "wait", "off", &error_abort);
CHARDEV_CLASS(object_class_by_name(TYPE_CHARDEV_SOCKET))->parse(
opts, be, errp);
if (*errp) {
return;
}
CHARDEV_CLASS(object_class_by_name(TYPE_CHARDEV_SOCKET))->open(
chr, be, be_opened, errp);
}
static void
dbus_chr_set_fe_open(Chardev *chr, int fe_open)
{
DBusChardev *dc = DBUS_CHARDEV(chr);
g_object_set(dc->iface, "feopened", fe_open, NULL);
}
static void
dbus_chr_set_echo(Chardev *chr, bool echo)
{
DBusChardev *dc = DBUS_CHARDEV(chr);
g_object_set(dc->iface, "echo", echo, NULL);
}
static void
dbus_chr_be_event(Chardev *chr, QEMUChrEvent event)
{
DBusChardev *dc = DBUS_CHARDEV(chr);
DBusChardevClass *klass = DBUS_CHARDEV_GET_CLASS(chr);
switch (event) {
case CHR_EVENT_CLOSED:
if (dc->iface) {
/* on finalize, iface is set to NULL */
g_object_set(dc->iface, "owner", "", NULL);
}
break;
default:
break;
};
klass->parent_chr_be_event(chr, event);
}
static void
dbus_chr_parse(QemuOpts *opts, ChardevBackend *backend,
Error **errp)
{
const char *name = qemu_opt_get(opts, "name");
ChardevDBus *dbus;
if (name == NULL) {
error_setg(errp, "chardev: dbus: no name given");
return;
}
backend->type = CHARDEV_BACKEND_KIND_DBUS;
dbus = backend->u.dbus.data = g_new0(ChardevDBus, 1);
qemu_chr_parse_common(opts, qapi_ChardevDBus_base(dbus));
dbus->name = g_strdup(name);
}
static void
char_dbus_class_init(ObjectClass *oc, void *data)
{
DBusChardevClass *klass = DBUS_CHARDEV_CLASS(oc);
ChardevClass *cc = CHARDEV_CLASS(oc);
cc->parse = dbus_chr_parse;
cc->open = dbus_chr_open;
cc->chr_set_fe_open = dbus_chr_set_fe_open;
cc->chr_set_echo = dbus_chr_set_echo;
klass->parent_chr_be_event = cc->chr_be_event;
cc->chr_be_event = dbus_chr_be_event;
}
static void
char_dbus_finalize(Object *obj)
{
DBusChardev *dc = DBUS_CHARDEV(obj);
DBusDisplayEvent event = {
.type = DBUS_DISPLAY_CHARDEV_CLOSE,
.chardev = dc,
};
dbus_display_notify(&event);
g_clear_object(&dc->iface);
}
static const TypeInfo char_dbus_type_info = {
.name = TYPE_CHARDEV_DBUS,
.parent = TYPE_CHARDEV_SOCKET,
.class_size = sizeof(DBusChardevClass),
.instance_size = sizeof(DBusChardev),
.instance_finalize = char_dbus_finalize,
.class_init = char_dbus_class_init,
};
module_obj(TYPE_CHARDEV_DBUS);
static void
register_types(void)
{
type_register_static(&char_dbus_type_info);
}
type_init(register_types);

View File

@ -683,4 +683,79 @@
</arg>
</method>
</interface>
<!--
org.qemu.Display1.Chardev:
Character devices may be available on ``/org/qemu/Display1/Chardev_$id``.
They may be used for different kind of streams, which are identified via
their FQDN :dbus:prop:`Name`.
.. _dbus-chardev-fqdn:
Here are some known reserved kind names (the ``org.qemu`` prefix is
reserved by QEMU):
org.qemu.console.serial.0
A serial console stream.
org.qemu.monitor.hmp.0
A QEMU HMP human monitor.
org.qemu.monitor.qmp.0
A QEMU QMP monitor.
org.qemu.usbredir
A usbredir stream.
-->
<interface name="org.qemu.Display1.Chardev">
<!--
Register:
@stream: a Unix FD to redirect the stream to.
Register a file-descriptor for the stream handling.
The current handler, if any, will be replaced.
-->
<method name="Register">
<arg type="h" name="stream" direction="in"/>
</method>
<!--
SendBreak:
Send a break event to the character device.
-->
<method name="SendBreak"/>
<!--
Name:
The FQDN name to identify the kind of stream. See :ref:`reserved
names<dbus-chardev-fqdn>`.
-->
<property name="Name" type="s" access="read"/>
<!--
FEOpened:
Whether the front-end side is opened.
-->
<property name="FEOpened" type="b" access="read"/>
<!--
Echo:
Whether the input should be echo'ed (for serial streams).
-->
<property name="Echo" type="b" access="read"/>
<!--
Owner:
The D-Bus unique name of the registered handler.
-->
<property name="Owner" type="s" access="read"/>
</interface>
</node>

View File

@ -55,6 +55,27 @@ static const DisplayGLCtxOps dbus_gl_ops = {
.dpy_gl_ctx_make_current = qemu_egl_make_context_current,
};
static NotifierList dbus_display_notifiers =
NOTIFIER_LIST_INITIALIZER(dbus_display_notifiers);
void
dbus_display_notifier_add(Notifier *notifier)
{
notifier_list_add(&dbus_display_notifiers, notifier);
}
static void
dbus_display_notifier_remove(Notifier *notifier)
{
notifier_remove(notifier);
}
void
dbus_display_notify(DBusDisplayEvent *event)
{
notifier_list_notify(&dbus_display_notifiers, event);
}
static void
dbus_display_init(Object *o)
{
@ -73,6 +94,7 @@ dbus_display_init(Object *o)
g_dbus_object_manager_server_export(dd->server, vm);
dbus_clipboard_init(dd);
dbus_chardev_init(dd);
}
static void
@ -80,6 +102,10 @@ dbus_display_finalize(Object *o)
{
DBusDisplay *dd = DBUS_DISPLAY(o);
if (dd->notifier.notify) {
dbus_display_notifier_remove(&dd->notifier);
}
qemu_clipboard_peer_unregister(&dd->clipboard_peer);
g_clear_object(&dd->clipboard);

View File

@ -24,6 +24,7 @@
#ifndef UI_DBUS_H_
#define UI_DBUS_H_
#include "chardev/char-socket.h"
#include "qemu/dbus.h"
#include "qom/object.h"
#include "ui/console.h"
@ -56,11 +57,15 @@ struct DBusDisplay {
QemuDBusDisplay1Clipboard *clipboard;
QemuDBusDisplay1Clipboard *clipboard_proxy;
DBusClipboardRequest clipboard_request[QEMU_CLIPBOARD_SELECTION__COUNT];
Notifier notifier;
};
#define TYPE_DBUS_DISPLAY "dbus-display"
OBJECT_DECLARE_SIMPLE_TYPE(DBusDisplay, DBUS_DISPLAY)
void dbus_display_notifier_add(Notifier *notifier);
#define DBUS_DISPLAY_TYPE_CONSOLE dbus_display_console_get_type()
G_DECLARE_FINAL_TYPE(DBusDisplayConsole,
dbus_display_console,
@ -95,6 +100,45 @@ dbus_display_listener_get_bus_name(DBusDisplayListener *ddl);
extern const DisplayChangeListenerOps dbus_gl_dcl_ops;
extern const DisplayChangeListenerOps dbus_dcl_ops;
#define TYPE_CHARDEV_DBUS "chardev-dbus"
typedef struct DBusChardevClass {
SocketChardevClass parent_class;
void (*parent_chr_be_event)(Chardev *s, QEMUChrEvent event);
} DBusChardevClass;
DECLARE_CLASS_CHECKERS(DBusChardevClass, DBUS_CHARDEV,
TYPE_CHARDEV_DBUS)
typedef struct DBusChardev {
SocketChardev parent;
bool exported;
QemuDBusDisplay1Chardev *iface;
} DBusChardev;
DECLARE_INSTANCE_CHECKER(DBusChardev, DBUS_CHARDEV, TYPE_CHARDEV_DBUS)
#define CHARDEV_IS_DBUS(chr) \
object_dynamic_cast(OBJECT(chr), TYPE_CHARDEV_DBUS)
typedef enum {
DBUS_DISPLAY_CHARDEV_OPEN,
DBUS_DISPLAY_CHARDEV_CLOSE,
} DBusDisplayEventType;
typedef struct DBusDisplayEvent {
DBusDisplayEventType type;
union {
DBusChardev *chardev;
};
} DBusDisplayEvent;
void dbus_display_notify(DBusDisplayEvent *event);
void dbus_chardev_init(DBusDisplay *dpy);
void dbus_clipboard_init(DBusDisplay *dpy);
#endif /* UI_DBUS_H_ */

View File

@ -82,6 +82,7 @@ if dbus_display
'--generate-c-code', '@BASENAME@'])
dbus_ss.add(when: [gio, pixman, opengl, 'CONFIG_GIO'],
if_true: [files(
'dbus-chardev.c',
'dbus-clipboard.c',
'dbus-console.c',
'dbus-error.c',