Memory-managed wrapper type.

Type class for types which can be safely cast to DBusProxy, for instance with toDBusProxy.

Cast to DBusProxy, for types for which this is known to be safe. For general casts, use castTo.

A convenience alias for Nothing :: Maybe DBusProxy.

Asynchronously invokes the methodName method on proxy.

If methodName contains any dots, then name is split into interface and method name parts. This allows using proxy for invoking methods on other interfaces.

If the DBusConnection associated with proxy is closed then the operation will fail with IOErrorEnumClosed. If cancellable is canceled, the operation will fail with IOErrorEnumCancelled. If parameters contains a value not compatible with the D-Bus protocol, the operation fails with IOErrorEnumInvalidArgument.

If the parameters GVariant is floating, it is consumed. This allows convenient 'inline' use of g_variant_new(), e.g.:

C code

g_dbus_proxy_call (proxy,
                   "TwoStrings",
                   g_variant_new ("(ss)",
                                  "Thing One",
                                  "Thing Two"),
                   G_DBUS_CALL_FLAGS_NONE,
                   -1,
                   NULL,
                   (GAsyncReadyCallback) two_strings_done,
                   &data);

If proxy has an expected interface (see DBusProxy:g-interface-info) and methodName is referenced by it, then the return value is checked against the return type.

This is an asynchronous method. When the operation is finished, callback will be invoked in the [thread-default main context][g-main-context-push-thread-default] of the thread you are calling this method from. You can then call dBusProxyCallFinish to get the result of the operation. See dBusProxyCallSync for the synchronous version of this method.

If callback is Nothing then the D-Bus method call message will be sent with the DBusMessageFlagsNoReplyExpected flag set.

Since: 2.26

Finishes an operation started with dBusProxyCall.

Since: 2.26

Synchronously invokes the methodName method on proxy.

If methodName contains any dots, then name is split into interface and method name parts. This allows using proxy for invoking methods on other interfaces.

If the DBusConnection associated with proxy is disconnected then the operation will fail with IOErrorEnumClosed. If cancellable is canceled, the operation will fail with IOErrorEnumCancelled. If parameters contains a value not compatible with the D-Bus protocol, the operation fails with IOErrorEnumInvalidArgument.

If the parameters GVariant is floating, it is consumed. This allows convenient 'inline' use of g_variant_new(), e.g.:

C code

g_dbus_proxy_call_sync (proxy,
                        "TwoStrings",
                        g_variant_new ("(ss)",
                                       "Thing One",
                                       "Thing Two"),
                        G_DBUS_CALL_FLAGS_NONE,
                        -1,
                        NULL,
                        &error);

The calling thread is blocked until a reply is received. See dBusProxyCall for the asynchronous version of this method.

If proxy has an expected interface (see DBusProxy:g-interface-info) and methodName is referenced by it, then the return value is checked against the return type.

Since: 2.26

Like dBusProxyCall but also takes a UnixFDList object.

This method is only available on UNIX.

Since: 2.30

Finishes an operation started with dBusProxyCallWithUnixFdList.

Since: 2.30

Like dBusProxyCallSync but also takes and returns UnixFDList objects.

This method is only available on UNIX.

Since: 2.30

Looks up the value for a property from the cache. This call does no blocking IO.

If proxy has an expected interface (see DBusProxy:g-interface-info) and propertyName is referenced by it, then value is checked against the type of the property.

Since: 2.26

Gets the names of all cached properties on proxy.

Since: 2.26

Gets the connection proxy is for.

Since: 2.26

Gets the timeout to use if -1 (specifying default timeout) is passed as timeoutMsec in the dBusProxyCall and dBusProxyCallSync functions.

See the DBusProxy:g-default-timeout property for more details.

Since: 2.26

Gets the flags that proxy was constructed with.

Since: 2.26

Returns the DBusInterfaceInfo, if any, specifying the interface that proxy conforms to. See the DBusProxy:g-interface-info property for more details.

Since: 2.26

Gets the D-Bus interface name proxy is for.

Since: 2.26

Gets the name that proxy was constructed for.

Since: 2.26

The unique name that owns the name that proxy is for or Nothing if no-one currently owns that name. You may connect to the Object::notify signal to track changes to the DBusProxy:g-name-owner property.

Since: 2.26

Gets the object path proxy is for.

Since: 2.26

Creates a proxy for accessing interfaceName on the remote object at objectPath owned by name at connection and asynchronously loads D-Bus properties unless the DBusProxyFlagsDoNotLoadProperties flag is used. Connect to the DBusProxy::g-properties-changed signal to get notified about property changes.

If the DBusProxyFlagsDoNotConnectSignals flag is not set, also sets up match rules for signals. Connect to the DBusProxy::g-signal signal to handle signals from the remote object.

If name is a well-known name and the DBusProxyFlagsDoNotAutoStart and DBusProxyFlagsDoNotAutoStartAtConstruction flags aren't set and no name owner currently exists, the message bus will be requested to launch a name owner for the name.

This is a failable asynchronous constructor - when the proxy is ready, callback will be invoked and you can use dBusProxyNewFinish to get the result.

See dBusProxyNewSync and for a synchronous version of this constructor.

DBusProxy is used in this [example][gdbus-wellknown-proxy].

Since: 2.26

Finishes creating a DBusProxy.

Since: 2.26

Like dBusProxyNew but takes a BusType instead of a DBusConnection.

DBusProxy is used in this [example][gdbus-wellknown-proxy].

Since: 2.26

Finishes creating a DBusProxy.

Since: 2.26

Like dBusProxyNewSync but takes a BusType instead of a DBusConnection.

DBusProxy is used in this [example][gdbus-wellknown-proxy].

Since: 2.26

Creates a proxy for accessing interfaceName on the remote object at objectPath owned by name at connection and synchronously loads D-Bus properties unless the DBusProxyFlagsDoNotLoadProperties flag is used.

If the DBusProxyFlagsDoNotConnectSignals flag is not set, also sets up match rules for signals. Connect to the DBusProxy::g-signal signal to handle signals from the remote object.

If name is a well-known name and the DBusProxyFlagsDoNotAutoStart and DBusProxyFlagsDoNotAutoStartAtConstruction flags aren't set and no name owner currently exists, the message bus will be requested to launch a name owner for the name.

This is a synchronous failable constructor. See dBusProxyNew and dBusProxyNewFinish for the asynchronous version.

DBusProxy is used in this [example][gdbus-wellknown-proxy].

Since: 2.26

If value is not Nothing, sets the cached value for the property with name propertyName to the value in value.

If value is Nothing, then the cached value is removed from the property cache.

If proxy has an expected interface (see DBusProxy:g-interface-info) and propertyName is referenced by it, then value is checked against the type of the property.

If the value GVariant is floating, it is consumed. This allows convenient 'inline' use of g_variant_new(), e.g.

C code

g_dbus_proxy_set_cached_property (proxy,
                                  "SomeProperty",
                                  g_variant_new ("(si)",
                                                "A String",
                                                42));

Normally you will not need to use this method since proxy is tracking changes using the org.freedesktop.DBus.Properties.PropertiesChanged D-Bus signal. However, for performance reasons an object may decide to not use this signal for some properties and instead use a proprietary out-of-band mechanism to transmit changes.

As a concrete example, consider an object with a property ChatroomParticipants which is an array of strings. Instead of transmitting the same (long) array every time the property changes, it is more efficient to only transmit the delta using e.g. signals ChatroomParticipantJoined(String name) and ChatroomParticipantParted(String name).

Since: 2.26

Sets the timeout to use if -1 (specifying default timeout) is passed as timeoutMsec in the dBusProxyCall and dBusProxyCallSync functions.

See the DBusProxy:g-default-timeout property for more details.

Since: 2.26

Ensure that interactions with proxy conform to the given interface. See the DBusProxy:g-interface-info property for more details.

Since: 2.26

Construct a GValueConstruct with valid value for the “g-bus-type” property. This is rarely needed directly, but it is used by new.

Construct a GValueConstruct with valid value for the “g-connection” property. This is rarely needed directly, but it is used by new.

Get the value of the “g-connection” property. When overloading is enabled, this is equivalent to

get dBusProxy #gConnection

Construct a GValueConstruct with valid value for the “g-default-timeout” property. This is rarely needed directly, but it is used by new.

Get the value of the “g-default-timeout” property. When overloading is enabled, this is equivalent to

get dBusProxy #gDefaultTimeout

Set the value of the “g-default-timeout” property. When overloading is enabled, this is equivalent to

set dBusProxy [ #gDefaultTimeout := value ]

Construct a GValueConstruct with valid value for the “g-flags” property. This is rarely needed directly, but it is used by new.

Get the value of the “g-flags” property. When overloading is enabled, this is equivalent to

get dBusProxy #gFlags

Set the value of the “g-interface-info” property to Nothing. When overloading is enabled, this is equivalent to

clear #gInterfaceInfo

Construct a GValueConstruct with valid value for the “g-interface-info” property. This is rarely needed directly, but it is used by new.

Get the value of the “g-interface-info” property. When overloading is enabled, this is equivalent to

get dBusProxy #gInterfaceInfo

Set the value of the “g-interface-info” property. When overloading is enabled, this is equivalent to

set dBusProxy [ #gInterfaceInfo := value ]

Construct a GValueConstruct with valid value for the “g-interface-name” property. This is rarely needed directly, but it is used by new.

Get the value of the “g-interface-name” property. When overloading is enabled, this is equivalent to

get dBusProxy #gInterfaceName

Construct a GValueConstruct with valid value for the “g-name” property. This is rarely needed directly, but it is used by new.

Get the value of the “g-name” property. When overloading is enabled, this is equivalent to

get dBusProxy #gName

Get the value of the “g-name-owner” property. When overloading is enabled, this is equivalent to

get dBusProxy #gNameOwner

Construct a GValueConstruct with valid value for the “g-object-path” property. This is rarely needed directly, but it is used by new.

Get the value of the “g-object-path” property. When overloading is enabled, this is equivalent to

get dBusProxy #gObjectPath

Type for the callback on the (unwrapped) C side.

Emitted when one or more D-Bus properties on proxy changes. The local cache has already been updated when this signal fires. Note that both changedProperties and invalidatedProperties are guaranteed to never be Nothing (either may be empty though).

If the proxy has the flag DBusProxyFlagsGetInvalidatedProperties set, then invalidatedProperties will always be empty.

This signal corresponds to the PropertiesChanged D-Bus signal on the org.freedesktop.DBus.Properties interface.

Since: 2.26

Connect a signal handler for the “g-properties-changed” signal, to be run after the default handler. When overloading is enabled, this is equivalent to

after dBusProxy #gPropertiesChanged callback

Wrap the callback into a Closure.

Generate a function pointer callable from C code, from a C_DBusProxyGPropertiesChangedCallback.

A convenience synonym for Nothing :: Maybe DBusProxyGPropertiesChangedCallback.

Connect a signal handler for the “g-properties-changed” signal, to be run before the default handler. When overloading is enabled, this is equivalent to

on dBusProxy #gPropertiesChanged callback

Wrap a DBusProxyGPropertiesChangedCallback into a C_DBusProxyGPropertiesChangedCallback.

Type for the callback on the (unwrapped) C side.

Emitted when a signal from the remote object and interface that proxy is for, has been received.

Since: 2.26

Connect a signal handler for the “g-signal” signal, to be run after the default handler. When overloading is enabled, this is equivalent to

after dBusProxy #gSignal callback

Wrap the callback into a Closure.

Generate a function pointer callable from C code, from a C_DBusProxyGSignalCallback.

A convenience synonym for Nothing :: Maybe DBusProxyGSignalCallback.

Connect a signal handler for the “g-signal” signal, to be run before the default handler. When overloading is enabled, this is equivalent to

on dBusProxy #gSignal callback

Wrap a DBusProxyGSignalCallback into a C_DBusProxyGSignalCallback.