]> Savannah Git Hosting - gnulib.git/commitdiff
doc: Update regarding Windows <winsock2.h> functions.
authorBruno Haible <bruno@clisp.org>
Sun, 11 Aug 2024 19:01:38 +0000 (21:01 +0200)
committerBruno Haible <bruno@clisp.org>
Sun, 11 Aug 2024 19:01:38 +0000 (21:01 +0200)
* doc/posix-functions/accept.texi: Mention that it's declared elsewhere
on native Windows.
* doc/posix-functions/bind.texi: Likewise.
* doc/posix-functions/connect.texi: Likewise.
* doc/posix-functions/getpeername.texi: Likewise.
* doc/posix-functions/getsockname.texi: Likewise.
* doc/posix-functions/getsockopt.texi: Likewise.
* doc/posix-functions/listen.texi: Likewise.
* doc/posix-functions/recv.texi: Likewise.
* doc/posix-functions/recvfrom.texi: Likewise.
* doc/posix-functions/select.texi: Likewise.
* doc/posix-functions/send.texi: Likewise.
* doc/posix-functions/sendto.texi: Likewise.
* doc/posix-functions/setsockopt.texi: Likewise.
* doc/posix-functions/shutdown.texi: Likewise.
* doc/posix-functions/socket.texi: Likewise.
* doc/pastposix-functions/gethostbyaddr.texi: Don't say that the
function is missing on native Windows.
* doc/pastposix-functions/gethostbyname.texi: Likewise.
* doc/posix-functions/getprotobyname.texi: Likewise.
* doc/posix-functions/getprotobynumber.texi: Likewise.
* doc/posix-functions/getservbyname.texi: Likewise.
* doc/posix-functions/getservbyport.texi: Likewise.
* doc/posix-functions/htonl.texi: Likewise.
* doc/posix-functions/htons.texi: Likewise.
* doc/posix-functions/inet_addr.texi: Likewise.
* doc/posix-functions/inet_ntoa.texi: Likewise.
* doc/posix-functions/ntohl.texi: Likewise.
* doc/posix-functions/ntohs.texi: Likewise.
* doc/posix-functions/gethostname.texi: Update.

29 files changed:
ChangeLog
doc/pastposix-functions/gethostbyaddr.texi
doc/pastposix-functions/gethostbyname.texi
doc/posix-functions/accept.texi
doc/posix-functions/bind.texi
doc/posix-functions/connect.texi
doc/posix-functions/gethostname.texi
doc/posix-functions/getpeername.texi
doc/posix-functions/getprotobyname.texi
doc/posix-functions/getprotobynumber.texi
doc/posix-functions/getservbyname.texi
doc/posix-functions/getservbyport.texi
doc/posix-functions/getsockname.texi
doc/posix-functions/getsockopt.texi
doc/posix-functions/htonl.texi
doc/posix-functions/htons.texi
doc/posix-functions/inet_addr.texi
doc/posix-functions/inet_ntoa.texi
doc/posix-functions/listen.texi
doc/posix-functions/ntohl.texi
doc/posix-functions/ntohs.texi
doc/posix-functions/recv.texi
doc/posix-functions/recvfrom.texi
doc/posix-functions/select.texi
doc/posix-functions/send.texi
doc/posix-functions/sendto.texi
doc/posix-functions/setsockopt.texi
doc/posix-functions/shutdown.texi
doc/posix-functions/socket.texi

index 0f232e39db7e7ab3b348f76a5f131c771323ceb2..3133b317d2780cd79e6a378561d0cdb0afff88c6 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,37 @@
+2024-08-11  Bruno Haible  <bruno@clisp.org>
+
+       doc: Update regarding Windows <winsock2.h> functions.
+       * doc/posix-functions/accept.texi: Mention that it's declared elsewhere
+       on native Windows.
+       * doc/posix-functions/bind.texi: Likewise.
+       * doc/posix-functions/connect.texi: Likewise.
+       * doc/posix-functions/getpeername.texi: Likewise.
+       * doc/posix-functions/getsockname.texi: Likewise.
+       * doc/posix-functions/getsockopt.texi: Likewise.
+       * doc/posix-functions/listen.texi: Likewise.
+       * doc/posix-functions/recv.texi: Likewise.
+       * doc/posix-functions/recvfrom.texi: Likewise.
+       * doc/posix-functions/select.texi: Likewise.
+       * doc/posix-functions/send.texi: Likewise.
+       * doc/posix-functions/sendto.texi: Likewise.
+       * doc/posix-functions/setsockopt.texi: Likewise.
+       * doc/posix-functions/shutdown.texi: Likewise.
+       * doc/posix-functions/socket.texi: Likewise.
+       * doc/pastposix-functions/gethostbyaddr.texi: Don't say that the
+       function is missing on native Windows.
+       * doc/pastposix-functions/gethostbyname.texi: Likewise.
+       * doc/posix-functions/getprotobyname.texi: Likewise.
+       * doc/posix-functions/getprotobynumber.texi: Likewise.
+       * doc/posix-functions/getservbyname.texi: Likewise.
+       * doc/posix-functions/getservbyport.texi: Likewise.
+       * doc/posix-functions/htonl.texi: Likewise.
+       * doc/posix-functions/htons.texi: Likewise.
+       * doc/posix-functions/inet_addr.texi: Likewise.
+       * doc/posix-functions/inet_ntoa.texi: Likewise.
+       * doc/posix-functions/ntohl.texi: Likewise.
+       * doc/posix-functions/ntohs.texi: Likewise.
+       * doc/posix-functions/gethostname.texi: Update.
+
 2024-08-10  Paul Eggert  <eggert@cs.ucla.edu>
 
        test-fdutimensat: fix newly-added test
index 556bb69c907833424eb4898d17d9fb6a22322947..c2822a1cd3ac1b877c19b02405abf50fdb622f76 100644 (file)
@@ -14,6 +14,7 @@ Portability problems fixed by Gnulib:
 Portability problems not fixed by Gnulib:
 @itemize
 @item
-This function is missing on some platforms:
+This function is declared in @code{<winsock2.h>} instead of @code{<netdb.h>}
+on some platforms:
 mingw, MSVC 14.
 @end itemize
index 5f01377b00eab797060d6a8fb8e25db34137c69c..fb1775575cd5e7e5ba5ac98410af166a3459d4aa 100644 (file)
@@ -14,6 +14,7 @@ Portability problems fixed by Gnulib:
 Portability problems not fixed by Gnulib:
 @itemize
 @item
-This function is missing on some platforms:
+This function is declared in @code{<winsock2.h>} instead of @code{<netdb.h>}
+on some platforms:
 mingw, MSVC 14.
 @end itemize
index 2e084f7a72e3ca25b60c3129f0af91fe66a435be..fbbfc3765c2184465a98509f40a9eac63f27039a 100644 (file)
@@ -9,6 +9,11 @@ Gnulib module: accept
 Portability problems fixed by Gnulib:
 @itemize
 @item
+This function is declared in @code{<winsock2.h>}
+instead of @code{<sys/socket.h>}
+on some platforms:
+mingw, MSVC 14.
+@item
 On Windows platforms (excluding Cygwin), the descriptors returned by
 the @code{accept} function cannot be used in calls to @code{read},
 @code{write}, and @code{close}; you have to use @code{recv}, @code{send},
index a7f225a305da18fedb61e83cf358a96c25119208..0e607070bc75ee34a15e83de21857004ea5e39fc 100644 (file)
@@ -9,6 +9,11 @@ Gnulib module: bind
 Portability problems fixed by Gnulib:
 @itemize
 @item
+This function is declared in @code{<winsock2.h>}
+instead of @code{<sys/socket.h>}
+on some platforms:
+mingw, MSVC 14.
+@item
 On Windows platforms (excluding Cygwin), error codes from this function
 are not placed in @code{errno}, and @code{WSAGetLastError} must be used
 instead.
index a24499c0ce22e4eecdd3a29e659d7bb6205689a2..8b0e2e07b5ef7f82135f1af45d3179799fedd378 100644 (file)
@@ -9,6 +9,11 @@ Gnulib module: connect
 Portability problems fixed by Gnulib:
 @itemize
 @item
+This function is declared in @code{<winsock2.h>}
+instead of @code{<sys/socket.h>}
+on some platforms:
+mingw, MSVC 14.
+@item
 On Windows platforms (excluding Cygwin), error codes from this function
 are not placed in @code{errno}, and @code{WSAGetLastError} must be used
 instead.
index f2368194d6678d3c886f39aaaa991761e3846ec5..2e099292bebe1479ec2612bff5e1fb7d8a62b600 100644 (file)
@@ -9,8 +9,8 @@ Gnulib module: gethostname
 Portability problems fixed by Gnulib:
 @itemize
 @item
-This function is declared in a different header file (namely,
-@code{<winsock2.h>}) on some platforms:
+This function is declared in @code{<winsock2.h>} instead of @code{<unistd.h>}
+on some platforms:
 MSVC 14.
 @item
 On mingw and MSVC 14, this function has a prototype that differs from that
index 78d9f217f628bb48ab510dca1f110c2e1ec56712..a02df57702e307279ed8eab5907e85f57361a9c2 100644 (file)
@@ -9,6 +9,11 @@ Gnulib module: getpeername
 Portability problems fixed by Gnulib:
 @itemize
 @item
+This function is declared in @code{<winsock2.h>}
+instead of @code{<sys/socket.h>}
+on some platforms:
+mingw, MSVC 14.
+@item
 On Windows platforms (excluding Cygwin), error codes from this function
 are not placed in @code{errno}, and @code{WSAGetLastError} must be used
 instead.
index 4152e0a8df8213c3b6a07b66f9ca756062576e11..ab1d21059a0523d88ebf76d62ab3ab044a8e62c1 100644 (file)
@@ -13,6 +13,7 @@ Portability problems fixed by Gnulib:
 Portability problems not fixed by Gnulib:
 @itemize
 @item
-This function is missing on some platforms:
+This function is declared in @code{<winsock2.h>} instead of @code{<netdb.h>}
+on some platforms:
 mingw, MSVC 14.
 @end itemize
index 64c9e83abcfd3f2c32b0b5cdfd542c9900904318..e0ed2bdaeb88e53b181e0da6601cabaec33ef725 100644 (file)
@@ -13,6 +13,7 @@ Portability problems fixed by Gnulib:
 Portability problems not fixed by Gnulib:
 @itemize
 @item
-This function is missing on some platforms:
+This function is declared in @code{<winsock2.h>} instead of @code{<netdb.h>}
+on some platforms:
 mingw, MSVC 14.
 @end itemize
index 40c20bf83d8666be5e10d540cbda91aa1c613979..3e5ea8efc06ea7b13152e5aad2fb38a752e1adc0 100644 (file)
@@ -13,6 +13,7 @@ Portability problems fixed by Gnulib:
 Portability problems not fixed by Gnulib:
 @itemize
 @item
-This function is missing on some platforms:
+This function is declared in @code{<winsock2.h>} instead of @code{<netdb.h>}
+on some platforms:
 mingw, MSVC 14.
 @end itemize
index d10d73e2d0148dbe5e06a566fba0015ec9ad3f52..0034ce69c75fac85b9c39b5672922d1744c75987 100644 (file)
@@ -13,6 +13,7 @@ Portability problems fixed by Gnulib:
 Portability problems not fixed by Gnulib:
 @itemize
 @item
-This function is missing on some platforms:
+This function is declared in @code{<winsock2.h>} instead of @code{<netdb.h>}
+on some platforms:
 mingw, MSVC 14.
 @end itemize
index b09c4da2d362c3b81e9ac007b525c3a35689eb91..530283d89f42873240033b5228e4290909f95065 100644 (file)
@@ -9,6 +9,11 @@ Gnulib module: getsockname
 Portability problems fixed by Gnulib:
 @itemize
 @item
+This function is declared in @code{<winsock2.h>}
+instead of @code{<sys/socket.h>}
+on some platforms:
+mingw, MSVC 14.
+@item
 On Windows platforms (excluding Cygwin), error codes from this function
 are not placed in @code{errno}, and @code{WSAGetLastError} must be used
 instead.
index 4f09ff10ad6d1b946895803e9c407c87be5d94fb..03e0eb0799a70fadce30bbd999390a83c5b3f182 100644 (file)
@@ -11,6 +11,11 @@ Gnulib module: getsockopt
 Portability problems fixed by Gnulib:
 @itemize
 @item
+This function is declared in @code{<winsock2.h>}
+instead of @code{<sys/socket.h>}
+on some platforms:
+mingw, MSVC 14.
+@item
 On Windows platforms (excluding Cygwin), error codes from this function
 are not placed in @code{errno}, and @code{WSAGetLastError} must be used
 instead.
index a4411b4206c0c5de83650e4b5c03a02944b914f1..2a5c79bc7509352f09169be9837c3f4c069af44e 100644 (file)
@@ -10,7 +10,11 @@ Portability problems fixed by Gnulib:
 @itemize
 @item
 This function is missing on some platforms:
-HP-UX 11, mingw, MSVC 14, Android 4.4.
+HP-UX 11, Android API level 20.
+@item
+This function is declared in @code{<winsock2.h>} instead of @code{<arpa/inet.h>}
+on some platforms:
+mingw, MSVC 14.
 @end itemize
 
 Portability problems not fixed by Gnulib:
index ee413f223f865911a552af64a2cc3fa2c421a14f..35b66d334c3f267ff630637f1e0beead29cc952f 100644 (file)
@@ -10,7 +10,11 @@ Portability problems fixed by Gnulib:
 @itemize
 @item
 This function is missing on some platforms:
-HP-UX 11, mingw, MSVC 14, Android 4.4.
+HP-UX 11, Android API level 20.
+@item
+This function is declared in @code{<winsock2.h>} instead of @code{<arpa/inet.h>}
+on some platforms:
+mingw, MSVC 14.
 @end itemize
 
 Portability problems not fixed by Gnulib:
index 2cc85eeaab886470e785e787b862f323b00b1643..e6a0893657867651dd10d8ccac0151cba8cf5120 100644 (file)
@@ -13,7 +13,8 @@ Portability problems fixed by Gnulib:
 Portability problems not fixed by Gnulib:
 @itemize
 @item
-This function is missing on some platforms:
+This function is declared in @code{<winsock2.h>} instead of @code{<arpa/inet.h>}
+on some platforms:
 mingw, MSVC 14.
 @item
 POSIX.1-2024 says this function is obsolescent and it is planned to be
index 6ad1e5cf29ae97748f2e15cb2ef5e34d65617008..d6989b02d28ee0d6d07c248efd7b2be31ecb28c8 100644 (file)
@@ -13,7 +13,8 @@ Portability problems fixed by Gnulib:
 Portability problems not fixed by Gnulib:
 @itemize
 @item
-This function is missing on some platforms:
+This function is declared in @code{<winsock2.h>} instead of @code{<arpa/inet.h>}
+on some platforms:
 mingw, MSVC 14.
 @item
 POSIX.1-2024 says this function is obsolescent and it is planned to be
index d1e3bb4e36f7314a22a5b77b1e85a78cfce2174b..248727466d7fd1aa2fe16c3a2148fa81291ed4f3 100644 (file)
@@ -9,6 +9,11 @@ Gnulib module: listen
 Portability problems fixed by Gnulib:
 @itemize
 @item
+This function is declared in @code{<winsock2.h>}
+instead of @code{<sys/socket.h>}
+on some platforms:
+mingw, MSVC 14.
+@item
 On Windows platforms (excluding Cygwin), error codes from this function
 are not placed in @code{errno}, and @code{WSAGetLastError} must be used
 instead.
index 17b61633253481b9923671d85b6f42329a18a4a5..c4b5a0126dcd0bed065e2f72e7826855b9fc278b 100644 (file)
@@ -10,7 +10,11 @@ Portability problems fixed by Gnulib:
 @itemize
 @item
 This function is missing on some platforms:
-HP-UX 11, mingw, MSVC 14, Android 4.4.
+HP-UX 11, Android API level 20.
+@item
+This function is declared in @code{<winsock2.h>} instead of @code{<arpa/inet.h>}
+on some platforms:
+mingw, MSVC 14.
 @end itemize
 
 Portability problems not fixed by Gnulib:
index 2fe65fdb6be8cd3d00a5025cdb9cb1ef65701a18..b9a7450d7a9745035a6243a92a6029338aa26ded 100644 (file)
@@ -10,7 +10,11 @@ Portability problems fixed by Gnulib:
 @itemize
 @item
 This function is missing on some platforms:
-HP-UX 11, mingw, MSVC 14, Android 4.4.
+HP-UX 11, Android API level 20.
+@item
+This function is declared in @code{<winsock2.h>} instead of @code{<arpa/inet.h>}
+on some platforms:
+mingw, MSVC 14.
 @end itemize
 
 Portability problems not fixed by Gnulib:
index b5dffe39b1a00774762d7f3c1506f722165a0e9a..9d75a327df9db3730fd8ea7e1656d1000930ccec 100644 (file)
@@ -9,6 +9,11 @@ Gnulib module: recv
 Portability problems fixed by Gnulib:
 @itemize
 @item
+This function is declared in @code{<winsock2.h>}
+instead of @code{<sys/socket.h>}
+on some platforms:
+mingw, MSVC 14.
+@item
 On Windows platforms (excluding Cygwin), error codes from this function
 are not placed in @code{errno}, and @code{WSAGetLastError} must be used
 instead.
index a71cd2d7ed05d38e627168d24e94ff8bd636c744..2bd773a33ce74de8c99744a812b13397f7fe8570 100644 (file)
@@ -9,6 +9,11 @@ Gnulib module: recvfrom
 Portability problems fixed by Gnulib:
 @itemize
 @item
+This function is declared in @code{<winsock2.h>}
+instead of @code{<sys/socket.h>}
+on some platforms:
+mingw, MSVC 14.
+@item
 On Windows platforms (excluding Cygwin), error codes from this function
 are not placed in @code{errno}, and @code{WSAGetLastError} must be used
 instead.
index 154fc7f743ee428a5b677f7812930dd21af07ee0..79b0d877b337535a82a3f43f99b3abee4d540df9 100644 (file)
@@ -9,6 +9,11 @@ Gnulib module: select
 Portability problems fixed by Gnulib:
 @itemize
 @item
+This function is declared in @code{<winsock2.h>}
+instead of @code{<sys/select.h>}
+on some platforms:
+mingw, MSVC 14.
+@item
 On Windows platforms (excluding Cygwin), @code{select} can only be
 called on descriptors created by the @code{socket} function, not on regular
 file descriptors.
index 88ddfdc775d88cf7f8aa574103c1691a17624f8c..d25628df6c77238c551f8574c723cd1c6ada8546 100644 (file)
@@ -9,6 +9,11 @@ Gnulib module: send
 Portability problems fixed by Gnulib:
 @itemize
 @item
+This function is declared in @code{<winsock2.h>}
+instead of @code{<sys/socket.h>}
+on some platforms:
+mingw, MSVC 14.
+@item
 On Windows platforms (excluding Cygwin), error codes from this function
 are not placed in @code{errno}, and @code{WSAGetLastError} must be used
 instead.
index 49e9c8707835efe441d80d3909f03e6d700378e1..d5f160006a313564d18c2e7d322e2998b9331cea 100644 (file)
@@ -9,6 +9,11 @@ Gnulib module: sendto
 Portability problems fixed by Gnulib:
 @itemize
 @item
+This function is declared in @code{<winsock2.h>}
+instead of @code{<sys/socket.h>}
+on some platforms:
+mingw, MSVC 14.
+@item
 On Windows platforms (excluding Cygwin), error codes from this function
 are not placed in @code{errno}, and @code{WSAGetLastError} must be used
 instead.
index ba8d6ec1b72f5316310349d145776104e176ae60..348ca8c0b1e1e007c23201fa841becf793e45e8c 100644 (file)
@@ -11,6 +11,11 @@ Gnulib module: setsockopt
 Portability problems fixed by Gnulib:
 @itemize
 @item
+This function is declared in @code{<winsock2.h>}
+instead of @code{<sys/socket.h>}
+on some platforms:
+mingw, MSVC 14.
+@item
 On Windows platforms (excluding Cygwin), error codes from this function
 are not placed in @code{errno}, and @code{WSAGetLastError} must be used
 instead.
index ec6a3d45c9d2968977162aed6746ec76c19fcefb..8b531791f72a16db60578754bdb7a76d26a99375 100644 (file)
@@ -9,6 +9,11 @@ Gnulib module: shutdown
 Portability problems fixed by Gnulib:
 @itemize
 @item
+This function is declared in @code{<winsock2.h>}
+instead of @code{<sys/socket.h>}
+on some platforms:
+mingw, MSVC 14.
+@item
 On Windows platforms (excluding Cygwin), error codes from this function
 are not placed in @code{errno}, and @code{WSAGetLastError} must be used
 instead.
index 4ec8b0626fb23f38b01795c8b5100e60a29c12bd..d0211767cc23e1cd07d411caad673facb1fced24 100644 (file)
@@ -9,6 +9,11 @@ Gnulib module: socket
 Portability problems fixed by Gnulib:
 @itemize
 @item
+This function is declared in @code{<winsock2.h>}
+instead of @code{<sys/socket.h>}
+on some platforms:
+mingw, MSVC 14.
+@item
 On Windows platforms (excluding Cygwin), the descriptors returned by
 the @code{socket} function cannot be used in calls to @code{read},
 @code{write}, and @code{close}; you have to use @code{recv}, @code{send},