File 7742-kernel-Document-the-reuseaddr-inet-option-behavior-o.patch of Package erlang
From 354f21c1aaf257138755991919b3141385944d59 Mon Sep 17 00:00:00 2001
From: Rickard Green <rickard@erlang.org>
Date: Thu, 17 Nov 2022 13:36:01 +0100
Subject: [PATCH 2/2] [kernel] Document the reuseaddr inet option behavior on
Windows
---
lib/kernel/doc/src/inet.xml | 15 +++++++++++++--
lib/kernel/src/kernel.app.src | 2 +-
2 files changed, 14 insertions(+), 3 deletions(-)
diff --git a/lib/kernel/doc/src/inet.xml b/lib/kernel/doc/src/inet.xml
index 6604f2e762..0fe3c00659 100644
--- a/lib/kernel/doc/src/inet.xml
+++ b/lib/kernel/doc/src/inet.xml
@@ -1568,8 +1568,19 @@ setcap cap_sys_admin,cap_sys_ptrace,cap_dac_read_search+epi beam.smp</code>
</item>
<tag><c>{reuseaddr, Boolean}</c></tag>
<item>
- <p>Allows or disallows local reuse of port numbers. By
- default, reuse is disallowed.</p>
+ <p>
+ Allows or disallows local reuse of port numbers. By
+ default, reuse is disallowed.
+ </p>
+ <note><p>
+ On Windows this option will be ignored unless
+ <c><anno>Socket</anno></c> is an UDP socket. This since the
+ behavior of <c>reuseaddr</c> is very different on Windows
+ compared to other system. The Windows behavior makes its use
+ dangerous, and there probably are no useful use-cases in the
+ non-UDP cases either. However, in the UDP case on Windows there
+ are useful use-cases.
+ </p></note>
</item>
<tag><c>{send_timeout, Integer}</c></tag>
<item>
--
2.35.3