1 files changed, 87 insertions, 0 deletions

diff --git a/src/lib/include/gnunet_dbus_lib_service.h b/src/lib/include/gnunet_dbus_lib_service.h
new file mode 100644
index 0000000..4d88079
--- /dev/null
+++ b/src/lib/include/gnunet_dbus_lib_service.h
@@ -0,0 +1,87 @@
+#ifndef GNUNET_DBUS_LIB_SERVICE_H
+#define GNUNET_DBUS_LIB_SERVICE_H
+
+#include <gnunet/platform.h>
+#include <gnunet/gnunet_common.h>
+#include <gnunet/gnunet_configuration_lib.h>
+
+/**
+ * Represents a DBus service that we are running.
+ */
+struct GNUNET_DBUS_Service;
+
+#include "gnunet_dbus_lib_object.h"
+#include "gnunet_dbus_lib_client.h"
+
+/**
+ * The type of callbacks used to handle newly-connecting clients.
+ */
+typedef void (*GNUNET_DBUS_ClientConnectsHandler)(
+    struct GNUNET_DBUS_Service *service,
+    struct GNUNET_DBUS_Client *client);
+
+/**
+ * The type of callbacks used to handle clients disconnecting.
+ */
+typedef void (*GNUNET_DBUS_ClientDisconnectsHandler)(
+    struct GNUNET_DBUS_Service *service,
+    struct GNUNET_DBUS_Client *client);
+
+/**
+ * Create a service with the given name and configuration. The service will
+ * start running immediately in GNUnet's scheduler.
+ */
+struct GNUNET_DBUS_Service *
+GNUNET_DBUS_service_create (
+    const struct GNUNET_CONFIGURATION_Handle *cfg,
+    const char *name);
+
+/**
+ * Increase the reference count of this GNUNET_DBUS_Service by one.
+ */
+void
+GNUNET_DBUS_service_ref (
+    struct GNUNET_DBUS_Service *service);
+
+/**
+ * Decrease the reference count of this GNUNET_DBUS_Service by one. Will free
+ * the service if the reference count reaches zero.
+ */
+void
+GNUNET_DBUS_service_unref (
+    struct GNUNET_DBUS_Service *service);
+
+/**
+ * Get a reference to this GNUNET_DBUS_Service's configuration.
+ */
+const struct GNUNET_CONFIGURATION_Handle *
+GNUNET_DBUS_service_get_config (
+    struct GNUNET_DBUS_Service *service);
+
+/**
+ * Send an arbitrary message from this service.
+ */
+void
+GNUNET_DBUS_service_send (
+    struct GNUNET_DBUS_Service *service,
+    DBusMessage *dbus_message);
+
+/**
+ * Set the callbacks used by this service to handle clients connecting and
+ * disconnecting.
+ */
+void
+GNUNET_DBUS_service_set_client_handlers (
+    struct GNUNET_DBUS_Service *service,
+    GNUNET_DBUS_ClientConnectsHandler client_connects,
+    GNUNET_DBUS_ClientDisconnectsHandler client_disconnects);
+
+/**
+ * Get this GNUNET_DBUS_Service's root object (a.k.a. '/')
+ */
+struct GNUNET_DBUS_Object *
+GNUNET_DBUS_service_get_root_object (
+    struct GNUNET_DBUS_Service *service);
+
+#endif
+