1 files changed, 62 insertions, 0 deletions

diff --git a/src/lib/include/gnunet_dbus_lib_object_path.h b/src/lib/include/gnunet_dbus_lib_object_path.h
new file mode 100644
index 0000000..ec93d99
--- /dev/null
+++ b/src/lib/include/gnunet_dbus_lib_object_path.h
@@ -0,0 +1,62 @@
+#ifndef GNUNET_DBUS_LIB_OBJECT_PATH_H
+#define GNUNET_DBUS_LIB_OBJECT_PATH_H
+
+#include "gnunet_dbus_lib_object.h"
+
+/**
+ * Represents a path of DBus objects in service's object namespace. eg.
+ * /org/freedesktop/PolicyKit1/Authority
+ */
+struct GNUNET_DBUS_ObjectPath;
+
+/**
+ * Create an object path from a GNUNET_DBUS_Service and a list of
+ * GNUNET_DBUS_Object. The last item in the list must be NULL.
+ * For example, to create the path to the
+ * /org/freedesktop/PolicyKit1/Authority1 object you would call as:
+ * 
+ *     GNUNET_DBUS_object_path_create(policy_kit_service_object,
+ *                                    org_object,
+ *                                    freedesktop_object,
+ *                                    PolicyKit1_object,
+ *                                    Authority_object,
+ *                                    NULL);
+ */
+struct GNUNET_DBUS_ObjectPath *
+GNUNET_DBUS_object_path_create (
+    struct GNUNET_DBUS_Service *service,
+    ...)
+  __attribute__((sentinel));
+
+/**
+ * Increase the reference count of this GNUNET_DBUS_ObjectPath by one.
+ */
+void
+GNUNET_DBUS_object_path_ref (
+    struct GNUNET_DBUS_ObjectPath *path);
+
+/**
+ * Decrease the reference count of this GNUNET_DBUS_ObjectPath by one. Will
+ * free the GNUNET_DBUS_ObjectPath if the reference count reaches zero.
+ */
+void
+GNUNET_DBUS_object_path_unref (
+    struct GNUNET_DBUS_ObjectPath *path);
+
+/**
+ * Format the GNUNET_DBUS_ObjectPath as a string. eg.
+ * "/org/freedesktop/PolicyKit1/Authority1".
+ */
+char *
+GNUNET_DBUS_object_path_to_string (
+    const struct GNUNET_DBUS_ObjectPath *path);
+
+/**
+ * Get the destination object of this path. ie. the final object in the path.
+ */
+struct GNUNET_DBUS_Object *
+GNUNET_DBUS_object_path_get_destination (
+    const struct GNUNET_DBUS_ObjectPath *path);
+
+#endif
+