gethostbyname.3: Rationalize text on POSIX.1-2001 obsolete interfaces

POSIX.1 marks gethostbyname(), gethostbyaddr(), and 'h_errno'
as obsolete.  The man page explained this, but with some
duplication.  Remove the duplication, and otherwise tidy up
discussion of this point.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Michael Kerrisk 2008-10-22 05:00:05 -05:00
parent 546f67f3cd
commit e47fa14cd1
1 changed files with 7 additions and 14 deletions

View File

@ -33,7 +33,7 @@
.\" Modified 2002-08-05, Michael Kerrisk
.\" Modified 2004-10-31, Andries Brouwer
.\"
.TH GETHOSTBYNAME 3 2008-08-18 "" "Linux Programmer's Manual"
.TH GETHOSTBYNAME 3 2008-10-21 "" "Linux Programmer's Manual"
.SH NAME
gethostbyname, gethostbyaddr, sethostent, gethostent, endhostent,
h_errno,
@ -291,7 +291,12 @@ POSIX.1-2001 specifies
.BR endhostent (),
.BR gethostent (),
and
.IR h_errno .
.IR h_errno ;
.BR gethostbyname (),
.BR gethostbyaddr (),
and
.IR h_errno
are marked obsolescent in that standard.
POSIX.1-2008 removes the specifications of
.BR gethostbyname (),
.BR gethostbyaddr (),
@ -337,18 +342,6 @@ The BSD prototype for
uses
.I const char *
for the first argument.
.LP
POSIX.1-2001 marks
.BR gethostbyaddr ()
and
.BR gethostbyname ()
obsolescent.
.\" FIXME . SUSv4 removes the specs for gethostbyname(),
.\" gethostbyaddr(), and h_errno.
See
.BR getaddrinfo (3),
.BR getnameinfo (3),
.BR gai_strerror (3).
.SS "System V/POSIX Extension"
POSIX requires the
.BR gethostent ()