File 2281-erts-Update-distribution-protocol-doc.patch of Package erlang
From 76ce72abf70ade3b8bff214893f9ff239a74278b Mon Sep 17 00:00:00 2001
From: Takeru Ohta <phjgt308@gmail.com>
Date: Fri, 29 Apr 2022 12:26:16 +0900
Subject: [PATCH 1/2] erts: Update distribution protocol doc
---
erts/doc/src/erl_dist_protocol.xml | 22 ++++++++++++++++------
1 file changed, 16 insertions(+), 6 deletions(-)
diff --git a/erts/doc/src/erl_dist_protocol.xml b/erts/doc/src/erl_dist_protocol.xml
index de0b125c3a..613d821b15 100644
--- a/erts/doc/src/erl_dist_protocol.xml
+++ b/erts/doc/src/erl_dist_protocol.xml
@@ -682,6 +682,11 @@ io:format("old/unused name ~ts at port ~p, fd = ~p ~n",
16-bit big endian. Any extra data after the node <c>Name</c> must be
accepted and ignored.
</p>
+ <p>
+ The <c>Name</c> must be just the host name (without @) when
+ <seeguide marker="#DFLAG_NAME_ME"><c>DFLAG_NAME_ME</c></seeguide>
+ is set.
+ </p>
</item>
<tag>3) <c>recv_status</c>/<c>send_status</c></tag>
<item>
@@ -741,7 +746,9 @@ io:format("old/unused name ~ts at port ~p, fd = ~p ~n",
node name by setting flag <seeguide marker="#DFLAG_NAME_ME">
<c>DFLAG_NAME_ME</c></seeguide>. The dynamic node name of
<c>A</c> is supplied at the end of the status message from
- <c>B</c>.</p>
+ <c>B</c>. The host name of <c>A</c> which was sent as <c>Name</c>
+ in <c>send_name</c> will be used by node <c>B</c> to generate
+ the full dynamic node name.</p>
</item>
</taglist>
<table align="left">
@@ -750,20 +757,23 @@ io:format("old/unused name ~ts at port ~p, fd = ~p ~n",
<cell align="center">Slen=6</cell>
<cell align="center">2</cell>
<cell align="center">Nlen</cell>
+ <cell align="center">4</cell>
</row>
<row>
<cell align="center"><c>'s'</c></cell>
<cell align="center"><c>Status='named:'</c></cell>
<cell align="center"><c>Nlen</c></cell>
<cell align="center"><c>Name</c></cell>
+ <cell align="center"><c>Creation</c></cell>
</row>
<tcaption>The format of the 'named:' status message</tcaption>
</table>
<p>
<c>Name</c> is the full dynamic node name of <c>A</c>, as a
string of bytes. <c>Nlen</c> is the byte length of the node name in
- 16-bit big endian. Any extra data after the node <c>Name</c> must be
- accepted and ignored.
+ 16-bit big endian. <c>Creation</c> is the incarnation identifier
+ of node <c>A</c> generated by node <c>B</c>.
+ Any extra data after the node <c>Creation</c> must be accepted and ignored.
</p>
</item>
<tag>3B) <c>send_status</c>/<c>recv_status</c></tag>
@@ -1419,7 +1429,7 @@ DiB == gen_digest(ChA, ICA)?
</item>
<tag><c>PAYLOAD_EXIT_TT</c></tag>
<item>
- <p><c>{25, FromPid, ToPid}</c></p>
+ <p><c>{25, FromPid, ToPid, TraceToken}</c></p>
<p>Followed by <c>Reason</c>.</p>
<p>
This control message replaces the <c>EXIT_TT</c> control
@@ -1441,7 +1451,7 @@ DiB == gen_digest(ChA, ICA)?
</item>
<tag><c>PAYLOAD_EXIT2_TT</c></tag>
<item>
- <p><c>{27, FromPid, ToPid}</c></p>
+ <p><c>{27, FromPid, ToPid, TraceToken}</c></p>
<p>Followed by <c>Reason</c>.</p>
<p>
This control message replaces the <c>EXIT2_TT</c> control
@@ -1452,7 +1462,7 @@ DiB == gen_digest(ChA, ICA)?
</item>
<tag><c>PAYLOAD_MONITOR_P_EXIT</c></tag>
<item>
- <p><c>{28, FromPid, ToPid, Ref}</c></p>
+ <p><c>{28, FromProc, ToPid, Ref}</c></p>
<p>Followed by <c>Reason</c>.</p>
<p>
This control message replaces the <c>MONITOR_P_EXIT</c> control
--
2.35.3
