doc/posix-functions/strerror_r.texi

   1 @node strerror_r
   2 @section @code{strerror_r}
   3 @findex strerror_r
   4
   5 POSIX specification:@* @url{http://www.opengroup.org/onlinepubs/9699919799/functions/strerror_r.html}
   6
   7 Gnulib module: strerror_r-posix
   8
   9 Portability problems fixed by Gnulib:
  10 @itemize
  11 @item
  12 This function is missing on some platforms:
  13 NetBSD 3.0, Minix 3.1.8, HP-UX 11.23, IRIX 6.5, Solaris 9, mingw, MSVC 14.
  14 @item
  15 glibc, Cygwin, and Android have an incompatible version of this function.
  16 The POSIX compliant code
  17 @smallexample
  18 char *s = (strerror_r (err, buf, buflen) == 0 ? buf : NULL);
  19 @end smallexample
  20 is essentially equivalent to this code using the glibc function:
  21 @smallexample
  22 char *s = strerror_r (err, buf, buflen);
  23 @end smallexample
  24 @item
  25 This function clobbers the @code{strerror} buffer on some platforms:
  26 Cygwin 1.7.9.
  27 @item
  28 This function is sometimes not declared in @code{<string.h>} on some platforms:
  29 glibc 2.8, OSF/1 5.1.
  30 @item
  31 The third argument is of type @code{int} instead of @code{size_t} on some
  32 platforms:
  33 AIX 5.1, OSF/1 5.1.
  34 @item
  35 When this function fails, it returns @minus{}1 and sets @code{errno}, instead of
  36 returning the error number, on some platforms:
  37 glibc 2.12 with @code{-D_POSIX_C_SOURCE=200112L}, AIX 6.1, OSF/1 5.1.
  38 @item
  39 When this function fails, it corrupts @code{errno}, on some platforms:
  40 Solaris 10.
  41 @item
  42 This function does not support many error values defined in @code{<errno.h>} on
  43 some platforms:
  44 MSVC 14.
  45 @item
  46 This function does not support the error values that are specified by POSIX
  47 but not defined by the system, on some platforms:
  48 OpenBSD 4.0, OSF/1 5.1, NonStop Kernel, Cygwin 1.5.x.
  49 @item
  50 This function reports failure for @code{strerror_r(0, buf, len)},
  51 although POSIX requires this to succeed, on some platforms:
  52 FreeBSD 8.2.
  53 @item
  54 This function produces a different string for @code{0} than
  55 @code{strerror} on some platforms:
  56 Mac OS X 10.5.
  57 @item
  58 This function always fails when the third argument is less than 80 on some
  59 platforms:
  60 HP-UX 11.31.
  61 @item
  62 When the buffer is too small and the value is in range, this function
  63 does not fail, but instead truncates the result and returns 0 on some
  64 platforms:
  65 AIX 6.1, OSF/1 5.1, Haiku 2017.
  66 @item
  67 When the value is not in range or the buffer is too small, this
  68 function fails to leave a NUL-terminated string in the buffer on some
  69 platforms:
  70 glibc 2.13, FreeBSD 8.2, Solaris 10.
  71 @item
  72 When the value is out of range but the buffer is too small, this
  73 function does not always return the longest possible string on some
  74 platforms:
  75 OpenBSD 4.7.
  76 @end itemize
  77
  78 Portability problems not fixed by Gnulib:
  79 @itemize
  80 @end itemize