DBusConnection.signalSubscribe

Subscribes to signals on @connection and invokes @callback with a whenever the signal is received. Note that @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.

If @connection is not a message bus connection, @sender must be %NULL.

If @sender is a well-known name note that @callback is invoked with the unique name for the owner of @sender, not the well-known name as one would expect. This is because the message bus rewrites the name. As such, to avoid certain race conditions, users should be tracking the name owner of the well-known name and use that when processing the received signal.

If one of %G_DBUS_SIGNAL_FLAGS_MATCH_ARG0_NAMESPACE or %G_DBUS_SIGNAL_FLAGS_MATCH_ARG0_PATH are given, @arg0 is interpreted as part of a namespace or path. The first argument of a signal is matched against that part as specified by D-Bus.

If @user_data_free_func is non-%NULL, it will be called (in the thread-default main context of the thread you are calling this method from) at some point after @user_data is no longer needed. (It is not guaranteed to be called synchronously when the signal is unsubscribed from, and may be called after @connection has been destroyed.)

class DBusConnection
uint
signalSubscribe

Parameters

sender string

sender name to match on (unique or well-known name) or %NULL to listen from all senders

interfaceName string

D-Bus interface name to match on or %NULL to match on all interfaces

member string

D-Bus signal name to match on or %NULL to match on all signals

objectPath string

object path to match on or %NULL to match on all object paths

arg0 string

contents of first string argument to match on or %NULL to match on all kinds of arguments

flags GDBusSignalFlags

#GDBusSignalFlags describing how arg0 is used in subscribing to the signal

callback GDBusSignalCallback

callback to invoke when there is a signal matching the requested data

userData void*

user data to pass to @callback

userDataFreeFunc GDestroyNotify

function to free @user_data with when subscription is removed or %NULL

Return Value

Type: uint

a subscription identifier that can be used with g_dbus_connection_signal_unsubscribe()

Meta

Since

2.26