doc: Mention the effects of AC_SYS_LARGEFILE.

* doc/posix-functions/aio_cancel.texi: Mention the effects of AC_SYS_LARGEFILE
on this function.
* doc/posix-functions/aio_error.texi: Likewise.
* doc/posix-functions/aio_fsync.texi: Likewise.
* doc/posix-functions/aio_read.texi: Likewise.
* doc/posix-functions/aio_return.texi: Likewise.
* doc/posix-functions/aio_suspend.texi: Likewise.
* doc/posix-functions/aio_write.texi: Likewise.
* doc/posix-functions/fgetpos.texi: Likewise.
* doc/posix-functions/fopen.texi: Likewise.
* doc/posix-functions/freopen.texi: Likewise.
* doc/posix-functions/fsetpos.texi: Likewise.
* doc/posix-functions/fstatvfs.texi: Likewise.
* doc/posix-functions/ftruncate.texi: Likewise.
* doc/posix-functions/ftw.texi: Likewise.
* doc/posix-functions/getrlimit.texi: Likewise.
* doc/posix-functions/glob.texi: Likewise.
* doc/posix-functions/lio_listio.texi: Likewise.
* doc/posix-functions/lockf.texi: Likewise.
* doc/posix-functions/mkstemp.texi: Likewise.
* doc/posix-functions/mmap.texi: Likewise.
* doc/posix-functions/nftw.texi: Likewise.
* doc/posix-functions/openat.texi: Likewise.
* doc/posix-functions/opendir.texi: Likewise.
* doc/posix-functions/posix_fadvise.texi: Likewise.
* doc/posix-functions/posix_fallocate.texi: Likewise.
* doc/posix-functions/pread.texi: Likewise.
* doc/posix-functions/pwrite.texi: Likewise.
* doc/posix-functions/readdir.texi: Likewise.
* doc/posix-functions/readdir_r.texi: Likewise.
* doc/posix-functions/rewinddir.texi: Likewise.
* doc/posix-functions/scandir.texi: Likewise.
* doc/posix-functions/seekdir.texi: Likewise.
* doc/posix-functions/setrlimit.texi: Likewise.
* doc/posix-functions/statvfs.texi: Likewise.
* doc/posix-functions/telldir.texi: Likewise.
* doc/posix-functions/tmpfile.texi: Likewise.
* doc/posix-functions/truncate.texi: Likewise.
* doc/glibc-functions/fallocate.texi: Likewise.
* doc/glibc-functions/fstatfs.texi: Likewise.
* doc/glibc-functions/fts_children.texi: Likewise.
* doc/glibc-functions/fts_read.texi: Likewise.
* doc/glibc-functions/getdirentries.texi: Likewise.
* doc/glibc-functions/mkostemp.texi: Likewise.
* doc/glibc-functions/mkostemps.texi: Likewise.
* doc/glibc-functions/mkstemps.texi: Likewise.
* doc/glibc-functions/preadv.texi: Likewise.
* doc/glibc-functions/pwritev.texi: Likewise.
* doc/glibc-functions/sendfile.texi: Likewise.
* doc/glibc-functions/statfs.texi: Likewise.

diff --git a/ChangeLog b/ChangeLog
index ddfa089046e2144475ec5b290155b087e15b13f9..2d8964ff11c443b2073d3ceee3a37d5cb4f17d48 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,57 @@
+2011-07-24  Bruno Haible  <bruno@clisp.org>
+
+       doc: Mention the effects of AC_SYS_LARGEFILE.
+       * doc/posix-functions/aio_cancel.texi: Mention the effects of AC_SYS_LARGEFILE
+       on this function.
+       * doc/posix-functions/aio_error.texi: Likewise.
+       * doc/posix-functions/aio_fsync.texi: Likewise.
+       * doc/posix-functions/aio_read.texi: Likewise.
+       * doc/posix-functions/aio_return.texi: Likewise.
+       * doc/posix-functions/aio_suspend.texi: Likewise.
+       * doc/posix-functions/aio_write.texi: Likewise.
+       * doc/posix-functions/fgetpos.texi: Likewise.
+       * doc/posix-functions/fopen.texi: Likewise.
+       * doc/posix-functions/freopen.texi: Likewise.
+       * doc/posix-functions/fsetpos.texi: Likewise.
+       * doc/posix-functions/fstatvfs.texi: Likewise.
+       * doc/posix-functions/ftruncate.texi: Likewise.
+       * doc/posix-functions/ftw.texi: Likewise.
+       * doc/posix-functions/getrlimit.texi: Likewise.
+       * doc/posix-functions/glob.texi: Likewise.
+       * doc/posix-functions/lio_listio.texi: Likewise.
+       * doc/posix-functions/lockf.texi: Likewise.
+       * doc/posix-functions/mkstemp.texi: Likewise.
+       * doc/posix-functions/mmap.texi: Likewise.
+       * doc/posix-functions/nftw.texi: Likewise.
+       * doc/posix-functions/openat.texi: Likewise.
+       * doc/posix-functions/opendir.texi: Likewise.
+       * doc/posix-functions/posix_fadvise.texi: Likewise.
+       * doc/posix-functions/posix_fallocate.texi: Likewise.
+       * doc/posix-functions/pread.texi: Likewise.
+       * doc/posix-functions/pwrite.texi: Likewise.
+       * doc/posix-functions/readdir.texi: Likewise.
+       * doc/posix-functions/readdir_r.texi: Likewise.
+       * doc/posix-functions/rewinddir.texi: Likewise.
+       * doc/posix-functions/scandir.texi: Likewise.
+       * doc/posix-functions/seekdir.texi: Likewise.
+       * doc/posix-functions/setrlimit.texi: Likewise.
+       * doc/posix-functions/statvfs.texi: Likewise.
+       * doc/posix-functions/telldir.texi: Likewise.
+       * doc/posix-functions/tmpfile.texi: Likewise.
+       * doc/posix-functions/truncate.texi: Likewise.
+       * doc/glibc-functions/fallocate.texi: Likewise.
+       * doc/glibc-functions/fstatfs.texi: Likewise.
+       * doc/glibc-functions/fts_children.texi: Likewise.
+       * doc/glibc-functions/fts_read.texi: Likewise.
+       * doc/glibc-functions/getdirentries.texi: Likewise.
+       * doc/glibc-functions/mkostemp.texi: Likewise.
+       * doc/glibc-functions/mkostemps.texi: Likewise.
+       * doc/glibc-functions/mkstemps.texi: Likewise.
+       * doc/glibc-functions/preadv.texi: Likewise.
+       * doc/glibc-functions/pwritev.texi: Likewise.
+       * doc/glibc-functions/sendfile.texi: Likewise.
+       * doc/glibc-functions/statfs.texi: Likewise.
+

 2011-07-24  Bruno Haible  <bruno@clisp.org>
 
        doc: Fix typo.
 2011-07-24  Bruno Haible  <bruno@clisp.org>
 
        doc: Fix typo.

diff --git a/doc/glibc-functions/fallocate.texi b/doc/glibc-functions/fallocate.texi
index c8a3fb3398ef683d7dc88d2e6c10fa3b81534445..8141571aa77553e5e79bfa85852ce6afed4809bd 100644 (file)
--- a/doc/glibc-functions/fallocate.texi
+++ b/doc/glibc-functions/fallocate.texi
@@ -13,4 +13,8 @@ Portability problems not fixed by Gnulib:
 @item
 This function is missing on older glibc versions and all non-glibc 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, mingw, Interix 3.5, BeOS.
 @item
 This function is missing on older glibc versions and all non-glibc 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, mingw, Interix 3.5, BeOS.

+@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.

 @end itemize
 @end itemize

diff --git a/doc/glibc-functions/fstatfs.texi b/doc/glibc-functions/fstatfs.texi
index 6c4c50d2ce6e7cd8e56c9d4ba54f5f901dee850f..080d1af87de602f65421ff21bd4ca08d973eff88 100644 (file)
--- a/doc/glibc-functions/fstatfs.texi
+++ b/doc/glibc-functions/fstatfs.texi
@@ -13,4 +13,9 @@ Portability problems not fixed by Gnulib:
 @item
 This function is missing on some platforms:
 AIX 5.1, mingw, Interix 3.5, BeOS.
 @item
 This function is missing on some platforms:
 AIX 5.1, mingw, Interix 3.5, BeOS.

+@item
+On platforms where @code{f_blocks} in @samp{struct statfs} is a 32-bit
+value, this function may not work correctly on files systems larger than
+4 TiB.  The fix is to use the @code{AC_SYS_LARGEFILE} macro.  This affects
+MacOS X.

 @end itemize
 @end itemize

diff --git a/doc/glibc-functions/fts_children.texi b/doc/glibc-functions/fts_children.texi
index 5acca48a5026216697ff485f55fa614057c10263..64bbe824dc86046ac3bb1959a90e9231dd666bc4 100644 (file)
--- a/doc/glibc-functions/fts_children.texi
+++ b/doc/glibc-functions/fts_children.texi
@@ -13,4 +13,11 @@ Portability problems not fixed by Gnulib:
 @item
 This function is missing on some platforms:
 AIX 5.1, HP-UX 11, IRIX 6.5, OSF/1 5.1, Solaris 11 2010-11, mingw, BeOS.
 @item
 This function is missing on some platforms:
 AIX 5.1, HP-UX 11, IRIX 6.5, OSF/1 5.1, Solaris 11 2010-11, mingw, BeOS.

+@item
+On platforms where @code{off_t} is a 32-bit type, this function may not
+correctly report the size of files or block devices larger than 2 GB and
+may not work correctly on huge directories larger than 2 GB.  Also, on
+platforms where @code{ino_t} is a 32-bit type, this function may report
+inode numbers incorrectly.  The fix is to use the @code{AC_SYS_LARGEFILE}
+macro (only on MacOS X systems).

 @end itemize
 @end itemize

diff --git a/doc/glibc-functions/fts_read.texi b/doc/glibc-functions/fts_read.texi
index 24a91c431948e09667ed41e77fdf3320c84b72e1..363f051abd6c8352e91bd48fe12aecd74a02d5ba 100644 (file)
--- a/doc/glibc-functions/fts_read.texi
+++ b/doc/glibc-functions/fts_read.texi
@@ -13,4 +13,11 @@ Portability problems not fixed by Gnulib:
 @item
 This function is missing on some platforms:
 AIX 5.1, HP-UX 11, IRIX 6.5, OSF/1 5.1, Solaris 11 2010-11, mingw, BeOS.
 @item
 This function is missing on some platforms:
 AIX 5.1, HP-UX 11, IRIX 6.5, OSF/1 5.1, Solaris 11 2010-11, mingw, BeOS.

+@item
+On platforms where @code{off_t} is a 32-bit type, this function may not
+correctly report the size of files or block devices larger than 2 GB and
+may not work correctly on huge directories larger than 2 GB.  Also, on
+platforms where @code{ino_t} is a 32-bit type, this function may report
+inode numbers incorrectly.  The fix is to use the @code{AC_SYS_LARGEFILE}
+macro (only on MacOS X systems).

 @end itemize
 @end itemize

diff --git a/doc/glibc-functions/getdirentries.texi b/doc/glibc-functions/getdirentries.texi
index b89335ed8a3d0361fa7b78c4a784b04d1683994b..f45f65030cf32b9737c4379ffc9e4d82706ea23f 100644 (file)
--- a/doc/glibc-functions/getdirentries.texi
+++ b/doc/glibc-functions/getdirentries.texi
@@ -13,4 +13,8 @@ Portability problems not fixed by Gnulib:
 @item
 This function is missing on some platforms:
 AIX 4.3.2, IRIX 6.5, Solaris 11 2010-11, Cygwin, mingw, Interix 3.5, BeOS.
 @item
 This function is missing on some platforms:
 AIX 4.3.2, IRIX 6.5, Solaris 11 2010-11, Cygwin, mingw, Interix 3.5, BeOS.

+@item
+On platforms where @code{off_t} is a 32-bit type, this function may not
+work correctly on huge directories larger than 2 GB.  The fix is to use
+the @code{AC_SYS_LARGEFILE} macro.

 @end itemize
 @end itemize

diff --git a/doc/glibc-functions/mkostemp.texi b/doc/glibc-functions/mkostemp.texi
index 44e3ab31383e051ea43fdb7ca02806c0a64d350b..f9635ed55c0410ea8b91a638e4fba848580d183a 100644 (file)
--- a/doc/glibc-functions/mkostemp.texi
+++ b/doc/glibc-functions/mkostemp.texi
@@ -14,6 +14,10 @@ IRIX 6.5, OSF/1 5.1, Solaris 11 2010-11, Cygwin 1.7.5, mingw, Interix 3.5, BeOS.
 
 Portability problems not fixed by Gnulib:
 @itemize
 
 Portability problems not fixed by Gnulib:
 @itemize

+@item
+On platforms where @code{off_t} is a 32-bit type, @code{mkostemp} may not work
+correctly to create files larger than 2 GB.  The fix is to use the
+@code{AC_SYS_LARGEFILE} macro.

 @end itemize
 
 The gnulib module @code{clean-temp} can create temporary files that will not
 @end itemize
 
 The gnulib module @code{clean-temp} can create temporary files that will not

diff --git a/doc/glibc-functions/mkostemps.texi b/doc/glibc-functions/mkostemps.texi
index 033d462c77939df38c0213d09aa771a4b674f89d..07e5e18a91dd720ebaf541ecdf4b5f9736518742 100644 (file)
--- a/doc/glibc-functions/mkostemps.texi
+++ b/doc/glibc-functions/mkostemps.texi
@@ -14,6 +14,10 @@ glibc 2.10, MacOS X 10.5, FreeBSD 6.0, NetBSD 5.0, OpenBSD 3.8, AIX
 
 Portability problems not fixed by Gnulib:
 @itemize
 
 Portability problems not fixed by Gnulib:
 @itemize

+@item
+On platforms where @code{off_t} is a 32-bit type, @code{mkostemps} may not work
+correctly to create files larger than 2 GB.  The fix is to use the
+@code{AC_SYS_LARGEFILE} macro.

 @end itemize
 
 The gnulib module @code{clean-temp} can create temporary files that will not
 @end itemize
 
 The gnulib module @code{clean-temp} can create temporary files that will not

diff --git a/doc/glibc-functions/mkstemps.texi b/doc/glibc-functions/mkstemps.texi
index 845d5dcf364d7eaf4296a10af4aad30fd2b85447..5cd0b3bceb631e388aa11993e186bb51b376d726 100644 (file)
--- a/doc/glibc-functions/mkstemps.texi
+++ b/doc/glibc-functions/mkstemps.texi
@@ -18,6 +18,10 @@ MacOS X 10.5.
 
 Portability problems not fixed by Gnulib:
 @itemize
 
 Portability problems not fixed by Gnulib:
 @itemize

+@item
+On platforms where @code{off_t} is a 32-bit type, @code{mkstemps} may not work
+correctly to create files larger than 2 GB.  The fix is to use the
+@code{AC_SYS_LARGEFILE} macro.

 @end itemize
 
 The gnulib module @code{clean-temp} can create temporary files that will not
 @end itemize
 
 The gnulib module @code{clean-temp} can create temporary files that will not

diff --git a/doc/glibc-functions/preadv.texi b/doc/glibc-functions/preadv.texi
index d23b58c8e550d70c366159163ebe3d6470c0f3e4..7dc226b3bfeba80ae41c888bdec4afe9862e221e 100644 (file)
--- a/doc/glibc-functions/preadv.texi
+++ b/doc/glibc-functions/preadv.texi
@@ -13,4 +13,8 @@ Portability problems not fixed by Gnulib:
 @item
 This function is missing on some platforms:
 glibc 2.9, MacOS X 10.5, FreeBSD 5.2.1, AIX 5.2, HP-UX 11.31, IRIX 6.5, OSF/1 5.1, Solaris 11 2010-11, Cygwin, mingw, Interix 3.5, BeOS.
 @item
 This function is missing on some platforms:
 glibc 2.9, MacOS X 10.5, FreeBSD 5.2.1, AIX 5.2, HP-UX 11.31, IRIX 6.5, OSF/1 5.1, Solaris 11 2010-11, Cygwin, mingw, Interix 3.5, BeOS.

+@item
+On platforms where @code{off_t} is a 32-bit type, this function may not
+work correctly on files larger than 2 GB.  The fix is to use the
+@code{AC_SYS_LARGEFILE} macro.

 @end itemize
 @end itemize

diff --git a/doc/glibc-functions/pwritev.texi b/doc/glibc-functions/pwritev.texi
index e08fe3face64c05b33acbbe14d4a6b1d908bd233..f69acb879469805bb09ed7d6bad91c52688146ee 100644 (file)
--- a/doc/glibc-functions/pwritev.texi
+++ b/doc/glibc-functions/pwritev.texi
@@ -13,4 +13,8 @@ Portability problems not fixed by Gnulib:
 @item
 This function is missing on some platforms:
 glibc 2.9, MacOS X 10.5, FreeBSD 5.2.1, AIX 5.2, HP-UX 11.31, IRIX 6.5, OSF/1 5.1, Solaris 11 2010-11, Cygwin, mingw, Interix 3.5, BeOS.
 @item
 This function is missing on some platforms:
 glibc 2.9, MacOS X 10.5, FreeBSD 5.2.1, AIX 5.2, HP-UX 11.31, IRIX 6.5, OSF/1 5.1, Solaris 11 2010-11, Cygwin, mingw, Interix 3.5, BeOS.

+@item
+On platforms where @code{off_t} is a 32-bit type, this function may not
+work correctly on files larger than 2 GB.  The fix is to use the
+@code{AC_SYS_LARGEFILE} macro.

 @end itemize
 @end itemize

diff --git a/doc/glibc-functions/sendfile.texi b/doc/glibc-functions/sendfile.texi
index 756f6bd9f9a603be4f88eb5c1b6fef99b09f2310..3870f16828005a82c4b7e0d59c8252515ba9c3a0 100644 (file)
--- a/doc/glibc-functions/sendfile.texi
+++ b/doc/glibc-functions/sendfile.texi
@@ -13,4 +13,8 @@ Portability problems not fixed by Gnulib:
 @item
 This function is missing on some platforms:
 MacOS X 10.4, NetBSD 5.0, OpenBSD 3.8, AIX 5.1, IRIX 6.5, OSF/1 4.0, Solaris 11 2010-11, Cygwin, mingw, Interix 3.5, BeOS.
 @item
 This function is missing on some platforms:
 MacOS X 10.4, NetBSD 5.0, OpenBSD 3.8, AIX 5.1, IRIX 6.5, OSF/1 4.0, Solaris 11 2010-11, Cygwin, mingw, Interix 3.5, BeOS.

+@item
+On platforms where @code{off_t} is a 32-bit type, this function may not
+work correctly on files larger than 2 GB.  The fix is to use the
+@code{AC_SYS_LARGEFILE} macro.

 @end itemize
 @end itemize

diff --git a/doc/glibc-functions/statfs.texi b/doc/glibc-functions/statfs.texi
index b2182b10b5d5e001dbb9d100ea0607b3d20d2b46..8fcee65677549b9fcf0c533f5b31144a92efcab2 100644 (file)
--- a/doc/glibc-functions/statfs.texi
+++ b/doc/glibc-functions/statfs.texi
@@ -13,4 +13,9 @@ Portability problems not fixed by Gnulib:
 @item
 This function is missing on some platforms:
 AIX 5.1, mingw, Interix 3.5, BeOS.
 @item
 This function is missing on some platforms:
 AIX 5.1, mingw, Interix 3.5, BeOS.

+@item
+On platforms where @code{f_blocks} in @samp{struct statfs} is a 32-bit
+value, this function may not work correctly on files systems larger than
+4 TiB.  The fix is to use the @code{AC_SYS_LARGEFILE} macro.  This affects
+MacOS X.

 @end itemize
 @end itemize

diff --git a/doc/posix-functions/aio_cancel.texi b/doc/posix-functions/aio_cancel.texi
index 44f2687ff0639b244323e18a228308837d50c8d9..86e89a438f7b849351d5e14401459c4df10383d8 100644 (file)
--- a/doc/posix-functions/aio_cancel.texi
+++ b/doc/posix-functions/aio_cancel.texi
@@ -15,4 +15,8 @@ Portability problems not fixed by Gnulib:
 @item
 This function is missing on some platforms:
 NetBSD 3.0, OpenBSD 3.8, OSF/1 5.1, Solaris 2.4, Cygwin, mingw, Interix 3.5, BeOS.
 @item
 This function is missing on some platforms:
 NetBSD 3.0, OpenBSD 3.8, OSF/1 5.1, Solaris 2.4, Cygwin, mingw, Interix 3.5, BeOS.

+@item
+On platforms where @code{off_t} is a 32-bit type, this function may not
+work correctly on files larger than 2 GB.  The fix is to use the
+@code{AC_SYS_LARGEFILE} macro.

 @end itemize
 @end itemize

diff --git a/doc/posix-functions/aio_error.texi b/doc/posix-functions/aio_error.texi
index 43de4fc21b4d203e9602fec9159e1ddc07c9957d..971f4c0affa003ca898ae99408873f7b3cff5ca6 100644 (file)
--- a/doc/posix-functions/aio_error.texi
+++ b/doc/posix-functions/aio_error.texi
@@ -15,4 +15,8 @@ Portability problems not fixed by Gnulib:
 @item
 This function is missing on some platforms:
 NetBSD 3.0, OpenBSD 3.8, AIX 5.1, OSF/1 5.1, Solaris 2.4, Cygwin, mingw, Interix 3.5, BeOS.
 @item
 This function is missing on some platforms:
 NetBSD 3.0, OpenBSD 3.8, AIX 5.1, OSF/1 5.1, Solaris 2.4, Cygwin, mingw, Interix 3.5, BeOS.

+@item
+On platforms where @code{off_t} is a 32-bit type, this function may not
+work correctly on files larger than 2 GB.  The fix is to use the
+@code{AC_SYS_LARGEFILE} macro.

 @end itemize
 @end itemize

diff --git a/doc/posix-functions/aio_fsync.texi b/doc/posix-functions/aio_fsync.texi
index a77a264b7299a88f6c28b20566ad7f980d3d48a2..38d6f6888409e8f82fbc5e07048f2c3d859e02a6 100644 (file)
--- a/doc/posix-functions/aio_fsync.texi
+++ b/doc/posix-functions/aio_fsync.texi
@@ -15,4 +15,8 @@ Portability problems not fixed by Gnulib:
 @item
 This function is missing on some platforms:
 FreeBSD 6.0, NetBSD 3.0, OpenBSD 3.8, AIX 5.1, OSF/1 5.1, Solaris 2.4, Cygwin, mingw, Interix 3.5, BeOS.
 @item
 This function is missing on some platforms:
 FreeBSD 6.0, NetBSD 3.0, OpenBSD 3.8, AIX 5.1, OSF/1 5.1, Solaris 2.4, Cygwin, mingw, Interix 3.5, BeOS.

+@item
+On platforms where @code{off_t} is a 32-bit type, this function may not
+work correctly on files larger than 2 GB.  The fix is to use the
+@code{AC_SYS_LARGEFILE} macro.

 @end itemize
 @end itemize

diff --git a/doc/posix-functions/aio_read.texi b/doc/posix-functions/aio_read.texi
index e2a99d2b62ec9d2420d35d0f2984318b43826054..b216df7591abe73fa675bd622f27b2ee95d3e59a 100644 (file)
--- a/doc/posix-functions/aio_read.texi
+++ b/doc/posix-functions/aio_read.texi
@@ -15,4 +15,8 @@ Portability problems not fixed by Gnulib:
 @item
 This function is missing on some platforms:
 NetBSD 3.0, OpenBSD 3.8, OSF/1 5.1, Solaris 2.4, Cygwin, mingw, Interix 3.5, BeOS.
 @item
 This function is missing on some platforms:
 NetBSD 3.0, OpenBSD 3.8, OSF/1 5.1, Solaris 2.4, Cygwin, mingw, Interix 3.5, BeOS.

+@item
+On platforms where @code{off_t} is a 32-bit type, this function may not
+work correctly on files larger than 2 GB.  The fix is to use the
+@code{AC_SYS_LARGEFILE} macro.

 @end itemize
 @end itemize

diff --git a/doc/posix-functions/aio_return.texi b/doc/posix-functions/aio_return.texi
index 9dff96824ab3dfde16cc3fabf3b4aae94bc873d0..15d3214f8a15be1a3ff840105575c51e85236d04 100644 (file)
--- a/doc/posix-functions/aio_return.texi
+++ b/doc/posix-functions/aio_return.texi
@@ -15,4 +15,8 @@ Portability problems not fixed by Gnulib:
 @item
 This function is missing on some platforms:
 NetBSD 3.0, OpenBSD 3.8, AIX 5.1, OSF/1 5.1, Solaris 2.4, Cygwin, mingw, Interix 3.5, BeOS.
 @item
 This function is missing on some platforms:
 NetBSD 3.0, OpenBSD 3.8, AIX 5.1, OSF/1 5.1, Solaris 2.4, Cygwin, mingw, Interix 3.5, BeOS.

+@item
+On platforms where @code{off_t} is a 32-bit type, this function may not
+work correctly on files larger than 2 GB.  The fix is to use the
+@code{AC_SYS_LARGEFILE} macro.

 @end itemize
 @end itemize

diff --git a/doc/posix-functions/aio_suspend.texi b/doc/posix-functions/aio_suspend.texi
index 57e04995948e2ac13b275a7f6fd32dc7359a8725..f40a12454478fdde92c2397380940df0288b4a3b 100644 (file)
--- a/doc/posix-functions/aio_suspend.texi
+++ b/doc/posix-functions/aio_suspend.texi
@@ -15,4 +15,8 @@ Portability problems not fixed by Gnulib:
 @item
 This function is missing on some platforms:
 NetBSD 3.0, OpenBSD 3.8, OSF/1 5.1, Solaris 2.4, Cygwin, mingw, Interix 3.5, BeOS.
 @item
 This function is missing on some platforms:
 NetBSD 3.0, OpenBSD 3.8, OSF/1 5.1, Solaris 2.4, Cygwin, mingw, Interix 3.5, BeOS.

+@item
+On platforms where @code{off_t} is a 32-bit type, this function may not
+work correctly on files larger than 2 GB.  The fix is to use the
+@code{AC_SYS_LARGEFILE} macro.

 @end itemize
 @end itemize

diff --git a/doc/posix-functions/aio_write.texi b/doc/posix-functions/aio_write.texi
index 57a8eed0743428efdc596b7c91c529508fe66427..9f1337c6505685b285ad2455b13507ca1b2c579b 100644 (file)
--- a/doc/posix-functions/aio_write.texi
+++ b/doc/posix-functions/aio_write.texi
@@ -15,4 +15,8 @@ Portability problems not fixed by Gnulib:
 @item
 This function is missing on some platforms:
 NetBSD 3.0, OpenBSD 3.8, OSF/1 5.1, Solaris 2.4, Cygwin, mingw, Interix 3.5, BeOS.
 @item
 This function is missing on some platforms:
 NetBSD 3.0, OpenBSD 3.8, OSF/1 5.1, Solaris 2.4, Cygwin, mingw, Interix 3.5, BeOS.

+@item
+On platforms where @code{off_t} is a 32-bit type, this function may not
+work correctly on files larger than 2 GB.  The fix is to use the
+@code{AC_SYS_LARGEFILE} macro.

 @end itemize
 @end itemize

diff --git a/doc/posix-functions/fgetpos.texi b/doc/posix-functions/fgetpos.texi
index ecdc0cd8305584d556aeb0f4bdc8c9dc35366cf6..52ffc1288f29add4b3daa7211811bdc2b52970be 100644 (file)
--- a/doc/posix-functions/fgetpos.texi
+++ b/doc/posix-functions/fgetpos.texi
@@ -17,6 +17,10 @@ Portability problems not fixed by Gnulib:
 on input streams that are opened in @code{O_TEXT} mode and whose contents
 contains Unix line terminators (LF), on some platforms: mingw.
 @item
 on input streams that are opened in @code{O_TEXT} mode and whose contents
 contains Unix line terminators (LF), on some platforms: mingw.
 @item

+On platforms where @code{off_t} is a 32-bit type, this function may not
+work correctly on files larger than 2 GB.  The fix is to use the
+@code{AC_SYS_LARGEFILE} macro.
+@item

 On platforms where @code{off_t} is a 64-bit type, but @code{fseeko} is
 not present, stream operations on files larger than 2 GB silently do
 the wrong thing.  This affects BSD/OS, which is mostly obsolete.
 On platforms where @code{off_t} is a 64-bit type, but @code{fseeko} is
 not present, stream operations on files larger than 2 GB silently do
 the wrong thing.  This affects BSD/OS, which is mostly obsolete.

diff --git a/doc/posix-functions/fopen.texi b/doc/posix-functions/fopen.texi
index 3affa3981c09ee5198d92649cd8ccdee0bef762c..77f671d36c10a4c830d0a1c590746f8429c6d5ff 100644 (file)
--- a/doc/posix-functions/fopen.texi
+++ b/doc/posix-functions/fopen.texi
@@ -28,6 +28,10 @@ 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
 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 platforms where @code{off_t} is a 32-bit type, @code{fopen} may not work
+correctly with files larger than 2 GB.  The fix is to use the
+@code{AC_SYS_LARGEFILE} macro.
+@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
 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

diff --git a/doc/posix-functions/freopen.texi b/doc/posix-functions/freopen.texi
index b33b5aeac04f0ad127cfd6d15fb4135b823ba275..23595e003c336cdec7e1fe77739034a39da0f05f 100644 (file)
--- a/doc/posix-functions/freopen.texi
+++ b/doc/posix-functions/freopen.texi
@@ -24,6 +24,10 @@ 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
 directory, on some platforms:
 HP-UX 11.00, Solaris 9, Irix 5.3.
 @item

+On platforms where @code{off_t} is a 32-bit type, @code{freopen} may not work
+correctly with files larger than 2 GB.  The fix is to use the
+@code{AC_SYS_LARGEFILE} macro.
+@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},
 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},

diff --git a/doc/posix-functions/fsetpos.texi b/doc/posix-functions/fsetpos.texi
index 8cf598d4e71188e6d63692a8fbe274a7288bd4b8..547f866a21b63481e4a454233f6b5275bd9502f7 100644 (file)
--- a/doc/posix-functions/fsetpos.texi
+++ b/doc/posix-functions/fsetpos.texi
@@ -12,4 +12,8 @@ Portability problems fixed by Gnulib:
 
 Portability problems not fixed by Gnulib:
 @itemize
 
 Portability problems not fixed by Gnulib:
 @itemize

+@item
+On platforms where @code{off_t} is a 32-bit type, this function may not
+work correctly on files larger than 2 GB.  The fix is to use the
+@code{AC_SYS_LARGEFILE} macro.

 @end itemize
 @end itemize

diff --git a/doc/posix-functions/fstatvfs.texi b/doc/posix-functions/fstatvfs.texi
index 87831e97ffd12db475de458bd1aa69ff8212ab81..a17c816af22acc6ad7bdcfa5ac6f56053c1ccf51 100644 (file)
--- a/doc/posix-functions/fstatvfs.texi
+++ b/doc/posix-functions/fstatvfs.texi
@@ -15,4 +15,9 @@ Portability problems not fixed by Gnulib:
 @item
 This function is missing on some platforms:
 MacOS X 10.3, OpenBSD 3.8, mingw.
 @item
 This function is missing on some platforms:
 MacOS X 10.3, OpenBSD 3.8, mingw.

+@item
+On platforms where @code{f_blocks} in @samp{struct statvfs} is a 32-bit
+value, this function may not work correctly on files systems larger than
+4 TiB.  The fix is to use the @code{AC_SYS_LARGEFILE} macro.  This affects
+glibc/Hurd, HP-UX 11, Solaris.

 @end itemize
 @end itemize

diff --git a/doc/posix-functions/ftruncate.texi b/doc/posix-functions/ftruncate.texi
index ebd8f27ebe2708f5949040f5b5d5a8859547a538..60d31882b5ee76d3aae974109ae9fd44981fb119 100644 (file)
--- a/doc/posix-functions/ftruncate.texi
+++ b/doc/posix-functions/ftruncate.texi
@@ -12,4 +12,8 @@ Portability problems fixed by Gnulib:
 
 Portability problems not fixed by Gnulib:
 @itemize
 
 Portability problems not fixed by Gnulib:
 @itemize

+@item
+On platforms where @code{off_t} is a 32-bit type, this function is not
+applicable to arbitrary lengths for files larger than 2 GB.  The fix is to
+use the @code{AC_SYS_LARGEFILE} macro.

 @end itemize
 @end itemize

diff --git a/doc/posix-functions/ftw.texi b/doc/posix-functions/ftw.texi
index 1ec2472842d1eaa0cf9964ff2eb84757898b9468..cc84ec57a4eed50a227e37dd4d02fcb6676c27d0 100644 (file)
--- a/doc/posix-functions/ftw.texi
+++ b/doc/posix-functions/ftw.texi
@@ -15,4 +15,8 @@ Portability problems not fixed by Gnulib:
 @item
 This function is missing on some platforms:
 MacOS X 10.3, FreeBSD 5.2.1, NetBSD 3.0, mingw, BeOS.
 @item
 This function is missing on some platforms:
 MacOS X 10.3, FreeBSD 5.2.1, NetBSD 3.0, mingw, BeOS.

+@item
+On platforms where @code{off_t} is a 32-bit type, this function may not
+correctly report the size of files or block devices larger than 2 GB.
+The fix is to use the @code{AC_SYS_LARGEFILE} macro.

 @end itemize
 @end itemize

diff --git a/doc/posix-functions/getrlimit.texi b/doc/posix-functions/getrlimit.texi
index 5cc92519505be421fef1972493452af14c329ab0..61377a1c316e782204ff6f23b8ceb5e6791eb76f 100644 (file)
--- a/doc/posix-functions/getrlimit.texi
+++ b/doc/posix-functions/getrlimit.texi
@@ -15,4 +15,8 @@ Portability problems not fixed by Gnulib:
 @item
 This function is missing on some platforms:
 mingw, BeOS.
 @item
 This function is missing on some platforms:
 mingw, BeOS.

+@item
+On platforms where @code{rlim_t} is a 32-bit type, this function does not
+allow to retrieve limits larger than 4 GB, such as for RLIMIT_FSIZE.  The
+fix is to use the @code{AC_SYS_LARGEFILE} macro.

 @end itemize
 @end itemize

diff --git a/doc/posix-functions/glob.texi b/doc/posix-functions/glob.texi
index 96ae5ff4dc0525335762459fbeb3f10810d3bbf4..1f236bf0cb65af1b54566c351b79e9480b64cd3e 100644 (file)
--- a/doc/posix-functions/glob.texi
+++ b/doc/posix-functions/glob.texi
@@ -19,5 +19,9 @@ on some platforms.
 Portability problems not fixed by Gnulib:
 @itemize
 @item
 Portability problems not fixed by Gnulib:
 @itemize
 @item

+On platforms where @code{off_t} is a 32-bit type, this function may not
+work correctly on huge directories larger than 2 GB.  The fix is to use
+the @code{AC_SYS_LARGEFILE} macro.
+@item

 Some platforms may store additional flags in the @code{gl_flags} field.
 @end itemize
 Some platforms may store additional flags in the @code{gl_flags} field.
 @end itemize

diff --git a/doc/posix-functions/lio_listio.texi b/doc/posix-functions/lio_listio.texi
index 35b75ff61b9ceef9abf637ce4008290bd0fc8730..b3c06eba2d3496309837c5a1bddf8e86381c309c 100644 (file)
--- a/doc/posix-functions/lio_listio.texi
+++ b/doc/posix-functions/lio_listio.texi
@@ -15,4 +15,8 @@ Portability problems not fixed by Gnulib:
 @item
 This function is missing on some platforms:
 NetBSD 3.0, OpenBSD 3.8, OSF/1 5.1, Solaris 2.4, Cygwin, mingw, Interix 3.5, BeOS.
 @item
 This function is missing on some platforms:
 NetBSD 3.0, OpenBSD 3.8, OSF/1 5.1, Solaris 2.4, Cygwin, mingw, Interix 3.5, BeOS.

+@item
+On platforms where @code{off_t} is a 32-bit type, this function may not
+work correctly on files larger than 2 GB.  The fix is to use the
+@code{AC_SYS_LARGEFILE} macro.

 @end itemize
 @end itemize

diff --git a/doc/posix-functions/lockf.texi b/doc/posix-functions/lockf.texi
index 329dc8d732f2f314cfe3904f59eacf90e031b11b..a68a62385a5377ef64fe18cd558c27d6b8cc061f 100644 (file)
--- a/doc/posix-functions/lockf.texi
+++ b/doc/posix-functions/lockf.texi
@@ -15,4 +15,8 @@ Portability problems not fixed by Gnulib:
 @item
 This function is missing on some platforms:
 Cygwin 1.5.x, mingw, BeOS.
 @item
 This function is missing on some platforms:
 Cygwin 1.5.x, mingw, BeOS.

+@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.

 @end itemize
 @end itemize

diff --git a/doc/posix-functions/mkstemp.texi b/doc/posix-functions/mkstemp.texi
index ebe8c50c8bdf83ce06fd313088cd097cf8aebc0e..b31bd07bc9a9ff0d7831f677be9e3b3fc59768c1 100644 (file)
--- a/doc/posix-functions/mkstemp.texi
+++ b/doc/posix-functions/mkstemp.texi
@@ -27,6 +27,10 @@ writable or readable file, if you haven't set the process umask to
 
 Portability problems not fixed by Gnulib:
 @itemize
 
 Portability problems not fixed by Gnulib:
 @itemize

+@item
+On platforms where @code{off_t} is a 32-bit type, @code{mkstemp} may not work
+correctly to create files larger than 2 GB.  The fix is to use the
+@code{AC_SYS_LARGEFILE} macro.

 @end itemize
 
 The gnulib module @code{clean-temp} can create temporary files that will not
 @end itemize
 
 The gnulib module @code{clean-temp} can create temporary files that will not

diff --git a/doc/posix-functions/mmap.texi b/doc/posix-functions/mmap.texi
index 4343e3f5e90a8bede105df4ae8c8f785d301d901..8e3e5f330d86230452875a6fdd19bed914d6da86 100644 (file)
--- a/doc/posix-functions/mmap.texi
+++ b/doc/posix-functions/mmap.texi
@@ -16,6 +16,10 @@ Portability problems not fixed by Gnulib:
 This function is missing on some platforms:
 mingw, BeOS.
 @item
 This function is missing on some platforms:
 mingw, BeOS.
 @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.
+@item

 To get anonymous memory, on some platforms, you can use the flags
 @code{MAP_ANONYMOUS | MAP_PRIVATE} and @code{-1} instead of a file descriptor;
 on others you have to use a read-only file descriptor of @file{/dev/zero}.
 To get anonymous memory, on some platforms, you can use the flags
 @code{MAP_ANONYMOUS | MAP_PRIVATE} and @code{-1} instead of a file descriptor;
 on others you have to use a read-only file descriptor of @file{/dev/zero}.

diff --git a/doc/posix-functions/nftw.texi b/doc/posix-functions/nftw.texi
index bd915b01626da7be842947418a54b2daeb2638dc..a4bfaf6f0d6e2bbcc33c8bdbe31826305a0c4e17 100644 (file)
--- a/doc/posix-functions/nftw.texi
+++ b/doc/posix-functions/nftw.texi
@@ -15,4 +15,8 @@ Portability problems not fixed by Gnulib:
 @item
 This function is missing on some platforms:
 MacOS X 10.3, FreeBSD 5.2.1, NetBSD 3.0, mingw, BeOS.
 @item
 This function is missing on some platforms:
 MacOS X 10.3, FreeBSD 5.2.1, NetBSD 3.0, mingw, BeOS.

+@item
+On platforms where @code{off_t} is a 32-bit type, this function may not
+correctly report the size of files or block devices larger than 2 GB.
+The fix is to use the @code{AC_SYS_LARGEFILE} macro.

 @end itemize
 @end itemize

diff --git a/doc/posix-functions/openat.texi b/doc/posix-functions/openat.texi
index 4f494b2df1fa411048ff7941d85f19b770e263c6..6311515416b8dc82c5f475bf3c7cae9d390fc8b5 100644 (file)
--- a/doc/posix-functions/openat.texi
+++ b/doc/posix-functions/openat.texi
@@ -22,4 +22,8 @@ Solaris 9.
 
 Portability problems not fixed by Gnulib:
 @itemize
 
 Portability problems not fixed by Gnulib:
 @itemize

+@item
+On platforms where @code{off_t} is a 32-bit type, @code{open} may not work
+correctly with files larger than 2 GB.  The fix is to use the
+@code{AC_SYS_LARGEFILE} macro.

 @end itemize
 @end itemize

diff --git a/doc/posix-functions/opendir.texi b/doc/posix-functions/opendir.texi
index b86734341bb066653aae94213b7c3d391897564d..e004987efcd7378034283a0057baf3242c41b249 100644 (file)
--- a/doc/posix-functions/opendir.texi
+++ b/doc/posix-functions/opendir.texi
@@ -12,4 +12,9 @@ Portability problems fixed by Gnulib:
 
 Portability problems not fixed by Gnulib:
 @itemize
 
 Portability problems not fixed by Gnulib:
 @itemize

+@item
+On platforms where @code{off_t} is a 32-bit type, this function may not
+work correctly on huge directories larger than 2 GB.  Also, on platforms
+where @code{ino_t} is a 32-bit type, this function may report inode numbers
+incorrectly.  The fix is to use the @code{AC_SYS_LARGEFILE} macro.

 @end itemize
 @end itemize

diff --git a/doc/posix-functions/posix_fadvise.texi b/doc/posix-functions/posix_fadvise.texi
index b84971845335c39474087da3909f453feaca0f27..277b1223a217141d7beb028f980f89b0105f8fbe 100644 (file)
--- a/doc/posix-functions/posix_fadvise.texi
+++ b/doc/posix-functions/posix_fadvise.texi
@@ -16,4 +16,8 @@ Portability problems not fixed by Gnulib:
 This function is missing on some platforms:
 MacOS X 10.5, FreeBSD 6.0, NetBSD 3.0, OpenBSD 3.8, AIX 5.1, HP-UX 11.23,
 IRIX 6.5, OSF/1 5.1, Solaris 10, Cygwin 1.5.x, mingw, Interix 3.5, BeOS.
 This function is missing on some platforms:
 MacOS X 10.5, FreeBSD 6.0, NetBSD 3.0, OpenBSD 3.8, AIX 5.1, HP-UX 11.23,
 IRIX 6.5, OSF/1 5.1, Solaris 10, Cygwin 1.5.x, mingw, Interix 3.5, BeOS.

+@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.

 @end itemize
 @end itemize

diff --git a/doc/posix-functions/posix_fallocate.texi b/doc/posix-functions/posix_fallocate.texi
index 372a6194509badbdf6d538d48b20310f9ef3aac4..03ccd54e2699a3df0e6335fd4d1bb62b2e52ed45 100644 (file)
--- a/doc/posix-functions/posix_fallocate.texi
+++ b/doc/posix-functions/posix_fallocate.texi
@@ -16,4 +16,8 @@ Portability problems not fixed by Gnulib:
 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 10, Cygwin 1.5.x, mingw, Interix 3.5, BeOS.
 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 10, Cygwin 1.5.x, mingw, Interix 3.5, BeOS.

+@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.

 @end itemize
 @end itemize

diff --git a/doc/posix-functions/pread.texi b/doc/posix-functions/pread.texi
index 0a4fc7c1caed75df2a8d52f465c3ca2503877dd1..b86e8a412fa926dde37e800efc80cdf652226ca1 100644 (file)
--- a/doc/posix-functions/pread.texi
+++ b/doc/posix-functions/pread.texi
@@ -22,4 +22,8 @@ HP-UX 11.31.
 
 Portability problems not fixed by Gnulib:
 @itemize
 
 Portability problems not fixed by Gnulib:
 @itemize

+@item
+On platforms where @code{off_t} is a 32-bit type, this function may not
+work correctly on files larger than 2 GB.  The fix is to use the
+@code{AC_SYS_LARGEFILE} macro.

 @end itemize
 @end itemize

diff --git a/doc/posix-functions/pwrite.texi b/doc/posix-functions/pwrite.texi
index 599c7d2a918d7edf67cab6f51f3829f95e7eb06b..713e07e4db6dde56aac8cbbb3b0f9b54c7ff4cf5 100644 (file)
--- a/doc/posix-functions/pwrite.texi
+++ b/doc/posix-functions/pwrite.texi
@@ -23,4 +23,8 @@ HP-UX 11.11.
 
 Portability problems not fixed by Gnulib:
 @itemize
 
 Portability problems not fixed by Gnulib:
 @itemize

+@item
+On platforms where @code{off_t} is a 32-bit type, this function may not
+work correctly on files larger than 2 GB.  The fix is to use the
+@code{AC_SYS_LARGEFILE} macro.

 @end itemize
 @end itemize

diff --git a/doc/posix-functions/readdir.texi b/doc/posix-functions/readdir.texi
index 8b5331c75a82141d4986d338793f85410a226729..8bed94f18d1e8d18621264391e696b6c084516f1 100644 (file)
--- a/doc/posix-functions/readdir.texi
+++ b/doc/posix-functions/readdir.texi
@@ -12,4 +12,9 @@ Portability problems fixed by Gnulib:
 
 Portability problems not fixed by Gnulib:
 @itemize
 
 Portability problems not fixed by Gnulib:
 @itemize

+@item
+On platforms where @code{off_t} is a 32-bit type, this function may not
+work correctly on huge directories larger than 2 GB.  Also, on platforms
+where @code{ino_t} is a 32-bit type, this function may report inode numbers
+incorrectly.  The fix is to use the @code{AC_SYS_LARGEFILE} macro.

 @end itemize
 @end itemize

diff --git a/doc/posix-functions/readdir_r.texi b/doc/posix-functions/readdir_r.texi
index 7cebe2799feaa17129cb04c717cef6b3c0ce069f..5bcdc1473b097d33ba2d357bb237dd0729f9664a 100644 (file)
--- a/doc/posix-functions/readdir_r.texi
+++ b/doc/posix-functions/readdir_r.texi
@@ -18,4 +18,9 @@ Portability problems not fixed by Gnulib:
 @item
 This function is missing on some platforms:
 mingw, BeOS.
 @item
 This function is missing on some platforms:
 mingw, BeOS.

+@item
+On platforms where @code{off_t} is a 32-bit type, this function may not
+work correctly on huge directories larger than 2 GB.  Also, on platforms
+where @code{ino_t} is a 32-bit type, this function may report inode numbers
+incorrectly.  The fix is to use the @code{AC_SYS_LARGEFILE} macro.

 @end itemize
 @end itemize

diff --git a/doc/posix-functions/rewinddir.texi b/doc/posix-functions/rewinddir.texi
index 67dd286870fbf3f2b04e8c024c9d44b2704025d1..4492d4f386d0005daa4d0e3b7e460754ef604052 100644 (file)
--- a/doc/posix-functions/rewinddir.texi
+++ b/doc/posix-functions/rewinddir.texi
@@ -12,4 +12,8 @@ Portability problems fixed by Gnulib:
 
 Portability problems not fixed by Gnulib:
 @itemize
 
 Portability problems not fixed by Gnulib:
 @itemize

+@item
+On platforms where @code{long int} is a 32-bit type, this function may not
+work correctly on huge directories larger than 2 GB.  The fix is to use
+the @code{AC_SYS_LARGEFILE} macro (only on MacOS X systems).

 @end itemize
 @end itemize

diff --git a/doc/posix-functions/scandir.texi b/doc/posix-functions/scandir.texi
index 2065c6eea1695c453cfb84af3542f7fe54a79459..6a7f2942894b621e7b47745afc95fe5113e3516b 100644 (file)
--- a/doc/posix-functions/scandir.texi
+++ b/doc/posix-functions/scandir.texi
@@ -21,4 +21,9 @@ glibc 2.3.6, MacOS X 10.5, FreeBSD 6.0, NetBSD 5.0, OpenBSD 3.8, Interix 3.5.
 @item
 The fourth parameter of this function is declared as @code{int (*) (void *, void *)} on some platforms:
 AIX 5.1.
 @item
 The fourth parameter of this function is declared as @code{int (*) (void *, void *)} on some platforms:
 AIX 5.1.

+@item
+On platforms where @code{off_t} is a 32-bit type, this function may not
+work correctly on huge directories larger than 2 GB.  Also, on platforms
+where @code{ino_t} is a 32-bit type, this function may report inode numbers
+incorrectly.  The fix is to use the @code{AC_SYS_LARGEFILE} macro.

 @end itemize
 @end itemize

diff --git a/doc/posix-functions/seekdir.texi b/doc/posix-functions/seekdir.texi
index b5a9ebecc8d473fb3a33854d3853d313735e47de..d1e8eebba5aaebcf7b68ad44e09500d8ec084e9e 100644 (file)
--- a/doc/posix-functions/seekdir.texi
+++ b/doc/posix-functions/seekdir.texi
@@ -15,4 +15,8 @@ Portability problems not fixed by Gnulib:
 @item
 This function is missing on some platforms:
 BeOS.
 @item
 This function is missing on some platforms:
 BeOS.

+@item
+On platforms where @code{long int} is a 32-bit type, this function may not
+work correctly on huge directories larger than 2 GB.  The fix is to use
+the @code{AC_SYS_LARGEFILE} macro (only on MacOS X systems).

 @end itemize
 @end itemize

diff --git a/doc/posix-functions/setrlimit.texi b/doc/posix-functions/setrlimit.texi
index bc223aa41693787da4f9ddc4974da9ca680a8838..a3abf0e7ca40162de411879b2ca5356f3e78fad3 100644 (file)
--- a/doc/posix-functions/setrlimit.texi
+++ b/doc/posix-functions/setrlimit.texi
@@ -15,4 +15,8 @@ Portability problems not fixed by Gnulib:
 @item
 This function is missing on some platforms:
 mingw, BeOS.
 @item
 This function is missing on some platforms:
 mingw, BeOS.

+@item
+On platforms where @code{rlim_t} is a 32-bit type, this function does not
+allow to set limits larger than 4 GB, such as for RLIMIT_FSIZE.  The fix is
+to use the @code{AC_SYS_LARGEFILE} macro.

 @end itemize
 @end itemize

diff --git a/doc/posix-functions/statvfs.texi b/doc/posix-functions/statvfs.texi
index 59a7f65044cbc16f3d2daf058121bc7343246705..d0133555b3f324e5ec99f53aa7c223d14b1112d2 100644 (file)
--- a/doc/posix-functions/statvfs.texi
+++ b/doc/posix-functions/statvfs.texi
@@ -15,6 +15,11 @@ Portability problems not fixed by Gnulib:
 @item
 This function is missing on some platforms:
 MacOS X 10.3, OpenBSD 3.8, mingw.
 @item
 This function is missing on some platforms:
 MacOS X 10.3, OpenBSD 3.8, mingw.

+@item
+On platforms where @code{f_blocks} in @samp{struct statvfs} is a 32-bit
+value, this function may not work correctly on files systems larger than
+4 TiB.  The fix is to use the @code{AC_SYS_LARGEFILE} macro.  This affects
+glibc/Hurd, HP-UX 11, Solaris.

 @end itemize
 
 Gnulib provides a module @code{fsusage} that provides similar information
 @end itemize
 
 Gnulib provides a module @code{fsusage} that provides similar information

diff --git a/doc/posix-functions/telldir.texi b/doc/posix-functions/telldir.texi
index 60942183cfcb12e70b8b976247e8564dd929f6b7..88b19080ba0e8c686a9722a55898e0345c4b8625 100644 (file)
--- a/doc/posix-functions/telldir.texi
+++ b/doc/posix-functions/telldir.texi
@@ -15,4 +15,8 @@ Portability problems not fixed by Gnulib:
 @item
 This function is missing on some platforms:
 BeOS.
 @item
 This function is missing on some platforms:
 BeOS.

+@item
+On platforms where @code{long int} is a 32-bit type, this function may not
+work correctly on huge directories larger than 2 GB.  The fix is to use
+the @code{AC_SYS_LARGEFILE} macro (only on MacOS X systems).

 @end itemize
 @end itemize

diff --git a/doc/posix-functions/tmpfile.texi b/doc/posix-functions/tmpfile.texi
index 7ce07781c845aa68b4c7cd0aca5400d511273687..186683603c32c12825ed8ac5990a6c3ecf40356f 100644 (file)
--- a/doc/posix-functions/tmpfile.texi
+++ b/doc/posix-functions/tmpfile.texi
@@ -15,4 +15,8 @@ mingw.
 
 Portability problems not fixed by Gnulib:
 @itemize
 
 Portability problems not fixed by Gnulib:
 @itemize

+@item
+On platforms where @code{off_t} is a 32-bit type, @code{tmpfile} may not work
+correctly to create files larger than 2 GB.  The fix is to use the
+@code{AC_SYS_LARGEFILE} macro.

 @end itemize
 @end itemize

diff --git a/doc/posix-functions/truncate.texi b/doc/posix-functions/truncate.texi
index eb10406197878795c60a411056df6b3c525aeb17..55e7f1a43d2bf025977ca2758c5c96ea9a0610e0 100644 (file)
--- a/doc/posix-functions/truncate.texi
+++ b/doc/posix-functions/truncate.texi
@@ -15,4 +15,8 @@ Portability problems not fixed by Gnulib:
 @item
 This function is missing on some platforms:
 mingw.
 @item
 This function is missing on some platforms:
 mingw.

+@item
+On platforms where @code{off_t} is a 32-bit type, this function is not
+applicable to arbitrary lengths for files larger than 2 GB.  The fix is to
+use the @code{AC_SYS_LARGEFILE} macro.

 @end itemize
 @end itemize