summaryrefslogtreecommitdiffstats
path: root/man3/gethostbyname.3
diff options
context:
space:
mode:
Diffstat (limited to 'man3/gethostbyname.3')
-rw-r--r--man3/gethostbyname.377
1 files changed, 54 insertions, 23 deletions
diff --git a/man3/gethostbyname.3 b/man3/gethostbyname.3
index 9b1f6aacb..620d492c9 100644
--- a/man3/gethostbyname.3
+++ b/man3/gethostbyname.3
@@ -16,7 +16,7 @@
.\" Modified 2002-08-05, Michael Kerrisk
.\" Modified 2004-10-31, Andries Brouwer
.\"
-.TH gethostbyname 3 2023-02-05 "Linux man-pages 6.03"
+.TH gethostbyname 3 2023-07-20 "Linux man-pages 6.05.01"
.SH NAME
gethostbyname, gethostbyaddr, sethostent, gethostent, endhostent,
h_errno,
@@ -316,57 +316,77 @@ name service switch configuration
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
-.ad l
-.nh
.TS
allbox;
lb lb lbx
l l l.
Interface Attribute Value
T{
+.na
+.nh
.BR gethostbyname ()
T} Thread safety T{
+.na
+.nh
MT-Unsafe race:hostbyname env
locale
T}
T{
+.na
+.nh
.BR gethostbyaddr ()
T} Thread safety T{
+.na
+.nh
MT-Unsafe race:hostbyaddr env
locale
T}
T{
+.na
+.nh
.BR sethostent (),
.BR endhostent (),
.BR gethostent_r ()
T} Thread safety T{
+.na
+.nh
MT-Unsafe race:hostent env
locale
T}
T{
+.na
+.nh
.BR herror (),
.BR hstrerror ()
T} Thread safety MT-Safe
T{
+.na
+.nh
.BR gethostent ()
T} Thread safety T{
+.na
+.nh
MT-Unsafe race:hostent
race:hostentbuf env locale
T}
T{
+.na
+.nh
.BR gethostbyname2 ()
T} Thread safety T{
+.na
+.nh
MT-Unsafe race:hostbyname2
env locale
T}
T{
+.na
+.nh
.BR gethostbyaddr_r (),
.BR gethostbyname_r (),
.BR gethostbyname2_r ()
T} Thread safety MT-Safe env locale
.TE
-.hy
-.ad
.sp 1
In the above table,
.I hostent
@@ -377,28 +397,39 @@ signifies that if any of the functions
.BR gethostent (),
.BR gethostent_r (),
or
-.BR endhostent ()
+.BR \%endhostent ()
are used in parallel in different threads of a program,
then data races could occur.
.SH STANDARDS
-POSIX.1-2001 specifies
-.BR gethostbyname (),
-.BR gethostbyaddr (),
-.BR sethostent (),
-.BR endhostent (),
-.BR gethostent (),
-and
-.IR h_errno ;
-.BR gethostbyname (),
-.BR gethostbyaddr (),
-and
+.TP
+.BR sethostent ()
+.TQ
+.BR endhostent ()
+.TQ
+.BR gethostent ()
+POSIX.1-2008.
+.TP
+.BR gethostent_r ()
+GNU.
+.TP
+Others:
+None.
+.SH HISTORY
+.TP
+.BR sethostent ()
+.TQ
+.BR endhostent ()
+.TQ
+.BR gethostent ()
+POSIX.1-2001.
+.TP
+.BR gethostbyname ()
+.TQ
+.BR gethostbyaddr ()
+.TQ
.I h_errno
-are marked obsolescent in that standard.
-POSIX.1-2008 removes the specifications of
-.BR gethostbyname (),
-.BR gethostbyaddr (),
-and
-.IR h_errno ,
+Marked obsolescent in POSIX.1-2001.
+Removed in POSIX.1-2008,
recommending the use of
.BR getaddrinfo (3)
and