X-Git-Url: https://erislabs.net/gitweb/?a=blobdiff_plain;f=doc%2Fposix-functions%2Fstrerror_r.texi;h=658e0811e5ce0091db0476e57a5e7718968639c7;hb=58d8afd0545d6321272bb7fb243db3295c5fdeec;hp=1bcde1a74dea50b1d5c7268558130606959257e9;hpb=1838494765155d7c9ac63832182cd4ef9f368bf5;p=gnulib.git diff --git a/doc/posix-functions/strerror_r.texi b/doc/posix-functions/strerror_r.texi index 1bcde1a74..658e0811e 100644 --- a/doc/posix-functions/strerror_r.texi +++ b/doc/posix-functions/strerror_r.texi @@ -10,9 +10,10 @@ Portability problems fixed by Gnulib: @itemize @item This function is missing on some platforms: -NetBSD 3.0, HP-UX 11.23, IRIX 6.5, Solaris 9, mingw. +NetBSD 3.0, Minix 3.1.8, HP-UX 11.23, IRIX 6.5, Solaris 9, mingw, MSVC 9. @item -glibc has an incompatible version of this function. The POSIX compliant code +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 @@ -21,6 +22,9 @@ is essentially equivalent to this code using the glibc function: 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{} on some platforms: glibc 2.8, OSF/1 5.1. @item @@ -30,25 +34,43 @@ 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.8 with @code{-D_POSIX_C_SOURCE=200112L}, AIX 6.1, OSF/1 5.1. +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, this function does not fail, but instead -truncates the result and returns 0 on some platforms: -OSF/1 5.1. +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 -@item -When the buffer is too small, this function does not fail, but instead -truncates the result and returns 0 on some platforms: -AIX 6.1. @end itemize