luc14n0/glib
1
0
Fork 0
mirror of https://gitlab.gnome.org/GNOME/glib.git synced 2025-04-01 05:13:06 +02:00
Code Issues Packages Projects Releases Wiki Activity

gdbusobjectmanagerserver: Clarify recommended ObjectManager paths

Browse Source 
Otherwise people might try to export the object manager at ‘/’, which
doesn’t work. And I have no intention of making it work.

https://bugzilla.gnome.org/show_bug.cgi?id=760852
This commit is contained in:
Philip Withnall 2016-01-19 17:02:03 +00:00
parent 1725580f26
commit 3c0cddfe80
1 changed files with 10 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

11
gio/gdbusobjectmanagerserver.c
View File

@ -48,6 +48,14 @@
* clients can keep caches up to date by only listening to D-Bus * clients can keep caches up to date by only listening to D-Bus
* signals. * signals.
* *
* The recommended path to export an object manager at is the path form of the
* well-known name of a D-Bus service, or below. For example, if a D-Bus service
* is available at the well-known name `net.example.ExampleService1`, the object
* manager should typically be exported at `/net/example/ExampleService1`, or
* below (to allow for multiple object managers in a service).
*
* It is not supported to export an object manager at the root path, `/`.
*
* See #GDBusObjectManagerClient for the client-side code that is * See #GDBusObjectManagerClient for the client-side code that is
* intended to be used with #GDBusObjectManagerServer or any D-Bus * intended to be used with #GDBusObjectManagerServer or any D-Bus
* object implementing the org.freedesktop.DBus.ObjectManager * object implementing the org.freedesktop.DBus.ObjectManager
@ -236,7 +244,8 @@ g_dbus_object_manager_server_init (GDBusObjectManagerServer *manager)
/** /**
* g_dbus_object_manager_server_new: * g_dbus_object_manager_server_new:
* @object_path: The object path to export the manager object at. * @object_path: The object path to export the manager object at, which should
* not be `/`.
* *
* Creates a new #GDBusObjectManagerServer object. * Creates a new #GDBusObjectManagerServer object.
* *