Mercurial > hg > octave-shane > gnulib-hg

annotate doc/posix-functions/perror.texi @ 15607:6355dc4626b5

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
doc: Update regarding MSVC 9. * doc/gnulib-intro.texi (Target Platforms): Classify MSVC as "rarely tested". * doc/posix-functions/*.texi: Update with info about MSVC 9. * doc/posix-headers/*.texi: Likewise. * doc/pastposix-functions/*.texi: Likewise. * doc/glibc-functions/*.texi: Likewise. * doc/glibc-headers/*.texi: Likewise.
author Bruno Haible <bruno@clisp.org>
date Sun, 11 Sep 2011 21:56:17 +0200
parents a3ba680ad389
children 498a2211d839
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
9638
070329237839 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
1 @node perror
070329237839 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
2 @section @code{perror}
070329237839 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
3 @findex perror
070329237839 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
4
13549
bb0ceefd22dc avoid some overlong lines from posix urls, etc.
Karl Berry <karl@freefriends.org>
parents: 11048
diff changeset
5 POSIX specification:@* @url{http://www.opengroup.org/onlinepubs/9699919799/functions/perror.html}
9638
070329237839 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
6
10433
02b0f65bfbfc New module 'perror'.
Bruno Haible <bruno@clisp.org>
parents: 9638
diff changeset
7 Gnulib module: perror
9638
070329237839 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
8
070329237839 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
9 Portability problems fixed by Gnulib:
070329237839 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
10 @itemize
10433
02b0f65bfbfc New module 'perror'.
Bruno Haible <bruno@clisp.org>
parents: 9638
diff changeset
11 @item
02b0f65bfbfc New module 'perror'.
Bruno Haible <bruno@clisp.org>
parents: 9638
diff changeset
12 This function does not support the error values that are specified by POSIX
02b0f65bfbfc New module 'perror'.
Bruno Haible <bruno@clisp.org>
parents: 9638
diff changeset
13 but not defined by the system, on some platforms:
15607
6355dc4626b5 doc: Update regarding MSVC 9.
Bruno Haible <bruno@clisp.org>
parents: 15308
diff changeset
14 OpenBSD 4.0, OSF/1 5.1, Cygwin 1.5.x, mingw, MSVC 9.
14778
85c9ed97c132 perror: work around FreeBSD bug
Eric Blake <eblake@redhat.com>
parents: 14777
diff changeset
15 @item
85c9ed97c132 perror: work around FreeBSD bug
Eric Blake <eblake@redhat.com>
parents: 14777
diff changeset
16 This function treats @code{errno} of 0 like failure, although POSIX
85c9ed97c132 perror: work around FreeBSD bug
Eric Blake <eblake@redhat.com>
parents: 14777
diff changeset
17 requires that the message declare it as a success, on some platforms:
15308
a3ba680ad389 strerror_r: fix OpenBSD behavior on 0
Eric Blake <eblake@redhat.com>
parents: 14895
diff changeset
18 FreeBSD 8.2, OpenBSD 4.7, MacOS X 10.5.
14891
e12d3081aeca perror: document fixed bugs
Eric Blake <eblake@redhat.com>
parents: 14888
diff changeset
19 @item
e12d3081aeca perror: document fixed bugs
Eric Blake <eblake@redhat.com>
parents: 14888
diff changeset
20 This function clobbers the @code{strerror} buffer on some platforms:
e12d3081aeca perror: document fixed bugs
Eric Blake <eblake@redhat.com>
parents: 14888
diff changeset
21 Cygwin 1.7.9.
e12d3081aeca perror: document fixed bugs
Eric Blake <eblake@redhat.com>
parents: 14888
diff changeset
22 @item
e12d3081aeca perror: document fixed bugs
Eric Blake <eblake@redhat.com>
parents: 14888
diff changeset
23 This function fails to print a useful a string for out-of-range integers on
e12d3081aeca perror: document fixed bugs
Eric Blake <eblake@redhat.com>
parents: 14888
diff changeset
24 some platforms:
e12d3081aeca perror: document fixed bugs
Eric Blake <eblake@redhat.com>
parents: 14888
diff changeset
25 HP-UX 11, IRIX 6.5, Solaris 8.
9638
070329237839 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
26 @end itemize
070329237839 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
27
070329237839 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
28 Portability problems not fixed by Gnulib:
070329237839 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
29 @itemize
14777
d614bf2c2613 test-perror: check for strerror interactions
Eric Blake <eblake@redhat.com>
parents: 13549
diff changeset
30 @item
d614bf2c2613 test-perror: check for strerror interactions
Eric Blake <eblake@redhat.com>
parents: 13549
diff changeset
31 POSIX requires that this function set the stream error bit (detected
d614bf2c2613 test-perror: check for strerror interactions
Eric Blake <eblake@redhat.com>
parents: 13549
diff changeset
32 by @code{ferror}) on write failure, but not all platforms do this:
14888
805e07cd88c7 test-perror: relax test to ignore cygwin bug
Eric Blake <eblake@redhat.com>
parents: 14852
diff changeset
33 glibc 2.13, cygwin 1.7.9.
14852
b88eb8c00c28 perror: call strerror_r directly
Eric Blake <eblake@redhat.com>
parents: 14778
diff changeset
34 @item
b88eb8c00c28 perror: call strerror_r directly
Eric Blake <eblake@redhat.com>
parents: 14778
diff changeset
35 POSIX requires that this function not alter stream orientation, but
b88eb8c00c28 perror: call strerror_r directly
Eric Blake <eblake@redhat.com>
parents: 14778
diff changeset
36 the gnulib replacement locks in byte orientation and fails on wide
b88eb8c00c28 perror: call strerror_r directly
Eric Blake <eblake@redhat.com>
parents: 14778
diff changeset
37 character streams.
9638
070329237839 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
38 @end itemize