File 0876-kernel-doc-Update-use-of-the-resolver.patch of Package erlang

Overview Repositories Revisions Requests Users Attributes Meta

File 0876-kernel-doc-Update-use-of-the-resolver.patch of Package erlang (Revision e821d375830f7564cfd918f62d383b35)

Currently displaying revision e821d375830f7564cfd918f62d383b35 , Show latest

From 050ecfe1d4989ea5c92e2de82fd410550340677b Mon Sep 17 00:00:00 2001
From: Micael Karlberg <bmk@erlang.org>
Date: Thu, 21 Sep 2023 12:38:56 +0200
Subject: [PATCH] [kernel|doc] Update use of the resolver

Add some text in the doc of the gethostbyname function(s)
about the use of the resolver.

OTP-18769
---
 lib/kernel/doc/src/inet.xml | 35 +++++++++++++++++++++++++++++++----
 1 file changed, 31 insertions(+), 4 deletions(-)

diff --git a/lib/kernel/doc/src/inet.xml b/lib/kernel/doc/src/inet.xml
index b9a623e988..fc58e62ebf 100644
--- a/lib/kernel/doc/src/inet.xml
+++ b/lib/kernel/doc/src/inet.xml
@@ -470,9 +470,23 @@ fe80::204:acff:fe17:bf38
 </fsummary>
 <desc>
 Returns a <c>hostent</c> record for the host with the specified
- hostname.
- If resolver option <c>inet6</c> is <c>true</c>,
- an IPv6 address is looked up.
+	hostname.
+
+	This function uses the resolver,
+	which is often the native (OS) resolver. 
+
+	If resolver option <c>inet6</c> is <c>true</c>, an IPv6 address
+	is looked up.
+
+	See 
+	<seeguide marker="erts:inet_cfg">ERTS User's Guide:
+	Inet Configuration</seeguide> for information about the
+	resolver configuration.
+
+	A quirk of many resolver(s) is that an integer string is
+	interpreted as an IP address.
+	For instance, the integer string "3232235521" and the string
+	"192.168.0.1" is equal to the IP address <c>{192,168,0,1}</c>. 
 </desc>
 </func>
 
@@ -482,7 +496,20 @@ fe80::204:acff:fe17:bf38
 </fsummary>
 <desc>
 Returns a <c>hostent</c> record for the host with the specified
- name, restricted to the specified address family.
+	name, restricted to the specified address family.
+
+	This function uses the resolver,
+	which is often the native (OS) resolver. 
+
+	See 
+	<seeguide marker="erts:inet_cfg">ERTS User's Guide:
+	Inet Configuration</seeguide> for information about the
+	resolver configuration.
+
+	A quirk of many resolver(s) is that an integer string is
+	interpreted as an IP address.
+	For instance, the integer string "3232235521" and the string
+	"192.168.0.1" is equal to the IP address <c>{192,168,0,1}</c>. 
 </desc>
 </func>
 
-- 
2.35.3

Places

File 0876-kernel-doc-Update-use-of-the-resolver.patch of Package erlang (Revision e821d375830f7564cfd918f62d383b35)

Places