![]() |
![]() |
![]() |
Mission Control Reference Manual | ![]() |
---|---|---|---|---|
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);
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.
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. |
void mc_protocol_free (McProtocol *id);
Frees (unrefs) the protocol.
DEPRECATED, use g_object_unref()
instead.
id : |
The McProtocol. |
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. |
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. |
void mc_protocols_free_list (GList *list);
Frees a list of protocols.
list : |
a GList of McProtocol. |
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. |
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) |
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. |
void mc_protocol_free_params_list (GSList *list);
Frees a list of McProtocolParam.
list : |
The GList. |
void mc_protocol_print (McProtocol *protocol);
Prints the protocol name and all protocol parameters via g_print.
protocol : |
the McProtocol. |