r00t2/AnnNet
SHA256
1
0
Fork 0
Code

reorder protonum to beginning of bcast section

Browse Source
This commit is contained in:
brent saner 2025-09-03 16:10:29 -04:00
parent 066c281ed8
commit d3ca61b7ce
Signed by: bts
GPG Key ID: 8C004C2F93481F6B
2 changed files with 26 additions and 26 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
README.adoc
View File

@ -342,6 +342,12 @@ E:T:: EtherType (`0x88b5` or `0x88b6`) _(2 Bytes)_
=== AnnNet Broadcast
AnnNet Broadcast operates on layer 3, making use of <<spec_bcast_v4>> (EtherType `0x0800`) and/or <<spec_bcast_v6>> (EtherType `0x86dd`).
[id="spec_bcast_protonum"]
==== Internet Protocol Number
AnnNet currently uses the __IPv4 protocol__/__IPv6 Next Header__ protocol number `253` (`0xfd`) by default, as AnnNet is still in experimental stages and this protocol is https://www.iana.org/assignments/protocol-numbers/protocol-numbers.xhtml[reserved for experimentation^] per IANA. (`254`, `0xfe`, is another viable option for your implementation as it too is reserved by IANA for experimentation.)
If AnnNet is allocated a dedicated IANA-registered Protocol/Next Header, it will be implemented in a new major version release.
[id="spec_bcast_v4"]
==== IPv4
If IPv4, the AnnNet Broadcast sender _may_ send to:
@ -440,12 +446,6 @@ IP:H:: Hop Limit _(1 Byte)_
IP:S:: Source IPv6 Address _(128 Bits/16 Bytes)_
IP:D:: Destination IPv6 Address _(128 Bits/16 Bytes)_
[id="spec_bcast_protonum"]
==== Internet Protocol Number
AnnNet currently uses the __IPv4 protocol__/__IPv6 Next Header__ protocol number `253` (`0xfd`) by default, as AnnNet is still in experimental stages and this protocol is https://www.iana.org/assignments/protocol-numbers/protocol-numbers.xhtml[reserved for experimentation^] per IANA. (`254`, `0xfe`, is another viable option for your implementation as it too is reserved by IANA for experimentation.)
If AnnNet is allocated a dedicated IANA-registered Protocol/Next Header, it will be implemented in a new major version release.
[id="limits"]
== Limitations
. AnnNet messages *must* fit into a single frame on the network it is being sent/received on. If message continuation or longer messages are wanted/desired, then it is up to the implementer to add a mechanism for this within their implementation's payload.

40
README.html
View File

@ -559,7 +559,7 @@ pre.rouge .gs {
<div class="details">
<span id="author" class="author">Brent Saner</span><br>
<span id="email" class="email"><a href="mailto:bts@square-r00t.net">bts@square-r00t.net</a></span><br>
<span id="revdate">Last rendered 2025-09-03 10:50:06 -0400</span>
<span id="revdate">Last rendered 2025-09-03 16:12:52 -0400</span>
</div>
<div id="toc" class="toc2">
<div id="toctitle">Table of Contents</div>
@ -596,17 +596,17 @@ pre.rouge .gs {
<li><a href="#spec_link">5.2. AnnNet Link</a></li>
<li><a href="#spec_bcast">5.3. AnnNet Broadcast</a>
<ul class="sectlevel3">
<li><a href="#spec_bcast_v4">5.3.1. IPv4</a>
<li><a href="#spec_bcast_protonum">5.3.1. Internet Protocol Number</a></li>
<li><a href="#spec_bcast_v4">5.3.2. IPv4</a>
<ul class="sectlevel4">
<li><a href="#spec_bcast_v4_msg">5.3.1.1. Message Format</a></li>
<li><a href="#spec_bcast_v4_msg">5.3.2.1. Message Format</a></li>
</ul>
</li>
<li><a href="#spec_bcast_v6">5.3.2. IPv6</a>
<li><a href="#spec_bcast_v6">5.3.3. IPv6</a>
<ul class="sectlevel4">
<li><a href="#spec_bcast_v6_msg">5.3.2.1. Message Format</a></li>
<li><a href="#spec_bcast_v6_msg">5.3.3.1. Message Format</a></li>
</ul>
</li>
<li><a href="#spec_bcast_protonum">5.3.3. Internet Protocol Number</a></li>
</ul>
</li>
</ul>
@ -1919,7 +1919,16 @@ Its source <em>must</em> be the MAC/PHYS address of the network interface it is
<p>AnnNet Broadcast operates on layer 3, making use of <a href="#spec_bcast_v4">IPv4</a> (EtherType <code>0x0800</code>) and/or <a href="#spec_bcast_v6">IPv6</a> (EtherType <code>0x86dd</code>).</p>
</div>
<div class="sect3">
<h4 id="spec_bcast_v4"><a class="link" href="#spec_bcast_v4">5.3.1. IPv4</a></h4>
<h4 id="spec_bcast_protonum"><a class="link" href="#spec_bcast_protonum">5.3.1. Internet Protocol Number</a></h4>
<div class="paragraph">
<p>AnnNet currently uses the <em>IPv4 protocol</em>/<em>IPv6 Next Header</em> protocol number <code>253</code> (<code>0xfd</code>) by default, as AnnNet is still in experimental stages and this protocol is <a href="https://www.iana.org/assignments/protocol-numbers/protocol-numbers.xhtml" target="_blank" rel="noopener">reserved for experimentation</a> per IANA. (<code>254</code>, <code>0xfe</code>, is another viable option for your implementation as it too is reserved by IANA for experimentation.)</p>
</div>
<div class="paragraph">
<p>If AnnNet is allocated a dedicated IANA-registered Protocol/Next Header, it will be implemented in a new major version release.</p>
</div>
</div>
<div class="sect3">
<h4 id="spec_bcast_v4"><a class="link" href="#spec_bcast_v4">5.3.2. IPv4</a></h4>
<div class="paragraph">
<p>If IPv4, the AnnNet Broadcast sender <em>may</em> send to:</p>
</div>
@ -1947,7 +1956,7 @@ Its source <em>must</em> be the MAC/PHYS address of the network interface it is
<p>If using any other address, the source address <strong>must</strong> be an address reachable by the network/host the message is being sent to.</p>
</div>
<div class="sect4">
<h5 id="spec_bcast_v4_msg"><a class="link" href="#spec_bcast_v4_msg">5.3.1.1. Message Format</a></h5>
<h5 id="spec_bcast_v4_msg"><a class="link" href="#spec_bcast_v4_msg">5.3.2.1. Message Format</a></h5>
<div class="paragraph">
<p>The <a href="#spec_msg">AnnNet Message</a> follows the Options value immediately:</p>
</div>
@ -2098,7 +2107,7 @@ Its source <em>must</em> be the MAC/PHYS address of the network interface it is
</div>
</div>
<div class="sect3">
<h4 id="spec_bcast_v6"><a class="link" href="#spec_bcast_v6">5.3.2. IPv6</a></h4>
<h4 id="spec_bcast_v6"><a class="link" href="#spec_bcast_v6">5.3.3. IPv6</a></h4>
<div class="paragraph">
<p>If IPv6, the AnnNet Broadcast sender <em>may</em> send to:</p>
</div>
@ -2151,7 +2160,7 @@ Its source <em>must</em> be the MAC/PHYS address of the network interface it is
<p>If using any other address, the source address <strong>must</strong> be an address reachable by the network/host the message is being sent to.</p>
</div>
<div class="sect4">
<h5 id="spec_bcast_v6_msg"><a class="link" href="#spec_bcast_v6_msg">5.3.2.1. Message Format</a></h5>
<h5 id="spec_bcast_v6_msg"><a class="link" href="#spec_bcast_v6_msg">5.3.3.1. Message Format</a></h5>
<div class="paragraph">
<p>The <a href="#spec_msg">AnnNet Message</a> follows the Destination Address value immediately:</p>
</div>
@ -2252,15 +2261,6 @@ Its source <em>must</em> be the MAC/PHYS address of the network interface it is
</div>
</div>
</div>
<div class="sect3">
<h4 id="spec_bcast_protonum"><a class="link" href="#spec_bcast_protonum">5.3.3. Internet Protocol Number</a></h4>
<div class="paragraph">
<p>AnnNet currently uses the <em>IPv4 protocol</em>/<em>IPv6 Next Header</em> protocol number <code>253</code> (<code>0xfd</code>) by default, as AnnNet is still in experimental stages and this protocol is <a href="https://www.iana.org/assignments/protocol-numbers/protocol-numbers.xhtml" target="_blank" rel="noopener">reserved for experimentation</a> per IANA. (<code>254</code>, <code>0xfe</code>, is another viable option for your implementation as it too is reserved by IANA for experimentation.)</p>
</div>
<div class="paragraph">
<p>If AnnNet is allocated a dedicated IANA-registered Protocol/Next Header, it will be implemented in a new major version release.</p>
</div>
</div>
</div>
</div>
</div>
@ -3170,7 +3170,7 @@ and the <a href="https://www.iana.org/assignments/ip-parameters/ip-parameters.xh
</div>
<div id="footer">
<div id="footer-text">
Last updated 2025-09-03 10:49:50 -0400
Last updated 2025-09-03 16:12:45 -0400
</div>
</div>
</body>