From 09d1d202eabd3ca07faea5c3153cfcf5b93cb76c Mon Sep 17 00:00:00 2001 From: Eric Blake Date: Tue, 23 Sep 2008 06:48:07 -0600 Subject: [PATCH] fopen: document mingw bug on directories * doc/posix-functions/fopen.texi (fopen): Mention mingw bug for not allowing a stream visiting a directory, even though reading from such a stream is not portable. Signed-off-by: Eric Blake --- ChangeLog | 7 +++++++ doc/posix-functions/fopen.texi | 6 ++++++ 2 files changed, 13 insertions(+) diff --git a/ChangeLog b/ChangeLog index 3dfc1c44b7..38dd15e83f 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,10 @@ +2008-09-23 Eric Blake + + fopen: document mingw bug on directories + * doc/posix-functions/fopen.texi (fopen): Mention mingw bug for + not allowing a stream visiting a directory, even though reading + from such a stream is not portable. + 2008-09-23 Paolo Bonzini * lib/poll.c: Rewrite. diff --git a/doc/posix-functions/fopen.texi b/doc/posix-functions/fopen.texi index da6acde58e..442d1b6659 100644 --- a/doc/posix-functions/fopen.texi +++ b/doc/posix-functions/fopen.texi @@ -26,4 +26,10 @@ upon failure. On Windows, this function returns a file stream in ``text'' mode by default; this means that it translates @code{'\n'} to CR/LF by default. Use the @code{"b"} flag if you need reliable binary I/O. +@item +On Windows platforms (excluding Cygwin), this function fails to open +directories for reading. Such streams have implementation-defined +semantics on other platforms. To avoid directory streams with a +consistent error message, use @code{fstat} after @code{open} and +@code{fdopen}, rather than @code{fopen} and @code{fileno}. @end itemize -- 2.30.2