Discourage use of RES_USE_INET6

Suggested by eric@, input from deraadt@, ok deraadt@ eric@

1 files changed, 5 insertions, 1 deletions

diff --git a/src/lib/libc/net/res_init.3 b/src/lib/libc/net/res_init.3
index f9f13cf4f9..6b15b675b1 100644
--- a/src/lib/libc/net/res_init.3
+++ b/src/lib/libc/net/res_init.3
@@ -1,4 +1,4 @@
-.\"     $OpenBSD: res_init.3,v 1.2 2020/04/25 14:30:05 jca Exp $
+.\"     $OpenBSD: res_init.3,v 1.3 2020/04/25 16:23:59 jca Exp $
 .\"
 .\" Copyright (c) 1985, 1991, 1993
 .\"     The Regents of the University of California.  All rights reserved.
@@ -183,6 +183,10 @@ feature.
 With this option
 .Xr gethostbyname 3
 will return IPv6 addresses if available.
+This option is deprecated, software should use the
+.Xr getaddrinfo 3
+interface instead of modifying the behavior of
+.Xr gethostbyname 3 .
 On some operating systems this option also causes IPv4 addresses to be
 returned as IPv4-mapped IPv6 addresses.
 For example, 10.1.1.1 will be returned as ::ffff:10.1.1.1.