| Top | |
|
|
|
Utility functions for interacting between Telepathy and GNIO.
Telepathy uses address variants stored in GValue boxes for communicating network socket addresses over D-Bus to and from the Connection Manager (for instance when using the file transfer and stream tube APIs).
This API provides translation between GSocketAddress subtypes and a GValue that can be used by telepathy-glib. GInetSocketAddress is used for IPv4/IPv6 and GUnixSocketAddress for UNIX sockets (only available on platforms with gio-unix).
GSocketAddress * tp_g_socket_address_from_variant (TpSocketAddressType type,const GValue *variant,GError **error);
Converts an address variant stored in a GValue into a GSocketAddress that can be used to make a socket connection with GIO.
GValue * tp_address_variant_from_g_socket_address (GSocketAddress *address,TpSocketAddressType *type,GError **error);
Converts a GSocketAddress to a GValue address variant that can be used with Telepathy and dbus-glib.
address |
a GSocketAddress to convert |
|
type |
optional return of the Telepathy socket type (or NULL) |
|
error |
return location for a GError (or NULL) |
GSocketAddress * tp_g_socket_address_from_g_variant (TpSocketAddressType type,GVariant *variant,GError **error);
Converts an address variant stored in a GVariant into a GSocketAddress that can be used to make a socket connection with GIO.
If variant
is a floating reference, this function takes ownership
of it.
Since 0.19.10
GVariant * tp_address_g_variant_from_g_socket_address (GSocketAddress *address,TpSocketAddressType *type,GError **error);
Converts a GSocketAddress to a GVariant address variant that can be used with Telepathy.
address |
a GSocketAddress to convert |
|
type |
optional return of the Telepathy socket type (or NULL) |
|
error |
return location for a GError (or NULL) |
Since 0.19.10
GCredentials * tp_unix_connection_receive_credentials_with_byte (GSocketConnection *connection,guchar *byte,GCancellable *cancellable,GError **error);
A variant of g_unix_connection_receive_credentials() allowing you to get
the byte which has been received with the credentials.
connection |
||
byte |
if not |
[out] |
cancellable |
a GCancellable, or |
[allow-none] |
error |
a GError to fill |
Received credentials on success (free with
g_object_unref()), NULL if error is set.
[transfer full]
Since 0.13.2
void tp_unix_connection_receive_credentials_with_byte_async (GSocketConnection *connection,GCancellable *cancellable,GAsyncReadyCallback callback,gpointer user_data);
Asynchronously receive credentials.
For more details, see tp_unix_connection_receive_credentials_with_byte()
which is the synchronous version of this call.
When the operation is finished, callback
will be called. You can then call
tp_unix_connection_receive_credentials_with_byte_finish() to get the result
of the operation.
connection |
||
cancellable |
optional GCancellable object, |
[allow-none] |
callback |
a GAsyncReadyCallback to call when the request is satisfied. |
[scope async] |
user_data |
the data to pass to callback function. |
[closure] |
Since 0.17.5
GCredentials * tp_unix_connection_receive_credentials_with_byte_finish (GSocketConnection *connection,GAsyncResult *result,guchar *byte,GError **error);
Finishes an asynchronous receive credentials operation started with
tp_unix_connection_receive_credentials_with_byte_async().
a GCredentials, or NULL on error.
Free the returned object with g_object_unref().
[transfer full]
Since 0.17.5
gboolean tp_unix_connection_send_credentials_with_byte (GSocketConnection *connection,guchar byte,GCancellable *cancellable,GError **error);
A variant of g_unix_connection_send_credentials() allowing you to choose
the byte which is send with the credentials
connection |
||
byte |
the byte to send with the credentials |
|
cancellable |
a GCancellable, or |
[allow-none] |
error |
a GError to fill |
Since 0.13.2
void tp_unix_connection_send_credentials_with_byte_async (GSocketConnection *connection,guchar byte,GCancellable *cancellable,GAsyncReadyCallback callback,gpointer user_data);
Asynchronously send credentials.
For more details, see tp_unix_connection_send_credentials_with_byte() which
is the synchronous version of this call.
When the operation is finished, callback
will be called. You can then call
tp_unix_connection_send_credentials_with_byte_finish() to get the result of
the operation.
connection |
||
byte |
the byte to send with the credentials |
|
cancellable |
optional GCancellable object, |
[allow-none] |
callback |
a GAsyncReadyCallback to call when the request is satisfied. |
[scope async] |
user_data |
the data to pass to callback function. |
[closure] |
Since 0.17.5
gboolean tp_unix_connection_send_credentials_with_byte_finish (GSocketConnection *connection,GAsyncResult *result,GError **error);
Finishes an asynchronous send credentials operation started with
tp_unix_connection_send_credentials_with_byte_async().
Since 0.17.5