annotate doc/posix-functions/select.texi @ 30233:8bf8bbba1c84

documentation update for mingw socket functions 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.
author Paolo Bonzini <bonzini@gnu.org>
date Mon, 29 Sep 2008 13:23:50 +0200
parents 8cd0f07812b0
children a8bf2f84bb03
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
29329
8cd0f07812b0 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
1 @node select
8cd0f07812b0 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
2 @section @code{select}
8cd0f07812b0 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
3 @findex select
8cd0f07812b0 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
4
8cd0f07812b0 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
5 POSIX specification: @url{http://www.opengroup.org/susv3xsh/select.html}
8cd0f07812b0 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
6
30233
8bf8bbba1c84 documentation update for mingw socket functions
Paolo Bonzini <bonzini@gnu.org>
parents: 29329
diff changeset
7 Gnulib module: sys_select
29329
8cd0f07812b0 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
8
8cd0f07812b0 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
9 Portability problems fixed by Gnulib:
8cd0f07812b0 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
10 @itemize
30233
8bf8bbba1c84 documentation update for mingw socket functions
Paolo Bonzini <bonzini@gnu.org>
parents: 29329
diff changeset
11 @item
8bf8bbba1c84 documentation update for mingw socket functions
Paolo Bonzini <bonzini@gnu.org>
parents: 29329
diff changeset
12 On Windows platforms (excluding Cygwin), @code{select} can only be
8bf8bbba1c84 documentation update for mingw socket functions
Paolo Bonzini <bonzini@gnu.org>
parents: 29329
diff changeset
13 called on descriptors created by the @code{socket} function, not on regular
8bf8bbba1c84 documentation update for mingw socket functions
Paolo Bonzini <bonzini@gnu.org>
parents: 29329
diff changeset
14 file descriptors.
8bf8bbba1c84 documentation update for mingw socket functions
Paolo Bonzini <bonzini@gnu.org>
parents: 29329
diff changeset
15 @item
8bf8bbba1c84 documentation update for mingw socket functions
Paolo Bonzini <bonzini@gnu.org>
parents: 29329
diff changeset
16 On Windows platforms (excluding Cygwin), error codes for @code{accept} are not
8bf8bbba1c84 documentation update for mingw socket functions
Paolo Bonzini <bonzini@gnu.org>
parents: 29329
diff changeset
17 placed in @code{errno}, and @code{WSAGetLastError} must be used instead.
29329
8cd0f07812b0 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
18 @end itemize
8cd0f07812b0 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
19
8cd0f07812b0 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
20 Portability problems not fixed by Gnulib:
8cd0f07812b0 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
21 @itemize
8cd0f07812b0 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
22 @item
8cd0f07812b0 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
23 When you call @code{select} with a timeout, some implementations modify the
8cd0f07812b0 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
24 timeout parameter so that upon return from the function, it contains the
8cd0f07812b0 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
25 amount of time not slept. Other implementations leave the timeout parameter
8cd0f07812b0 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
26 unmodified.
8cd0f07812b0 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
27 @item
30233
8bf8bbba1c84 documentation update for mingw socket functions
Paolo Bonzini <bonzini@gnu.org>
parents: 29329
diff changeset
28 On BeOS, @code{select} can only be called on descriptors created by the
8bf8bbba1c84 documentation update for mingw socket functions
Paolo Bonzini <bonzini@gnu.org>
parents: 29329
diff changeset
29 @code{socket} function, not on regular file descriptors.
29329
8cd0f07812b0 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
30 @item
8cd0f07812b0 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
31 On Linux, when some file descriptor refers to a regular file, @code{select}
8cd0f07812b0 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
32 may fail, setting @code{errno} to @code{EBADF}.
8cd0f07812b0 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
33 @end itemize