documentation update for mingw socket functions
authorPaolo Bonzini <bonzini@gnu.org>
Mon, 29 Sep 2008 11:23:50 +0000 (13:23 +0200)
committerPaolo Bonzini <bonzini@gnu.org>
Mon, 29 Sep 2008 11:28:59 +0000 (13:28 +0200)
2008-08-24  Paolo Bonzini  <bonzini@gnu.org>

* doc/posix-functions/accept.texi: Update mingw problems.
* doc/posix-functions/bind.texi: Update mingw problems.
* doc/posix-functions/close.texi: Update mingw problems.
* doc/posix-functions/connect.texi: Update mingw problems.
* doc/posix-functions/getpeername.texi: Update mingw problems.
* doc/posix-functions/getsockname.texi: Update mingw problems.
* doc/posix-functions/getsockopt.texi: Update mingw problems.
* doc/posix-functions/ioctl.texi: Update mingw problems.
* doc/posix-functions/listen.texi: Update mingw problems.
* doc/posix-functions/recv.texi: Update mingw problems.
* doc/posix-functions/recvfrom.texi: Update mingw problems.
* doc/posix-functions/select.texi: Update mingw problems.
* doc/posix-functions/send.texi: Update mingw problems.
* doc/posix-functions/sendto.texi: Update mingw problems.
* doc/posix-functions/setsockopt.texi: Update mingw problems.
* doc/posix-functions/socket.texi: Update mingw problems.

17 files changed:
ChangeLog
doc/posix-functions/accept.texi
doc/posix-functions/bind.texi
doc/posix-functions/close.texi
doc/posix-functions/connect.texi
doc/posix-functions/getpeername.texi
doc/posix-functions/getsockname.texi
doc/posix-functions/getsockopt.texi
doc/posix-functions/ioctl.texi
doc/posix-functions/listen.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/socket.texi

index 42f640117ef7243ed21dd5f4aab3555b6dae3fd9..828fdab3733d35af818f3a0b5a3e59350721f89d 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,22 @@
+2008-08-24  Paolo Bonzini  <bonzini@gnu.org>
+
+       * doc/posix-functions/accept.texi: Update mingw problems.
+       * doc/posix-functions/bind.texi: Update mingw problems.
+       * doc/posix-functions/close.texi: Update mingw problems.
+       * doc/posix-functions/connect.texi: Update mingw problems.
+       * doc/posix-functions/getpeername.texi: Update mingw problems.
+       * doc/posix-functions/getsockname.texi: Update mingw problems.
+       * doc/posix-functions/getsockopt.texi: Update mingw problems.
+       * doc/posix-functions/ioctl.texi: Update mingw problems.
+       * doc/posix-functions/listen.texi: Update mingw problems.
+       * doc/posix-functions/recv.texi: Update mingw problems.
+       * doc/posix-functions/recvfrom.texi: Update mingw problems.
+       * doc/posix-functions/select.texi: Update mingw problems.
+       * doc/posix-functions/send.texi: Update mingw problems.
+       * doc/posix-functions/sendto.texi: Update mingw problems.
+       * doc/posix-functions/setsockopt.texi: Update mingw problems.
+       * doc/posix-functions/socket.texi: Update mingw problems.
+
 2008-09-29  Paolo Bonzini  <bonzini@gnu.org>
             Bruno Haible  <bruno@clisp.org>
 
index fe85c630d07b4f930d60399dd5c371373687f99f..be125cfa2c7242eddbd470fbcea74ca7c1cab12a 100644 (file)
@@ -4,17 +4,26 @@
 
 POSIX specification: @url{http://www.opengroup.org/susv3xsh/accept.html}
 
-Gnulib module: ---
+Gnulib module: sys_socket
 
 Portability problems fixed by Gnulib:
 @itemize
+@item
+On Windows platforms (excluding Cygwin), the descriptors returned by
+the @code{accept} function can not be used in calls to @code{read},
+@code{write}, and @code{close}; you have to use @code{recv}, @code{send},
+@code{closesocket} in these cases instead.
+@item
+On Windows platforms (excluding Cygwin), error codes for @code{accept} are not
+placed in @code{errno}, and @code{WSAGetLastError} must be used instead.
 @end itemize
 
 Portability problems not fixed by Gnulib:
 @itemize
 @item
-This function is missing on some platforms:
-mingw.
+On BeOS, the descriptors returned by the @code{accept} function can not be used
+in calls to @code{read}, @code{write}, and @code{close}; you have to use
+@code{recv}, @code{send}, @code{closesocket} in these cases instead.
 @item
 Some platforms don't have a @code{socklen_t} type; in this case this function's
 third argument type is @samp{int *}.
index 2211dd0bc98328ee0d86bf54b2112acbfaa9b65b..5a2a8ff9176516af8a3bae8eb936ad252c92ed41 100644 (file)
@@ -4,15 +4,15 @@
 
 POSIX specification: @url{http://www.opengroup.org/susv3xsh/bind.html}
 
-Gnulib module: ---
+Gnulib module: sys_socket
 
 Portability problems fixed by Gnulib:
 @itemize
+@item
+On Windows platforms (excluding Cygwin), error codes for @code{accept} are not
+placed in @code{errno}, and @code{WSAGetLastError} must be used instead.
 @end itemize
 
 Portability problems not fixed by Gnulib:
 @itemize
-@item
-This function is missing on some platforms:
-mingw.
 @end itemize
index ec961dca8c8d03385b717e12e5eabf5b2bba44a3..84bdd388fc94eb18e4c568a3ef9dff24f9916f7e 100644 (file)
@@ -4,12 +4,20 @@
 
 POSIX specification: @url{http://www.opengroup.org/susv3xsh/close.html}
 
-Gnulib module: ---
+Gnulib module: sys_socket
 
 Portability problems fixed by Gnulib:
 @itemize
+@item
+On Windows platforms (excluding Cygwin), @code{socket} and @code{accept}
+do not return file descriptors that can be closed by @code{close}.
+Instead, @code{closesocket} must be used.
 @end itemize
 
 Portability problems not fixed by Gnulib:
 @itemize
+@item
+On BeOS, @code{socket} and @code{accept} do not return file descriptors
+that can be closed by @code{close}.  Instead, @code{closesocket} must be
+used.
 @end itemize
index 4987034763f37d2e2b99c413635b7e956ccf729d..5a832c9e3b761cb3a697f5d0e4ad92621455aea7 100644 (file)
@@ -4,15 +4,15 @@
 
 POSIX specification: @url{http://www.opengroup.org/susv3xsh/connect.html}
 
-Gnulib module: ---
+Gnulib module: sys_socket
 
 Portability problems fixed by Gnulib:
 @itemize
+@item
+On Windows platforms (excluding Cygwin), error codes for @code{accept} are not
+placed in @code{errno}, and @code{WSAGetLastError} must be used instead.
 @end itemize
 
 Portability problems not fixed by Gnulib:
 @itemize
-@item
-This function is missing on some platforms:
-mingw.
 @end itemize
index e22953419b0aa4ab61d12bb473832ef930c4706a..0cd05a71dff8b65564667144aeecaad16dc3ed63 100644 (file)
@@ -4,18 +4,18 @@
 
 POSIX specification: @url{http://www.opengroup.org/susv3xsh/getpeername.html}
 
-Gnulib module: ---
+Gnulib module: sys_socket
 
 Portability problems fixed by Gnulib:
 @itemize
+@item
+On Windows platforms (excluding Cygwin), error codes for @code{accept} are not
+placed in @code{errno}, and @code{WSAGetLastError} must be used instead.
 @end itemize
 
 Portability problems not fixed by Gnulib:
 @itemize
 @item
-This function is missing on some platforms:
-mingw.
-@item
 Some platforms don't have a @code{socklen_t} type; in this case this function's
 third argument type is @samp{int *}.
 @end itemize
index 0d591e477895ab243d55b5c47083cf5a852dffd2..d45469a0f0519cb18c3539655d3445c41bad3f68 100644 (file)
@@ -4,10 +4,13 @@
 
 POSIX specification: @url{http://www.opengroup.org/susv3xsh/getsockname.html}
 
-Gnulib module: ---
+Gnulib module: sys_socket
 
 Portability problems fixed by Gnulib:
 @itemize
+@item
+On Windows platforms (excluding Cygwin), error codes for @code{accept} are not
+placed in @code{errno}, and @code{WSAGetLastError} must be used instead.
 @end itemize
 
 Portability problems not fixed by Gnulib:
index 583bb90b885beb341b54070c5f45dc5f596ffc54..34863f13104850aafd48534d552ccead7c13d739 100644 (file)
@@ -4,17 +4,20 @@
 
 POSIX specification: @url{http://www.opengroup.org/susv3xsh/getsockopt.html}
 
-Gnulib module: ---
+Gnulib module: sys_socket
 
 Portability problems fixed by Gnulib:
 @itemize
+@item
+On Windows platforms (excluding Cygwin), error codes for @code{accept} are not
+placed in @code{errno}, and @code{WSAGetLastError} must be used instead.
 @end itemize
 
 Portability problems not fixed by Gnulib:
 @itemize
 @item
 This function is missing on some platforms:
-mingw, BeOS.
+BeOS.
 @item
 Some platforms don't have a @code{socklen_t} type; in this case this function's
 fifth argument type is @samp{int *}.
index 56380a8526683fae11b5f12a23ef106ed193e011..86235d897c79e8047e18039e4b02a36d6fee2dff 100644 (file)
@@ -4,17 +4,19 @@
 
 POSIX specification: @url{http://www.opengroup.org/susv3xsh/ioctl.html}
 
-Gnulib module: ---
+Gnulib module: sys_socket
 
 Portability problems fixed by Gnulib:
 @itemize
+@item
+On Windows platforms (excluding Cygwin), error codes for @code{accept} are not
+placed in @code{errno}, and @code{WSAGetLastError} must be used instead.
+@item
+@code{ioctl} is called @code{ioctlsocket} under mingw
 @end itemize
 
 Portability problems not fixed by Gnulib:
 @itemize
 @item
-This function is missing on some platforms:
-mingw.
-@item
 Most @code{ioctl} requests are platform and hardware specific.
 @end itemize
index 6ffb36bccce906c6a8406b9bf7fba602a9351412..02631fb3e11ee8c292a1566f80c228ab85f2451f 100644 (file)
@@ -4,15 +4,15 @@
 
 POSIX specification: @url{http://www.opengroup.org/susv3xsh/listen.html}
 
-Gnulib module: ---
+Gnulib module: sys_socket
 
 Portability problems fixed by Gnulib:
 @itemize
+@item
+On Windows platforms (excluding Cygwin), error codes for @code{accept} are not
+placed in @code{errno}, and @code{WSAGetLastError} must be used instead.
 @end itemize
 
 Portability problems not fixed by Gnulib:
 @itemize
-@item
-This function is missing on some platforms:
-mingw.
 @end itemize
index 1cebbd4156d06493541c4b0c5c6e3013e6905f71..6204b09a80442a2a528d276578e62a08da350906 100644 (file)
@@ -4,15 +4,15 @@
 
 POSIX specification: @url{http://www.opengroup.org/susv3xsh/recv.html}
 
-Gnulib module: ---
+Gnulib module: sys_socket
 
 Portability problems fixed by Gnulib:
 @itemize
+@item
+On Windows platforms (excluding Cygwin), error codes for @code{accept} are not
+placed in @code{errno}, and @code{WSAGetLastError} must be used instead.
 @end itemize
 
 Portability problems not fixed by Gnulib:
 @itemize
-@item
-This function is missing on some platforms:
-mingw.
 @end itemize
index fdb54a6ab055c6a62cdc562f036a8d227ff8e260..9b15e13b4f249c3cbf224fb5664c4d736c1cd05f 100644 (file)
@@ -4,18 +4,18 @@
 
 POSIX specification: @url{http://www.opengroup.org/susv3xsh/recvfrom.html}
 
-Gnulib module: ---
+Gnulib module: sys_socket
 
 Portability problems fixed by Gnulib:
 @itemize
+@item
+On Windows platforms (excluding Cygwin), error codes for @code{accept} are not
+placed in @code{errno}, and @code{WSAGetLastError} must be used instead.
 @end itemize
 
 Portability problems not fixed by Gnulib:
 @itemize
 @item
-This function is missing on some platforms:
-mingw.
-@item
 Some platforms don't have a @code{socklen_t} type; in this case this function's
 sixth argument type is @samp{int *}.
 @end itemize
index 1c6475263e52380187b70dba3d6c886b649e2ff9..81e56116bbe06dfd7f66bcbc9b418cc1cbc1bcdc 100644 (file)
@@ -4,26 +4,29 @@
 
 POSIX specification: @url{http://www.opengroup.org/susv3xsh/select.html}
 
-Gnulib module: ---
+Gnulib module: sys_select
 
 Portability problems fixed by Gnulib:
 @itemize
+@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.
+@item
+On Windows platforms (excluding Cygwin), error codes for @code{accept} are not
+placed in @code{errno}, and @code{WSAGetLastError} must be used instead.
 @end itemize
 
 Portability problems not fixed by Gnulib:
 @itemize
 @item
-This function is missing on some platforms:
-mingw.
-@item
 When you call @code{select} with a timeout, some implementations modify the
 timeout parameter so that upon return from the function, it contains the
 amount of time not slept.  Other implementations leave the timeout parameter
 unmodified.
 @item
-On Windows platforms (excluding Cygwin) and on BeOS, @code{select} can only be
-called on descriptors created by the @code{socket} function, not on regular
-file descriptors.
+On BeOS, @code{select} can only be called on descriptors created by the
+@code{socket} function, not on regular file descriptors.
 @item
 On Linux, when some file descriptor refers to a regular file, @code{select}
 may fail, setting @code{errno} to @code{EBADF}.
index 2320826683bebe4c3b0c564ee7508f77e8aebd7e..f7c9a4ab7ea0be5df882ede9ff2cbdf11adc0b6b 100644 (file)
@@ -4,15 +4,15 @@
 
 POSIX specification: @url{http://www.opengroup.org/susv3xsh/send.html}
 
-Gnulib module: ---
+Gnulib module: sys_socket
 
 Portability problems fixed by Gnulib:
 @itemize
+@item
+On Windows platforms (excluding Cygwin), error codes for @code{accept} are not
+placed in @code{errno}, and @code{WSAGetLastError} must be used instead.
 @end itemize
 
 Portability problems not fixed by Gnulib:
 @itemize
-@item
-This function is missing on some platforms:
-mingw.
 @end itemize
index 62330a6b27a9220d4eae0a8f9e53e0ade060d18e..47e38d2660646a7282779e62628b7fe862b057c8 100644 (file)
@@ -4,15 +4,15 @@
 
 POSIX specification: @url{http://www.opengroup.org/susv3xsh/sendto.html}
 
-Gnulib module: ---
+Gnulib module: sys_socket
 
 Portability problems fixed by Gnulib:
 @itemize
+@item
+On Windows platforms (excluding Cygwin), error codes for @code{accept} are not
+placed in @code{errno}, and @code{WSAGetLastError} must be used instead.
 @end itemize
 
 Portability problems not fixed by Gnulib:
 @itemize
-@item
-This function is missing on some platforms:
-mingw.
 @end itemize
index 2146c35578782841832730a5ded3dfce18399329..f4399710a6ed921ab70bd2e0b12daa27a6767f13 100644 (file)
@@ -4,17 +4,17 @@
 
 POSIX specification: @url{http://www.opengroup.org/susv3xsh/setsockopt.html}
 
-Gnulib module: ---
+Gnulib module: sys_socket
 
 Portability problems fixed by Gnulib:
 @itemize
+@item
+On Windows platforms (excluding Cygwin), error codes for @code{accept} are not
+placed in @code{errno}, and @code{WSAGetLastError} must be used instead.
 @end itemize
 
 Portability problems not fixed by Gnulib:
 @itemize
 @item
-This function is missing on some platforms:
-mingw.
-@item
 Many socket options are not available on all platforms.
 @end itemize
index 46a3605f7c802a41fbb63fa7d4b8e3887474ba03..9675f32be7ab03ce7a1e636217e243412c9fe498 100644 (file)
@@ -4,18 +4,23 @@
 
 POSIX specification: @url{http://www.opengroup.org/susv3xsh/socket.html}
 
-Gnulib module: ---
+Gnulib module: sys_socket
 
 Portability problems fixed by Gnulib:
 @itemize
+@item
+On Windows platforms (excluding Cygwin), the descriptors returned by
+the @code{socket} function can not be used in calls to @code{read},
+@code{write}, and @code{close}; you have to use @code{recv}, @code{send},
+@code{closesocket} in these cases instead.
+@item
+On Windows platforms (excluding Cygwin), error codes for @code{accept} are not
+placed in @code{errno}, and @code{WSAGetLastError} must be used instead.
 @end itemize
 
 Portability problems not fixed by Gnulib:
 @itemize
 @item
-This function is missing on some platforms:
-mingw.
-@item
 On BeOS, the descriptors returned by the @code{socket} function can not be used
 in calls to @code{read}, @code{write}, and @code{close}; you have to use
 @code{recv}, @code{send}, @code{closesocket} in these cases instead.