Import Upstream version 2.72.4

2023-07-04 11:23:22 +02:00 · 2023-07-04 11:23:22 +02:00 · 4ef3ff9793
commit 4ef3ff9793
2003 changed files with 1332420 additions and 0 deletions
--- a/gio/gdbusobject.c
+++ b/gio/gdbusobject.c
@ -0,0 +1,152 @@
+/* GDBus - GLib D-Bus Library
+ *
+ * Copyright (C) 2008-2010 Red Hat, Inc.
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2.1 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General
+ * Public License along with this library; if not, see <http://www.gnu.org/licenses/>.
+ *
+ * Author: David Zeuthen <davidz@redhat.com>
+ */
+
+#include "config.h"
+
+#include "gdbusobject.h"
+#include "gdbusinterface.h"
+#include "gdbusutils.h"
+
+#include "glibintl.h"
+
+/**
+ * SECTION:gdbusobject
+ * @short_description: Base type for D-Bus objects
+ * @include: gio/gio.h
+ *
+ * The #GDBusObject type is the base type for D-Bus objects on both
+ * the service side (see #GDBusObjectSkeleton) and the client side
+ * (see #GDBusObjectProxy). It is essentially just a container of
+ * interfaces.
+ */
+
+/**
+ * GDBusObject:
+ *
+ * #GDBusObject is an opaque data structure and can only be accessed
+ * using the following functions.
+ */
+
+typedef GDBusObjectIface GDBusObjectInterface;
+G_DEFINE_INTERFACE (GDBusObject, g_dbus_object, G_TYPE_OBJECT)
+
+static void
+g_dbus_object_default_init (GDBusObjectIface *iface)
+{
+  /**
+   * GDBusObject::interface-added:
+   * @object: The #GDBusObject emitting the signal.
+   * @interface: The #GDBusInterface that was added.
+   *
+   * Emitted when @interface is added to @object.
+   *
+   * Since: 2.30
+   */
+  g_signal_new (I_("interface-added"),
+                G_TYPE_FROM_INTERFACE (iface),
+                G_SIGNAL_RUN_LAST,
+                G_STRUCT_OFFSET (GDBusObjectIface, interface_added),
+                NULL,
+                NULL,
+                NULL,
+                G_TYPE_NONE,
+                1,
+                G_TYPE_DBUS_INTERFACE);
+
+  /**
+   * GDBusObject::interface-removed:
+   * @object: The #GDBusObject emitting the signal.
+   * @interface: The #GDBusInterface that was removed.
+   *
+   * Emitted when @interface is removed from @object.
+   *
+   * Since: 2.30
+   */
+  g_signal_new (I_("interface-removed"),
+                G_TYPE_FROM_INTERFACE (iface),
+                G_SIGNAL_RUN_LAST,
+                G_STRUCT_OFFSET (GDBusObjectIface, interface_removed),
+                NULL,
+                NULL,
+                NULL,
+                G_TYPE_NONE,
+                1,
+                G_TYPE_DBUS_INTERFACE);
+}
+
+/* ---------------------------------------------------------------------------------------------------- */
+
+/**
+ * g_dbus_object_get_object_path:
+ * @object: A #GDBusObject.
+ *
+ * Gets the object path for @object.
+ *
+ * Returns: A string owned by @object. Do not free.
+ *
+ * Since: 2.30
+ */
+const gchar *
+g_dbus_object_get_object_path (GDBusObject *object)
+{
+  GDBusObjectIface *iface = G_DBUS_OBJECT_GET_IFACE (object);
+  return iface->get_object_path (object);
+}
+
+/**
+ * g_dbus_object_get_interfaces:
+ * @object: A #GDBusObject.
+ *
+ * Gets the D-Bus interfaces associated with @object.
+ *
+ * Returns: (element-type GDBusInterface) (transfer full): A list of #GDBusInterface instances.
+ *   The returned list must be freed by g_list_free() after each element has been freed
+ *   with g_object_unref().
+ *
+ * Since: 2.30
+ */
+GList *
+g_dbus_object_get_interfaces (GDBusObject *object)
+{
+  GDBusObjectIface *iface = G_DBUS_OBJECT_GET_IFACE (object);
+  return iface->get_interfaces (object);
+}
+
+/**
+ * g_dbus_object_get_interface:
+ * @object: A #GDBusObject.
+ * @interface_name: A D-Bus interface name.
+ *
+ * Gets the D-Bus interface with name @interface_name associated with
+ * @object, if any.
+ *
+ * Returns: (nullable) (transfer full): %NULL if not found, otherwise a
+ *   #GDBusInterface that must be freed with g_object_unref().
+ *
+ * Since: 2.30
+ */
+GDBusInterface *
+g_dbus_object_get_interface (GDBusObject *object,
+                             const gchar *interface_name)
+{
+  GDBusObjectIface *iface = G_DBUS_OBJECT_GET_IFACE (object);
+  g_return_val_if_fail (g_dbus_is_interface_name (interface_name), NULL);
+  return iface->get_interface (object, interface_name);
+}