From aef76b8e8bdce86e46e2267331b1b957f796653f Mon Sep 17 00:00:00 2001
From: Sverker Eriksson <sverker@erlang.org>
Date: Tue, 26 Mar 2019 17:19:20 +0100
Subject: erts: Document new EPMD response ALIVE2_X_RESP

with 32-bit creation.
---
 erts/doc/src/erl_dist_protocol.xml | 28 +++++++++++++++++++++++-----
 1 file changed, 23 insertions(+), 5 deletions(-)

(limited to 'erts/doc/src/erl_dist_protocol.xml')

diff --git a/erts/doc/src/erl_dist_protocol.xml b/erts/doc/src/erl_dist_protocol.xml
index 185c75fe84..1951d498cd 100644
--- a/erts/doc/src/erl_dist_protocol.xml
+++ b/erts/doc/src/erl_dist_protocol.xml
@@ -109,7 +109,8 @@
       <title>Register a Node in EPMD</title>
       <p>When a distributed node is started it registers itself in the EPMD.
         The message <c>ALIVE2_REQ</c> described below is sent from the node to
-        the EPMD. The response from the EPMD is <c>ALIVE2_RESP</c>.</p>
+        the EPMD. The response from the EPMD is <c>ALIVE2_X_RESP</c> (or
+        <c>ALIVE2_RESP</c>).</p>
 
       <table align="left">
         <row>
@@ -155,12 +156,12 @@
         <tag><c>HighestVersion</c></tag>
         <item>
           <p>The highest distribution version that this node can handle.
-            The value in Erlang/OTP R6B and later is 5.</p>
+            The value in OTP 22 and later is 6.</p>
         </item>
         <tag><c>LowestVersion</c></tag>
         <item>
           <p>The lowest distribution version that this node can handle.
-            The value in Erlang/OTP R6B and later is 5.</p>
+            The value in OTP 22 and later is 5.</p>
         </item>
         <tag><c>Nlen</c></tag>
         <item>
@@ -184,7 +185,24 @@
         node is a distributed node. When the connection is closed,
         the node is automatically unregistered from the EPMD.</p>
 
-      <p>The response message <c>ALIVE2_RESP</c> is as follows:</p>
+      <p>The response message is either <c>ALIVE2_X_RESP</c> or
+        <c>ALIVE2_RESP</c> depending on distribution version. If both the node
+        and EPMD support distribution version 6 then response is
+        <c>ALIVE2_X_RESP</c> otherwise it is the older <c>ALIVE2_RESP</c>:</p>
+
+      <table align="left">
+        <row>
+          <cell align="center">1</cell>
+          <cell align="center">1</cell>
+          <cell align="center">4</cell>
+        </row>
+        <row>
+          <cell align="center"><c>118</c></cell>
+          <cell align="center"><c>Result</c></cell>
+          <cell align="center"><c>Creation</c></cell>
+        </row>
+        <tcaption>ALIVE2_X_RESP (118) with 32 bit creation</tcaption>
+      </table>
 
       <table align="left">
         <row>
@@ -197,7 +215,7 @@
           <cell align="center"><c>Result</c></cell>
           <cell align="center"><c>Creation</c></cell>
         </row>
-        <tcaption>ALIVE2_RESP (121)</tcaption>
+        <tcaption>ALIVE2_RESP (121) with 16-bit creation</tcaption>
       </table>
 
       <p>Result = 0 -> ok, result &gt; 0 -> error.</p>
-- 
cgit v1.2.3