Mercurial > gnulib

annotate doc/posix-functions/getsockopt.texi @ 39231:05af34a75041

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Fix malfunction of socket functions on HP-UX in 64-bit mode. * m4/socketlib.m4 (gl_SOCKETLIB): Add comment. * m4/extensions.m4 (AC_USE_SYSTEM_EXTENSIONS): Define _HPUX_ALT_XOPEN_SOCKET_API. * modules/accept (Depends-on): Add 'extensions'. * modules/getpeername (Depends-on): Likewise. * modules/getsockname (Depends-on): Likewise. * modules/getsockopt (Depends-on): Likewise. * modules/recvfrom (Depends-on): Likewise. * doc/posix-functions/accept.texi: Mention the HP-UX socklen_t problem. * doc/posix-functions/getpeername.texi: Likewise. * doc/posix-functions/getsockname.texi: Likewise. * doc/posix-functions/getsockopt.texi: Likewise. * doc/posix-functions/recvfrom.texi: Likewise.
author Bruno Haible <bruno@clisp.org>
date Sat, 27 Jan 2018 10:57:59 +0100
parents a9320246370f
children
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 getsockopt
8cd0f07812b0 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
2 @section @code{getsockopt}
8cd0f07812b0 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
3 @findex getsockopt
8cd0f07812b0 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
4
33240
837ccd6b7cab avoid some overlong lines from posix urls, etc.
Karl Berry <karl@freefriends.org>
parents: 30567
diff changeset
5 POSIX specification:@* @url{http://www.opengroup.org/onlinepubs/9699919799/functions/getsockopt.html}
29329
8cd0f07812b0 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
6
30285
434dd52e2675 New modules 'accept', 'bind', 'connect', 'getpeername', 'getsockname', 'getsockopt', 'listen', 'recv', 'recvfrom', 'send', 'sendto', 'setsockopt', 'socket'.
Bruno Haible <bruno@clisp.org>
parents: 30233
diff changeset
7 Gnulib module: getsockopt
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
38566
a9320246370f doc: Clarify doc about socket functions on native Windows.
Bruno Haible <bruno@clisp.org>
parents: 33240
diff changeset
12 On Windows platforms (excluding Cygwin), error codes from this function
a9320246370f doc: Clarify doc about socket functions on native Windows.
Bruno Haible <bruno@clisp.org>
parents: 33240
diff changeset
13 are not placed in @code{errno}, and @code{WSAGetLastError} must be used
a9320246370f doc: Clarify doc about socket functions on native Windows.
Bruno Haible <bruno@clisp.org>
parents: 33240
diff changeset
14 instead.
39231
05af34a75041 Fix malfunction of socket functions on HP-UX in 64-bit mode.
Bruno Haible <bruno@clisp.org>
parents: 38566
diff changeset
15 @item
05af34a75041 Fix malfunction of socket functions on HP-UX in 64-bit mode.
Bruno Haible <bruno@clisp.org>
parents: 38566
diff changeset
16 On HP-UX 11, in 64-bit mode, when the macro @code{_HPUX_ALT_XOPEN_SOCKET_API}
05af34a75041 Fix malfunction of socket functions on HP-UX in 64-bit mode.
Bruno Haible <bruno@clisp.org>
parents: 38566
diff changeset
17 is not defined, this function behaves incorrectly because it is declared
05af34a75041 Fix malfunction of socket functions on HP-UX in 64-bit mode.
Bruno Haible <bruno@clisp.org>
parents: 38566
diff changeset
18 to take a pointer to a 64-bit wide @code{socklen_t} entity but in fact
05af34a75041 Fix malfunction of socket functions on HP-UX in 64-bit mode.
Bruno Haible <bruno@clisp.org>
parents: 38566
diff changeset
19 considers it as a pointer to a 32-bit wide @code{unsigned int} entity.
29329
8cd0f07812b0 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
20 @end itemize
8cd0f07812b0 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
21
8cd0f07812b0 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
22 Portability problems not fixed by Gnulib:
8cd0f07812b0 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
23 @itemize
8cd0f07812b0 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
24 @item
8cd0f07812b0 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
25 This function is missing on some platforms:
30233
8bf8bbba1c84 documentation update for mingw socket functions
Paolo Bonzini <bonzini@gnu.org>
parents: 29329
diff changeset
26 BeOS.
29329
8cd0f07812b0 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
27 @item
8cd0f07812b0 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
28 Some platforms don't have a @code{socklen_t} type; in this case this function's
8cd0f07812b0 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
29 fifth argument type is @samp{int *}.
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 Many socket options are not available on all platforms.
8cd0f07812b0 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
32 @item
8cd0f07812b0 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
33 BeOS has the @code{setsockopt} function, but not the @code{getsockopt}
8cd0f07812b0 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
34 function.
8cd0f07812b0 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
35 @end itemize