diff --git a/README.md b/README.md index de0e1c5..f4c38d4 100644 --- a/README.md +++ b/README.md @@ -1 +1,39 @@ -See mkmap.sh for now :) +ffmap-backend - Data for Freifunk Map + +ffmap-backend gathers information on the batman network by invoking + batctl +and + batadv-vis +as root (via sudo) and has this information placed into a target directory +as the file "nodes.json" and also updates the directory "nodes" with graphical +representations of uptimes and the number of clients connecting. + +The target directory is suggested to host all information for interpreting those +node descriptions, e.g. as provided by https://github.com/ffnord/ffmap-d3.git . +When executed without root privileges, we suggest to grant sudo permissions +within wrappers of those binaries, so no further changes are required in other +scripts: + +$ cat < $HOME/batctl +#!/bin/sh +exec sudo /usr/sbin/batctl $* +EOCAT + +and analogously for batadv-vis. The entry for /etc/sudoers could be +whateveruser ALL=(ALL:ALL) NOPASSWD: /usr/sbin/batctl,/usr/sbin/batadv-vis,/usr/sbin/alfred-json + +The destination directory can be made directly available through apache: + +$ cat /etc/apache2/site-enabled/000-default +... + + Options Indexes FollowSymLinks MultiViews + AllowOverride None + Order allow,deny + allow from all + +... + +$ cat /etc/apache2/conf.d/freifunk +Alias /map /home/ffmap/www/ +Alias /firmware /home/freifunk/autoupdates/