docs/package/gluon-ebtables-limit-arp.rst

@@ -21,3 +21,10 @@ However it mitigates the impact on the mesh when a larger range of
 its IPv4 subnet is being scanned, which would otherwise result in
 a significant amount of ARP chatter, even for unused IP addresses.
 
+This package is installed by default if the selected routing
+feature is *mesh-batman-adv-15*.
+It can be unselected via::
+
+    packages {
+      '-gluon-ebtables-limit-arp',
+    }

docs/package/gluon-harden-dropbear.rst

+gluon-harden-dropbear
+=====================
+
+This package reduces the attack surface of dropbear, the SSH server on the router.
+
+If the root account either has no password configured or is locked,
+password authorization is disabled in dropbear's settings.
+
+If furthermore no SSH key is authorized to login, the ``dropbear`` service is disabled.
+
+Changing the password or updating authorized keys
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Via console
+"""""""""""
+
+Upon editing */etc/dropbear/authorized_keys* or changing root's password,
+a call to *gluon-reconfigure* as well as a reboot might be needed in order to have dropbear launched conditionally upon boot.
+
+.. code-block:: bash
+
+  passwd
+  gluon-reconfigure
+  reboot
+
+
+In setup-mode
+"""""""""""""
+
+As *gluon-reconfigure* is run when rebooting from the setup-mode web interface, no further steps are required.

docs/package/gluon-hoodselector.dia

@@ -131,7 +131,7 @@
             <dia:real val="0.80000000000000004"/>
           </dia:attribute>
           <dia:attribute name="pos">
-            <dia:point val="12.876,6.683"/>
+            <dia:point val="12.876,6.68206"/>
           </dia:attribute>
           <dia:attribute name="color">
             <dia:color val="#000000"/>
@@ -178,7 +178,7 @@
         <dia:point val="5.3,3.85"/>
       </dia:attribute>
       <dia:attribute name="obj_bb">
-        <dia:rectangle val="5.3,3.255;9.1875,4.0025"/>
+        <dia:rectangle val="5.3,3.25594;9.1875,4.00094"/>
       </dia:attribute>
       <dia:attribute name="text">
         <dia:composite type="text">
@@ -217,7 +217,7 @@
         <dia:point val="20.9,3.85"/>
       </dia:attribute>
       <dia:attribute name="obj_bb">
-        <dia:rectangle val="18.0225,3.255;23.7775,4.0025"/>
+        <dia:rectangle val="18.0225,3.25594;23.7775,4.00094"/>
       </dia:attribute>
       <dia:attribute name="text">
         <dia:composite type="text">
@@ -288,7 +288,7 @@
             <dia:real val="0.80000000000000004"/>
           </dia:attribute>
           <dia:attribute name="pos">
-            <dia:point val="21.026,6.68302"/>
+            <dia:point val="21.026,6.68208"/>
           </dia:attribute>
           <dia:attribute name="color">
             <dia:color val="#000000"/>
@@ -335,7 +335,7 @@
         <dia:point val="26.05,6.1"/>
       </dia:attribute>
       <dia:attribute name="obj_bb">
-        <dia:rectangle val="26.05,5.505;27.5725,6.2525"/>
+        <dia:rectangle val="26.05,5.50594;27.5725,6.25094"/>
       </dia:attribute>
       <dia:attribute name="text">
         <dia:composite type="text">
@@ -400,7 +400,7 @@
             <dia:real val="0.80000000000000004"/>
           </dia:attribute>
           <dia:attribute name="pos">
-            <dia:point val="21,13.345"/>
+            <dia:point val="20.9999,13.3441"/>
           </dia:attribute>
           <dia:attribute name="color">
             <dia:color val="#000000"/>
@@ -413,14 +413,14 @@
     </dia:object>
     <dia:object type="Standard - Line" version="0" id="O9">
       <dia:attribute name="obj_pos">
-        <dia:point val="21.0188,8.3365"/>
+        <dia:point val="21.0188,8.33651"/>
       </dia:attribute>
       <dia:attribute name="obj_bb">
-        <dia:rectangle val="20.718,8.3114;21.2989,11.5689"/>
+        <dia:rectangle val="20.718,8.31141;21.2989,11.5689"/>
       </dia:attribute>
       <dia:attribute name="conn_endpoints">
-        <dia:point val="21.0188,8.3365"/>
-        <dia:point val="21.0064,11.513"/>
+        <dia:point val="21.0188,8.33651"/>
+        <dia:point val="21.0063,11.513"/>
       </dia:attribute>
       <dia:attribute name="numcp">
         <dia:int val="1"/>
@@ -447,7 +447,7 @@
         <dia:point val="21.4,9.75"/>
       </dia:attribute>
       <dia:attribute name="obj_bb">
-        <dia:rectangle val="21.4,9.155;22.7125,9.9025"/>
+        <dia:rectangle val="21.4,9.15594;22.7125,9.90094"/>
       </dia:attribute>
       <dia:attribute name="text">
         <dia:composite type="text">
@@ -477,14 +477,14 @@
     </dia:object>
     <dia:object type="Standard - Line" version="0" id="O11">
       <dia:attribute name="obj_pos">
-        <dia:point val="21,14.7867"/>
+        <dia:point val="21,14.7868"/>
       </dia:attribute>
       <dia:attribute name="obj_bb">
-        <dia:rectangle val="20.7096,14.7617;21.2905,16.6596"/>
+        <dia:rectangle val="20.7096,14.7618;21.2905,16.6597"/>
       </dia:attribute>
       <dia:attribute name="conn_endpoints">
-        <dia:point val="21,14.7867"/>
-        <dia:point val="21,16.6037"/>
+        <dia:point val="21,14.7868"/>
+        <dia:point val="21,16.6038"/>
       </dia:attribute>
       <dia:attribute name="numcp">
         <dia:int val="1"/>
@@ -508,14 +508,14 @@
     </dia:object>
     <dia:object type="Standard - Line" version="0" id="O12">
       <dia:attribute name="obj_pos">
-        <dia:point val="23.2629,11.9796"/>
+        <dia:point val="23.2628,11.9797"/>
       </dia:attribute>
       <dia:attribute name="obj_bb">
-        <dia:rectangle val="23.2292,7.69634;31.5265,12.0133"/>
+        <dia:rectangle val="23.2291,7.69635;31.5265,12.0134"/>
       </dia:attribute>
       <dia:attribute name="conn_endpoints">
-        <dia:point val="23.2629,11.9796"/>
-        <dia:point val="31.4768,7.73127"/>
+        <dia:point val="23.2628,11.9797"/>
+        <dia:point val="31.4768,7.73128"/>
       </dia:attribute>
       <dia:attribute name="numcp">
         <dia:int val="1"/>
@@ -574,7 +574,7 @@
             <dia:real val="0.80000000000000004"/>
           </dia:attribute>
           <dia:attribute name="pos">
-            <dia:point val="21,18.42"/>
+            <dia:point val="21.0001,18.419"/>
           </dia:attribute>
           <dia:attribute name="color">
             <dia:color val="#000000"/>
@@ -590,7 +590,7 @@
         <dia:point val="25.8,9.7625"/>
       </dia:attribute>
       <dia:attribute name="obj_bb">
-        <dia:rectangle val="25.8,9.1675;27.3225,9.915"/>
+        <dia:rectangle val="25.8,9.16844;27.3225,9.91344"/>
       </dia:attribute>
       <dia:attribute name="text">
         <dia:composite type="text">
@@ -623,7 +623,7 @@
         <dia:point val="21.5,15.6625"/>
       </dia:attribute>
       <dia:attribute name="obj_bb">
-        <dia:rectangle val="21.5,15.0675;22.8125,15.815"/>
+        <dia:rectangle val="21.5,15.0684;22.8125,15.8134"/>
       </dia:attribute>
       <dia:attribute name="text">
         <dia:composite type="text">
@@ -688,7 +688,7 @@
             <dia:real val="0.80000000000000004"/>
           </dia:attribute>
           <dia:attribute name="pos">
-            <dia:point val="21,22.87"/>
+            <dia:point val="21,22.869"/>
           </dia:attribute>
           <dia:attribute name="color">
             <dia:color val="#000000"/>
@@ -735,7 +735,7 @@
         <dia:point val="45.6176,6.49732"/>
       </dia:attribute>
       <dia:attribute name="obj_bb">
-        <dia:rectangle val="45.6176,5.90232;45.6176,6.64982"/>
+        <dia:rectangle val="45.6176,5.90326;45.6176,6.64826"/>
       </dia:attribute>
       <dia:attribute name="text">
         <dia:composite type="text">
@@ -768,7 +768,7 @@
         <dia:point val="45.6176,6.49732"/>
       </dia:attribute>
       <dia:attribute name="obj_bb">
-        <dia:rectangle val="45.6176,5.90232;45.6176,6.64982"/>
+        <dia:rectangle val="45.6176,5.90326;45.6176,6.64826"/>
       </dia:attribute>
       <dia:attribute name="text">
         <dia:composite type="text">
@@ -801,7 +801,7 @@
         <dia:point val="4.825,11.825"/>
       </dia:attribute>
       <dia:attribute name="obj_bb">
-        <dia:rectangle val="4.825,11.23;4.825,11.9775"/>
+        <dia:rectangle val="4.825,11.2309;4.825,11.9759"/>
       </dia:attribute>
       <dia:attribute name="text">
         <dia:composite type="text">
@@ -834,7 +834,7 @@
         <dia:point val="4.775,12.575"/>
       </dia:attribute>
       <dia:attribute name="obj_bb">
-        <dia:rectangle val="4.775,11.98;4.775,12.7275"/>
+        <dia:rectangle val="4.775,11.9809;4.775,12.7259"/>
       </dia:attribute>
       <dia:attribute name="text">
         <dia:composite type="text">
@@ -899,7 +899,7 @@
             <dia:real val="0.80000000000000004"/>
           </dia:attribute>
           <dia:attribute name="pos">
-            <dia:point val="3.46205,6.62618"/>
+            <dia:point val="3.46205,6.62524"/>
           </dia:attribute>
           <dia:attribute name="color">
             <dia:color val="#000000"/>
@@ -915,7 +915,7 @@
         <dia:point val="33.97,3.865"/>
       </dia:attribute>
       <dia:attribute name="obj_bb">
-        <dia:rectangle val="30.5337,3.27;37.4062,4.0175"/>
+        <dia:rectangle val="30.5337,3.27094;37.4062,4.01594"/>
       </dia:attribute>
       <dia:attribute name="text">
         <dia:composite type="text">
@@ -986,7 +986,7 @@
             <dia:real val="0.80000000000000004"/>
           </dia:attribute>
           <dia:attribute name="pos">
-            <dia:point val="34.0455,6.59773"/>
+            <dia:point val="34.0455,6.59679"/>
           </dia:attribute>
           <dia:attribute name="color">
             <dia:color val="#000000"/>
@@ -1034,7 +1034,7 @@
             <dia:real val="0.80000000000000004"/>
           </dia:attribute>
           <dia:attribute name="pos">
-            <dia:point val="42.75,6.495"/>
+            <dia:point val="42.75,6.49406"/>
           </dia:attribute>
           <dia:attribute name="color">
             <dia:color val="#000000"/>
@@ -1050,7 +1050,7 @@
         <dia:point val="37.7352,6.35918"/>
       </dia:attribute>
       <dia:attribute name="obj_bb">
-        <dia:rectangle val="37.7352,6.08231;40.5139,6.58227"/>
+        <dia:rectangle val="37.7099,6.04215;40.5698,6.62302"/>
       </dia:attribute>
       <dia:attribute name="conn_endpoints">
         <dia:point val="37.7352,6.35918"/>
@@ -1060,7 +1060,7 @@
         <dia:int val="1"/>
       </dia:attribute>
       <dia:attribute name="line_width">
-        <dia:real val="0"/>
+        <dia:real val="0.05000000074505806"/>
       </dia:attribute>
       <dia:attribute name="end_arrow">
         <dia:enum val="3"/>

docs/package/gluon-hoodselector.rst

@@ -28,15 +28,18 @@ A domain is defined by geostationary fixed shapes by using longitude & latitude
 in combination with the domain configuration system. Below you can see a visual
 example of a regional domain:
 
-.. image:: gluon-hoodselector-domainmap.jpeg
+.. figure:: ./gluon-hoodselector-domainmap.jpeg
+    :alt: Regional domains visualized as shapes defined by latitude & longitude
+
+    © OpenStreetMap contributors
 
 Behaviour
 ------------------
 
-The following is an abstract state diagramm which gives an overview
+The following is an abstract state diagram which gives an overview
 of the process:
 
-.. image:: gluon-hoodselector.svg
+.. image:: ./gluon-hoodselector.svg
 
 The sequence of this diagram reflects the priority of its running modes.
 Each mode will be explained separately below.
@@ -58,12 +61,12 @@ It provides a fallback to the default domain.
 Domain shapes
 -------------
 
-There are two types of domains: the unique dehault one without a defined shape
+There are two types of domains: the unique default one without a defined shape
 and others which contain shapes.
 
 * **default domain**
 
-The default domain doesn’t hold any shapes and represents the inverted area of
+The default domain doesn't hold any shapes and represents the inverted area of
 all other shapes held by other domains with geo coordinates. It will only be
 entered if a node could not be matched to a geo domain. A suggested approach is
 to define the "old" network as default domain and gradually migrate nodes from
@@ -78,7 +81,7 @@ two coordinates per box are needed to define it (see below for an
 example). The second one uses polygons which can have multiple edges.
 Each domain can hold multiple shapes.
 
-.. image:: gluon-hoodselector-rectangle-example.svg
+.. image:: ./gluon-hoodselector-rectangle-example.svg
 
 site.conf
 ---------

docs/package/gluon-logging.rst

+gluon-logging
+=============
+
+The *gluon-logging* package allows to configure a remote syslog server that
+will receive the systems log output that is also visible when calling ``logread``
+from a terminal.
+
+It supports both IPv4 and IPv6 endpoints over UDP and TCP.
+
+Note: The syslog mechanism is incapable of providing a complete log as network
+access is required to send out log messages and ``logd`` does not buffer and resend
+older log messages even though they might be available in ``logread``.
+
+This package conflicts with ``gluon-web-logging`` as it will overwrite the
+user-given syslog server on every upgrade.
+
+site.conf
+---------
+
+syslog.ip : required
+    - Destination address of the remote syslog server
+
+syslog.port : optional
+    - Destination port of the remote syslog server
+    - Defaults to 514
+
+syslog.proto : optional
+    - Protocol to transport syslog frames in, can be either ``tcp`` or ``udp``
+    - Defaults to UDP
+
+Example::
+
+  syslog = {
+    ip = "2001:db8::1",
+    port = 514,
+    proto = "udp",
+  },

docs/package/gluon-mesh-batman-adv-logo.svg

+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!-- Created with Inkscape (http://www.inkscape.org/) -->
+<svg xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:cc="http://creativecommons.org/ns#" xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" xmlns:svg="http://www.w3.org/2000/svg" xmlns="http://www.w3.org/2000/svg" xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd" xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape" version="1.1" width="931.48547" height="370.93994" id="svg4059" inkscape:version="0.48.1 r9760" sodipodi:docname="bat_v2_black.svg" inkscape:export-filename="/mnt/pandem0nium/pub/incoming/bat_logo_v2/bat_v2_black.png" inkscape:export-xdpi="90" inkscape:export-ydpi="90" style="display:inline">
+  <sodipodi:namedview pagecolor="#000000" bordercolor="#666666" borderopacity="1" objecttolerance="10" gridtolerance="10" guidetolerance="10" inkscape:pageopacity="0" inkscape:pageshadow="2" inkscape:window-width="956" inkscape:window-height="1173" id="namedview9" showgrid="false" inkscape:zoom="0.88204281" inkscape:cx="466.24453" inkscape:cy="37.028713" inkscape:window-x="1920" inkscape:window-y="0" inkscape:window-maximized="0" inkscape:current-layer="layer2" fit-margin-top="0" fit-margin-left="0" fit-margin-right="0" fit-margin-bottom="0" inkscape:snap-nodes="true"/>
+  <defs id="defs4061"/>
+  <metadata id="metadata4064">
+    <rdf:RDF>
+      <cc:Work rdf:about="">
+        <dc:format>image/svg+xml</dc:format>
+        <dc:type rdf:resource="http://purl.org/dc/dcmitype/StillImage"/>
+        <dc:title/>
+      </cc:Work>
+    </rdf:RDF>
+  </metadata>
+  <g inkscape:groupmode="layer" id="layer3" inkscape:label="outline" style="display:none" transform="translate(6.26672, 5.9375)">
+    <path style="color:#000000;fill:#ffffff;stroke:none;stroke-width:4.27199984;marker:none;visibility:visible;display:inline;overflow:visible;enable-background:accumulate" d="m 483.25,-3.21875 c -6.08901,48.631979 -35.33662,91.011416 -69.21578,124.91707 -21.83485,21.38244 -47.03966,39.44335 -75.34672,51.17668 5.57969,-19.28428 1.04687,-40.97874 -11.5,-56.59375 2.45626,-29.914047 0.68927,-59.992978 -2.5,-89.78125 -15.98198,19.265018 -27.7684,41.544355 -37.5,64.5 -12.24825,-3.17862 -25.72651,-2.402049 -37.71875,0.46875 C 239.88593,74.102096 226.47693,59.077996 210.625,47.0625 c -3.34092,23.469062 -2.56561,47.559048 0.25,70.875 -6.69043,8.82966 -11.26059,19.42531 -12.0625,30.53125 -1.92921,1.3424 -3.05608,3.45019 -4.6875,0.40625 -20.84238,-21.1131 -32.59851,-48.84198 -44.9375,-75.34375 -14.85679,72.96988 -54.000466,137.54014 -93.508574,199.57505 -20.539303,31.20908 -42.388201,61.40672 -64.085176,91.86245 8.08014534,2.26279 14.376322,-5.17296 21.382238,-7.84546 48.067949,-26.0431 95.020242,-57.97999 149.805262,-67.65454 7.73822,-1.18656 15.65228,-1.74501 23.53125,-1.625 -0.16141,-13.91977 12.35539,-25.87856 26.40625,-24.625 13.02151,-0.10475 25.24921,5.06339 36.71875,10.84375 3.0761,-8.90096 9.56834,-15.98034 17.8125,-20.25 15.98458,27.53202 46.28592,42.98776 75.65932,52.75163 10.28498,3.53684 21.92146,5.33208 32.02818,7.49837 -0.72852,8.29742 2.55832,18.64745 11.71875,20.5625 7.84288,-6.18411 13.7902,-15.27395 22.59202,-19.68372 10.89918,-0.79379 21.80373,-2.64611 32.18923,-5.97253 8.1863,6.12253 18.23881,13.28825 29.03125,9.78125 0.2397,-7.80979 -2.17974,-15.60208 -1.25,-23.34375 14.60652,-14.33722 28.49903,-29.6116 39.75,-46.65625 -31.89112,0.19103 -65.39001,-1.50716 -93.6875,-17.375 12.63668,-0.24322 25.04624,3.36048 36.09375,9.40625 26.41279,-12.24594 57.54458,-3.79641 80.97725,11.3725 5.86994,3.60205 11.37305,7.64719 16.46025,12.19 36.58823,-16.89113 78.56629,-15.82385 118.11934,-12.20623 88.66214,9.36494 173.26796,44.12384 247.50566,92.70623 3.41963,1.85442 7.16209,2.95892 10.78125,4.40625 -11.75164,-20.6658 -29.05422,-37.32743 -43.5,-56.125 C 818.67884,217.58496 746.42668,149.41496 664.49937,94.602513 607.29452,55.830775 546.38636,22.78003 483.5625,-5.9375 c -0.10417,0.90625 -0.20833,1.8125 -0.3125,2.71875 z" id="path3993-5" inkscape:connector-curvature="0"/>
+  </g>
+  <g inkscape:groupmode="layer" id="layer2" inkscape:label="batman-adv" style="display:inline" transform="translate(6.26672, 5.9375)">
+    <g style="display:inline" transform="translate(-51.5312, -495.768)" id="layer1">
+      <path d="m 538.40625,495.76769 c -8.05674,66.9338 -77.31603,151.94452 -154.9375,179.84375 3.27747,-7.40037 5.09375,-15.49392 5.09375,-24 0,-14.42887 -5.21809,-27.70021 -13.96875,-38.3125 1.97025,-21.96404 1.77421,-48.67721 -1.375,-80.59375 -13.0022,16.9579 -23.30307,37.7663 -32.15625,58.78125 -6.27289,-1.8029 -12.93745,-2.78125 -19.84375,-2.78125 -7.73405,0 -15.17627,1.22854 -22.09375,3.46875 -7.42014,-13.90647 -17.47037,-28.11748 -33.78125,-41.59375 -2.4998,23.48832 -1.59267,44.90394 1.6875,63.65625 -8.2866,10.45096 -13.63544,23.35979 -12.0986,32.68414 -4.42484,0.36051 -5.23536,4.01016 -5.31948,6.88419 -19.28312,-16.49687 -32.60091,-39.15698 -47.58192,-72.16208 -13.26705,58.98947 -53.37139,142.16702 -150.5,273.75 61.55905,-33.2251 123.79671,-75.61843 182.8125,-75.78125 4.05468,-25.33145 30.1327,-32.48291 64.65625,-15.15625 4.05331,-9.20658 11.84907,-15.85762 21.59375,-20.21875 12.89223,29.16757 60.06405,56.23506 110.53125,61.78125 -2.71475,10.31567 2.48339,19.28096 6.03125,19.90625 L 457.25,806.89269 c 12.40469,-0.59384 24.70147,-2.7024 36.40625,-6.5625 8.39362,6.41285 17.71829,12.37841 24.1875,10.96875 l -1.71875,-21.125 c 13.74684,-14.03964 23.51218,-23.14064 36.6879,-41.69749 -37.60849,-0.0334 -70.29254,-4.68998 -97.84415,-24.05251 14.31376,-2.87534 30.90137,-1.2243 48.09375,7.71875 48.64496,-20.64584 97.96875,23.25 97.96875,23.25 59.36547,-28.55091 217.47867,-17.57755 366.6875,81.8125 -81.50891,-100.35408 -186.3503,-229.51108 -429.3125,-341.4375 z" id="path3993" style="color:#000000;fill:#000000;stroke:none;stroke-width:4.27199984;marker:none;visibility:visible;display:inline;overflow:visible;enable-background:accumulate" inkscape:export-filename="/home/sven/dokumente/bat_logo_v2.png" inkscape:export-xdpi="90" inkscape:export-ydpi="90" inkscape:connector-curvature="0" sodipodi:nodetypes="ccscccscccccccccccccccccccccc"/>
+      <path d="m 287.37698,691.21665 6.32487,6.0769 42.42641,-3.28299 4.04061,-10.85914 -6.08375,5.31015 -38.85662,6.0495 z" id="path4001" style="color:#000000;fill:#ffffff;stroke:none;stroke-width:1.77165353;marker:none;visibility:visible;display:inline;overflow:visible;enable-background:accumulate" inkscape:connector-curvature="0" sodipodi:nodetypes="ccccccc"/>
+      <path d="m 304.03798,658.90775 c 3.73562,-7.35256 3.37257,-7.75354 27.47128,-14.84657 15.15993,-4.46206 30.11288,-9.25782 32.38025,-2.07348 l 18.53034,-4.86774 0.54842,3.1737 -18.32114,6.49226 c -3.7905,21.99567 -3.66551,19.92566 -20.7106,21.97074 -27.63928,3.31618 -30.32837,6.17704 -39.39348,-6.06083 l -7.32361,1.01015 c -3.77481,8.34177 -0.87651,8.42602 -25.47706,7.6321 -16.18663,-0.52238 -14.20261,-0.23719 -17.22819,-15.14996 -1.35304,-6.66902 -0.33802,-7.91117 21.30347,-5.15085 17.50983,2.23334 17.19396,1.76122 21.20894,8.92319 z" id="path4003" style="color:#000000;fill:#ffffff;stroke:none;stroke-width:1.77165353;marker:none;visibility:visible;display:inline;overflow:visible;enable-background:accumulate" inkscape:connector-curvature="0" sodipodi:nodetypes="csccccsccssscc"/>
+    </g>
+  </g>
+</svg>
\ No newline at end of file