|  |  |  | telepathy-glib API Reference Manual |  | 
|---|---|---|---|---|
| Top | Description | ||||
| Tube channelsTube channels — client-side wrappers for the Tube channel interface, StreamTube channel type and DBusTube channel type. | 
#include <telepathy-glib/telepathy-glib-dbus.h> TpProxySignalConnection * tp_cli_channel_interface_tube_connect_to_tube_channel_state_changed (TpChannel *proxy,tp_cli_channel_interface_tube_signal_callback_tube_channel_state_changed callback,gpointer user_data,GDestroyNotify destroy,GObject *weak_object,GError **error); void (*tp_cli_channel_interface_tube_signal_callback_tube_channel_state_changed) (TpChannel *proxy,guint arg_State,gpointer user_data,GObject *weak_object); gboolean tp_cli_channel_type_stream_tube_run_offer (TpChannel *proxy,gint timeout_ms,guint in_address_type,const GValue *in_address,guint in_access_control,GHashTable *in_parameters,GError **error,GMainLoop **loop); gboolean tp_cli_channel_type_stream_tube_run_accept (TpChannel *proxy,gint timeout_ms,guint in_address_type,guint in_access_control,const GValue *in_access_control_param,GValue **out_address,GError **error,GMainLoop **loop); TpProxyPendingCall * tp_cli_channel_type_stream_tube_call_offer (TpChannel *proxy,gint timeout_ms,guint in_address_type,const GValue *in_address,guint in_access_control,GHashTable *in_parameters,tp_cli_channel_type_stream_tube_callback_for_offer callback,gpointer user_data,GDestroyNotify destroy,GObject *weak_object); TpProxyPendingCall * tp_cli_channel_type_stream_tube_call_accept (TpChannel *proxy,gint timeout_ms,guint in_address_type,guint in_access_control,const GValue *in_access_control_param,tp_cli_channel_type_stream_tube_callback_for_accept callback,gpointer user_data,GDestroyNotify destroy,GObject *weak_object); void (*tp_cli_channel_type_stream_tube_callback_for_offer) (TpChannel *proxy,const GError *error,gpointer user_data,GObject *weak_object); void (*tp_cli_channel_type_stream_tube_callback_for_accept) (TpChannel *proxy,const GValue *out_address,const GError *error,gpointer user_data,GObject *weak_object); TpProxySignalConnection * tp_cli_channel_type_stream_tube_connect_to_new_remote_connection (TpChannel *proxy,tp_cli_channel_type_stream_tube_signal_callback_new_remote_connection callback,gpointer user_data,GDestroyNotify destroy,GObject *weak_object,GError **error); TpProxySignalConnection * tp_cli_channel_type_stream_tube_connect_to_new_local_connection (TpChannel *proxy,tp_cli_channel_type_stream_tube_signal_callback_new_local_connection callback,gpointer user_data,GDestroyNotify destroy,GObject *weak_object,GError **error); TpProxySignalConnection * tp_cli_channel_type_stream_tube_connect_to_connection_closed (TpChannel *proxy,tp_cli_channel_type_stream_tube_signal_callback_connection_closed callback,gpointer user_data,GDestroyNotify destroy,GObject *weak_object,GError **error); void (*tp_cli_channel_type_stream_tube_signal_callback_new_remote_connection) (TpChannel *proxy,guint arg_Handle,const GValue *arg_Connection_Param,guint arg_Connection_ID,gpointer user_data,GObject *weak_object); void (*tp_cli_channel_type_stream_tube_signal_callback_new_local_connection) (TpChannel *proxy,guint arg_Connection_ID,gpointer user_data,GObject *weak_object); void (*tp_cli_channel_type_stream_tube_signal_callback_connection_closed) (TpChannel *proxy,guint arg_Connection_ID,const gchar *arg_Error,const gchar *arg_Message,gpointer user_data,GObject *weak_object); gboolean tp_cli_channel_type_dbus_tube_run_offer (TpChannel *proxy,gint timeout_ms,GHashTable *in_parameters,guint in_access_control,gchar **out_address,GError **error,GMainLoop **loop); gboolean tp_cli_channel_type_dbus_tube_run_accept (TpChannel *proxy,gint timeout_ms,guint in_access_control,gchar **out_address,GError **error,GMainLoop **loop); TpProxyPendingCall * tp_cli_channel_type_dbus_tube_call_offer (TpChannel *proxy,gint timeout_ms,GHashTable *in_parameters,guint in_access_control,tp_cli_channel_type_dbus_tube_callback_for_offer callback,gpointer user_data,GDestroyNotify destroy,GObject *weak_object); TpProxyPendingCall * tp_cli_channel_type_dbus_tube_call_accept (TpChannel *proxy,gint timeout_ms,guint in_access_control,tp_cli_channel_type_dbus_tube_callback_for_accept callback,gpointer user_data,GDestroyNotify destroy,GObject *weak_object); void (*tp_cli_channel_type_dbus_tube_callback_for_offer) (TpChannel *proxy,const gchar *out_address,const GError *error,gpointer user_data,GObject *weak_object); void (*tp_cli_channel_type_dbus_tube_callback_for_accept) (TpChannel *proxy,const gchar *out_address,const GError *error,gpointer user_data,GObject *weak_object); TpProxySignalConnection * tp_cli_channel_type_dbus_tube_connect_to_dbus_names_changed (TpChannel *proxy,tp_cli_channel_type_dbus_tube_signal_callback_dbus_names_changed callback,gpointer user_data,GDestroyNotify destroy,GObject *weak_object,GError **error); void (*tp_cli_channel_type_dbus_tube_signal_callback_dbus_names_changed) (TpChannel *proxy,GHashTable *arg_Added,const GArray *arg_Removed,gpointer user_data,GObject *weak_object);
A "tube" is a mechanism for arbitrary data transfer. This section documents the auto-generated C wrappers for the Tube channel interface, StreamTube channel type and DBusTube channel type.
TpProxySignalConnection * tp_cli_channel_interface_tube_connect_to_tube_channel_state_changed (TpChannel *proxy,tp_cli_channel_interface_tube_signal_callback_tube_channel_state_changed callback,gpointer user_data,GDestroyNotify destroy,GObject *weak_object,GError **error);
Connect a handler to the signal TubeChannelStateChanged.
Emitted when the state of the tube channel changes. Valid state transitions are documented with <tp:type>Tube_Channel_State</tp:type>.
| 
 | A TpChannel or subclass | 
| 
 | Callback to be called when the signal is received | 
| 
 | User-supplied data for the callback | 
| 
 | Destructor for the user-supplied data, which
will be called when this signal is disconnected, or
before this function returns NULL | 
| 
 | A GObject which will be weakly referenced; if it is destroyed, this callback will automatically be disconnected | 
| 
 | If not NULL, used to raise an error ifNULLis
returned | 
| Returns : | a TpProxySignalConnection containing all of the
above, which can be used to disconnect the signal; or NULLif the proxy does not have the desired interface
or has become invalid. | 
void (*tp_cli_channel_interface_tube_signal_callback_tube_channel_state_changed) (TpChannel *proxy,guint arg_State,gpointer user_data,GObject *weak_object);
Represents the signature of a callback for the signal TubeChannelStateChanged.
| 
 | The proxy on which tp_cli_channel_interface_tube_connect_to_tube_channel_state_changed()was called | 
| 
 | The new state of the tube. (TpTubeChannelState) | 
| 
 | User-supplied data | 
| 
 | User-supplied weakly referenced object | 
gboolean tp_cli_channel_type_stream_tube_run_offer (TpChannel *proxy,gint timeout_ms,guint in_address_type,const GValue *in_address,guint in_access_control,GHashTable *in_parameters,GError **error,GMainLoop **loop);
tp_cli_channel_type_stream_tube_run_offer is deprecated and should not be used in newly-written code.
Call the method Offer and run the main loop until it returns. Before calling this method, you must add a reference to any borrowed objects you need to keep, and generally ensure that everything is in a consistent state.
Offer a stream tube exporting the local socket specified.
| 
 | A TpChannel or subclass | 
| 
 | Timeout in milliseconds, or -1 for default | 
| 
 | Used to pass an 'in' argument: The type of the listening address of the local service, as a member of Socket_Address_Type. (TpSocketAddressType) | 
| 
 | Used to pass an 'in' argument: The listening address of the local service, as indicated by the address_type. | 
| 
 | Used to pass an 'in' argument: The access control the local service applies to the local socket, specified so the connection manager can behave appropriately when it connects. (TpSocketAccessControl) | 
| 
 | Used to pass an 'in' argument: The dictionary of arbitrary <tp:dbus-ref namespace="org.freedesktop.Telepathy.Channel.Interface.Tube">Parameters</tp:dbus-ref> to send with the tube offer. | 
| 
 | If not NULL, used to return errors ifFALSEis returned | 
| 
 | If not NULL, set before re-entering
the main loop, to point to a GMainLoop
which can be used to cancel this call withg_main_loop_quit(), causing a return ofFALSEwitherrorset toTP_DBUS_ERROR_CANCELLED | 
| Returns : | TRUE on success, FALSE and sets erroron error | 
gboolean tp_cli_channel_type_stream_tube_run_accept (TpChannel *proxy,gint timeout_ms,guint in_address_type,guint in_access_control,const GValue *in_access_control_param,GValue **out_address,GError **error,GMainLoop **loop);
tp_cli_channel_type_stream_tube_run_accept is deprecated and should not be used in newly-written code.
Call the method Accept and run the main loop until it returns. Before calling this method, you must add a reference to any borrowed objects you need to keep, and generally ensure that everything is in a consistent state.
Accept a stream tube that's in the "local pending" state. The connection manager will attempt to open the tube. The tube remains in the "local pending" state until the <tp:dbus-ref namespace="org.freedesktop.Telepathy.Channel.Interface.Tube">TubeChannelStateChanged</tp:dbus-ref> signal is emitted.
| 
 | A TpChannel or subclass | 
| 
 | Timeout in milliseconds, or -1 for default | 
| 
 | Used to pass an 'in' argument: The type of address the connection manager should listen on. (TpSocketAddressType) | 
| 
 | Used to pass an 'in' argument: <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>The type of access control the connection manager should apply to the socket.</p> <p>Note that if you plan to establish more than one connection through the tube, the Socket_Access_Control_Port access control can't be used as you can't connect more than once from the same port.</p> (TpSocketAccessControl) | 
| 
 | Used to pass an 'in' argument: A parameter for the access control type, to be interpreted as specified in the documentation for the Socket_Access_Control enum. | 
| 
 | Used to return an 'out' argument if TRUEis returned: The address on which the connection manager will listen for           connections to this tube. The client should not attempt to connect           to the address until the tube is open. | 
| 
 | If not NULL, used to return errors ifFALSEis returned | 
| 
 | If not NULL, set before re-entering
the main loop, to point to a GMainLoop
which can be used to cancel this call withg_main_loop_quit(), causing a return ofFALSEwitherrorset toTP_DBUS_ERROR_CANCELLED | 
| Returns : | TRUE on success, FALSE and sets erroron error | 
TpProxyPendingCall * tp_cli_channel_type_stream_tube_call_offer (TpChannel *proxy,gint timeout_ms,guint in_address_type,const GValue *in_address,guint in_access_control,GHashTable *in_parameters,tp_cli_channel_type_stream_tube_callback_for_offer callback,gpointer user_data,GDestroyNotify destroy,GObject *weak_object);
Start a Offer method call.
Offer a stream tube exporting the local socket specified.
| 
 | the TpProxy | 
| 
 | the timeout in milliseconds, or -1 to use the default | 
| 
 | Used to pass an 'in' argument: The type of the listening address of the local service, as a member of Socket_Address_Type. (TpSocketAddressType) | 
| 
 | Used to pass an 'in' argument: The listening address of the local service, as indicated by the address_type. | 
| 
 | Used to pass an 'in' argument: The access control the local service applies to the local socket, specified so the connection manager can behave appropriately when it connects. (TpSocketAccessControl) | 
| 
 | Used to pass an 'in' argument: The dictionary of arbitrary <tp:dbus-ref namespace="org.freedesktop.Telepathy.Channel.Interface.Tube">Parameters</tp:dbus-ref> to send with the tube offer. | 
| 
 | called when the method call succeeds or fails;
may be NULLto make a "fire and forget" call with no
reply tracking | 
| 
 | user-supplied data passed to the callback;
must be NULLifcallbackisNULL | 
| 
 | called with the user_data as argument, after the
call has succeeded, failed or been cancelled;
must be NULLifcallbackisNULL | 
| 
 | If not NULL, a GObject which will be
weakly referenced; if it is destroyed, this call
will automatically be cancelled. Must beNULLifcallbackisNULL | 
| Returns : | a TpProxyPendingCall representing the call in progress. It is borrowed from the object, and will become invalid when the callback is called, the call is cancelled or the TpProxy becomes invalid. | 
TpProxyPendingCall * tp_cli_channel_type_stream_tube_call_accept (TpChannel *proxy,gint timeout_ms,guint in_address_type,guint in_access_control,const GValue *in_access_control_param,tp_cli_channel_type_stream_tube_callback_for_accept callback,gpointer user_data,GDestroyNotify destroy,GObject *weak_object);
Start a Accept method call.
Accept a stream tube that's in the "local pending" state. The connection manager will attempt to open the tube. The tube remains in the "local pending" state until the <tp:dbus-ref namespace="org.freedesktop.Telepathy.Channel.Interface.Tube">TubeChannelStateChanged</tp:dbus-ref> signal is emitted.
| 
 | the TpProxy | 
| 
 | the timeout in milliseconds, or -1 to use the default | 
| 
 | Used to pass an 'in' argument: The type of address the connection manager should listen on. (TpSocketAddressType) | 
| 
 | Used to pass an 'in' argument: <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>The type of access control the connection manager should apply to the socket.</p> <p>Note that if you plan to establish more than one connection through the tube, the Socket_Access_Control_Port access control can't be used as you can't connect more than once from the same port.</p> (TpSocketAccessControl) | 
| 
 | Used to pass an 'in' argument: A parameter for the access control type, to be interpreted as specified in the documentation for the Socket_Access_Control enum. | 
| 
 | called when the method call succeeds or fails;
may be NULLto make a "fire and forget" call with no
reply tracking | 
| 
 | user-supplied data passed to the callback;
must be NULLifcallbackisNULL | 
| 
 | called with the user_data as argument, after the
call has succeeded, failed or been cancelled;
must be NULLifcallbackisNULL | 
| 
 | If not NULL, a GObject which will be
weakly referenced; if it is destroyed, this call
will automatically be cancelled. Must beNULLifcallbackisNULL | 
| Returns : | a TpProxyPendingCall representing the call in progress. It is borrowed from the object, and will become invalid when the callback is called, the call is cancelled or the TpProxy becomes invalid. | 
void (*tp_cli_channel_type_stream_tube_callback_for_offer) (TpChannel *proxy,const GError *error,gpointer user_data,GObject *weak_object);
Signature of the callback called when a Offer method call succeeds or fails.
| 
 | the proxy on which the call was made | 
| 
 | NULLon success, or an error on failure | 
| 
 | user-supplied data | 
| 
 | user-supplied object | 
void (*tp_cli_channel_type_stream_tube_callback_for_accept) (TpChannel *proxy,const GValue *out_address,const GError *error,gpointer user_data,GObject *weak_object);
Signature of the callback called when a Accept method call succeeds or fails.
| 
 | the proxy on which the call was made | 
| 
 | Used to return an 'out' argument if errorisNULL: The address on which the connection manager will listen for           connections to this tube. The client should not attempt to connect           to the address until the tube is open. | 
| 
 | NULLon success, or an error on failure | 
| 
 | user-supplied data | 
| 
 | user-supplied object | 
TpProxySignalConnection * tp_cli_channel_type_stream_tube_connect_to_new_remote_connection (TpChannel *proxy,tp_cli_channel_type_stream_tube_signal_callback_new_remote_connection callback,gpointer user_data,GDestroyNotify destroy,GObject *weak_object,GError **error);
Connect a handler to the signal NewRemoteConnection.
<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Emitted each time a participant opens a new connection to its socket.</p> <p>This signal is only fired on the offering side.</p>
| 
 | A TpChannel or subclass | 
| 
 | Callback to be called when the signal is received | 
| 
 | User-supplied data for the callback | 
| 
 | Destructor for the user-supplied data, which
will be called when this signal is disconnected, or
before this function returns NULL | 
| 
 | A GObject which will be weakly referenced; if it is destroyed, this callback will automatically be disconnected | 
| 
 | If not NULL, used to raise an error ifNULLis
returned | 
| Returns : | a TpProxySignalConnection containing all of the
above, which can be used to disconnect the signal; or NULLif the proxy does not have the desired interface
or has become invalid. | 
TpProxySignalConnection * tp_cli_channel_type_stream_tube_connect_to_new_local_connection (TpChannel *proxy,tp_cli_channel_type_stream_tube_signal_callback_new_local_connection callback,gpointer user_data,GDestroyNotify destroy,GObject *weak_object,GError **error);
Connect a handler to the signal NewLocalConnection.
<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Emitted when the tube application connects to the CM's socket.</p> <p>This signal is only fired on the accepting side.</p>
| 
 | A TpChannel or subclass | 
| 
 | Callback to be called when the signal is received | 
| 
 | User-supplied data for the callback | 
| 
 | Destructor for the user-supplied data, which
will be called when this signal is disconnected, or
before this function returns NULL | 
| 
 | A GObject which will be weakly referenced; if it is destroyed, this callback will automatically be disconnected | 
| 
 | If not NULL, used to raise an error ifNULLis
returned | 
| Returns : | a TpProxySignalConnection containing all of the
above, which can be used to disconnect the signal; or NULLif the proxy does not have the desired interface
or has become invalid. | 
TpProxySignalConnection * tp_cli_channel_type_stream_tube_connect_to_connection_closed (TpChannel *proxy,tp_cli_channel_type_stream_tube_signal_callback_connection_closed callback,gpointer user_data,GDestroyNotify destroy,GObject *weak_object,GError **error);
Connect a handler to the signal ConnectionClosed.
<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Emitted when a connection has been closed.</p>
| 
 | A TpChannel or subclass | 
| 
 | Callback to be called when the signal is received | 
| 
 | User-supplied data for the callback | 
| 
 | Destructor for the user-supplied data, which
will be called when this signal is disconnected, or
before this function returns NULL | 
| 
 | A GObject which will be weakly referenced; if it is destroyed, this callback will automatically be disconnected | 
| 
 | If not NULL, used to raise an error ifNULLis
returned | 
| Returns : | a TpProxySignalConnection containing all of the
above, which can be used to disconnect the signal; or NULLif the proxy does not have the desired interface
or has become invalid. | 
void (*tp_cli_channel_type_stream_tube_signal_callback_new_remote_connection) (TpChannel *proxy,guint arg_Handle,const GValue *arg_Connection_Param,guint arg_Connection_ID,gpointer user_data,GObject *weak_object);
Represents the signature of a callback for the signal NewRemoteConnection.
| 
 | The proxy on which tp_cli_channel_type_stream_tube_connect_to_new_remote_connection()was called | 
| 
 | The handle of the participant who opened the new connection (TpContactHandle) | 
| 
 | <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>A parameter which can be used by the listening process to identify the connection. Note that this parameter has a meaningful value only in the Socket_Access_Control_Port and Socket_Access_Control_Credentials cases. If a different Socket_Access_Control has been chosen when offering the tube, this parameter should be ignored.</p> <p>In the Socket_Access_Control_Port case, the variant contains a struct Socket_Address_IPv4 (or Socket_Address_IPv6) containing the address from which the CM is connected to the client application.</p> <p>In the Socket_Access_Control_Credentials case, the variant contains the byte (D-Bus signature 'y') that has been sent with the credentials.</p> | 
| 
 | The unique ID associated with this connection. This ID will be used to identifiy the connection when reporting errors with <tp:member-ref>ConnectionClosed</tp:member-ref>. (TpStreamTubeConnectionID) | 
| 
 | User-supplied data | 
| 
 | User-supplied weakly referenced object | 
void (*tp_cli_channel_type_stream_tube_signal_callback_new_local_connection) (TpChannel *proxy,guint arg_Connection_ID,gpointer user_data,GObject *weak_object);
Represents the signature of a callback for the signal NewLocalConnection.
| 
 | The proxy on which tp_cli_channel_type_stream_tube_connect_to_new_local_connection()was called | 
| 
 | The unique ID associated with this connection. This ID will be used to identifiy the connection when reporting errors with <tp:member-ref>ConnectionClosed</tp:member-ref>. (TpStreamTubeConnectionID) | 
| 
 | User-supplied data | 
| 
 | User-supplied weakly referenced object | 
void (*tp_cli_channel_type_stream_tube_signal_callback_connection_closed) (TpChannel *proxy,guint arg_Connection_ID,const gchar *arg_Error,const gchar *arg_Message,gpointer user_data,GObject *weak_object);
Represents the signature of a callback for the signal ConnectionClosed.
| 
 | The proxy on which tp_cli_channel_type_stream_tube_connect_to_connection_closed()was called | 
| 
 | The ID of the connection. (TpStreamTubeConnectionID) | 
| 
 | <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>The name of a D-Bus error describing the error that occurred.</p> <p>The following errors can be used:</p> <ul> <li><code>org.freedesktop.Telepathy.Error.Cancelled</code>: user closed the socket or the tube.</li> <li><code>org.freedesktop.Telepathy.Error.ConnectionLost</code>: the bytestream relaying connection's data has been broken.</li> <li><code>org.freedesktop.Telepathy.Error.ConnectionRefused</code>: the tube offer refused the connection.</li> </ul> | 
| 
 | A debug message. | 
| 
 | User-supplied data | 
| 
 | User-supplied weakly referenced object | 
gboolean tp_cli_channel_type_dbus_tube_run_offer (TpChannel *proxy,gint timeout_ms,GHashTable *in_parameters,guint in_access_control,gchar **out_address,GError **error,GMainLoop **loop);
tp_cli_channel_type_dbus_tube_run_offer is deprecated and should not be used in newly-written code.
Call the method Offer and run the main loop until it returns. Before calling this method, you must add a reference to any borrowed objects you need to keep, and generally ensure that everything is in a consistent state.
Offers a D-Bus tube providing the service specified.
| 
 | A TpChannel or subclass | 
| 
 | Timeout in milliseconds, or -1 for default | 
| 
 | Used to pass an 'in' argument: The dictionary of arbitrary <tp:dbus-ref namespace="org.freedesktop.Telepathy.Channel.Interface.Tube">Parameters</tp:dbus-ref> to send with the tube offer. | 
| 
 | Used to pass an 'in' argument: The access control the connection manager applies to the D-Bus socket. (TpSocketAccessControl) | 
| 
 | Used to return an 'out' argument if TRUEis returned: The string describing the address of the private bus. The client           SHOULD NOT attempt to connect to the address until the tube is open. | 
| 
 | If not NULL, used to return errors ifFALSEis returned | 
| 
 | If not NULL, set before re-entering
the main loop, to point to a GMainLoop
which can be used to cancel this call withg_main_loop_quit(), causing a return ofFALSEwitherrorset toTP_DBUS_ERROR_CANCELLED | 
| Returns : | TRUE on success, FALSE and sets erroron error | 
gboolean tp_cli_channel_type_dbus_tube_run_accept (TpChannel *proxy,gint timeout_ms,guint in_access_control,gchar **out_address,GError **error,GMainLoop **loop);
tp_cli_channel_type_dbus_tube_run_accept is deprecated and should not be used in newly-written code.
Call the method Accept and run the main loop until it returns. Before calling this method, you must add a reference to any borrowed objects you need to keep, and generally ensure that everything is in a consistent state.
Accept a D-Bus tube that's in the "local pending" state. The connection manager will attempt to open the tube. The tube remains in the "local pending" state until the <tp:dbus-ref namespace="org.freedesktop.Telepathy.Channel.Interface.Tube">TubeChannelStateChanged</tp:dbus-ref> signal is emitted.
| 
 | A TpChannel or subclass | 
| 
 | Timeout in milliseconds, or -1 for default | 
| 
 | Used to pass an 'in' argument: The access control the connection manager applies to the D-Bus socket. (TpSocketAccessControl) | 
| 
 | Used to return an 'out' argument if TRUEis returned: The string describing the address of the private bus. The client           SHOULD NOT attempt to connect to the address until the tube is open. | 
| 
 | If not NULL, used to return errors ifFALSEis returned | 
| 
 | If not NULL, set before re-entering
the main loop, to point to a GMainLoop
which can be used to cancel this call withg_main_loop_quit(), causing a return ofFALSEwitherrorset toTP_DBUS_ERROR_CANCELLED | 
| Returns : | TRUE on success, FALSE and sets erroron error | 
TpProxyPendingCall * tp_cli_channel_type_dbus_tube_call_offer (TpChannel *proxy,gint timeout_ms,GHashTable *in_parameters,guint in_access_control,tp_cli_channel_type_dbus_tube_callback_for_offer callback,gpointer user_data,GDestroyNotify destroy,GObject *weak_object);
Start a Offer method call.
Offers a D-Bus tube providing the service specified.
| 
 | the TpProxy | 
| 
 | the timeout in milliseconds, or -1 to use the default | 
| 
 | Used to pass an 'in' argument: The dictionary of arbitrary <tp:dbus-ref namespace="org.freedesktop.Telepathy.Channel.Interface.Tube">Parameters</tp:dbus-ref> to send with the tube offer. | 
| 
 | Used to pass an 'in' argument: The access control the connection manager applies to the D-Bus socket. (TpSocketAccessControl) | 
| 
 | called when the method call succeeds or fails;
may be NULLto make a "fire and forget" call with no
reply tracking | 
| 
 | user-supplied data passed to the callback;
must be NULLifcallbackisNULL | 
| 
 | called with the user_data as argument, after the
call has succeeded, failed or been cancelled;
must be NULLifcallbackisNULL | 
| 
 | If not NULL, a GObject which will be
weakly referenced; if it is destroyed, this call
will automatically be cancelled. Must beNULLifcallbackisNULL | 
| Returns : | a TpProxyPendingCall representing the call in progress. It is borrowed from the object, and will become invalid when the callback is called, the call is cancelled or the TpProxy becomes invalid. | 
TpProxyPendingCall * tp_cli_channel_type_dbus_tube_call_accept (TpChannel *proxy,gint timeout_ms,guint in_access_control,tp_cli_channel_type_dbus_tube_callback_for_accept callback,gpointer user_data,GDestroyNotify destroy,GObject *weak_object);
Start a Accept method call.
Accept a D-Bus tube that's in the "local pending" state. The connection manager will attempt to open the tube. The tube remains in the "local pending" state until the <tp:dbus-ref namespace="org.freedesktop.Telepathy.Channel.Interface.Tube">TubeChannelStateChanged</tp:dbus-ref> signal is emitted.
| 
 | the TpProxy | 
| 
 | the timeout in milliseconds, or -1 to use the default | 
| 
 | Used to pass an 'in' argument: The access control the connection manager applies to the D-Bus socket. (TpSocketAccessControl) | 
| 
 | called when the method call succeeds or fails;
may be NULLto make a "fire and forget" call with no
reply tracking | 
| 
 | user-supplied data passed to the callback;
must be NULLifcallbackisNULL | 
| 
 | called with the user_data as argument, after the
call has succeeded, failed or been cancelled;
must be NULLifcallbackisNULL | 
| 
 | If not NULL, a GObject which will be
weakly referenced; if it is destroyed, this call
will automatically be cancelled. Must beNULLifcallbackisNULL | 
| Returns : | a TpProxyPendingCall representing the call in progress. It is borrowed from the object, and will become invalid when the callback is called, the call is cancelled or the TpProxy becomes invalid. | 
void (*tp_cli_channel_type_dbus_tube_callback_for_offer) (TpChannel *proxy,const gchar *out_address,const GError *error,gpointer user_data,GObject *weak_object);
Signature of the callback called when a Offer method call succeeds or fails.
| 
 | the proxy on which the call was made | 
| 
 | Used to return an 'out' argument if errorisNULL: The string describing the address of the private bus. The client           SHOULD NOT attempt to connect to the address until the tube is open. | 
| 
 | NULLon success, or an error on failure | 
| 
 | user-supplied data | 
| 
 | user-supplied object | 
void (*tp_cli_channel_type_dbus_tube_callback_for_accept) (TpChannel *proxy,const gchar *out_address,const GError *error,gpointer user_data,GObject *weak_object);
Signature of the callback called when a Accept method call succeeds or fails.
| 
 | the proxy on which the call was made | 
| 
 | Used to return an 'out' argument if errorisNULL: The string describing the address of the private bus. The client           SHOULD NOT attempt to connect to the address until the tube is open. | 
| 
 | NULLon success, or an error on failure | 
| 
 | user-supplied data | 
| 
 | user-supplied object | 
TpProxySignalConnection * tp_cli_channel_type_dbus_tube_connect_to_dbus_names_changed (TpChannel *proxy,tp_cli_channel_type_dbus_tube_signal_callback_dbus_names_changed callback,gpointer user_data,GDestroyNotify destroy,GObject *weak_object,GError **error);
Connect a handler to the signal DBusNamesChanged.
Emitted on a multi-user (i.e. Handle_Type_Room) D-Bus tube when a participant opens or closes the tube. This provides change notification for the <tp:member-ref>DBusNames</tp:member-ref> property.
| 
 | A TpChannel or subclass | 
| 
 | Callback to be called when the signal is received | 
| 
 | User-supplied data for the callback | 
| 
 | Destructor for the user-supplied data, which
will be called when this signal is disconnected, or
before this function returns NULL | 
| 
 | A GObject which will be weakly referenced; if it is destroyed, this callback will automatically be disconnected | 
| 
 | If not NULL, used to raise an error ifNULLis
returned | 
| Returns : | a TpProxySignalConnection containing all of the
above, which can be used to disconnect the signal; or NULLif the proxy does not have the desired interface
or has become invalid. | 
void (*tp_cli_channel_type_dbus_tube_signal_callback_dbus_names_changed) (TpChannel *proxy,GHashTable *arg_Added,const GArray *arg_Removed,gpointer user_data,GObject *weak_object);
Represents the signature of a callback for the signal DBusNamesChanged.
| 
 | The proxy on which tp_cli_channel_type_dbus_tube_connect_to_dbus_names_changed()was called | 
| 
 | Array of handles and D-Bus names of new participants. | 
| 
 | Array of handles of former participants. | 
| 
 | User-supplied data | 
| 
 | User-supplied weakly referenced object |