diff options
Diffstat (limited to 'gnulib/doc/posix-functions/strerror_r.texi')
m--------- | gnulib | 0 | ||||
-rw-r--r-- | gnulib/doc/posix-functions/strerror_r.texi | 76 |
2 files changed, 76 insertions, 0 deletions
diff --git a/gnulib b/gnulib deleted file mode 160000 -Subproject 443bc5ffcf7429e557f4a371b0661abe98ddbc1 diff --git a/gnulib/doc/posix-functions/strerror_r.texi b/gnulib/doc/posix-functions/strerror_r.texi new file mode 100644 index 0000000..658e081 --- /dev/null +++ b/gnulib/doc/posix-functions/strerror_r.texi @@ -0,0 +1,76 @@ +@node strerror_r +@section @code{strerror_r} +@findex strerror_r + +POSIX specification:@* @url{http://www.opengroup.org/onlinepubs/9699919799/functions/strerror_r.html} + +Gnulib module: strerror_r-posix + +Portability problems fixed by Gnulib: +@itemize +@item +This function is missing on some platforms: +NetBSD 3.0, Minix 3.1.8, HP-UX 11.23, IRIX 6.5, Solaris 9, mingw, MSVC 9. +@item +glibc and Cygwin have an incompatible version of this function. The +POSIX compliant code +@smallexample +char *s = (strerror_r (err, buf, buflen) == 0 ? buf : NULL); +@end smallexample +is essentially equivalent to this code using the glibc function: +@smallexample +char *s = strerror_r (err, buf, buflen); +@end smallexample +@item +This function clobbers the @code{strerror} buffer on some platforms: +Cygwin 1.7.9. +@item +This function is sometimes not declared in @code{<string.h>} on some platforms: +glibc 2.8, OSF/1 5.1. +@item +The third argument is of type @code{int} instead of @code{size_t} on some +platforms: +AIX 5.1, OSF/1 5.1. +@item +When this function fails, it returns -1 and sets @code{errno}, instead of +returning the error number, on some platforms: +glibc 2.12 with @code{-D_POSIX_C_SOURCE=200112L}, AIX 6.1, OSF/1 5.1. +@item +When this function fails, it corrupts @code{errno}, on some platforms: +Solaris 10. +@item +This function does not support the error values that are specified by POSIX +but not defined by the system, on some platforms: +OpenBSD 4.0, OSF/1 5.1, NonStop Kernel, Cygwin 1.5.x. +@item +This function reports failure for @code{strerror_r(0, buf, len)}, +although POSIX requires this to succeed, on some platforms: +FreeBSD 8.2. +@item +This function produces a different string for @code{0} than +@code{strerror} on some platforms: +MacOS X 10.5. +@item +This function always fails when the third argument is less than 80 on some +platforms: +HP-UX 11.31. +@item +When the buffer is too small and the value is in range, this function +does not fail, but instead truncates the result and returns 0 on some +platforms: +AIX 6.1, OSF/1 5.1. +@item +When the value is not in range or the buffer is too small, this +function fails to leave a NUL-terminated string in the buffer on some +platforms: +glibc 2.13, FreeBSD 8.2, Solaris 10. +@item +When the value is out of range but the buffer is too small, this +function does not always return the longest possible string on some +platforms: +OpenBSD 4.7. +@end itemize + +Portability problems not fixed by Gnulib: +@itemize +@end itemize |