Top |
Description
Routines for working with D-Bus addresses. A D-Bus address is a string like "unix:tmpdir=/tmp/my-app-name". The exact format of addresses is explained in detail in the D-Bus specification.
Functions
g_dbus_is_address ()
gboolean
g_dbus_is_address (const gchar *string
);
Checks if string
is a D-Bus address.
This doesn't check if string
is actually supported by GDBusServer
or GDBusConnection - use g_dbus_is_supported_address()
to do more
checks.
Since 2.26
g_dbus_is_supported_address ()
gboolean g_dbus_is_supported_address (const gchar *string
,GError **error
);
Like g_dbus_is_address()
but also checks if the library suppors the
transports in string
and that key/value pairs for each transport
are valid.
Returns
TRUE
if string
is a valid D-Bus address that is
supported by this library, FALSE
if error
is set.
Since 2.26
g_dbus_address_get_stream ()
void g_dbus_address_get_stream (const gchar *address
,GCancellable *cancellable
,GAsyncReadyCallback callback
,gpointer user_data
);
Asynchronously connects to an endpoint specified by address
and
sets up the connection so it is in a state to run the client-side
of the D-Bus authentication conversation.
When the operation is finished, callback
will be invoked. You can
then call g_dbus_address_get_stream_finish()
to get the result of
the operation.
This is an asynchronous failable function. See
g_dbus_address_get_stream_sync()
for the synchronous version.
Parameters
address |
A valid D-Bus address. |
|
cancellable |
A GCancellable or |
[allow-none] |
callback |
A GAsyncReadyCallback to call when the request is satisfied. |
|
user_data |
Data to pass to |
Since 2.26
g_dbus_address_get_stream_finish ()
GIOStream * g_dbus_address_get_stream_finish (GAsyncResult *res
,gchar **out_guid
,GError **error
);
Finishes an operation started with g_dbus_address_get_stream()
.
Parameters
res |
A GAsyncResult obtained from the GAsyncReadyCallback passed to |
|
out_guid |
|
|
error |
Return location for error or |
Since 2.26
g_dbus_address_get_stream_sync ()
GIOStream * g_dbus_address_get_stream_sync (const gchar *address
,gchar **out_guid
,GCancellable *cancellable
,GError **error
);
Synchronously connects to an endpoint specified by address
and
sets up the connection so it is in a state to run the client-side
of the D-Bus authentication conversation.
This is a synchronous failable function. See
g_dbus_address_get_stream()
for the asynchronous version.
Parameters
address |
A valid D-Bus address. |
|
out_guid |
|
|
cancellable |
A GCancellable or |
[allow-none] |
error |
Return location for error or |
Since 2.26
g_dbus_address_get_for_bus_sync ()
gchar * g_dbus_address_get_for_bus_sync (GBusType bus_type
,GCancellable *cancellable
,GError **error
);
Synchronously looks up the D-Bus address for the well-known message
bus instance specified by bus_type
. This may involve using various
platform specific mechanisms.
Parameters
bus_type |
a GBusType |
|
cancellable |
a GCancellable or |
[allow-none] |
error |
return location for error or |
Since 2.26
g_dbus_address_escape_value ()
gchar *
g_dbus_address_escape_value (const gchar *string
);
Escape string
so it can appear in a D-Bus address as the value
part of a key-value pair.
For instance, if string
is "/run/bus-for-:0",
this function would return "/run/bus-for-3A0
",
which could be used in a D-Bus address like
"unix:nonce-tcp:host=127.0.0.1,port=42,noncefile=/run/bus-for-3A0
".
Parameters
string |
an unescaped string to be included in a D-Bus address as the value in a key-value pair |
Since 2.36