1 files changed, 110 insertions, 0 deletions

diff --git a/src/lib/include/gnunet_dbus_lib_method.h b/src/lib/include/gnunet_dbus_lib_method.h
new file mode 100644
index 0000000..9b47fcf
--- /dev/null
+++ b/src/lib/include/gnunet_dbus_lib_method.h
@@ -0,0 +1,110 @@
+#ifndef GNUNET_DBUS_LIB_METHOD_H
+#define GNUNET_DBUS_LIB_METHOD_H
+
+#include <stdbool.h>
+
+/**
+ * Represents a DBus method. Consists of a linked-list of args and return args
+ * of type GNUNET_DBUS_Arg.
+ */
+struct GNUNET_DBUS_Method;
+
+#include "gnunet_dbus_lib_object.h"
+#include "gnunet_dbus_lib_method_context.h"
+
+/**
+ * An iterable, double-linked list of GNUNET_DBUS_Method.
+ */
+struct GNUNET_DBUS_MethodIterator
+{
+  /* linked list */
+  struct GNUNET_DBUS_MethodIterator *next;
+  struct GNUNET_DBUS_MethodIterator *prev;
+
+  struct GNUNET_DBUS_Method *method;
+};
+
+/**
+ * Create a new GNUNET_DBUS_Method with the given name. The underlying_method
+ * function will be called whenever this method is called via DBus. After
+ * creating a method you need to populate it the args and return args before
+ * binding it to an interface with GNUNET_DBUS_interface_add_method.
+ */
+struct GNUNET_DBUS_Method *
+GNUNET_DBUS_method_create (
+    const char *name,
+    void (*underlying_method)(struct GNUNET_DBUS_MethodContext *mc));
+
+/**
+ * Increase the reference count of this GNUNET_DBUS_Method by one.
+ */
+void
+GNUNET_DBUS_method_ref (
+    struct GNUNET_DBUS_Method *method);
+
+/**
+ * Decrease the reference count of this GNUNET_DBUS_Method by one. Will free
+ * the method if the reference count reaches zero.
+ */
+void
+GNUNET_DBUS_method_unref (
+    struct GNUNET_DBUS_Method *method);
+
+/**
+ * Add an argument with the given name and type signature to this method.
+ */
+void
+GNUNET_DBUS_method_add_arg (
+    struct GNUNET_DBUS_Method *method,
+    const char *name,
+    const char *signature);
+
+/**
+ * Add a return argument with the given name and type signature to this method.
+ */
+void
+GNUNET_DBUS_method_add_return_arg (
+    struct GNUNET_DBUS_Method *method,
+    const char *name,
+    const char *signature);
+
+/**
+ * Get the name of this method.
+ */
+const char *
+GNUNET_DBUS_method_get_name (
+    const struct GNUNET_DBUS_Method *method);
+
+/**
+ * Iterate over the arguments of this GNUNET_DBUS_Method.
+ */
+const struct GNUNET_DBUS_ArgIterator *
+GNUNET_DBUS_method_iterate_args (
+    const struct GNUNET_DBUS_Method *method);
+/*
+ * Iterate over the return arguments of this GNUNET_DBUS_Method.
+ */
+const struct GNUNET_DBUS_ArgIterator *
+GNUNET_DBUS_method_iterate_return_args (
+    const struct GNUNET_DBUS_Method *method);
+
+/**
+ * Call this method with the supplied GNUNET_DBUS_MethodContext.
+ */
+void
+GNUNET_DBUS_method_call (
+    struct GNUNET_DBUS_Method *method,
+    struct GNUNET_DBUS_MethodContext *mc);
+
+/**
+ * Find a GNUNET_DBUS_Method with the given name in the supplied iterator.
+ * Returns the position in the iterator of the method or NULL if it could not
+ * be found.
+ */
+const struct GNUNET_DBUS_MethodIterator *
+GNUNET_DBUS_method_find (
+    const struct GNUNET_DBUS_MethodIterator *meth_it,
+    const char *name);
+
+#endif
+