summaryrefslogtreecommitdiffstats
path: root/modules/retiolum/scripts/adv_graphgen/README
diff options
context:
space:
mode:
authorroot <root@krebs>2011-05-27 02:15:17 +0200
committerroot <root@krebs>2011-05-27 02:15:17 +0200
commitd2ce18954f19edccf23dddf76c737cd76ca7881e (patch)
tree09d5deb390e5f7955b56b29730de22649b12f298 /modules/retiolum/scripts/adv_graphgen/README
parent8fe5eab10765eaf34a6f27802c17dad777863a87 (diff)
prepare .scripts for import into krebscode
Diffstat (limited to 'modules/retiolum/scripts/adv_graphgen/README')
-rw-r--r--modules/retiolum/scripts/adv_graphgen/README28
1 files changed, 28 insertions, 0 deletions
diff --git a/modules/retiolum/scripts/adv_graphgen/README b/modules/retiolum/scripts/adv_graphgen/README
new file mode 100644
index 00000000..082e0f2b
--- /dev/null
+++ b/modules/retiolum/scripts/adv_graphgen/README
@@ -0,0 +1,28 @@
+The folder contains a number of scripts which provide a convenient way to
+generate advanced graphs from the SIGUSR2 output of tinc.
+
+it currently contains the following files:
+
+sanitize.sh:
+ wrapper arond parse.py which filters the syslog file for all tinc
+ related lines and removes the status informations:
+ this means that
+ <code>
+ May 19 20:40:44 servarch dnsmasq[5382]: reading /etc/resolv.conf
+ May 19 20:41:38 servarch tinc.retiolum[4780]: Error looking up pa-sharepoint.informatik.ba-stuttgart.de port 655: Name or service not known
+ </code>
+ becomes
+ <code>
+ Error looking up pa-sharepoint.informatik.ba-stuttgart.de port 655: Name or service not known
+ </code>
+ and so on.
+ It also provides a wrapper around graphviz which automagically
+ generates graphs from the produced graph file
+
+parse.py:
+ reads from stdin the sanitized syslog file and prints a valid dot file
+ from the given output.
+ The parser module may also produce any other output (e.g. for dns
+ entries and so on) you will need to actually read and modify the source
+ in order to be able to do this. ~May the source be with you~
+