Connection manager life cycle: telepathy-glib API Reference Manual

Connection manager life cycle

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

Functions

int	tp_run_connection_manager ()

Includes

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

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.

Functions

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.

Parameters

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