From: Ralph Ronnquist Date: Mon, 18 Oct 2021 12:36:06 +0000 (+1100) Subject: editorial X-Git-Tag: 1.5~5 X-Git-Url: https://git.rrq.au/?a=commitdiff_plain;h=202bf70621df94162ae90fc502565020f7991472;p=rrq%2Frrqnet.git editorial --- diff --git a/readme.adoc b/readme.adoc index aa2ca5f..f216a2f 100644 --- a/readme.adoc +++ b/readme.adoc @@ -9,8 +9,8 @@ combinations of ipv4 and ipv6 tunneling over ipv4 or ipv6. MAN PAGES --------- * link:rrqnet/src/branch/suites/unstable/rrqnet.8.adoc[The rrqnet man page] - * link:rrqnet/src/branch/suites/unstable/rrqnet-cron.8.adoc[The rrqnet-cron man page] * link:rrqnet/src/branch/suites/unstable/rrqnet-ifupdown.sh.8.adoc[The rrqnet-ifupdown.sh man page] + * link:rrqnet/src/branch/suites/unstable/rrqnet-cron.8.adoc[The rrqnet-cron man page] Devuan Packages --------------- diff --git a/rrqnet-ifupdown.sh.8.adoc b/rrqnet-ifupdown.sh.8.adoc index 536cbc7..787b294 100644 --- a/rrqnet-ifupdown.sh.8.adoc +++ b/rrqnet-ifupdown.sh.8.adoc @@ -19,13 +19,11 @@ DESCRIPTION */etc/rrqnet/ifupdown.sh* is a utility script for managing +rrqnet+ virtual cables via +/etc/network/interfaces+ declarations. In normal -use the script is set up as "pre-up" and "post-down" scripts by means -of links from +/etc/network/if-pre-up.d/rrqnet+ and from -+/etc/network/if-post-down.d/rrqnet+. It will then be invoked by -+ifup+ and +ifdown+ for handling the +rrqnet+ declarations and bring -up or tear down +rrqnet+ virtual cable plugs over +tap+ interfaces. +use the script is set up as hook script by means of links from all ++/etc/network/if-*.d/rrqnet+ for automatic invocation with the +commands +ifup+ and +ifdown+. -An +rrqnet+ virtual cable uses a +tap+ interface at each cable end +A +rrqnet+ virtual cable uses a +tap+ interface at each cable end host, and a service process (aptly named +rrqnet+) to tunnel the +tap+ network traffic over UDP. Each +rrqnet+ process acts as a networking switch that facilitates level 2 connectivity among all its end points @@ -33,7 +31,7 @@ with packet routing according to the destination Ethernet machine addresses. This script handles the special purpose "option codes" for the IFACE -stanzas that are used for declaring the +rrqnet+ daemon configuration +blocks that are used for declaring the +rrqnet+ daemon configuration to for the +tap+ interface for its virtual cabling. I.e., the IFACE stanza is made for the tap interface and it includes one or more of these +rrqnet+ options. @@ -115,9 +113,9 @@ marks the stanza as an ++rrqnet+ virtual cabling set up which then is duly handled by +rrqnet-ifupdown.sh+. The +rrqnet_options+ in the example tells the +rrqnet+ process to use -an ipv4-only socket, 10 packet buffers and a single delivery thread. -If left out, the default is to use an ipv6 socket, 10 bufffers and 5 -threads. +an ipv4-only socket, 10 packet buffers and a single delivery thread, +in addition to the socket reader threads. The default is to use an +ipv6 socket, 10 bufffers and 5 delivery threads. NOTES ----- diff --git a/rrqnet.8.adoc b/rrqnet.8.adoc index c7e1823..e3dc8e3 100644 --- a/rrqnet.8.adoc +++ b/rrqnet.8.adoc @@ -92,12 +92,12 @@ hosts via UDP messaging between the hosts. collection of fully connected hosts, although the more common is a "star' formation. See the EXAMPLES section for inspiration. -*rrqnet* includes logic aiming to protect against broadcast cycles. -Howewer it does not have the more advanced spanning tree logic that is -offered by bridge interfaces. In general it's probably best to avoid -cabling cycles and perhaps rather run several *rrqnet* on a host with -their taps connected with a bridge interface. Though, multiple virtual -cabling paths between hosts might increase connection reliability. +*rrqnet* includes logic to protect against broadcast cycles. Whilst +acting as a switch for all its remotes it does not have spanning tree +logic as is offered by bridge interfaces. Generally it's probably best +to avoid cabling cycles, but *rrqnet* also handles full mesh linking +between multiple hosts without additional configuration. Such a setup +is also dynamically adapting to prefer the fastest link between hosts. By default *rrqnet* opens an +ipv6+ socket on the given port. This mode handles both +ipv6+ and +ipv4+ remotes with +ipv4+ remotes @@ -440,6 +440,7 @@ Using +-t -+ for stdin/stdout packet traffic is compatible with SEE ALSO -------- *rrqnet-cron(8)* - Management script to uphold a *rrqnet* plug. +*rrqnet-ifupdown(8)* - Management script to uphold a *rrqnet* plug. *vde_plug(1)* - Virtual Distributed Ethernet plug.