| telepathy-glib API Reference Manual | ||||
|---|---|---|---|---|
| Top | Description | ||||
#include <telepathy-glib/gnio-util.h> GSocketAddress * tp_g_socket_address_from_variant (TpSocketAddressType type,const GValue *variant,GError **error); GValue * tp_address_variant_from_g_socket_address (GSocketAddress *address,TpSocketAddressType *type,GError **error); GCredentials * tp_unix_connection_receive_credentials_with_byte (GSocketConnection *connection,guchar *byte,GCancellable *cancellable,GError **error); void tp_unix_connection_receive_credentials_with_byte_async (GSocketConnection *connection,GCancellable *cancellable,GAsyncReadyCallback callback,gpointer user_data); GCredentials * tp_unix_connection_receive_credentials_with_byte_finish (GSocketConnection *connection,GAsyncResult *result,guchar *byte,GError **error); gboolean tp_unix_connection_send_credentials_with_byte (GSocketConnection *connection,guchar byte,GCancellable *cancellable,GError **error); void tp_unix_connection_send_credentials_with_byte_async (GSocketConnection *connection,guchar byte,GCancellable *cancellable,GAsyncReadyCallback callback,gpointer user_data); gboolean tp_unix_connection_send_credentials_with_byte_finish (GSocketConnection *connection,GAsyncResult *result,GError **error);
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.
|
a Telepathy socket address type |
|
an initialised GValue containing an address variant |
|
return location for a GError (or NULL) |
Returns : |
a newly allocated GSocketAddress for the given variant, or NULL on error |
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.
|
a GSocketAddress to convert |
|
optional return of the Telepathy socket type (or NULL) |
|
return location for a GError (or NULL) |
Returns : |
a newly allocated GValue, free with tp_g_value_slice_free()
|
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.
|
a GUnixConnection |
|
if not NULL, used to return the byte. [out]
|
|
a GCancellable, or NULL. [allow-none]
|
|
a GError to fill |
Returns : |
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.
|
A GUnixConnection. |
|
optional GCancellable object, NULL to ignore. [allow-none]
|
|
a GAsyncReadyCallback to call when the request is satisfied. [scope async] |
|
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 GUnixConnection. |
|
a GAsyncResult. |
|
if not NULL, used to return the byte. [out]
|
|
a GError, or NULL
|
Returns : |
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
|
a GUnixConnection |
|
the byte to send with the credentials |
|
a GCancellable, or NULL. [allow-none]
|
|
a GError to fill |
Returns : |
TRUE on success, FALSE if error is set. |
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.
|
A GUnixConnection. |
|
the byte to send with the credentials |
|
optional GCancellable object, NULL to ignore. [allow-none]
|
|
a GAsyncReadyCallback to call when the request is satisfied. [scope async] |
|
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().
|
A GUnixConnection. |
|
a GAsyncResult. |
|
a GError, or NULL
|
Returns : |
TRUE if the operation was successful, otherwise FALSE. |
Since 0.17.5