--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/libtelepathy/inc/tp-helpers.h	Tue Feb 02 01:10:06 2010 +0200
@@ -0,0 +1,82 @@
+/*
+ * tp-helpers.h - Header for various helper functions 
+ * for telepathy implementation
+ * Copyright (C) 2005 Collabora Ltd.
+ * 
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2.1 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the Free Software
+ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
+ */
+
+#ifndef __TELEPATHY_HELPERS_H__
+#define __TELEPATHY_HELPERS_H__
+
+#include <glib.h>
+
+G_BEGIN_DECLS
+
+typedef struct
+{
+  gpointer key;
+  gpointer value;
+} TpKeyValue;
+
+DBusGConnection * tp_get_bus ();
+DBusGProxy * tp_get_bus_proxy ();
+GSList *tp_hash_to_key_value_list(GHashTable *hashtable);
+void tp_key_value_list_free(GSList *list);
+
+
+typedef struct _tp_connmgr_info TpConnMgrInfo;
+typedef struct _tp_connmgr_protocol_info TpConnMgrProtInfo;
+
+struct _tp_connmgr_protocol_info
+{
+  gchar **mandatory_params;
+  gchar **optional_params;
+
+  /* defaul value hash */
+  GHashTable *default_params;
+};
+
+struct _tp_connmgr_info
+{
+  gchar *name;
+  gchar *bus_name;
+  gchar *object_path;
+  gchar **protocols;
+
+  /* hash of protocol infos */
+  GHashTable *protocol_info;
+};
+
+/*
+ * Lists all the connection manager files.
+ * @return A list of connection manager names
+ */
+GSList *tp_connmgr_list_cms(void);
+
+/*
+ * Returns the connection manager information for the given connection manager
+ * @param cm: the connection manager name string
+ * @return A struct containing all the information read from the connection
+ * manager file.
+ */
+TpConnMgrInfo *tp_connmgr_get_info(gchar *cm);
+
+
+G_END_DECLS
+
+#endif /* __TELEPATHY_HELPERS_H__ */
+