]> Savannah Git Hosting - gnulib.git/commitdiff
doc: document glibc posix_fallocate() issues
authorPádraig Brady <P@draigBrady.com>
Wed, 6 May 2015 15:23:56 +0000 (16:23 +0100)
committerPádraig Brady <P@draigBrady.com>
Wed, 6 May 2015 15:28:01 +0000 (16:28 +0100)
* doc/posix-functions/posix_fallocate.texi: Mention the
glibc efficiency problems and issues with NFS.

ChangeLog
doc/posix-functions/posix_fallocate.texi

index cf3acc7ee11dc2571184b71335632c2f2b83aa23..fc08ebae5cda6ad26a21642941d7289f1cbdc34f 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,9 @@
+2015-05-06  Pádraig Brady  <P@draigBrady.com>
+
+       doc: document glibc posix_fallocate() issues
+       * doc/posix-functions/posix_fallocate.texi: Mention the
+       glibc efficiency problems and issues with NFS.
+
 2015-05-05  Karl Berry  <karl@freefriends.org>
 
        * build-aux/gendocs.sh (usage): document new css default
index a7c47008d8e9ded9351799c1abed29bf1bf6873b..9e04b44e2227ebb9ed0fe26dfcceaab0ddf6a98e 100644 (file)
@@ -17,6 +17,12 @@ This function is missing on some platforms:
 Mac OS X 10.5, FreeBSD 6.0, NetBSD 5.0, OpenBSD 3.8, Minix 3.1.8, AIX 5.1, HP-UX 11,
 IRIX 6.5, OSF/1 5.1, Solaris 10, Cygwin 1.5.x, mingw, MSVC 9, Interix 3.5, BeOS.
 @item
+POSIX specifies that EINVAL should be returned when the file system doesn't
+support the allocation operation directly.  glibc however emulates the file system
+allocation with writes where unsupported, and apps have depended on
+that long term implementation.  This is both inefficient, and as of
+glibc 2.21 at least, buggy on certain NFS setups.
+@item
 On platforms where @code{off_t} is a 32-bit type, this function may not
 work correctly across the entire data range of files larger than 2 GB.
 The fix is to use the @code{AC_SYS_LARGEFILE} macro.