kc3-lang/gnulib/doc/posix-functions/vdprintf.texi

• Show log

  Commit

• Hash : fd33cbeb
  Author :
  Date : 2011-06-07T15:41:20
  

  test-perror: relax test to ignore cygwin bug
  
  glibc was not the only platform where fprintf(fopen(,"r"))
  fails to detect errors; cygwin 1.7.9 is another culprit
  (although it will be fixed for 1.7.10), and I suspect that
  several other platforms were failing perror2 for the same
  reason.
  
  At this point, there are so many functions affected, and
  the way to avoid the bug is easy enough (don't pass bogus
  streams to output-producing functions), that I'm not worried
  about fixing things other than to document them.
  
  * tests/test-perror2.c (main): Relax test on requiring detection
  of stream errors, and use unbuffered stream.
  * doc/posix-functions/dprintf.texi (dprintf): Document bug.
  * doc/posix-functions/fprintf.texi (fprintf): Likewise.
  * doc/posix-functions/fputc.texi (fputc): Likewise.
  * doc/posix-functions/fputs.texi (fputs): Likewise.
  * doc/posix-functions/fputws.texi (fputws): Likewise.
  * doc/posix-functions/fwprintf.texi (fwprintf): Likewise.
  * doc/posix-functions/fwrite.texi (fwrite): Likewise.
  * doc/posix-functions/getopt.texi (getopt): Likewise.
  * doc/posix-functions/perror.texi (perror): Likewise.
  * doc/posix-functions/printf.texi (printf): Likewise.
  * doc/posix-functions/psiginfo.texi (psiginfo): Likewise.
  * doc/posix-functions/psignal.texi (psignal): Likewise.
  * doc/posix-functions/putc.texi (putc): Likewise.
  * doc/posix-functions/putc_unlocked.texi (putc_unlocked):
  Likewise.
  * doc/posix-functions/putchar.texi (putchar): Likewise.
  * doc/posix-functions/putchar_unlocked.texi (putchar_unlocked):
  Likewise.
  * doc/posix-functions/puts.texi (puts): Likewise.
  * doc/posix-functions/putwc.texi (putwc): Likewise.
  * doc/posix-functions/putwchar.texi (putwchar): Likewise.
  * doc/posix-functions/vdprintf.texi (vdprintf): Likewise.
  * doc/posix-functions/vfprintf.texi (vfprintf): Likewise.
  * doc/posix-functions/vfwprintf.texi (vfwprintf): Likewise.
  * doc/posix-functions/vprintf.texi (vprintf): Likewise.
  * doc/posix-functions/vwprintf.texi (vwprintf): Likewise.
  * doc/posix-functions/wordexp.texi (wordexp): Likewise.
  * doc/posix-functions/wprintf.texi (wprintf): Likewise.
  
  Signed-off-by: Eric Blake <eblake@redhat.com>
  

Download

• doc/posix-functions/vdprintf.texi

• @node vdprintf
  @section @code{vdprintf}
  @findex vdprintf
  
  POSIX specification:@* @url{http://www.opengroup.org/onlinepubs/9699919799/functions/vdprintf.html}
  
  Gnulib module: vdprintf or vdprintf-posix
  
  Portability problems fixed by either Gnulib module @code{vdprintf} or @code{vdprintf-posix}:
  @itemize
  @item
  This function is missing on some platforms:
  MacOS X 10.5, FreeBSD 6.0, NetBSD 5.0, OpenBSD 3.8, AIX 5.1, HP-UX 11,
  IRIX 6.5, OSF/1 5.1, Solaris 11 2010-11, Cygwin 1.5.x, mingw, Interix 3.5.
  @end itemize
  
  Portability problems fixed by Gnulib module @code{vdprintf-posix}:
  @itemize
  @item
  This function does not support size specifiers as in C99 (@code{hh}, @code{ll},
  @code{j}, @code{t}, @code{z}) on some platforms:
  BeOS.
  @item
  printf of @samp{long double} numbers is unsupported on some platforms:
  BeOS.
  @item
  This function does not support the @samp{a} and @samp{A} directives on some
  platforms:
  glibc-2.3.6, BeOS.
  @item
  This function does not support the @samp{F} directive on some platforms:
  BeOS.
  @item
  This function does not support format directives that access arguments in an
  arbitrary order, such as @code{"%2$s"}, on some platforms:
  BeOS.
  @item
  This function does not support precisions larger than 512 or 1024 in integer,
  floating-point and pointer output on some platforms:
  BeOS.
  @end itemize
  
  Portability problems not fixed by Gnulib:
  @itemize
  @item
  On some platforms, this function does not set @code{errno} or the
  stream error indicator on attempts to write to a read-only stream:
  Cygwin 1.7.9.
  @end itemize
  

Download