## McProtocol

McProtocol — representation of a communication protocol.

## Synopsis

                        McProtocol;
    McProtocol*         mc_protocol_lookup                  (McManager *id,
                                                             const gchar *protocol);
    void                mc_protocol_free                    (McProtocol *id);
    GList*              mc_protocols_list                   (void);
    GList*              mc_protocols_list_by_manager        (McManager *id);
    void                mc_protocols_free_list              (GList *list);
    McManager*          mc_protocol_get_manager             (McProtocol *id);
    const gchar*        mc_protocol_get_name                (McProtocol *id);
    GSList*             mc_protocol_get_params              (McProtocol *protocol);
    void                mc_protocol_free_params_list        (GSList *list);
    void                mc_protocol_print                   (McProtocol *protocol);

## Object Hierarchy

      GObject
       +----McProtocol

## Description

An McProtocol represents a protocol (such as Jabber, SIP, IRC...) and stores some parameters about it. It also specifies what is the backend (McManager) which can handle this protocol.

## Details

### McProtocol

    typedef struct _McProtocol McProtocol;

### mc_protocol_lookup ()

    McProtocol*         mc_protocol_lookup                  (McManager *id,
                                                             const gchar *protocol);

Looks up the protocol having the given name in the manager's supported protocols. The returned object's reference count is incremented.

`id` : | The McManager.
`protocol` : | The protocol name.
Returns : | the McProtocol, or NULL if not found.

### mc_protocol_free ()

    void                mc_protocol_free                    (McProtocol *id);

Frees (unrefs) the protocol. DEPRECATED, use `g_object_unref()` instead.

`id` : | The McProtocol.

### mc_protocols_list ()

    GList*              mc_protocols_list                   (void);

Lists all supported protocols. This currently lists all protocols supported by the "gabble" manager.

Returns : | a GList of McProtocol, to be freed with mc_protocols_free_list.

### mc_protocols_list_by_manager ()

    GList*              mc_protocols_list_by_manager        (McManager *id);

Lists all protocols supported by the given manager.

`id` : | a McManager.
Returns : | a GList of McProtocol, to be freed with mc_protocols_free_list.

### mc_protocols_free_list ()

    void                mc_protocols_free_list              (GList *list);

Frees a list of protocols.

`list` : | a GList of McProtocol.

### mc_protocol_get_manager ()

    McManager*          mc_protocol_get_manager             (McProtocol *id);

Gets the manager for this protocol.

`id` : | The McProtocol.
Returns : | the McManager, or NULL if some error occurred.

### mc_protocol_get_name ()

    const gchar*        mc_protocol_get_name                (McProtocol *id);

Gets the name of this protocol.

`id` : | The McProtocol.
Returns : | a string representing the name (not to be freed)

### mc_protocol_get_params ()

    GSList*             mc_protocol_get_params              (McProtocol *protocol);

Gets the parameters for this protocol.

`protocol` : | The McProtocol.
Returns : | a GList of McProtocolParam, to be freed with mc_protocol_free_params_list.

### mc_protocol_free_params_list ()

    void                mc_protocol_free_params_list        (GSList *list);

Frees a list of McProtocolParam.

`list` : | The GList.

### mc_protocol_print ()

    void                mc_protocol_print                   (McProtocol *protocol);

Prints the protocol name and all protocol parameters via g_print.

`protocol` : | the McProtocol.