File 7742-kernel-Document-the-reuseaddr-inet-option-... of Package erlang

Overview Repositories Revisions Requests Users Attributes Meta

File 7742-kernel-Document-the-reuseaddr-inet-option-behavior-o.patch of Package erlang (Revision 4d643f2a582dd56ae31bd6a44d721f27)

Currently displaying revision 4d643f2a582dd56ae31bd6a44d721f27 , Show latest

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>
- Allows or disallows local reuse of port numbers. By
- default, reuse is disallowed.
+ 
+ Allows or disallows local reuse of port numbers. By
+ default, reuse is disallowed.
+ 
+ <note>
+ 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.
+ </note>
 </item>
 <tag><c>{send_timeout, Integer}</c></tag>
 <item>
-- 
2.35.3

Places

File 7742-kernel-Document-the-reuseaddr-inet-option-behavior-o.patch of Package erlang (Revision 4d643f2a582dd56ae31bd6a44d721f27)

Places