|  |  |  | telepathy-glib Reference Manual |  | 
|---|---|---|---|---|
#include <telepathy-glib/connection-manager.h> void (*TpConnectionManagerListCb) (TpConnectionManager * const *cms, gsize n_cms, const GError *error, gpointer user_data, GObject *weak_object); void tp_list_connection_managers (TpDBusDaemon *bus_daemon, TpConnectionManagerListCb callback, gpointer user_data, GDestroyNotify destroy, GObject *weak_object); TpConnectionManager; TpConnectionManagerProtocol; TpConnectionManagerParam; TpConnectionManagerClass; enum TpCMInfoSource; TpConnectionManager* tp_connection_manager_new (TpDBusDaemon *dbus, const gchar *name, const gchar *manager_filename, GError **error); gboolean tp_connection_manager_activate (TpConnectionManager *self); gboolean tp_connection_manager_check_valid_name (const gchar *name, GError **error); gboolean tp_connection_manager_check_valid_protocol_name (const gchar *name, GError **error); void (*tp_cli_connection_manager_callback_for_get_parameters) (TpConnectionManager *proxy, const GPtrArray *out0, const GError *error, gpointer user_data, GObject *weak_object); TpProxyPendingCall* tp_cli_connection_manager_call_get_parameters (TpConnectionManager *proxy, gint timeout_ms, const gchar *in_proto, tp_cli_connection_manager_callback_for_get_parameters callback, gpointer user_data, GDestroyNotify destroy, GObject *weak_object); gboolean tp_cli_connection_manager_run_get_parameters (TpConnectionManager *proxy, gint timeout_ms, const gchar *in_proto, GPtrArray **out0, GError **error, GMainLoop **loop); void (*tp_cli_connection_manager_callback_for_list_protocols) (TpConnectionManager *proxy, const gchar **out0, const GError *error, gpointer user_data, GObject *weak_object); TpProxyPendingCall* tp_cli_connection_manager_call_list_protocols (TpConnectionManager *proxy, gint timeout_ms, tp_cli_connection_manager_callback_for_list_protocols callback, gpointer user_data, GDestroyNotify destroy, GObject *weak_object); gboolean tp_cli_connection_manager_run_list_protocols (TpConnectionManager *proxy, gint timeout_ms, gchar ***out0, GError **error, GMainLoop **loop); void (*tp_cli_connection_manager_callback_for_request_connection) (TpConnectionManager *proxy, const gchar *out0, const gchar *out1, const GError *error, gpointer user_data, GObject *weak_object); TpProxyPendingCall* tp_cli_connection_manager_call_request_connection (TpConnectionManager *proxy, gint timeout_ms, const gchar *in_proto, GHashTable *in_parameters, tp_cli_connection_manager_callback_for_request_connection callback, gpointer user_data, GDestroyNotify destroy, GObject *weak_object); gboolean tp_cli_connection_manager_run_request_connection (TpConnectionManager *proxy, gint timeout_ms, const gchar *in_proto, GHashTable *in_parameters, gchar **out0, gchar **out1, GError **error, GMainLoop **loop); void (*tp_cli_connection_manager_signal_callback_new_connection) (TpConnectionManager *proxy, const gchar *arg_bus_name, const gchar *arg_object_path, const gchar *arg_proto, gpointer user_data, GObject *weak_object); TpProxySignalConnection* tp_cli_connection_manager_connect_to_new_connection (TpConnectionManager *proxy, tp_cli_connection_manager_signal_callback_new_connection callback, gpointer user_data, GDestroyNotify destroy, GObject *weak_object, GError **error);
"always-introspect" gboolean : Read / Write "connection-manager" gchar* : Read "info-source" guint : Read "manager-file" gchar* : Read / Write / Construct
"activated" : Run Last / Has Details "exited" : Run Last / Has Details "got-info" : Run Last / Has Details
TpConnectionManager objects represent Telepathy connection managers. They can be used to open connections.
void (*TpConnectionManagerListCb) (TpConnectionManager * const *cms, gsize n_cms, const GError *error, gpointer user_data, GObject *weak_object);
Signature of the callback supplied to tp_list_connection_managers().
| 
 | NULL-terminated array of TpConnectionManager (the objects will
  be unreferenced and the array will be freed after the callback returns,
  so the callback must reference any CMs it stores a pointer to),
  orNULLon error | 
| 
 | number of connection managers in cms(not including the finalNULL) | 
| 
 | NULLon success, or an error that occurred | 
| 
 | user-supplied data | 
| 
 | user-supplied weakly referenced object | 
Since 0.7.1
void tp_list_connection_managers (TpDBusDaemon *bus_daemon, TpConnectionManagerListCb callback, gpointer user_data, GDestroyNotify destroy, GObject *weak_object);
List the available (running or installed) connection managers. Call the callback when done.
| 
 | proxy for the D-Bus daemon | 
| 
 | callback to be called when listing the CMs succeeds or fails;
  not called if the weak_objectgoes away | 
| 
 | user-supplied data for the callback | 
| 
 | callback to destroy the user-supplied data, called after callback, but also if theweak_objectgoes away | 
| 
 | if not NULL, will be weakly referenced; the callback will
  not be called, and the call will be cancelled, if the object has vanished | 
Since 0.7.1
typedef struct {
    TpProxy parent;
    const gchar *name;
    const TpConnectionManagerProtocol * const *protocols;
    gboolean running:1;
    gboolean always_introspect:1;
    TpCMInfoSource info_source:2;
    guint reserved_flags:28;
    TpConnectionManagerPrivate *priv;
} TpConnectionManager;
A proxy object for a Telepathy connection manager.
This might represent a connection manager which is currently running (in which case it can be introspected) or not (in which case its capabilities can be read from .manager files in the filesystem). Accordingly, this object never emits "invalidated" unless all references to it are discarded.
On initialization, we find and read the .manager file, and emit got-info(FILE) on success, got-info(NONE) if no file or if reading the file failed.
When the CM runs, we automatically introspect it if always_introspect
is TRUE. On success we emit got-info(LIVE). On failure, re-emit
got-info(NONE) or got-info(FILE) as appropriate.
If we're asked to activate the CM, it'll implicitly be introspected.
If the CM exits, we still consider it to have been "introspected". If it's re-run, we introspect it again.
| TpProxy  | The parent class instance | 
| const gchar * | The identifier of the connection manager (e.g. "gabble"). Should be considered read-only | 
| const TpConnectionManagerProtocol * const  * | If info_source > TP_CM_INFO_SOURCE_NONE, aNULL-terminated
 array of pointers to TpConnectionManagerProtocol structures; otherwiseNULL. Should be considered read-only | 
| gboolean  | TRUEif the CM is currently known to be running. Should be
 considered read-only | 
| gboolean  | TRUEif the CM will be introspected automatically.
 Should be considered read-only: use the
 "always-introspect" property if you want to change it | 
| TpCMInfoSource  | The source of protocols, orTP_CM_INFO_SOURCE_NONEif no info has been discovered yet | 
| guint  | Reserved for future use | 
| TpConnectionManagerPrivate * | Pointer to opaque private data | 
Since 0.7.1
typedef struct {
  gchar *name;
  TpConnectionManagerParam *params;
} TpConnectionManagerProtocol;
Structure representing a protocol supported by a connection manager. Note that the size of this structure may change, so its size must not be relied on.
| gchar * | The name of this connection manager | 
| TpConnectionManagerParam * | Array of TpConnectionManagerParam structures, terminated by
 a structure whose nameisNULL | 
Since 0.7.1
typedef struct {
  gchar *name;
  gchar *dbus_signature;
  GValue default_value;
  guint flags;
  gpointer priv;
} TpConnectionManagerParam;
Structure representing a connection manager parameter.
| gchar * | The name of this parameter | 
| gchar * | This parameter's D-Bus signature | 
| GValue  | This parameter's default value, or an arbitrary value
 of an appropriate type if TP_CONN_MGR_PARAM_FLAG_HAS_DEFAULTis not
 set on this parameter, or an unset GValue if the signature is not
 recognised by telepathy-glib | 
| guint  | This parameter's flags (a combination of TpConnMgrParamFlags) | 
| gpointer  | Pointer to opaque private data | 
Since 0.7.1
typedef struct {
} TpConnectionManagerClass;
The class of a TpConnectionManager.
Since 0.7.1
typedef enum
{
  TP_CM_INFO_SOURCE_NONE,
  TP_CM_INFO_SOURCE_FILE,
  TP_CM_INFO_SOURCE_LIVE
} TpCMInfoSource;
Describes possible sources of information on connection managers' supported protocols.
| no information available | |
| information came from a .manager file | |
| information came from the connection manager | 
Since 0.7.1
TpConnectionManager* tp_connection_manager_new (TpDBusDaemon *dbus, const gchar *name, const gchar *manager_filename, GError **error);
Convenience function to create a new connection manager proxy.
| 
 | Proxy for the D-Bus daemon | 
| 
 | The connection manager name | 
| 
 | The "manager-file" property | 
| 
 | used to return an error if NULLis returned | 
| Returns : | a new reference to a connection manager proxy | 
gboolean tp_connection_manager_activate (TpConnectionManager *self);
Attempt to run and introspect the connection manager, asynchronously.
If the CM was already running, do nothing and return FALSE.
On success, emit "activated" when the CM appears on the bus, and "got-info" when its capabilities have been (re-)discovered.
On failure, emit "exited" without first emitting activated.
| 
 | a connection manager proxy | 
| Returns : | TRUEif activation was needed and is now in progress,FALSEif the connection manager was already running and no additional signals
 will be emitted. | 
Since 0.7.1
gboolean tp_connection_manager_check_valid_name (const gchar *name, GError **error);
Check that the given string is a valid connection manager name, i.e. that it consists entirely of ASCII letters, digits and underscores, and starts with a letter.
| 
 | a possible connection manager name | 
| 
 | used to raise TP_ERROR_INVALID_ARGUMENTifFALSEis returned | 
| Returns : | TRUEifnameis valid | 
Since 0.7.1
gboolean tp_connection_manager_check_valid_protocol_name (const gchar *name, GError **error);
Check that the given string is a valid protocol name, i.e. that it consists entirely of ASCII letters, digits and hyphen/minus, and starts with a letter.
| 
 | a possible protocol name | 
| 
 | used to raise TP_ERROR_INVALID_ARGUMENTifFALSEis returned | 
| Returns : | TRUEifnameis valid | 
Since 0.7.1
void                (*tp_cli_connection_manager_callback_for_get_parameters)
                                                        (TpConnectionManager *proxy,
                                                         const GPtrArray *out0,
                                                         const GError *error,
                                                         gpointer user_data,
                                                         GObject *weak_object);
Signature of the callback called when a GetParameters method call succeeds or fails.
| 
 | the proxy on which the call was made | 
| 
 | Used to return an 'out' argument if errorisNULL: <tp:docstring xmlns="http://www.w3.org/1999/xhtml">           An array of structs representing possible parameters. | 
| 
 | NULLon success, or an error on failure | 
| 
 | user-supplied data | 
| 
 | user-supplied object | 
TpProxyPendingCall* tp_cli_connection_manager_call_get_parameters (TpConnectionManager *proxy, gint timeout_ms, const gchar *in_proto, tp_cli_connection_manager_callback_for_get_parameters callback, gpointer user_data, GDestroyNotify destroy, GObject *weak_object);
Start a GetParameters method call.
Get a list of the parameters which must or may be provided to the RequestConnection method when connecting to the given protocol, or registering (the boolean "register" parameter is available, and set to true).
| 
 | the TpProxy | 
| 
 | the timeout in milliseconds, or -1 to use the default | 
| 
 | Used to pass an 'in' argument: The required protocol name | 
| 
 | 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. | 
gboolean tp_cli_connection_manager_run_get_parameters (TpConnectionManager *proxy, gint timeout_ms, const gchar *in_proto, GPtrArray **out0, GError **error, GMainLoop **loop);
Call the method GetParameters 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.
Get a list of the parameters which must or may be provided to the RequestConnection method when connecting to the given protocol, or registering (the boolean "register" parameter is available, and set to true).
| 
 | A TpConnectionManager or subclass | 
| 
 | Timeout in milliseconds, or -1 for default | 
| 
 | Used to pass an 'in' argument: The required protocol name | 
| 
 | Used to return an 'out' argument if TRUEis returned: <tp:docstring xmlns="http://www.w3.org/1999/xhtml">           An array of structs representing possible parameters. | 
| 
 | 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 | 
void                (*tp_cli_connection_manager_callback_for_list_protocols)
                                                        (TpConnectionManager *proxy,
                                                         const gchar **out0,
                                                         const GError *error,
                                                         gpointer user_data,
                                                         GObject *weak_object);
Signature of the callback called when a ListProtocols method call succeeds or fails.
TpProxyPendingCall* tp_cli_connection_manager_call_list_protocols (TpConnectionManager *proxy, gint timeout_ms, tp_cli_connection_manager_callback_for_list_protocols callback, gpointer user_data, GDestroyNotify destroy, GObject *weak_object);
Start a ListProtocols method call.
Get a list of protocol identifiers that are implemented by this connection manager.
| 
 | the TpProxy | 
| 
 | the timeout in milliseconds, or -1 to use the default | 
| 
 | 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. | 
gboolean tp_cli_connection_manager_run_list_protocols (TpConnectionManager *proxy, gint timeout_ms, gchar ***out0, GError **error, GMainLoop **loop);
Call the method ListProtocols 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.
Get a list of protocol identifiers that are implemented by this connection manager.
| 
 | A TpConnectionManager or subclass | 
| 
 | Timeout in milliseconds, or -1 for default | 
| 
 | Used to return an 'out' argument if TRUEis returned: A array of string protocol identifiers supported by this manager | 
| 
 | 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 | 
void                (*tp_cli_connection_manager_callback_for_request_connection)
                                                        (TpConnectionManager *proxy,
                                                         const gchar *out0,
                                                         const gchar *out1,
                                                         const GError *error,
                                                         gpointer user_data,
                                                         GObject *weak_object);
Signature of the callback called when a RequestConnection method call succeeds or fails.
| 
 | the proxy on which the call was made | 
| 
 | Used to return an 'out' argument if errorisNULL: A D-Bus service name where the new Connection object can be found | 
| 
 | Used to return an 'out' argument if errorisNULL: The D-Bus object path to the Connection on this service | 
| 
 | NULLon success, or an error on failure | 
| 
 | user-supplied data | 
| 
 | user-supplied object | 
TpProxyPendingCall* tp_cli_connection_manager_call_request_connection (TpConnectionManager *proxy, gint timeout_ms, const gchar *in_proto, GHashTable *in_parameters, tp_cli_connection_manager_callback_for_request_connection callback, gpointer user_data, GDestroyNotify destroy, GObject *weak_object);
Start a RequestConnection method call.
<tp:docstring xmlns="http://www.w3.org/1999/xhtml">         <p>Request a Connection object representing a given account on a given         protocol with the given parameters. The method returns the bus name         and the object path where the new Connection object can be found, which         should have the status of Connection_Status_Disconnected, to allow         signal handlers to be attached before connecting is started with the         Connect method.</p>          <p>In order to allow Connection objects to be discovered by new clients,         the object path and well-known bus name must be of the form         <code>/org/freedesktop/Telepathy/Connection/cmname/proto/account</code>         and         <code>org.freedesktop.Telepathy.Connection.cmname.proto.account</code>         where:</p>          <ul>           <li><em>cmname</em> is the same connection manager name that appears             in the connection manager's object path and well-known bus name</li>           <li><em>proto</em> is the protocol name as seen in             ListProtocols, but with "-" replaced with "_" to get a valid             object path/bus name</li>           <li><em>account</em> SHOULD be a series of elements formed such that             any valid distinct connection instance on this protocol has a             distinct name; this might be formed by including the server name             followed by the user name (escaped via some suitable mechanism like             telepathy-glib's tp_escape_as_identifier() function to preserve             uniqueness), or on protocols where connecting multiple times             is permissable, a per-connection identifier might be necessary to             ensure uniqueness</li>         </ul>          <p>Clients MUST NOT attempt to parse the <em>account</em> part of the           bus name. Connection managers MAY use any unique string for this           part.</p>          <p>The parameters which must and may be provided in the parameters         dictionary can be discovered with the GetParameters method. These         parameters, their types, and their default values may be cached         in files so that all available connection managers do not need to be         started to discover which protocols are available.</p>          <p>To request values for these parameters from the user, a client must         have prior knowledge of the meaning of the parameter names, so the         following well-known names and types should be used where appropriate:</p>          <dl>           <dt>s:account</dt>           <dd>The identifier for the user's account on the server</dd>            <dt>s:server</dt><dd>A fully qualified domain name or numeric IPv4 or IPv6         address. Using the fully-qualified domain name form is recommended         whenever possible. If this parameter is specified and the account         for that protocol also specifies a server, this parameter should         override that in the user id.</dd>        <dt>q:port</dt><dd>A TCP or UDP port number. If this parameter is specified         and the account for that protocol also specifies a port, this         parameter should override that in the account.</dd>        <dt>s:password</dt><dd>A password associated with the account.</dd>        <dt>b:require-encryption</dt><dd>Require encryption for this connection. A         connection should fail to connect if require-encryption is set         and an encrypted connection is not possible.</dd>        <dt>b:register</dt><dd>This account should be created on the server if it         does not already exist.</dd>        <dt>s:ident</dt><dd>The local username to report to the server if         necessary, such as in IRC.</dd>        <dt>s:fullname</dt><dd>The user's full name if the service requires this         when authenticating or registering.</dd>        <dt>s:stun-server</dt><dd>The IP address or FQDN of a STUN server to use         for NAT traversal, without any ":port" suffix.</dd>       <dt>q:stun-port</dt><dd>The UDP port number on the stun-server to use for         STUN. Only significant if the stun-server is also supplied.</dd>         </dl>          <p>Every successful RequestConnection call will cause the emission of a         NewConnection signal for the same newly created connection. The         requester can use the returned object path and service name         independently of the emission of that signal. In that case this signal         emission is most useful for, e.g. other processes that are monitoring         the creation of new connections.</p>
| 
 | the TpProxy | 
| 
 | the timeout in milliseconds, or -1 to use the default | 
| 
 | Used to pass an 'in' argument: The protocol identifier | 
| 
 | Used to pass an 'in' argument: A dictionary mapping parameter name to the variant boxed value | 
| 
 | 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. | 
gboolean tp_cli_connection_manager_run_request_connection (TpConnectionManager *proxy, gint timeout_ms, const gchar *in_proto, GHashTable *in_parameters, gchar **out0, gchar **out1, GError **error, GMainLoop **loop);
Call the method RequestConnection 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.
<tp:docstring xmlns="http://www.w3.org/1999/xhtml">         <p>Request a Connection object representing a given account on a given         protocol with the given parameters. The method returns the bus name         and the object path where the new Connection object can be found, which         should have the status of Connection_Status_Disconnected, to allow         signal handlers to be attached before connecting is started with the         Connect method.</p>          <p>In order to allow Connection objects to be discovered by new clients,         the object path and well-known bus name must be of the form         <code>/org/freedesktop/Telepathy/Connection/cmname/proto/account</code>         and         <code>org.freedesktop.Telepathy.Connection.cmname.proto.account</code>         where:</p>          <ul>           <li><em>cmname</em> is the same connection manager name that appears             in the connection manager's object path and well-known bus name</li>           <li><em>proto</em> is the protocol name as seen in             ListProtocols, but with "-" replaced with "_" to get a valid             object path/bus name</li>           <li><em>account</em> SHOULD be a series of elements formed such that             any valid distinct connection instance on this protocol has a             distinct name; this might be formed by including the server name             followed by the user name (escaped via some suitable mechanism like             telepathy-glib's tp_escape_as_identifier() function to preserve             uniqueness), or on protocols where connecting multiple times             is permissable, a per-connection identifier might be necessary to             ensure uniqueness</li>         </ul>          <p>Clients MUST NOT attempt to parse the <em>account</em> part of the           bus name. Connection managers MAY use any unique string for this           part.</p>          <p>The parameters which must and may be provided in the parameters         dictionary can be discovered with the GetParameters method. These         parameters, their types, and their default values may be cached         in files so that all available connection managers do not need to be         started to discover which protocols are available.</p>          <p>To request values for these parameters from the user, a client must         have prior knowledge of the meaning of the parameter names, so the         following well-known names and types should be used where appropriate:</p>          <dl>           <dt>s:account</dt>           <dd>The identifier for the user's account on the server</dd>            <dt>s:server</dt><dd>A fully qualified domain name or numeric IPv4 or IPv6         address. Using the fully-qualified domain name form is recommended         whenever possible. If this parameter is specified and the account         for that protocol also specifies a server, this parameter should         override that in the user id.</dd>        <dt>q:port</dt><dd>A TCP or UDP port number. If this parameter is specified         and the account for that protocol also specifies a port, this         parameter should override that in the account.</dd>        <dt>s:password</dt><dd>A password associated with the account.</dd>        <dt>b:require-encryption</dt><dd>Require encryption for this connection. A         connection should fail to connect if require-encryption is set         and an encrypted connection is not possible.</dd>        <dt>b:register</dt><dd>This account should be created on the server if it         does not already exist.</dd>        <dt>s:ident</dt><dd>The local username to report to the server if         necessary, such as in IRC.</dd>        <dt>s:fullname</dt><dd>The user's full name if the service requires this         when authenticating or registering.</dd>        <dt>s:stun-server</dt><dd>The IP address or FQDN of a STUN server to use         for NAT traversal, without any ":port" suffix.</dd>       <dt>q:stun-port</dt><dd>The UDP port number on the stun-server to use for         STUN. Only significant if the stun-server is also supplied.</dd>         </dl>          <p>Every successful RequestConnection call will cause the emission of a         NewConnection signal for the same newly created connection. The         requester can use the returned object path and service name         independently of the emission of that signal. In that case this signal         emission is most useful for, e.g. other processes that are monitoring         the creation of new connections.</p>
| 
 | A TpConnectionManager or subclass | 
| 
 | Timeout in milliseconds, or -1 for default | 
| 
 | Used to pass an 'in' argument: The protocol identifier | 
| 
 | Used to pass an 'in' argument: A dictionary mapping parameter name to the variant boxed value | 
| 
 | Used to return an 'out' argument if TRUEis returned: A D-Bus service name where the new Connection object can be found | 
| 
 | Used to return an 'out' argument if TRUEis returned: The D-Bus object path to the Connection on this service | 
| 
 | 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 | 
void                (*tp_cli_connection_manager_signal_callback_new_connection)
                                                        (TpConnectionManager *proxy,
                                                         const gchar *arg_bus_name,
                                                         const gchar *arg_object_path,
                                                         const gchar *arg_proto,
                                                         gpointer user_data,
                                                         GObject *weak_object);
Represents the signature of a callback for the signal NewConnection.
| 
 | The proxy on which tp_cli_connection_manager_connect_to_new_connection()was called | 
| 
 | The D-Bus service where the connection object can be found | 
| 
 | The object path of the Connection object on this service | 
| 
 | The identifier for the protocol this connection uses | 
| 
 | User-supplied data | 
| 
 | User-supplied weakly referenced object | 
TpProxySignalConnection* tp_cli_connection_manager_connect_to_new_connection (TpConnectionManager *proxy, tp_cli_connection_manager_signal_callback_new_connection callback, gpointer user_data, GDestroyNotify destroy, GObject *weak_object, GError **error);
Connect a handler to the signal NewConnection.
Emitted when a new Connection object is created.
| 
 | A TpConnectionManager 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. | 
"always-introspect" property"always-introspect" gboolean : Read / Write
Opportunistically introspect the CM when it's run.
Default value: FALSE
"connection-manager" property"connection-manager" gchar* : Read
The name of the connection manager, e.g. "gabble" (read-only).
Default value: NULL
"info-source" property"info-source" guint : Read
Where we got the current information on supported protocols.
Allowed values: <= 2
Default value: 0
"manager-file" property"manager-file" gchar* : Read / Write / Construct
The .manager filename.
Default value: NULL
"activated" signalvoid user_function (TpConnectionManager *self, gpointer user_data) : Run Last / Has Details
Emitted when the connection manager's well-known name appears on the bus.
| 
 | the connection manager proxy | 
| 
 | user data set when the signal handler was connected. | 
"exited" signalvoid user_function (TpConnectionManager *self, gpointer user_data) : Run Last / Has Details
Emitted when the connection manager's well-known name disappears from the bus or when activation fails.
| 
 | the connection manager proxy | 
| 
 | user data set when the signal handler was connected. | 
"got-info" signalvoid user_function (TpConnectionManager *self, guint source, gpointer user_data) : Run Last / Has Details
Emitted when the connection manager's capabilities have been discovered.
| 
 | the connection manager proxy | 
| 
 | a TpCMInfoSource | 
| 
 | user data set when the signal handler was connected. |