Tubes channels

Tubes channels — client-side wrappers for the Tubes channel type

Functions

gboolean tp_cli_channel_type_tubes_run_accept_d_bus_tube ()
gboolean tp_cli_channel_type_tubes_run_accept_stream_tube ()
gboolean tp_cli_channel_type_tubes_run_close_tube ()
gboolean tp_cli_channel_type_tubes_run_get_available_stream_tube_types ()
gboolean tp_cli_channel_type_tubes_run_get_available_tube_types ()
gboolean tp_cli_channel_type_tubes_run_get_d_bus_names ()
gboolean tp_cli_channel_type_tubes_run_get_d_bus_tube_address ()
gboolean tp_cli_channel_type_tubes_run_get_stream_tube_socket_address ()
gboolean tp_cli_channel_type_tubes_run_list_tubes ()
gboolean tp_cli_channel_type_tubes_run_offer_d_bus_tube ()
gboolean tp_cli_channel_type_tubes_run_offer_stream_tube ()
TpProxyPendingCall * tp_cli_channel_type_tubes_call_accept_d_bus_tube ()
TpProxyPendingCall * tp_cli_channel_type_tubes_call_accept_stream_tube ()
TpProxyPendingCall * tp_cli_channel_type_tubes_call_close_tube ()
TpProxyPendingCall * tp_cli_channel_type_tubes_call_get_available_stream_tube_types ()
TpProxyPendingCall * tp_cli_channel_type_tubes_call_get_available_tube_types ()
TpProxyPendingCall * tp_cli_channel_type_tubes_call_get_d_bus_names ()
TpProxyPendingCall * tp_cli_channel_type_tubes_call_get_d_bus_tube_address ()
TpProxyPendingCall * tp_cli_channel_type_tubes_call_get_stream_tube_socket_address ()
TpProxyPendingCall * tp_cli_channel_type_tubes_call_list_tubes ()
TpProxyPendingCall * tp_cli_channel_type_tubes_call_offer_d_bus_tube ()
TpProxyPendingCall * tp_cli_channel_type_tubes_call_offer_stream_tube ()
void (*tp_cli_channel_type_tubes_callback_for_accept_d_bus_tube) ()
void (*tp_cli_channel_type_tubes_callback_for_accept_stream_tube) ()
void (*tp_cli_channel_type_tubes_callback_for_close_tube) ()
void (*tp_cli_channel_type_tubes_callback_for_get_available_stream_tube_types) ()
void (*tp_cli_channel_type_tubes_callback_for_get_available_tube_types) ()
void (*tp_cli_channel_type_tubes_callback_for_get_d_bus_names) ()
void (*tp_cli_channel_type_tubes_callback_for_get_d_bus_tube_address) ()
void (*tp_cli_channel_type_tubes_callback_for_get_stream_tube_socket_address) ()
void (*tp_cli_channel_type_tubes_callback_for_list_tubes) ()
void (*tp_cli_channel_type_tubes_callback_for_offer_d_bus_tube) ()
void (*tp_cli_channel_type_tubes_callback_for_offer_stream_tube) ()
TpProxySignalConnection * tp_cli_channel_type_tubes_connect_to_d_bus_names_changed ()
TpProxySignalConnection * tp_cli_channel_type_tubes_connect_to_new_tube ()
TpProxySignalConnection * tp_cli_channel_type_tubes_connect_to_stream_tube_new_connection ()
TpProxySignalConnection * tp_cli_channel_type_tubes_connect_to_tube_closed ()
TpProxySignalConnection * tp_cli_channel_type_tubes_connect_to_tube_state_changed ()
void (*tp_cli_channel_type_tubes_signal_callback_d_bus_names_changed) ()
void (*tp_cli_channel_type_tubes_signal_callback_new_tube) ()
void (*tp_cli_channel_type_tubes_signal_callback_stream_tube_new_connection) ()
void (*tp_cli_channel_type_tubes_signal_callback_tube_closed) ()
void (*tp_cli_channel_type_tubes_signal_callback_tube_state_changed) ()

Includes

#include <telepathy-glib/telepathy-glib-dbus.h>

Description

A "tube" is a mechanism for arbitrary data transfer. This section documents the auto-generated C wrappers for the Tubes channel type.

Functions

tp_cli_channel_type_tubes_run_accept_d_bus_tube ()

gboolean
tp_cli_channel_type_tubes_run_accept_d_bus_tube
                               (TpChannel *proxy,
                                gint timeout_ms,
                                guint in_ID,
                                gchar **out_Address,
                                GError **error,
                                GMainLoop **loop);

tp_cli_channel_type_tubes_run_accept_d_bus_tube is deprecated and should not be used in newly-written code.

Call the method AcceptDBusTube 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 &quot;local pending&quot; state. The connection manager will attempt to open the tube. The tube remains in the &quot;local pending&quot; state until the TubeStateChanged signal is emitted.

Parameters

proxy

A TpChannel or subclass

 

timeout_ms

Timeout in milliseconds, or -1 for default

 

in_ID

Used to pass an 'in' argument: The ID of the tube to accept. (TpTubeID)

 

out_Address

Used to return an 'out' argument if TRUE is 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.

 

error

If not NULL, used to return errors if FALSE is returned

 

loop

If not NULL, set before re-entering the main loop, to point to a GMainLoop which can be used to cancel this call with g_main_loop_quit(), causing a return of FALSE with error set to TP_DBUS_ERROR_CANCELLED

 

Returns

TRUE on success, FALSE and sets error on error


tp_cli_channel_type_tubes_run_accept_stream_tube ()

gboolean
tp_cli_channel_type_tubes_run_accept_stream_tube
                               (TpChannel *proxy,
                                gint timeout_ms,
                                guint in_ID,
                                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_tubes_run_accept_stream_tube is deprecated and should not be used in newly-written code.

Call the method AcceptStreamTube 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 &quot;local pending&quot; state. The connection manager will attempt to open the tube. The tube remains in the &quot;local pending&quot; state until the TubeStateChanged signal is emitted.

Parameters

proxy

A TpChannel or subclass

 

timeout_ms

Timeout in milliseconds, or -1 for default

 

in_ID

Used to pass an 'in' argument: The ID of the tube to accept. (TpTubeID)

 

in_Address_Type

Used to pass an 'in' argument: The type of address the connection manager should listen on. (TpSocketAddressType)

 

in_Access_Control

Used to pass an 'in' argument: The type of access control the connection manager should apply to the socket. (TpSocketAccessControl)

 

in_Access_Control_Param

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.

 

out_Address

Used to return an 'out' argument if TRUE is 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.

 

error

If not NULL, used to return errors if FALSE is returned

 

loop

If not NULL, set before re-entering the main loop, to point to a GMainLoop which can be used to cancel this call with g_main_loop_quit(), causing a return of FALSE with error set to TP_DBUS_ERROR_CANCELLED

 

Returns

TRUE on success, FALSE and sets error on error


tp_cli_channel_type_tubes_run_close_tube ()

gboolean
tp_cli_channel_type_tubes_run_close_tube
                               (TpChannel *proxy,
                                gint timeout_ms,
                                guint in_ID,
                                GError **error,
                                GMainLoop **loop);

tp_cli_channel_type_tubes_run_close_tube is deprecated and should not be used in newly-written code.

Call the method CloseTube 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.

Close a tube.

Parameters

proxy

A TpChannel or subclass

 

timeout_ms

Timeout in milliseconds, or -1 for default

 

in_ID

Used to pass an 'in' argument: The ID of the tube to close. (TpTubeID)

 

error

If not NULL, used to return errors if FALSE is returned

 

loop

If not NULL, set before re-entering the main loop, to point to a GMainLoop which can be used to cancel this call with g_main_loop_quit(), causing a return of FALSE with error set to TP_DBUS_ERROR_CANCELLED

 

Returns

TRUE on success, FALSE and sets error on error


tp_cli_channel_type_tubes_run_get_available_stream_tube_types ()

gboolean
tp_cli_channel_type_tubes_run_get_available_stream_tube_types
                               (TpChannel *proxy,
                                gint timeout_ms,
                                GHashTable **out_Available_Stream_Tube_Types,
                                GError **error,
                                GMainLoop **loop);

tp_cli_channel_type_tubes_run_get_available_stream_tube_types is deprecated and should not be used in newly-written code.

Call the method GetAvailableStreamTubeTypes 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.

List the available address types and access-control types for stream tubes.

Parameters

proxy

A TpChannel or subclass

 

timeout_ms

Timeout in milliseconds, or -1 for default

 

out_Available_Stream_Tube_Types

Used to return an 'out' argument if TRUE is returned: <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>A mapping from address types (members of Socket_Address_Type) to arrays of access-control type (members of Socket_Access_Control) that the connection manager supports for stream tubes with that address type. For simplicity, if a CM supports offering a particular type of tube, it is assumed to support accepting it.</p> <p>A typical value for a host without IPv6 support:</p> <pre> { Socket_Address_Type_IPv4: [Socket_Access_Control_Localhost, Socket_Access_Control_Port, Socket_Access_Control_Netmask], Socket_Address_Type_Unix: [Socket_Access_Control_Localhost, Socket_Access_Control_Credentials] } </pre> <p>If stream tubes are not supported, this will be an empty dictionary.</p>

 

error

If not NULL, used to return errors if FALSE is returned

 

loop

If not NULL, set before re-entering the main loop, to point to a GMainLoop which can be used to cancel this call with g_main_loop_quit(), causing a return of FALSE with error set to TP_DBUS_ERROR_CANCELLED

 

Returns

TRUE on success, FALSE and sets error on error


tp_cli_channel_type_tubes_run_get_available_tube_types ()

gboolean
tp_cli_channel_type_tubes_run_get_available_tube_types
                               (TpChannel *proxy,
                                gint timeout_ms,
                                GArray **out_Available_Tube_Types,
                                GError **error,
                                GMainLoop **loop);

tp_cli_channel_type_tubes_run_get_available_tube_types is deprecated and should not be used in newly-written code.

Call the method GetAvailableTubeTypes 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.

(Undocumented)

Parameters

proxy

A TpChannel or subclass

 

timeout_ms

Timeout in milliseconds, or -1 for default

 

out_Available_Tube_Types

Used to return an 'out' argument if TRUE is returned: An array of the available tube types, as defined by the Tube_Type enum.

 

error

If not NULL, used to return errors if FALSE is returned

 

loop

If not NULL, set before re-entering the main loop, to point to a GMainLoop which can be used to cancel this call with g_main_loop_quit(), causing a return of FALSE with error set to TP_DBUS_ERROR_CANCELLED

 

Returns

TRUE on success, FALSE and sets error on error


tp_cli_channel_type_tubes_run_get_d_bus_names ()

gboolean
tp_cli_channel_type_tubes_run_get_d_bus_names
                               (TpChannel *proxy,
                                gint timeout_ms,
                                guint in_ID,
                                GPtrArray **out_DBus_Names,
                                GError **error,
                                GMainLoop **loop);

tp_cli_channel_type_tubes_run_get_d_bus_names is deprecated and should not be used in newly-written code.

Call the method GetDBusNames 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.

For a multi-user (i.e. Handle_Type_Room) D-Bus tube, obtain a mapping between contact handles and their unique bus names on this tube.

Parameters

proxy

A TpChannel or subclass

 

timeout_ms

Timeout in milliseconds, or -1 for default

 

in_ID

Used to pass an 'in' argument: The ID of the tube to get names for. (TpTubeID)

 

out_DBus_Names

Used to return an 'out' argument if TRUE is returned: An array of structures, each containing a contact handle and a D-Bus bus name.

 

error

If not NULL, used to return errors if FALSE is returned

 

loop

If not NULL, set before re-entering the main loop, to point to a GMainLoop which can be used to cancel this call with g_main_loop_quit(), causing a return of FALSE with error set to TP_DBUS_ERROR_CANCELLED

 

Returns

TRUE on success, FALSE and sets error on error


tp_cli_channel_type_tubes_run_get_d_bus_tube_address ()

gboolean
tp_cli_channel_type_tubes_run_get_d_bus_tube_address
                               (TpChannel *proxy,
                                gint timeout_ms,
                                guint in_ID,
                                gchar **out_Address,
                                GError **error,
                                GMainLoop **loop);

tp_cli_channel_type_tubes_run_get_d_bus_tube_address is deprecated and should not be used in newly-written code.

Call the method GetDBusTubeAddress 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.

For a D-Bus tube, return a string describing the address of the private bus.

Parameters

proxy

A TpChannel or subclass

 

timeout_ms

Timeout in milliseconds, or -1 for default

 

in_ID

Used to pass an 'in' argument: The ID of the tube to get an address for. (TpTubeID)

 

out_Address

Used to return an 'out' argument if TRUE is returned: The bus address.

 

error

If not NULL, used to return errors if FALSE is returned

 

loop

If not NULL, set before re-entering the main loop, to point to a GMainLoop which can be used to cancel this call with g_main_loop_quit(), causing a return of FALSE with error set to TP_DBUS_ERROR_CANCELLED

 

Returns

TRUE on success, FALSE and sets error on error


tp_cli_channel_type_tubes_run_get_stream_tube_socket_address ()

gboolean
tp_cli_channel_type_tubes_run_get_stream_tube_socket_address
                               (TpChannel *proxy,
                                gint timeout_ms,
                                guint in_ID,
                                guint *out_Address_Type,
                                GValue **out_Address,
                                GError **error,
                                GMainLoop **loop);

tp_cli_channel_type_tubes_run_get_stream_tube_socket_address is deprecated and should not be used in newly-written code.

Call the method GetStreamTubeSocketAddress 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.

For a stream tube, obtain the address of the socket used to communicate over this tube.

Parameters

proxy

A TpChannel or subclass

 

timeout_ms

Timeout in milliseconds, or -1 for default

 

in_ID

Used to pass an 'in' argument: The ID of the stream tube to get the socket for. (TpTubeID)

 

out_Address_Type

Used to return an 'out' argument if TRUE is returned: The type of the listening address of the socket, as a member of Socket_Address_Type.

 

out_Address

Used to return an 'out' argument if TRUE is returned: The listening address of the socket, as indicated by the address_type.

 

error

If not NULL, used to return errors if FALSE is returned

 

loop

If not NULL, set before re-entering the main loop, to point to a GMainLoop which can be used to cancel this call with g_main_loop_quit(), causing a return of FALSE with error set to TP_DBUS_ERROR_CANCELLED

 

Returns

TRUE on success, FALSE and sets error on error


tp_cli_channel_type_tubes_run_list_tubes ()

gboolean
tp_cli_channel_type_tubes_run_list_tubes
                               (TpChannel *proxy,
                                gint timeout_ms,
                                GPtrArray **out_Tubes,
                                GError **error,
                                GMainLoop **loop);

tp_cli_channel_type_tubes_run_list_tubes is deprecated and should not be used in newly-written code.

Call the method ListTubes 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.

(Undocumented)

Parameters

proxy

A TpChannel or subclass

 

timeout_ms

Timeout in milliseconds, or -1 for default

 

out_Tubes

Used to return an 'out' argument if TRUE is returned: Return an array of tuples, each representing a tube, with the following members: <ul> <li>the tube's ID</li> <li>the tube's initiator</li> <li>the tube's type</li> <li>the tube's service</li> <li>the tube's parameters</li> <li>the tube's state</li> </ul>

 

error

If not NULL, used to return errors if FALSE is returned

 

loop

If not NULL, set before re-entering the main loop, to point to a GMainLoop which can be used to cancel this call with g_main_loop_quit(), causing a return of FALSE with error set to TP_DBUS_ERROR_CANCELLED

 

Returns

TRUE on success, FALSE and sets error on error


tp_cli_channel_type_tubes_run_offer_d_bus_tube ()

gboolean
tp_cli_channel_type_tubes_run_offer_d_bus_tube
                               (TpChannel *proxy,
                                gint timeout_ms,
                                const gchar *in_Service,
                                GHashTable *in_Parameters,
                                guint *out_Tube_ID,
                                GError **error,
                                GMainLoop **loop);

tp_cli_channel_type_tubes_run_offer_d_bus_tube is deprecated and should not be used in newly-written code.

Call the method OfferDBusTube 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.

Parameters

proxy

A TpChannel or subclass

 

timeout_ms

Timeout in milliseconds, or -1 for default

 

in_Service

Used to pass an 'in' argument: A string representing the service name that will be used over the tube. It should be a well-known D-Bus service name, of the form com.example.ServiceName.

 

in_Parameters

Used to pass an 'in' argument: A dictionary of properties for the new tube; the allowable keys, types and values are defined by the service. Connection managers must support the value being any primitive (non-container) D-Bus type, or a byte array 'ay'.

 

out_Tube_ID

Used to return an 'out' argument if TRUE is returned: The ID of the new tube.

 

error

If not NULL, used to return errors if FALSE is returned

 

loop

If not NULL, set before re-entering the main loop, to point to a GMainLoop which can be used to cancel this call with g_main_loop_quit(), causing a return of FALSE with error set to TP_DBUS_ERROR_CANCELLED

 

Returns

TRUE on success, FALSE and sets error on error


tp_cli_channel_type_tubes_run_offer_stream_tube ()

gboolean
tp_cli_channel_type_tubes_run_offer_stream_tube
                               (TpChannel *proxy,
                                gint timeout_ms,
                                const gchar *in_Service,
                                GHashTable *in_Parameters,
                                guint in_Address_Type,
                                const GValue *in_Address,
                                guint in_Access_Control,
                                const GValue *in_Access_Control_Param,
                                guint *out_Tube_ID,
                                GError **error,
                                GMainLoop **loop);

tp_cli_channel_type_tubes_run_offer_stream_tube is deprecated and should not be used in newly-written code.

Call the method OfferStreamTube 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.

Parameters

proxy

A TpChannel or subclass

 

timeout_ms

Timeout in milliseconds, or -1 for default

 

in_Service

Used to pass an 'in' argument: <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> A string representing the service name that will be used over the tube. It should be a well-known TCP service name as defined by <a href="http://www.iana.org/assignments/port-numbers"> http://www.iana.org/assignments/port-numbers</a> or <a href="http://www.dns-sd.org/ServiceTypes.html"> http://www.dns-sd.org/ServiceTypes.html</a>, for instance &quot;rsync&quot; or &quot;daap&quot;.

 

in_Parameters

Used to pass an 'in' argument: <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>A dictionary of properties for the new tube; the allowable keys, types and values are defined by the service. Connection managers must support the value being any primitive (non-container) D-Bus type, or a byte array 'ay'.</p> <p>These should usually be the same key-value pairs specified for use in the DNS-SD TXT record for that service.</p>

 

in_Address_Type

Used to pass an 'in' argument: The type of the listening address of the local service, as a member of Socket_Address_Type. (TpSocketAddressType)

 

in_Address

Used to pass an 'in' argument: The listening address of the local service, as indicated by the address_type.

 

in_Access_Control

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)

 

in_Access_Control_Param

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.

 

out_Tube_ID

Used to return an 'out' argument if TRUE is returned: The ID of the new tube.

 

error

If not NULL, used to return errors if FALSE is returned

 

loop

If not NULL, set before re-entering the main loop, to point to a GMainLoop which can be used to cancel this call with g_main_loop_quit(), causing a return of FALSE with error set to TP_DBUS_ERROR_CANCELLED

 

Returns

TRUE on success, FALSE and sets error on error


tp_cli_channel_type_tubes_call_accept_d_bus_tube ()

TpProxyPendingCall *
tp_cli_channel_type_tubes_call_accept_d_bus_tube
                               (TpChannel *proxy,
                                gint timeout_ms,
                                guint in_ID,
                                tp_cli_channel_type_tubes_callback_for_accept_d_bus_tube callback,
                                gpointer user_data,
                                GDestroyNotify destroy,
                                GObject *weak_object);

Start a AcceptDBusTube method call.

Accept a D-Bus tube that's in the &quot;local pending&quot; state. The connection manager will attempt to open the tube. The tube remains in the &quot;local pending&quot; state until the TubeStateChanged signal is emitted.

Parameters

proxy

the TpProxy

 

timeout_ms

the timeout in milliseconds, or -1 to use the default

 

in_ID

Used to pass an 'in' argument: The ID of the tube to accept. (TpTubeID)

 

callback

called when the method call succeeds or fails; may be NULL to make a "fire and forget" call with no reply tracking

 

user_data

user-supplied data passed to the callback; must be NULL if callback is NULL

 

destroy

called with the user_data as argument, after the call has succeeded, failed or been cancelled; must be NULL if callback is NULL

 

weak_object

If not NULL, a GObject which will be weakly referenced; if it is destroyed, this call will automatically be cancelled. Must be NULL if callback is NULL

 

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.


tp_cli_channel_type_tubes_call_accept_stream_tube ()

TpProxyPendingCall *
tp_cli_channel_type_tubes_call_accept_stream_tube
                               (TpChannel *proxy,
                                gint timeout_ms,
                                guint in_ID,
                                guint in_Address_Type,
                                guint in_Access_Control,
                                const GValue *in_Access_Control_Param,
                                tp_cli_channel_type_tubes_callback_for_accept_stream_tube callback,
                                gpointer user_data,
                                GDestroyNotify destroy,
                                GObject *weak_object);

Start a AcceptStreamTube method call.

Accept a stream tube that's in the &quot;local pending&quot; state. The connection manager will attempt to open the tube. The tube remains in the &quot;local pending&quot; state until the TubeStateChanged signal is emitted.

Parameters

proxy

the TpProxy

 

timeout_ms

the timeout in milliseconds, or -1 to use the default

 

in_ID

Used to pass an 'in' argument: The ID of the tube to accept. (TpTubeID)

 

in_Address_Type

Used to pass an 'in' argument: The type of address the connection manager should listen on. (TpSocketAddressType)

 

in_Access_Control

Used to pass an 'in' argument: The type of access control the connection manager should apply to the socket. (TpSocketAccessControl)

 

in_Access_Control_Param

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.

 

callback

called when the method call succeeds or fails; may be NULL to make a "fire and forget" call with no reply tracking

 

user_data

user-supplied data passed to the callback; must be NULL if callback is NULL

 

destroy

called with the user_data as argument, after the call has succeeded, failed or been cancelled; must be NULL if callback is NULL

 

weak_object

If not NULL, a GObject which will be weakly referenced; if it is destroyed, this call will automatically be cancelled. Must be NULL if callback is NULL

 

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.


tp_cli_channel_type_tubes_call_close_tube ()

TpProxyPendingCall *
tp_cli_channel_type_tubes_call_close_tube
                               (TpChannel *proxy,
                                gint timeout_ms,
                                guint in_ID,
                                tp_cli_channel_type_tubes_callback_for_close_tube callback,
                                gpointer user_data,
                                GDestroyNotify destroy,
                                GObject *weak_object);

Start a CloseTube method call.

Close a tube.

Parameters

proxy

the TpProxy

 

timeout_ms

the timeout in milliseconds, or -1 to use the default

 

in_ID

Used to pass an 'in' argument: The ID of the tube to close. (TpTubeID)

 

callback

called when the method call succeeds or fails; may be NULL to make a "fire and forget" call with no reply tracking

 

user_data

user-supplied data passed to the callback; must be NULL if callback is NULL

 

destroy

called with the user_data as argument, after the call has succeeded, failed or been cancelled; must be NULL if callback is NULL

 

weak_object

If not NULL, a GObject which will be weakly referenced; if it is destroyed, this call will automatically be cancelled. Must be NULL if callback is NULL

 

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.


tp_cli_channel_type_tubes_call_get_available_stream_tube_types ()

TpProxyPendingCall *
tp_cli_channel_type_tubes_call_get_available_stream_tube_types
                               (TpChannel *proxy,
                                gint timeout_ms,
                                tp_cli_channel_type_tubes_callback_for_get_available_stream_tube_types callback,
                                gpointer user_data,
                                GDestroyNotify destroy,
                                GObject *weak_object);

Start a GetAvailableStreamTubeTypes method call.

List the available address types and access-control types for stream tubes.

Parameters

proxy

the TpProxy

 

timeout_ms

the timeout in milliseconds, or -1 to use the default

 

callback

called when the method call succeeds or fails; may be NULL to make a "fire and forget" call with no reply tracking

 

user_data

user-supplied data passed to the callback; must be NULL if callback is NULL

 

destroy

called with the user_data as argument, after the call has succeeded, failed or been cancelled; must be NULL if callback is NULL

 

weak_object

If not NULL, a GObject which will be weakly referenced; if it is destroyed, this call will automatically be cancelled. Must be NULL if callback is NULL

 

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.


tp_cli_channel_type_tubes_call_get_available_tube_types ()

TpProxyPendingCall *
tp_cli_channel_type_tubes_call_get_available_tube_types
                               (TpChannel *proxy,
                                gint timeout_ms,
                                tp_cli_channel_type_tubes_callback_for_get_available_tube_types callback,
                                gpointer user_data,
                                GDestroyNotify destroy,
                                GObject *weak_object);

Start a GetAvailableTubeTypes method call.

(Undocumented)

Parameters

proxy

the TpProxy

 

timeout_ms

the timeout in milliseconds, or -1 to use the default

 

callback

called when the method call succeeds or fails; may be NULL to make a "fire and forget" call with no reply tracking

 

user_data

user-supplied data passed to the callback; must be NULL if callback is NULL

 

destroy

called with the user_data as argument, after the call has succeeded, failed or been cancelled; must be NULL if callback is NULL

 

weak_object

If not NULL, a GObject which will be weakly referenced; if it is destroyed, this call will automatically be cancelled. Must be NULL if callback is NULL

 

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.


tp_cli_channel_type_tubes_call_get_d_bus_names ()

TpProxyPendingCall *
tp_cli_channel_type_tubes_call_get_d_bus_names
                               (TpChannel *proxy,
                                gint timeout_ms,
                                guint in_ID,
                                tp_cli_channel_type_tubes_callback_for_get_d_bus_names callback,
                                gpointer user_data,
                                GDestroyNotify destroy,
                                GObject *weak_object);

Start a GetDBusNames method call.

For a multi-user (i.e. Handle_Type_Room) D-Bus tube, obtain a mapping between contact handles and their unique bus names on this tube.

Parameters

proxy

the TpProxy

 

timeout_ms

the timeout in milliseconds, or -1 to use the default

 

in_ID

Used to pass an 'in' argument: The ID of the tube to get names for. (TpTubeID)

 

callback

called when the method call succeeds or fails; may be NULL to make a "fire and forget" call with no reply tracking

 

user_data

user-supplied data passed to the callback; must be NULL if callback is NULL

 

destroy

called with the user_data as argument, after the call has succeeded, failed or been cancelled; must be NULL if callback is NULL

 

weak_object

If not NULL, a GObject which will be weakly referenced; if it is destroyed, this call will automatically be cancelled. Must be NULL if callback is NULL

 

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.


tp_cli_channel_type_tubes_call_get_d_bus_tube_address ()

TpProxyPendingCall *
tp_cli_channel_type_tubes_call_get_d_bus_tube_address
                               (TpChannel *proxy,
                                gint timeout_ms,
                                guint in_ID,
                                tp_cli_channel_type_tubes_callback_for_get_d_bus_tube_address callback,
                                gpointer user_data,
                                GDestroyNotify destroy,
                                GObject *weak_object);

Start a GetDBusTubeAddress method call.

For a D-Bus tube, return a string describing the address of the private bus.

Parameters

proxy

the TpProxy

 

timeout_ms

the timeout in milliseconds, or -1 to use the default

 

in_ID

Used to pass an 'in' argument: The ID of the tube to get an address for. (TpTubeID)

 

callback

called when the method call succeeds or fails; may be NULL to make a "fire and forget" call with no reply tracking

 

user_data

user-supplied data passed to the callback; must be NULL if callback is NULL

 

destroy

called with the user_data as argument, after the call has succeeded, failed or been cancelled; must be NULL if callback is NULL

 

weak_object

If not NULL, a GObject which will be weakly referenced; if it is destroyed, this call will automatically be cancelled. Must be NULL if callback is NULL

 

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.


tp_cli_channel_type_tubes_call_get_stream_tube_socket_address ()

TpProxyPendingCall *
tp_cli_channel_type_tubes_call_get_stream_tube_socket_address
                               (TpChannel *proxy,
                                gint timeout_ms,
                                guint in_ID,
                                tp_cli_channel_type_tubes_callback_for_get_stream_tube_socket_address callback,
                                gpointer user_data,
                                GDestroyNotify destroy,
                                GObject *weak_object);

Start a GetStreamTubeSocketAddress method call.

For a stream tube, obtain the address of the socket used to communicate over this tube.

Parameters

proxy

the TpProxy

 

timeout_ms

the timeout in milliseconds, or -1 to use the default

 

in_ID

Used to pass an 'in' argument: The ID of the stream tube to get the socket for. (TpTubeID)

 

callback

called when the method call succeeds or fails; may be NULL to make a "fire and forget" call with no reply tracking

 

user_data

user-supplied data passed to the callback; must be NULL if callback is NULL

 

destroy

called with the user_data as argument, after the call has succeeded, failed or been cancelled; must be NULL if callback is NULL

 

weak_object

If not NULL, a GObject which will be weakly referenced; if it is destroyed, this call will automatically be cancelled. Must be NULL if callback is NULL

 

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.


tp_cli_channel_type_tubes_call_list_tubes ()

TpProxyPendingCall *
tp_cli_channel_type_tubes_call_list_tubes
                               (TpChannel *proxy,
                                gint timeout_ms,
                                tp_cli_channel_type_tubes_callback_for_list_tubes callback,
                                gpointer user_data,
                                GDestroyNotify destroy,
                                GObject *weak_object);

Start a ListTubes method call.

(Undocumented)

Parameters

proxy

the TpProxy

 

timeout_ms

the timeout in milliseconds, or -1 to use the default

 

callback

called when the method call succeeds or fails; may be NULL to make a "fire and forget" call with no reply tracking

 

user_data

user-supplied data passed to the callback; must be NULL if callback is NULL

 

destroy

called with the user_data as argument, after the call has succeeded, failed or been cancelled; must be NULL if callback is NULL

 

weak_object

If not NULL, a GObject which will be weakly referenced; if it is destroyed, this call will automatically be cancelled. Must be NULL if callback is NULL

 

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.


tp_cli_channel_type_tubes_call_offer_d_bus_tube ()

TpProxyPendingCall *
tp_cli_channel_type_tubes_call_offer_d_bus_tube
                               (TpChannel *proxy,
                                gint timeout_ms,
                                const gchar *in_Service,
                                GHashTable *in_Parameters,
                                tp_cli_channel_type_tubes_callback_for_offer_d_bus_tube callback,
                                gpointer user_data,
                                GDestroyNotify destroy,
                                GObject *weak_object);

Start a OfferDBusTube method call.

Offers a D-Bus tube providing the service specified.

Parameters

proxy

the TpProxy

 

timeout_ms

the timeout in milliseconds, or -1 to use the default

 

in_Service

Used to pass an 'in' argument: A string representing the service name that will be used over the tube. It should be a well-known D-Bus service name, of the form com.example.ServiceName.

 

in_Parameters

Used to pass an 'in' argument: A dictionary of properties for the new tube; the allowable keys, types and values are defined by the service. Connection managers must support the value being any primitive (non-container) D-Bus type, or a byte array 'ay'.

 

callback

called when the method call succeeds or fails; may be NULL to make a "fire and forget" call with no reply tracking

 

user_data

user-supplied data passed to the callback; must be NULL if callback is NULL

 

destroy

called with the user_data as argument, after the call has succeeded, failed or been cancelled; must be NULL if callback is NULL

 

weak_object

If not NULL, a GObject which will be weakly referenced; if it is destroyed, this call will automatically be cancelled. Must be NULL if callback is NULL

 

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.


tp_cli_channel_type_tubes_call_offer_stream_tube ()

TpProxyPendingCall *
tp_cli_channel_type_tubes_call_offer_stream_tube
                               (TpChannel *proxy,
                                gint timeout_ms,
                                const gchar *in_Service,
                                GHashTable *in_Parameters,
                                guint in_Address_Type,
                                const GValue *in_Address,
                                guint in_Access_Control,
                                const GValue *in_Access_Control_Param,
                                tp_cli_channel_type_tubes_callback_for_offer_stream_tube callback,
                                gpointer user_data,
                                GDestroyNotify destroy,
                                GObject *weak_object);

Start a OfferStreamTube method call.

Offer a stream tube exporting the local socket specified.

Parameters

proxy

the TpProxy

 

timeout_ms

the timeout in milliseconds, or -1 to use the default

 

in_Service

Used to pass an 'in' argument: <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> A string representing the service name that will be used over the tube. It should be a well-known TCP service name as defined by <a href="http://www.iana.org/assignments/port-numbers"> http://www.iana.org/assignments/port-numbers</a> or <a href="http://www.dns-sd.org/ServiceTypes.html"> http://www.dns-sd.org/ServiceTypes.html</a>, for instance &quot;rsync&quot; or &quot;daap&quot;.

 

in_Parameters

Used to pass an 'in' argument: <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>A dictionary of properties for the new tube; the allowable keys, types and values are defined by the service. Connection managers must support the value being any primitive (non-container) D-Bus type, or a byte array 'ay'.</p> <p>These should usually be the same key-value pairs specified for use in the DNS-SD TXT record for that service.</p>

 

in_Address_Type

Used to pass an 'in' argument: The type of the listening address of the local service, as a member of Socket_Address_Type. (TpSocketAddressType)

 

in_Address

Used to pass an 'in' argument: The listening address of the local service, as indicated by the address_type.

 

in_Access_Control

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)

 

in_Access_Control_Param

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.

 

callback

called when the method call succeeds or fails; may be NULL to make a "fire and forget" call with no reply tracking

 

user_data

user-supplied data passed to the callback; must be NULL if callback is NULL

 

destroy

called with the user_data as argument, after the call has succeeded, failed or been cancelled; must be NULL if callback is NULL

 

weak_object

If not NULL, a GObject which will be weakly referenced; if it is destroyed, this call will automatically be cancelled. Must be NULL if callback is NULL

 

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.


tp_cli_channel_type_tubes_callback_for_accept_d_bus_tube ()

void
(*tp_cli_channel_type_tubes_callback_for_accept_d_bus_tube)
                               (TpChannel *proxy,
                                const gchar *out_Address,
                                const GError *error,
                                gpointer user_data,
                                GObject *weak_object);

Signature of the callback called when a AcceptDBusTube method call succeeds or fails.

Parameters

proxy

the proxy on which the call was made

 

out_Address

Used to return an 'out' argument if error is NULL: The string describing the address of the private bus. The client should not attempt to connect to the address until the tube is open.

 

error

NULL on success, or an error on failure

 

user_data

user-supplied data

 

weak_object

user-supplied object

 

tp_cli_channel_type_tubes_callback_for_accept_stream_tube ()

void
(*tp_cli_channel_type_tubes_callback_for_accept_stream_tube)
                               (TpChannel *proxy,
                                const GValue *out_Address,
                                const GError *error,
                                gpointer user_data,
                                GObject *weak_object);

Signature of the callback called when a AcceptStreamTube method call succeeds or fails.

Parameters

proxy

the proxy on which the call was made

 

out_Address

Used to return an 'out' argument if error is NULL: 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.

 

error

NULL on success, or an error on failure

 

user_data

user-supplied data

 

weak_object

user-supplied object

 

tp_cli_channel_type_tubes_callback_for_close_tube ()

void
(*tp_cli_channel_type_tubes_callback_for_close_tube)
                               (TpChannel *proxy,
                                const GError *error,
                                gpointer user_data,
                                GObject *weak_object);

Signature of the callback called when a CloseTube method call succeeds or fails.

Parameters

proxy

the proxy on which the call was made

 

error

NULL on success, or an error on failure

 

user_data

user-supplied data

 

weak_object

user-supplied object

 

tp_cli_channel_type_tubes_callback_for_get_available_stream_tube_types ()

void
(*tp_cli_channel_type_tubes_callback_for_get_available_stream_tube_types)
                               (TpChannel *proxy,
                                GHashTable *out_Available_Stream_Tube_Types,
                                const GError *error,
                                gpointer user_data,
                                GObject *weak_object);

Signature of the callback called when a GetAvailableStreamTubeTypes method call succeeds or fails.

Parameters

proxy

the proxy on which the call was made

 

out_Available_Stream_Tube_Types

Used to return an 'out' argument if error is NULL: <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>A mapping from address types (members of Socket_Address_Type) to arrays of access-control type (members of Socket_Access_Control) that the connection manager supports for stream tubes with that address type. For simplicity, if a CM supports offering a particular type of tube, it is assumed to support accepting it.</p> <p>A typical value for a host without IPv6 support:</p> <pre> { Socket_Address_Type_IPv4: [Socket_Access_Control_Localhost, Socket_Access_Control_Port, Socket_Access_Control_Netmask], Socket_Address_Type_Unix: [Socket_Access_Control_Localhost, Socket_Access_Control_Credentials] } </pre> <p>If stream tubes are not supported, this will be an empty dictionary.</p>

 

error

NULL on success, or an error on failure

 

user_data

user-supplied data

 

weak_object

user-supplied object

 

tp_cli_channel_type_tubes_callback_for_get_available_tube_types ()

void
(*tp_cli_channel_type_tubes_callback_for_get_available_tube_types)
                               (TpChannel *proxy,
                                const GArray *out_Available_Tube_Types,
                                const GError *error,
                                gpointer user_data,
                                GObject *weak_object);

Signature of the callback called when a GetAvailableTubeTypes method call succeeds or fails.

Parameters

proxy

the proxy on which the call was made

 

out_Available_Tube_Types

Used to return an 'out' argument if error is NULL: An array of the available tube types, as defined by the Tube_Type enum.

 

error

NULL on success, or an error on failure

 

user_data

user-supplied data

 

weak_object

user-supplied object

 

tp_cli_channel_type_tubes_callback_for_get_d_bus_names ()

void
(*tp_cli_channel_type_tubes_callback_for_get_d_bus_names)
                               (TpChannel *proxy,
                                const GPtrArray *out_DBus_Names,
                                const GError *error,
                                gpointer user_data,
                                GObject *weak_object);

Signature of the callback called when a GetDBusNames method call succeeds or fails.

Parameters

proxy

the proxy on which the call was made

 

out_DBus_Names

Used to return an 'out' argument if error is NULL: An array of structures, each containing a contact handle and a D-Bus bus name.

 

error

NULL on success, or an error on failure

 

user_data

user-supplied data

 

weak_object

user-supplied object

 

tp_cli_channel_type_tubes_callback_for_get_d_bus_tube_address ()

void
(*tp_cli_channel_type_tubes_callback_for_get_d_bus_tube_address)
                               (TpChannel *proxy,
                                const gchar *out_Address,
                                const GError *error,
                                gpointer user_data,
                                GObject *weak_object);

Signature of the callback called when a GetDBusTubeAddress method call succeeds or fails.

Parameters

proxy

the proxy on which the call was made

 

out_Address

Used to return an 'out' argument if error is NULL: The bus address.

 

error

NULL on success, or an error on failure

 

user_data

user-supplied data

 

weak_object

user-supplied object

 

tp_cli_channel_type_tubes_callback_for_get_stream_tube_socket_address ()

void
(*tp_cli_channel_type_tubes_callback_for_get_stream_tube_socket_address)
                               (TpChannel *proxy,
                                guint out_Address_Type,
                                const GValue *out_Address,
                                const GError *error,
                                gpointer user_data,
                                GObject *weak_object);

Signature of the callback called when a GetStreamTubeSocketAddress method call succeeds or fails.

Parameters

proxy

the proxy on which the call was made

 

out_Address_Type

Used to return an 'out' argument if error is NULL: The type of the listening address of the socket, as a member of Socket_Address_Type. (TpSocketAddressType)

 

out_Address

Used to return an 'out' argument if error is NULL: The listening address of the socket, as indicated by the address_type.

 

error

NULL on success, or an error on failure

 

user_data

user-supplied data

 

weak_object

user-supplied object

 

tp_cli_channel_type_tubes_callback_for_list_tubes ()

void
(*tp_cli_channel_type_tubes_callback_for_list_tubes)
                               (TpChannel *proxy,
                                const GPtrArray *out_Tubes,
                                const GError *error,
                                gpointer user_data,
                                GObject *weak_object);

Signature of the callback called when a ListTubes method call succeeds or fails.

Parameters

proxy

the proxy on which the call was made

 

out_Tubes

Used to return an 'out' argument if error is NULL: Return an array of tuples, each representing a tube, with the following members: <ul> <li>the tube's ID</li> <li>the tube's initiator</li> <li>the tube's type</li> <li>the tube's service</li> <li>the tube's parameters</li> <li>the tube's state</li> </ul>

 

error

NULL on success, or an error on failure

 

user_data

user-supplied data

 

weak_object

user-supplied object

 

tp_cli_channel_type_tubes_callback_for_offer_d_bus_tube ()

void
(*tp_cli_channel_type_tubes_callback_for_offer_d_bus_tube)
                               (TpChannel *proxy,
                                guint out_Tube_ID,
                                const GError *error,
                                gpointer user_data,
                                GObject *weak_object);

Signature of the callback called when a OfferDBusTube method call succeeds or fails.

Parameters

proxy

the proxy on which the call was made

 

out_Tube_ID

Used to return an 'out' argument if error is NULL: The ID of the new tube. (TpTubeID)

 

error

NULL on success, or an error on failure

 

user_data

user-supplied data

 

weak_object

user-supplied object

 

tp_cli_channel_type_tubes_callback_for_offer_stream_tube ()

void
(*tp_cli_channel_type_tubes_callback_for_offer_stream_tube)
                               (TpChannel *proxy,
                                guint out_Tube_ID,
                                const GError *error,
                                gpointer user_data,
                                GObject *weak_object);

Signature of the callback called when a OfferStreamTube method call succeeds or fails.

Parameters

proxy

the proxy on which the call was made

 

out_Tube_ID

Used to return an 'out' argument if error is NULL: The ID of the new tube. (TpTubeID)

 

error

NULL on success, or an error on failure

 

user_data

user-supplied data

 

weak_object

user-supplied object

 

tp_cli_channel_type_tubes_connect_to_d_bus_names_changed ()

TpProxySignalConnection *
tp_cli_channel_type_tubes_connect_to_d_bus_names_changed
                               (TpChannel *proxy,
                                tp_cli_channel_type_tubes_signal_callback_d_bus_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.

Parameters

proxy

A TpChannel or subclass

 

callback

Callback to be called when the signal is received

 

user_data

User-supplied data for the callback

 

destroy

Destructor for the user-supplied data, which will be called when this signal is disconnected, or before this function returns NULL

 

weak_object

A GObject which will be weakly referenced; if it is destroyed, this callback will automatically be disconnected

 

error

If not NULL, used to raise an error if NULL is returned

 

Returns

a TpProxySignalConnection containing all of the above, which can be used to disconnect the signal; or NULL if the proxy does not have the desired interface or has become invalid.


tp_cli_channel_type_tubes_connect_to_new_tube ()

TpProxySignalConnection *
tp_cli_channel_type_tubes_connect_to_new_tube
                               (TpChannel *proxy,
                                tp_cli_channel_type_tubes_signal_callback_new_tube callback,
                                gpointer user_data,
                                GDestroyNotify destroy,
                                GObject *weak_object,
                                GError **error);

Connect a handler to the signal NewTube.

Emitted when a tube is created.

Parameters

proxy

A TpChannel or subclass

 

callback

Callback to be called when the signal is received

 

user_data

User-supplied data for the callback

 

destroy

Destructor for the user-supplied data, which will be called when this signal is disconnected, or before this function returns NULL

 

weak_object

A GObject which will be weakly referenced; if it is destroyed, this callback will automatically be disconnected

 

error

If not NULL, used to raise an error if NULL is returned

 

Returns

a TpProxySignalConnection containing all of the above, which can be used to disconnect the signal; or NULL if the proxy does not have the desired interface or has become invalid.


tp_cli_channel_type_tubes_connect_to_stream_tube_new_connection ()

TpProxySignalConnection *
tp_cli_channel_type_tubes_connect_to_stream_tube_new_connection
                               (TpChannel *proxy,
                                tp_cli_channel_type_tubes_signal_callback_stream_tube_new_connection callback,
                                gpointer user_data,
                                GDestroyNotify destroy,
                                GObject *weak_object,
                                GError **error);

Connect a handler to the signal StreamTubeNewConnection.

Emitted on a stream tube when a participant opens a new connection to its socket.

Parameters

proxy

A TpChannel or subclass

 

callback

Callback to be called when the signal is received

 

user_data

User-supplied data for the callback

 

destroy

Destructor for the user-supplied data, which will be called when this signal is disconnected, or before this function returns NULL

 

weak_object

A GObject which will be weakly referenced; if it is destroyed, this callback will automatically be disconnected

 

error

If not NULL, used to raise an error if NULL is returned

 

Returns

a TpProxySignalConnection containing all of the above, which can be used to disconnect the signal; or NULL if the proxy does not have the desired interface or has become invalid.


tp_cli_channel_type_tubes_connect_to_tube_closed ()

TpProxySignalConnection *
tp_cli_channel_type_tubes_connect_to_tube_closed
                               (TpChannel *proxy,
                                tp_cli_channel_type_tubes_signal_callback_tube_closed callback,
                                gpointer user_data,
                                GDestroyNotify destroy,
                                GObject *weak_object,
                                GError **error);

Connect a handler to the signal TubeClosed.

Emitted when a tube has been closed. The ID of a closed tube is no longer valid. The ID may later be reused for a new tube.

Parameters

proxy

A TpChannel or subclass

 

callback

Callback to be called when the signal is received

 

user_data

User-supplied data for the callback

 

destroy

Destructor for the user-supplied data, which will be called when this signal is disconnected, or before this function returns NULL

 

weak_object

A GObject which will be weakly referenced; if it is destroyed, this callback will automatically be disconnected

 

error

If not NULL, used to raise an error if NULL is returned

 

Returns

a TpProxySignalConnection containing all of the above, which can be used to disconnect the signal; or NULL if the proxy does not have the desired interface or has become invalid.


tp_cli_channel_type_tubes_connect_to_tube_state_changed ()

TpProxySignalConnection *
tp_cli_channel_type_tubes_connect_to_tube_state_changed
                               (TpChannel *proxy,
                                tp_cli_channel_type_tubes_signal_callback_tube_state_changed callback,
                                gpointer user_data,
                                GDestroyNotify destroy,
                                GObject *weak_object,
                                GError **error);

Connect a handler to the signal TubeStateChanged.

Emitted when the state of a tube changes.

Parameters

proxy

A TpChannel or subclass

 

callback

Callback to be called when the signal is received

 

user_data

User-supplied data for the callback

 

destroy

Destructor for the user-supplied data, which will be called when this signal is disconnected, or before this function returns NULL

 

weak_object

A GObject which will be weakly referenced; if it is destroyed, this callback will automatically be disconnected

 

error

If not NULL, used to raise an error if NULL is returned

 

Returns

a TpProxySignalConnection containing all of the above, which can be used to disconnect the signal; or NULL if the proxy does not have the desired interface or has become invalid.


tp_cli_channel_type_tubes_signal_callback_d_bus_names_changed ()

void
(*tp_cli_channel_type_tubes_signal_callback_d_bus_names_changed)
                               (TpChannel *proxy,
                                guint arg_ID,
                                const GPtrArray *arg_Added,
                                const GArray *arg_Removed,
                                gpointer user_data,
                                GObject *weak_object);

Represents the signature of a callback for the signal DBusNamesChanged.

Parameters

proxy

The proxy on which tp_cli_channel_type_tubes_connect_to_d_bus_names_changed() was called

 

arg_ID

The ID of the tube whose names have changed. (TpTubeID)

 

arg_Added

Array of handles and D-Bus names of new participants.

 

arg_Removed

Array of handles of former participants.

 

user_data

User-supplied data

 

weak_object

User-supplied weakly referenced object

 

tp_cli_channel_type_tubes_signal_callback_new_tube ()

void
(*tp_cli_channel_type_tubes_signal_callback_new_tube)
                               (TpChannel *proxy,
                                guint arg_ID,
                                guint arg_Initiator,
                                guint arg_Type,
                                const gchar *arg_Service,
                                GHashTable *arg_Parameters,
                                guint arg_State,
                                gpointer user_data,
                                GObject *weak_object);

Represents the signature of a callback for the signal NewTube.

Parameters

proxy

The proxy on which tp_cli_channel_type_tubes_connect_to_new_tube() was called

 

arg_ID

The ID of the new tube. (TpTubeID)

 

arg_Initiator

The handle of the contact who initiated the tube. (TpContactHandle)

 

arg_Type

The tube type, as defined by the Tube_Type enum. (TpTubeType)

 

arg_Service

A string representing the service that will be used over the tube.

 

arg_Parameters

The new tube's properties.

 

arg_State

The new tube's state. (TpTubeState)

 

user_data

User-supplied data

 

weak_object

User-supplied weakly referenced object

 

tp_cli_channel_type_tubes_signal_callback_stream_tube_new_connection ()

void
(*tp_cli_channel_type_tubes_signal_callback_stream_tube_new_connection)
                               (TpChannel *proxy,
                                guint arg_ID,
                                guint arg_Handle,
                                gpointer user_data,
                                GObject *weak_object);

Represents the signature of a callback for the signal StreamTubeNewConnection.

Parameters

proxy

The proxy on which tp_cli_channel_type_tubes_connect_to_stream_tube_new_connection() was called

 

arg_ID

The ID of the tube (TpTubeID)

 

arg_Handle

The handle of the participant who opened the new connection (TpContactHandle)

 

user_data

User-supplied data

 

weak_object

User-supplied weakly referenced object

 

tp_cli_channel_type_tubes_signal_callback_tube_closed ()

void
(*tp_cli_channel_type_tubes_signal_callback_tube_closed)
                               (TpChannel *proxy,
                                guint arg_ID,
                                gpointer user_data,
                                GObject *weak_object);

Represents the signature of a callback for the signal TubeClosed.

Parameters

proxy

The proxy on which tp_cli_channel_type_tubes_connect_to_tube_closed() was called

 

arg_ID

The ID of the tube that was closed. (TpTubeID)

 

user_data

User-supplied data

 

weak_object

User-supplied weakly referenced object

 

tp_cli_channel_type_tubes_signal_callback_tube_state_changed ()

void
(*tp_cli_channel_type_tubes_signal_callback_tube_state_changed)
                               (TpChannel *proxy,
                                guint arg_ID,
                                guint arg_State,
                                gpointer user_data,
                                GObject *weak_object);

Represents the signature of a callback for the signal TubeStateChanged.

Parameters

proxy

The proxy on which tp_cli_channel_type_tubes_connect_to_tube_state_changed() was called

 

arg_ID

The ID of the tube that changed state. (TpTubeID)

 

arg_State

The new state of the tube; see the Tube_State enumeration. (TpTubeState)

 

user_data

User-supplied data

 

weak_object

User-supplied weakly referenced object

 

See Also

channel-group