DBusObjectManagerServer
GDBusObjectManagerServer
is used to export iface@Gio.DBusObject instances using the standardized org.freedesktop.DBus.ObjectManager
interface. For example, remote D-Bus clients can get all objects and properties in a single call. Additionally, any change in the object hierarchy is broadcast using signals. This means that D-Bus clients can keep caches up to date by only listening to D-Bus 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 supported, but not recommended, to export an object manager at the root path, /
.
See class@Gio.DBusObjectManagerClient for the client-side code that is intended to be used with GDBusObjectManagerServer
or any D-Bus object implementing the org.freedesktop.DBus.ObjectManager
interface.
Skipped during bindings generation
method
object-path
: Property has no getter nor setter
Since
2.30
Constructors
Properties
The #GDBusConnection to export objects on.
Functions
Emitted when @interface is added to @object.
Emitted when @interface has been removed from @object.
Emitted when @object is added to @manager.
Emitted when @object is removed from @manager.
Exports @object on @manager.
Like g_dbus_object_manager_server_export() but appends a string of the form _N (with N being a natural number) to @object's object path if an object with the given path already exists. As such, the #GDBusObjectProxy:g-object-path property of @object may be modified.
Gets the interface proxy for @interface_name at @object_path, if any.
Gets the #GDBusObject at @object_path, if any.
Gets the object path that @manager is for.
Gets all #GDBusObject objects known to @manager.
Returns whether @object is currently exported on @manager.