## 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).