From 2534ef153e3cb352fe9985a4d6c4bd1dc7f84bb7 Mon Sep 17 00:00:00 2001 From: Michael Kerrisk Date: Fri, 8 Nov 2013 14:24:57 +1300 Subject: [PATCH] getaddrinfo.3: Explain one use case for AI_ADDRCONFIG Signed-off-by: Michael Kerrisk --- man3/getaddrinfo.3 | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/man3/getaddrinfo.3 b/man3/getaddrinfo.3 index d2a329794..0f8c0efa7 100644 --- a/man3/getaddrinfo.3 +++ b/man3/getaddrinfo.3 @@ -385,6 +385,13 @@ IPv4 address configured, and IPv6 addresses are returned only if the local system has at least one IPv6 address configured. The loopback address is not considered for this case as valid as a configured address. +This flag is useful on, for example, +IPv4-only systems, to ensure that +.BR getaddrinfo () +does not return IPv6 socket addresses that would always fail in +.BR connect (2) +or +.BR bind (2). .PP If .I hints.ai_flags