## Connection manager life cycle

Connection manager life cycle — entry point for telepathy-glib connection managers

## Synopsis

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

    int                 tp_run_connection_manager           (const char *prog_name,
                                                             const char *version,
                                                             TpBaseConnectionManager* (*construct_cm) (void),
                                                             int argc,
                                                             char **argv);

## Description

`tp_run_connection_manager()` provides a convenient entry point for telepathy-glib connection managers. It initializes most of the functionality the CM will need, constructs a connection manager object and lets it run.

This function also manages the connection manager's lifetime - if there are no new connections for a while, it times out and exits.

## Details

### tp_run_connection_manager ()

    int                 tp_run_connection_manager           (const char *prog_name,
                                                             const char *version,
                                                             TpBaseConnectionManager* (*construct_cm) (void),
                                                             int argc,
                                                             char **argv);

Run the connection manager by initializing libraries, constructing a main loop, instantiating a connection manager and running the main loop. When this function returns, the program should exit.

If the connection manager does not create a connection within a short arbitrary time (currently 5 seconds), either on startup or after the last open connection is disconnected, and the PERSIST debug flag is not set, return 0.

If registering the connection manager on D-Bus fails, return 1.

`prog_name` : | The program name to be used in debug messages etc.
`version` : | The program version
`construct_cm` : | A function which will return the connection manager object
`argc` : | The number of arguments passed to the program
`argv` : | The arguments passed to the program
Returns : | the status code with which the process should exit