From 13cf7ad65ea3d630e0ad8e86eb366ab061c6dcac Mon Sep 17 00:00:00 2001 From: Bruno Haible Date: Sun, 14 Nov 2010 00:55:37 +0100 Subject: [PATCH] rename, renameat: Document Linux bug with NFS. . * doc/posix-functions/rename.texi: Mention the NFS bug on Linux. * doc/posix-functions/renameat.texi: Likewise. Suggested by Eric Blake. --- ChangeLog | 8 ++++++++ doc/posix-functions/rename.texi | 5 +++++ doc/posix-functions/renameat.texi | 5 +++++ 3 files changed, 18 insertions(+) diff --git a/ChangeLog b/ChangeLog index e2bd35cfaa..5ea657c543 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,11 @@ +2010-11-13 Bruno Haible + + rename, renameat: Document Linux bug with NFS + . + * doc/posix-functions/rename.texi: Mention the NFS bug on Linux. + * doc/posix-functions/renameat.texi: Likewise. + Suggested by Eric Blake. + 2010-11-13 Bruno Haible rename test: Add comments. diff --git a/doc/posix-functions/rename.texi b/doc/posix-functions/rename.texi index 7c66d28766..40e7c3c811 100644 --- a/doc/posix-functions/rename.texi +++ b/doc/posix-functions/rename.texi @@ -60,6 +60,11 @@ is counter-intuitive, so on some systems, @code{rename} fails with @code{ENOTDIR} if either argument is a symlink with a trailing slash: glibc, OpenBSD, Cygwin 1.7. @item +After renaming a non-empty directory over an existing empty directory, +the old directory name is still visible through the @code{stat} function +for 30 seconds after the rename, on NFS file systems, on some platforms: +Linux 2.6.18. +@item This function will not rename a source that is currently opened by any process: mingw. diff --git a/doc/posix-functions/renameat.texi b/doc/posix-functions/renameat.texi index 6100fb1c1f..e855a9327a 100644 --- a/doc/posix-functions/renameat.texi +++ b/doc/posix-functions/renameat.texi @@ -39,6 +39,11 @@ is counter-intuitive, so on some systems, @code{renameat} fails with @code{ENOTDIR} if either argument is a symlink with a trailing slash: glibc, OpenBSD, Cygwin 1.7. @item +After renaming a non-empty directory over an existing empty directory, +the old directory name is still visible through the @code{stat} function +for 30 seconds after the rename, on NFS file systems, on some platforms: +Linux 2.6.18. +@item This function will not rename a source that is currently opened by any process: mingw. -- 2.30.2