telepathy-glib API Reference Manual | ||||
---|---|---|---|---|
Top | Description |
#include <telepathy-glib/telepathy-glib.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
); GSocketAddress * tp_g_socket_address_from_g_variant (TpSocketAddressType type
,GVariant *variant
,GError **error
); GVariant * tp_address_g_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, as encoded by dbus-glib |
|
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 and dbus-glib.
|
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()
|
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.
|
a Telepathy socket address type |
|
a socket address as encoded by Telepathy according to type
|
|
return location for a GError (or NULL ) |
Returns : |
a newly allocated GSocketAddress for the given variant, or NULL
on error |
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.
|
a GSocketAddress to convert |
|
optional return of the Telepathy socket type (or NULL) |
|
return location for a GError (or NULL) |
Returns : |
a new variant with a floating reference, or NULL . [transfer none]
|
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.
|
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