McManager

McManager — A representation of a connection manager.

Synopsis

                    McManager;
McManager*          mc_manager_lookup                   (const gchar *unique_name);
void                mc_manager_free                     (McManager *id);
void                mc_manager_clear_cache              (void);
GList*              mc_managers_list                    (void);
void                mc_managers_free_list               (GList *list);
const gchar*        mc_manager_get_unique_name          (McManager *id);
const gchar*        mc_manager_get_bus_name             (McManager *id);
const gchar*        mc_manager_get_object_path          (McManager *id);

Object Hierarchy

  GObject
   +----McManager

Description

A McManager object represents a connection manager, that is the backend which can be used for handling one or more protocols.

The McManager API allows clients to query the available connection managers, and obtain their D-Bus coordinates.

Details

McManager

typedef struct _McManager McManager;


mc_manager_lookup ()

McManager*          mc_manager_lookup                   (const gchar *unique_name);

Looks up for the McManager having the given unique name. The returned object's reference count is incremented.

unique_name :

the unique name.

Returns :

the McManager, or NULL if not found.

mc_manager_free ()

void                mc_manager_free                     (McManager *id);

Frees (unrefs) the manager. DEPRECATED, use g_object_unref() instead.

id :

the McManager.

mc_manager_clear_cache ()

void                mc_manager_clear_cache              (void);

Clears the managers cache.


mc_managers_list ()

GList*              mc_managers_list                    (void);

Lists all configured managers. Currently this function returns only the "gabble" manager.

Returns :

a GList of the managers, to be freed with mc_managers_free_list.

mc_managers_free_list ()

void                mc_managers_free_list               (GList *list);

Frees a list of managers.

list :

a GList of McManager.

mc_manager_get_unique_name ()

const gchar*        mc_manager_get_unique_name          (McManager *id);

Gets the unique name of the manager.

id :

the McManager.

Returns :

the unique name, as a string (not to be freed).

mc_manager_get_bus_name ()

const gchar*        mc_manager_get_bus_name             (McManager *id);

Gets the D-Bus bus name of the manager.

id :

the McManager.

Returns :

the bus name, as a string (not to be freed).

mc_manager_get_object_path ()

const gchar*        mc_manager_get_object_path          (McManager *id);

Gets the D-Bus object path of the manager.

id :

the McManager.

Returns :

the object path, as a string (not to be freed).