[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[GNUnet-SVN] r36842 - in gnunet-dbus: . src src/etc

From: gnunet
Subject: [GNUnet-SVN] r36842 - in gnunet-dbus: . src src/etc
Date: Tue, 19 Jan 2016 04:40:54 +0100

Author: canndrew
Date: 2016-01-19 04:40:54 +0100 (Tue, 19 Jan 2016)
New Revision: 36842

Added README, bootstrap and dbus config file.

Modified: gnunet-dbus/README
--- gnunet-dbus/README  2016-01-18 22:56:50 UTC (rev 36841)
+++ gnunet-dbus/README  2016-01-19 03:40:54 UTC (rev 36842)
@@ -0,0 +1,46 @@
+## gnunet-dbus: A DBus proxy for GNUnet
+# Purpose
+The aim of this project is to make it easy to control GNUnet via DBus. Any
+DBus-enabled piece of software should be able to use this to start/stop GNUnet
+services, perform GNS lookups, download files etc.
+# Installation
+$ ./bootstrap
+$ ./configure
+$ make
+$ make install
+After that, you will need to relax the DBus permissions to allow gnunet-dbus to
+use the system bus. On most Linux distros, copying src/etc/gnunet-dbus.conf to
+/etc/dbus-1/system.d/ should do the trick. Otherwise, you can use that file for
+guidance on how to setup permissions.
+# Running
+gnunet-dbus is not currently integrated with gnunet-arm or any init system so
+you'll have to run the binaries manually. There is one gnunet-dbus executable
+per GNUnet service. They are installed to $PREFIX/bin by default and have names
+like gnunet-service-dht-dbus, gnunet-service-gns-dbus etc.
+# Hacking
+Contributions are welcome!
+In the src/ directory you'll find the service/ and lib/ directories. service/
+contains the source for the service executables (gnunet-service-gns-dbus etc.).
+lib/ contains all the source and headers for the gnunet-dbus libraries.
+lib/common/ is probably the most interesting directory here as it contains the
+bulk of the code for binding libdbus with GNUnet's event loop. The other
+directories in lib/ mainly consist of code for serialising/deserialising types
+from the various parts of GNUnet's API.
+For learning how to use this library to write more service wrappers or extend
+the existing ones it's probably easiest to read through existing code. The code
+tries to be clear and logical and is very object-oriented.
+gnunet-service-gns-dbus.c shows, for example, how to setup a dbus
+service+object+interface+method for performing lookups and bind this DBus
+method to an internal function which calls GNUNET_GNS_lookup.

Added: gnunet-dbus/bootstrap
--- gnunet-dbus/bootstrap                               (rev 0)
+++ gnunet-dbus/bootstrap       2016-01-19 03:40:54 UTC (rev 36842)
@@ -0,0 +1,4 @@
+autoreconf --install

Property changes on: gnunet-dbus/bootstrap
Added: svn:executable
## -0,0 +1 ##
\ No newline at end of property
Added: gnunet-dbus/src/etc/gnunet-dbus.conf
--- gnunet-dbus/src/etc/gnunet-dbus.conf                                (rev 0)
+++ gnunet-dbus/src/etc/gnunet-dbus.conf        2016-01-19 03:40:54 UTC (rev 
@@ -0,0 +1,20 @@
+<!DOCTYPE busconfig PUBLIC
+          "-//freedesktop//DTD D-BUS Bus Configuration 1.0//EN"
+          "";>
+  <policy group="gnunet">
+    <allow own_prefix="gnu.gnunet"/>
+    <allow send_destination="gnu.gnunet.dht"/>
+    <allow receive_sender="gnu.gnunet.dht"/>
+    <allow send_destination="gnu.gnunet.gns"/>
+    <allow receive_sender="gnu.gnunet.gns"/>
+  </policy>
+  <policy user="root">
+    <allow own_prefix="gnu.gnunet"/>
+    <allow send_destination="gnu.gnunet.dht"/>
+    <allow receive_sender="gnu.gnunet.dht"/>
+    <allow send_destination="gnu.gnunet.gns"/>
+    <allow receive_sender="gnu.gnunet.gns"/>
+  </policy>

reply via email to

[Prev in Thread] Current Thread [Next in Thread]