X-Git-Url: http://erislabs.net/gitweb/?a=blobdiff_plain;f=doc%2Fposix-functions%2Ffreopen.texi;h=d14c3e1e0501949240208e48a75136539c49b9d3;hb=178e3ad58f3e077cd87a3ca9a615541e428f9e17;hp=150b1aa6b495f80b538988a835c93f81b424339e;hpb=4fd7cdb11eef025a6c83c056cad3f29ed5d3161c;p=gnulib.git diff --git a/doc/posix-functions/freopen.texi b/doc/posix-functions/freopen.texi index 150b1aa6b..d14c3e1e0 100644 --- a/doc/posix-functions/freopen.texi +++ b/doc/posix-functions/freopen.texi @@ -2,13 +2,16 @@ @section @code{freopen} @findex freopen -POSIX specification: @url{http://www.opengroup.org/susv3xsh/freopen.html} +POSIX specification:@* @url{http://www.opengroup.org/onlinepubs/9699919799/functions/freopen.html} Gnulib module: freopen Portability problems fixed by Gnulib: @itemize @item +On platforms where @code{off_t} is a 32-bit type, @code{freopen} may not work +correctly with files larger than 2 GB. (Cf. @code{AC_SYS_LARGEFILE}.) +@item On Windows platforms (excluding Cygwin), this function does usually not recognize the @file{/dev/null} filename. @end itemize @@ -19,8 +22,17 @@ Portability problems not fixed by Gnulib: On Windows platforms (excluding Cygwin), this function does not set @code{errno} upon failure. @item +This function does not support a @code{NULL} file name argument on some +platforms: +OpenBSD 4.9, AIX 7.1, HP-UX 11.23, IRIX 6.5, OSF/1 5.1, Solaris 10, mingw, MSVC 9. +@item This function does not fail when the file name argument ends in a slash and (without the slash) names a nonexistent file or a file that is not a directory, on some platforms: HP-UX 11.00, Solaris 9, Irix 5.3. +@item +Applications should not assume that @code{fileno(f)} will be the same +before and after a call to @code{freopen(name,mode,f)}. However, the +module freopen-safer can at least protect @code{stdin}, @code{stdout}, +and @code{stderr}. @end itemize