From cac152301a43f148900fda9996229f20901ba6ba Mon Sep 17 00:00:00 2001
From: ru <ru@FreeBSD.org>
Date: Wed, 8 Aug 2001 11:05:47 +0000
Subject: Urge the reader to start using getaddrinfo(3) and getnameinfo(3)
 protocol-independant functions that don't use static memory area.

Suggested by:	nik
Liked by:	ume, brian
---
 lib/libc/net/gethostbyname.3 | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

(limited to 'lib/libc/net')

diff --git a/lib/libc/net/gethostbyname.3 b/lib/libc/net/gethostbyname.3
index 7d78f96..b845c28 100644
--- a/lib/libc/net/gethostbyname.3
+++ b/lib/libc/net/gethostbyname.3
@@ -67,6 +67,19 @@
 .Ft const char *
 .Fn hstrerror "int err"
 .Sh DESCRIPTION
+.Bf -symbolic
+The
+.Xr getaddrinfo 3
+and
+.Xr getnameinfo 3
+functions are preferred over the
+.Fn gethostbyname ,
+.Fn gethostbyname2 ,
+and
+.Fn gethostbyaddr
+functions.
+.Ef
+.Pp
 The
 .Fn gethostbyname ,
 .Fn gethostbyname2
@@ -287,6 +300,7 @@ for example, a mail-forwarder may be registered for this domain.
 .El
 .Sh SEE ALSO
 .Xr getaddrinfo 3 ,
+.Xr getnameinfo 3 ,
 .Xr inet_aton 3 ,
 .Xr resolver 3 ,
 .Xr hosts 5 ,
-- 
cgit v1.1