Repository : ssh://git@open-mesh.org/doc
On branches: backup-redmine/2017-07-13,master
commit 8effcc6d52f82e2a93ccba4b62af03df7b2078f0 Author: Marek Lindner mareklindner@neomailbox.ch Date: Mon Jun 21 00:07:12 2010 +0000
doc: batmand/VisOutput
8effcc6d52f82e2a93ccba4b62af03df7b2078f0 batmand/VisOutput.textile | 62 +++++++++++++++++++++++++++++------------------ 1 file changed, 38 insertions(+), 24 deletions(-)
diff --git a/batmand/VisOutput.textile b/batmand/VisOutput.textile index 77279f74..065eea40 100644 --- a/batmand/VisOutput.textile +++ b/batmand/VisOutput.textile @@ -1,15 +1,17 @@
-= Working with the vis server output =
-{{{ -#!div style="width: 46em; text-align: justify" +h1. Working with the vis server output
-This artcile is for those that intend to write their own visualization tool, combine the vis output with a map or want to understand the vis server output for another reason. If you want to setup the vis server for the batmand have a look at this [wiki:VisualizeMesh article] or for BATMAN-Advanced at [wiki:VisAdv this one]. + +<pre> +<code class="div"> + +This artcile is for those that intend to write their own visualization tool, combine the vis output with a map or want to understand the vis server output for another reason. If you want to setup the vis server for the batmand have a look at this [[VisualizeMesh|article] or for BATMAN-Advanced at [wikiVisAdv this one]].
Here is a sample output from the vis server in the dot draw format. Newer vis versions offer alternative formats (e.g. JSON) which follow the same rules but use another output style.
-{{{ +<pre> digraph topology { "5.174.37.225" -> "5.224.160.202"[label="2.13"] @@ -19,18 +21,21 @@ digraph topology "5.224.160.202" -> "5.174.37.225"[label="1.28"] "5.224.160.202" -> "0.0.0.0/0.0.0.0"[label="HNA"] } -}}} +</code></pre>
Each "digraph { ... }" block contains a complete dump of the vis servers internal database at a given time. Every line contains the IP address of a batman node, a network it has a relation to and a label. All nodes sending information to the vis server are listed in the first column. If a node is missing you should check whether there is a connection problem.
-[[BR]]
-=== Batman to batman connection ===
-{{{ + + +h3. Batman to batman connection + + +<pre> "5.174.37.225" -> "5.224.160.202"[label="2.13"] "5.224.160.202" -> "5.174.37.225"[label="1.28"] -}}} +</code></pre>
The batman node 5.174.37.225 has a connection towards the batman node 5.224.160.202 with a link quality of "2.13" whereas the 5.224.160.202 has a link quality of "1.28" towards the 5.174.37.225. The connection is listed twice because each node reports it individually which gives you the option of seeing asymetric links if you want to display it.
@@ -38,39 +43,48 @@ The link quality gives information how batman evaluates this link. 1.00 means 10
While looking at originator tables, debug logs or other batman output you might see different numbers. Due to performance considerations batman uses his own format (TQ value) to express link quality. Its max value is 255 and goes down to 0 (float operations are quite expensive on embedded devices). The vis server transforms the TQ value into its own format before outputting it.
-[[BR]]
-=== Internet gateways ===
-{{{ + + +h3. Internet gateways + + +<pre> "5.224.160.202" -> "0.0.0.0/0.0.0.0"[label="HNA"] -}}} +</code></pre>
The 5.224.160.202 announces a connection to the internet: "0.0.0.0/0.0.0.0" and the HNA label represent gateway functionality in the output.
-[[BR]]
-=== Announced networks ===
-{{{ + + +h3. Announced networks + + +<pre> "5.174.37.225" -> "192.168.15.0/24"[label="HNA"] -}}} +</code></pre>
The 5.174.37.225 announces a connection to the 192.168.15.0/24 network (which does not run batman). All nodes that establish a connection to this network use the 5.174.37.225 as gateway.
-[[BR]]
-=== Interfaces belonging to one BATMAN-Adv node === + + + +h3. Interfaces belonging to one BATMAN-Adv node +
In BATMAN-Advanced since revision 1424, the subgraphing/cluster feature of the dot-file-format has been added to mark interfaces as belonging to the same originator. Every originator the vis-server found has such an additional subgraph block:
-{{{ +<pre> subgraph "cluster_00:11:22:33:44:55" { "00:11:22:33:44:55" [peripheries=2] "01:23:45:67:89:AB" } -}}} +</code></pre>
-In this example the originator '00:11:22:33:44:55' has two active interfaces, "00:11:22:33:44:55" and "01:23:45:67:89:AB". With 'fdp' from the [http://www.graphviz.org/ graphviz-tools] for instance such interfaces inside of a subgraph would be surrounded by a box. The cluster-prefix is a prerequisite for this tool here to describe the relation between those interfaces and is not a label being visualized. Additionally, the ''primary'' interface gets the extra attribute '[peripheries=2]' which is the only interface known to other BATMAN-Nodes, except to direct neighbours (with graphviz, such an interface gets double circled). +In this example the originator '00:11:22:33:44:55' has two active interfaces, "00:11:22:33:44:55" and "01:23:45:67:89:AB". With 'fdp' from the "graphviz-tools":http://www.graphviz.org/ for instance such interfaces inside of a subgraph would be surrounded by a box. The cluster-prefix is a prerequisite for this tool here to describe the relation between those interfaces and is not a label being visualized. Additionally, the _primary_ interface gets the extra attribute '[peripheries=2]' which is the only interface known to other BATMAN-Nodes, except to direct neighbours (with graphviz, such an interface gets double circled).
-}}} \ No newline at end of file +</code></pre> \ No newline at end of file