]> Savannah Git Hosting - gnulib.git/commitdiff
doc: improve cross-refs for year 2038 issue
authorPaul Eggert <eggert@cs.ucla.edu>
Mon, 10 Apr 2023 01:16:57 +0000 (18:16 -0700)
committerPaul Eggert <eggert@cs.ucla.edu>
Mon, 10 Apr 2023 01:19:10 +0000 (18:19 -0700)
52 files changed:
ChangeLog
doc/posix-functions/aio_cancel.texi
doc/posix-functions/aio_error.texi
doc/posix-functions/aio_fsync.texi
doc/posix-functions/aio_read.texi
doc/posix-functions/aio_return.texi
doc/posix-functions/aio_suspend.texi
doc/posix-functions/aio_write.texi
doc/posix-functions/creat.texi
doc/posix-functions/fgetpos.texi
doc/posix-functions/fopen.texi
doc/posix-functions/freopen.texi
doc/posix-functions/fseek.texi
doc/posix-functions/fseeko.texi
doc/posix-functions/fsetpos.texi
doc/posix-functions/fstat.texi
doc/posix-functions/fstatat.texi
doc/posix-functions/fstatvfs.texi
doc/posix-functions/ftell.texi
doc/posix-functions/ftello.texi
doc/posix-functions/ftruncate.texi
doc/posix-functions/ftw.texi
doc/posix-functions/getrlimit.texi
doc/posix-functions/glob.texi
doc/posix-functions/lio_listio.texi
doc/posix-functions/lockf.texi
doc/posix-functions/lseek.texi
doc/posix-functions/lstat.texi
doc/posix-functions/mkstemp.texi
doc/posix-functions/mmap.texi
doc/posix-functions/nftw.texi
doc/posix-functions/open.texi
doc/posix-functions/openat.texi
doc/posix-functions/opendir.texi
doc/posix-functions/posix_fadvise.texi
doc/posix-functions/posix_fallocate.texi
doc/posix-functions/pread.texi
doc/posix-functions/pwrite.texi
doc/posix-functions/readdir.texi
doc/posix-functions/readdir_r.texi
doc/posix-functions/rewinddir.texi
doc/posix-functions/scandir.texi
doc/posix-functions/seekdir.texi
doc/posix-functions/setrlimit.texi
doc/posix-functions/stat.texi
doc/posix-functions/statvfs.texi
doc/posix-functions/telldir.texi
doc/posix-functions/tmpfile.texi
doc/posix-functions/truncate.texi
doc/posix-headers/sys_stat.texi
doc/posix-headers/sys_time.texi
doc/posix-headers/sys_types.texi

index 05b11d9f509e0de3cc4cdf0039012e1f3206615a..b71432e249e0e6e2dd502cce219c9d988b08b255 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,8 +1,13 @@
 2023-04-09  Paul Eggert  <eggert@cs.ucla.edu>
 
        largefile: sync from Autoconf master
-       * m4/largefile.m4 (_AC_SYS_LARGEFILE_TEST_INCLUDES):
-       Now an alias for _AC_SYS_LARGEFILE_TEST_CODE.
+       * modules/largefile-required, modules/year2038-required: New modules.
+       * MODULES.html.sh, doc/largefile.texi, doc/posix-headers/time.texi:
+       * doc/year2038.texi: Document this.
+       * m4/largefile.m4: Sync from Autoconf master.
+       Conditionalize the workaround on AC_SYS_LARGEFILE_REQUIRED rather
+       than on AC_SYS_YEAR2038 so that we replace older but still
+       unreleased Autoconf.
        (AC_SYS_LARGEFILE_REQUIRED, AC_SYS_YEAR2038_REQUIRED): New macros.
 
        year2038: configure earlier
index 8228d6a7afa83e102e8f8a9bea6af662bd0e6704..978247515ae742be9d8924b26dceff53a58a2c79 100644 (file)
@@ -8,6 +8,9 @@ Gnulib module: ---
 
 Portability problems fixed by Gnulib:
 @itemize
+@item
+On platforms where @code{off_t} is a 32-bit type, this function may not
+work correctly on files 2 GiB and larger.  @xref{Large File Support}.
 @end itemize
 
 Portability problems not fixed by Gnulib:
@@ -15,8 +18,4 @@ Portability problems not fixed by Gnulib:
 @item
 This function is missing on some platforms:
 NetBSD 3.0, OpenBSD 6.7, Minix 3.1.8, Cygwin 2.9, mingw, MSVC 14, Android 9.0.
-@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
index fd1257c32924e84fb3e1f514f347312ec2091584..9c461f079a193b15f7861bd19b36db794340eff9 100644 (file)
@@ -8,6 +8,9 @@ Gnulib module: ---
 
 Portability problems fixed by Gnulib:
 @itemize
+@item
+On platforms where @code{off_t} is a 32-bit type, this function may not
+work correctly on files 2 GiB and larger.  @xref{Large File Support}.
 @end itemize
 
 Portability problems not fixed by Gnulib:
@@ -15,8 +18,4 @@ Portability problems not fixed by Gnulib:
 @item
 This function is missing on some platforms:
 NetBSD 3.0, OpenBSD 6.7, Minix 3.1.8, AIX 5.1, Cygwin 2.9, mingw, MSVC 14, Android 9.0.
-@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
index 4163e27c6eb654f03bc84825088f2e2735a301a6..8ac2b9afc3d4a1b9fef142bcb2ba32fbdf2a6fd6 100644 (file)
@@ -8,6 +8,9 @@ Gnulib module: ---
 
 Portability problems fixed by Gnulib:
 @itemize
+@item
+On platforms where @code{off_t} is a 32-bit type, this function may not
+work correctly on files 2 GiB and larger.  @xref{Large File Support}.
 @end itemize
 
 Portability problems not fixed by Gnulib:
@@ -15,8 +18,4 @@ Portability problems not fixed by Gnulib:
 @item
 This function is missing on some platforms:
 FreeBSD 6.0, NetBSD 3.0, OpenBSD 6.7, Minix 3.1.8, AIX 5.1, Cygwin 2.9, mingw, MSVC 14, Android 9.0.
-@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
index 4923e556fcc1ab9dfe1f95ee2e0487d89024e64d..57b607064e9f2daf813e57696ce64c9c82e04747 100644 (file)
@@ -8,6 +8,9 @@ Gnulib module: ---
 
 Portability problems fixed by Gnulib:
 @itemize
+@item
+On platforms where @code{off_t} is a 32-bit type, this function may not
+work correctly on files 2 GiB and larger.  @xref{Large File Support}.
 @end itemize
 
 Portability problems not fixed by Gnulib:
@@ -15,8 +18,4 @@ Portability problems not fixed by Gnulib:
 @item
 This function is missing on some platforms:
 NetBSD 3.0, OpenBSD 6.7, Minix 3.1.8, Cygwin 2.9, mingw, MSVC 14, Android 9.0.
-@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
index 40385de0630dae02a212da3ee9ead0d773c792c2..faa62884778980cb0934253bea40ea2a0334b41b 100644 (file)
@@ -8,6 +8,9 @@ Gnulib module: ---
 
 Portability problems fixed by Gnulib:
 @itemize
+@item
+On platforms where @code{off_t} is a 32-bit type, this function may not
+work correctly on files 2 GiB and larger.  @xref{Large File Support}.
 @end itemize
 
 Portability problems not fixed by Gnulib:
@@ -15,8 +18,4 @@ Portability problems not fixed by Gnulib:
 @item
 This function is missing on some platforms:
 NetBSD 3.0, OpenBSD 6.7, Minix 3.1.8, AIX 5.1, Cygwin 2.9, mingw, MSVC 14, Android 9.0.
-@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
index 6d9d421d32aafa20d7a445eb8634d899eafcd9f1..ddf1b720dd856e381eaef3dcd4055f15c68724ff 100644 (file)
@@ -8,6 +8,9 @@ Gnulib module: ---
 
 Portability problems fixed by Gnulib:
 @itemize
+@item
+On platforms where @code{off_t} is a 32-bit type, this function may not
+work correctly on files 2 GiB and larger.  @xref{Large File Support}.
 @end itemize
 
 Portability problems not fixed by Gnulib:
@@ -15,8 +18,4 @@ Portability problems not fixed by Gnulib:
 @item
 This function is missing on some platforms:
 NetBSD 3.0, OpenBSD 6.7, Minix 3.1.8, Cygwin 2.9, mingw, MSVC 14, Android 9.0.
-@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
index 1e82adde593e1cf09ec19eb851d1ebb5c6b4a93c..5d8dfb22ff8e843175f5c19beb237a3d488ef0af 100644 (file)
@@ -8,6 +8,9 @@ Gnulib module: ---
 
 Portability problems fixed by Gnulib:
 @itemize
+@item
+On platforms where @code{off_t} is a 32-bit type, this function may not
+work correctly on files 2 GiB and larger.  @xref{Large File Support}.
 @end itemize
 
 Portability problems not fixed by Gnulib:
@@ -15,8 +18,4 @@ Portability problems not fixed by Gnulib:
 @item
 This function is missing on some platforms:
 NetBSD 3.0, OpenBSD 6.7, Minix 3.1.8, Cygwin 2.9, mingw, MSVC 14, Android 9.0.
-@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
index e7cc57e90c24ea7d982b9feded5a606f43165887..90ce9a4e24723bd5a363420b2cacd88b0f125f12 100644 (file)
@@ -14,7 +14,7 @@ on some platforms:
 MSVC 14.
 @item
 On platforms where @code{off_t} is a 32-bit type, @code{creat} may not work
-correctly with files larger than 2 GB@.  (Cf. @code{AC_SYS_LARGEFILE}.)
+correctly with files 2 GiB and larger.  @xref{Large File Support}.
 @item
 This function does not fail when the file name argument ends in a slash
 and (without the slash) names a nonexistent file, on some platforms:
index 607673ddf6c651c51ceb732933aca563ade5e5fb..89e3acd58fafb45434560ab51b2fb77d5fba4186 100644 (file)
@@ -8,6 +8,9 @@ Gnulib module: ---
 
 Portability problems fixed by Gnulib:
 @itemize
+@item
+On platforms where @code{off_t} is a 32-bit type, this function may not
+work correctly on files 2 GiB and larger.  @xref{Large File Support}.
 @end itemize
 
 Portability problems not fixed by Gnulib:
@@ -16,8 +19,4 @@ Portability problems not fixed by Gnulib:
 @code{fflush}, @code{ftell}, @code{ftello}, @code{fgetpos} behave incorrectly
 on input streams that are opened in @code{O_TEXT} mode and whose contents
 contains Unix line terminators (LF), on some platforms: mingw, MSVC 14.
-@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
index fee872601e03f73d5bdd7760f89ed469651452b2..eb6744e323d68312c2d30e94843a917b08972c8a 100644 (file)
@@ -15,7 +15,7 @@ directory, on some platforms:
 HP-UX 11.00, AIX 7.1, Solaris 9.
 @item
 On platforms where @code{off_t} is a 32-bit type, @code{fopen} may not work
-correctly with files larger than 2 GB@.  (Cf. @code{AC_SYS_LARGEFILE}.)
+correctly with files 2 GiB and larger.  @xref{Large File Support}.
 @item
 On Windows platforms (excluding Cygwin), this function does usually not
 recognize the @file{/dev/null} filename.
index 4b6cd8b13b75a3bd8ff1038f1a8bd49597ddd514..7e075fdd09afcec5b8e47744bdc1c6a2bb5959aa 100644 (file)
@@ -14,7 +14,7 @@ file descriptor, @code{freopen} returns the stream without opening
 the file: glibc 2.24.
 @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}.)
+correctly with files 2 GiB and larger.  @xref{Large File Support}.
 @item
 On Windows platforms (excluding Cygwin), this function does usually not
 recognize the @file{/dev/null} filename.
index d35765826b79011507d7f34d7f25e45bb0dee021..61e3191342f6e57277300dd81aafc740bfbbbb2f 100644 (file)
@@ -20,6 +20,6 @@ On Windows platforms (excluding Cygwin), this function does not set @code{errno}
 upon failure.
 @item
 On platforms where @code{long} is a 32-bit type, @code{fseek} does not work
-correctly with files larger than 2 GB, even when the @code{AC_SYS_LARGEFILE}
+correctly with files 2 GiB and larger, even when the @code{AC_SYS_LARGEFILE}
 macro is used.  The fix is to use @code{fseeko} instead.
 @end itemize
index b3276006243a1526f6949fb22c3f3a88eecf212e..eb3991f6932e1956e0a81852781c736ef4bf8871 100644 (file)
@@ -19,7 +19,7 @@ glibc 2.3.6.
 This function fails on seekable stdin, stdout, and stderr: cygwin <= 1.5.24.
 @item
 On platforms where @code{off_t} is a 32-bit type, @code{fseeko} does not work
-correctly with files larger than 2 GB@.  (Cf. @code{AC_SYS_LARGEFILE}.)
+correctly with files 2 GiB and larger.  @xref{Large File Support}.
 @end itemize
 
 Portability problems not fixed by Gnulib:
index f955970d3874547ff41567f7d7bc032f63f3daa4..f305b90f40065be75683d67b625bd1a23d57cbff 100644 (file)
@@ -8,12 +8,11 @@ Gnulib module: ---
 
 Portability problems fixed by Gnulib:
 @itemize
+@item
+On platforms where @code{off_t} is a 32-bit type, this function may not
+work correctly on files 2 GiB and larger.  @xref{Large File Support}.
 @end 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
index a404891cb70b01ad0a56a293804df82c60cc42ae..b4c2431ff413d16ec408ed9224099cf8aaf76707 100644 (file)
@@ -13,13 +13,13 @@ This function crashes when invoked with invalid arguments on some platforms:
 MSVC 14.
 @item
 On platforms where @code{off_t} is a 32-bit type, @code{fstat} may not correctly
-report the size of files or block devices larger than 2 GB.
-(Cf. @code{AC_SYS_LARGEFILE}.)
+report the size of files or block devices 2 GiB and larger..
+@xref{Large File Support}.
 @item
 On Linux/x86 and Linux/x86_64, applications compiled in 32-bit mode cannot
 access files that happen to have a 64-bit inode number.  This can occur with
 file systems such as XFS (typically on large disks) and NFS.
-(Cf. @code{AC_SYS_LARGEFILE}.)
+@xref{Large File Support}.
 @item
 On Solaris 11.4, when this function yields a timestamp with a
 nonpositive @code{tv_sec} value, @code{tv_nsec} might be in the range
index a37ee428b6c9a2a8ab0a60f050e78e9061920d50..49d394addf14ebc02c8f254e7c38a3fbe3f6a17d 100644 (file)
@@ -16,7 +16,7 @@ But the replacement function is not safe to be used in libraries and is not mult
 @item
 On platforms where @code{off_t} is a 32-bit type, @code{fstatat} may
 not correctly report the size of files or block devices larger than 2
-GB@.  (Cf. @code{AC_SYS_LARGEFILE}.)
+GB@.  @xref{Large File Support}.
 @item
 On some platforms, @code{fstatat(fd,"file/",buf,flag)} succeeds instead of
 failing with @code{ENOTDIR}.
index 805902f21ef68c93c91dab35dc66acb4b0618627..486fb354da8a6cf3ac060e979f494f54b05f60d4 100644 (file)
@@ -8,6 +8,11 @@ Gnulib module: ---
 
 Portability problems fixed by Gnulib:
 @itemize
+@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@.  @xref{Large File Support}.  This affects
+glibc/Hurd, HP-UX 11, Solaris.
 @end itemize
 
 Portability problems not fixed by Gnulib:
@@ -15,9 +20,4 @@ Portability problems not fixed by Gnulib:
 @item
 This function is missing on some platforms:
 OpenBSD 3.8, mingw, MSVC 14, Android 4.3.
-@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
index 3d405bf2a1e32499c81f78b33a1ad211b7908b8c..5a15dee8ea8eaef760e8426c118581f8ce8a860e 100644 (file)
@@ -34,6 +34,6 @@ on input streams that are opened in @code{O_TEXT} mode and whose contents
 contains Unix line terminators (LF), on some platforms: mingw, MSVC 14.
 @item
 On platforms where @code{long} is a 32-bit type, @code{ftell} does not work
-correctly with files larger than 2 GB, even when the @code{AC_SYS_LARGEFILE}
+correctly with files 2 GiB and larger, even when the @code{AC_SYS_LARGEFILE}
 macro is used.  The fix is to use @code{ftello} instead.
 @end itemize
index eab591fca0508449cf439b24ce694c020f4b7a1c..ded1df0c114e7422cf1aed8213671de49a74f47b 100644 (file)
@@ -28,7 +28,7 @@ macOS 10.15 and newer.
 This function fails on seekable stdin, stdout, and stderr: cygwin <= 1.5.24.
 @item
 On platforms where @code{off_t} is a 32-bit type, @code{ftello} does not work
-correctly with files larger than 2 GB@.  (Cf. @code{AC_SYS_LARGEFILE}.)
+correctly with files 2 GiB and larger.  @xref{Large File Support}.
 @end itemize
 
 Portability problems not fixed by Gnulib:
index 2abf1053eee02f48cda2a8353ff1ec1fe9220a31..504d8e9e88b32a637e9033f4a8a528e581381db8 100644 (file)
@@ -12,9 +12,8 @@ Portability problems fixed by Gnulib:
 This function is missing on some platforms:
 MSVC 14.
 @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.
+On platforms where @code{off_t} is a 32-bit type, this function may not
+work correctly on files 2 GiB and larger.  @xref{Large File Support}.
 @end itemize
 
 Portability problems not fixed by Gnulib:
index 0b4796602e70ae7ea429fffcf09a03f13739b268..b880339a9e8b6e10a2535399fe4447fc4b1b2dfa 100644 (file)
@@ -8,6 +8,9 @@ Gnulib module: ---
 
 Portability problems fixed by Gnulib:
 @itemize
+@item
+On platforms where @code{off_t} is a 32-bit type, this function may not
+work correctly on files 2 GiB and larger.  @xref{Large File Support}.
 @end itemize
 
 Portability problems not fixed by Gnulib:
@@ -15,8 +18,4 @@ Portability problems not fixed by Gnulib:
 @item
 This function is missing on some platforms:
 FreeBSD 5.2.1, NetBSD 3.0, Minix 3.1.8, mingw, MSVC 14, Android 4.1.
-@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
index 5a29faac9816bc84dce603f1ae5dc8bbbff3e3fc..d091fc8f9beeec9ed9907f517255768e8b198dbc 100644 (file)
@@ -10,6 +10,10 @@ Gnulib module: ---
 
 Portability problems fixed by Gnulib:
 @itemize
+@item
+On platforms where @code{rlim_t} is a 32-bit type, this function does not
+allow to retrieve limits larger than 4 GiB and larger,
+such as for RLIMIT_FSIZE@.  @xref{Large File Support}.
 @end itemize
 
 Portability problems not fixed by Gnulib:
@@ -17,8 +21,4 @@ Portability problems not fixed by Gnulib:
 @item
 This function is missing on some platforms:
 mingw, MSVC 14.
-@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
index 74ac551ebcde3ec0ab339be0374d1cd22687329d..8c0e3cff256395fb69a0bcff7364551385de17cd 100644 (file)
@@ -17,8 +17,8 @@ on some platforms:
 glibc 2.26, AIX 7.2, HP-UX 11, Solaris 11.4.
 @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.
-(Cf. @code{AC_SYS_LARGEFILE}.)
+work correctly on huge directories 2 GiB and larger.
+@xref{Large File Support}.
 @end itemize
 
 Portability problems not fixed by Gnulib:
index f133e65ba56d3ef1f4b49a03e1303d9a067384af..bd373aad6ee139cc8b78321b6146c982a0d59f05 100644 (file)
@@ -8,6 +8,9 @@ Gnulib module: ---
 
 Portability problems fixed by Gnulib:
 @itemize
+@item
+On platforms where @code{off_t} is a 32-bit type, this function may not
+work correctly on files 2 GiB and larger.  @xref{Large File Support}.
 @end itemize
 
 Portability problems not fixed by Gnulib:
@@ -15,8 +18,4 @@ Portability problems not fixed by Gnulib:
 @item
 This function is missing on some platforms:
 NetBSD 3.0, OpenBSD 6.7, Minix 3.1.8, Cygwin 2.9, mingw, MSVC 14, Android 9.0.
-@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
index 9b0fe2f814c8d6ee1a7dab86e6b0b7ef5545236d..efb9748b72ba5956bd4d6b1d0fda3cbf374bf306 100644 (file)
@@ -8,6 +8,10 @@ Gnulib module: ---
 
 Portability problems fixed by Gnulib:
 @itemize
+@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 2 GiB and larger.
+@xref{Large File Support}.
 @end itemize
 
 Portability problems not fixed by Gnulib:
@@ -15,8 +19,4 @@ Portability problems not fixed by Gnulib:
 @item
 This function is missing on some platforms:
 Minix 3.1.8, Cygwin 1.5.x, mingw, MSVC 14, Android 6.0.
-@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
index 3470524b128cca171166fd2710580a71aaa2ecfc..026bbada4038fd921f7256324d0de128ee1b44c0 100644 (file)
@@ -18,7 +18,7 @@ on some platforms:
 MSVC 14.
 @item
 On platforms where @code{off_t} is a 32-bit type, @code{lseek} does not work
-correctly with files larger than 2 GB@.  (Cf. @code{AC_SYS_LARGEFILE}.)
+correctly with files 2 GiB and larger.  @xref{Large File Support}.
 @item
 This function mistakenly succeeds on pipes on some platforms: mingw, MSVC 14.
 @end itemize
index 31b7759d95cab92032c00d8328d5f14dd25eb7cd..f0a6ffb572f8432acb192667390ab88d89743faa 100644 (file)
@@ -10,13 +10,13 @@ Portability problems fixed by Gnulib:
 @itemize
 @item
 On platforms where @code{off_t} is a 32-bit type, @code{lstat} may not
-correctly report the size of files or block devices larger than 2 GB.
-(Cf. @code{AC_SYS_LARGEFILE}.)
+correctly report the size of files or block devices 2 GiB and larger.
+@xref{Large File Support}.
 @item
 On Linux/x86 and Linux/x86_64, applications compiled in 32-bit mode cannot
 access files that happen to have a 64-bit inode number.  This can occur with
 file systems such as XFS (typically on large disks) and NFS.
-(Cf. @code{AC_SYS_LARGEFILE}.)
+@xref{Large File Support}.
 @item
 For symlinks, when the argument ends in a slash, some platforms don't
 dereference the argument:
index 0ec65f1b5831a3feac2971fcc27d6ba5210d5b75..b40305f0227bba078555d3276aedadb9be1de76b 100644 (file)
@@ -13,7 +13,7 @@ This function is missing on some platforms:
 mingw, MSVC 14.
 @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@.  (Cf. @code{AC_SYS_LARGEFILE}.)
+correctly to create files 2 GiB and larger.  @xref{Large File Support}.
 @item
 On some older platforms, @code{mkstemp} can create a world or group
 writable or readable file, if you haven't set the process umask to
index 016d0d279e085308149d65c1b206dc457da85349..24a79d554c1d270cf8788c771c2134ef13755008 100644 (file)
@@ -8,6 +8,10 @@ Gnulib module: ---
 
 Portability problems fixed by Gnulib:
 @itemize
+@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 2 GiB and larger.
+@xref{Large File Support}.
 @end itemize
 
 Portability problems not fixed by Gnulib:
@@ -16,10 +20,6 @@ Portability problems not fixed by Gnulib:
 This function is missing on some platforms:
 mingw, MSVC 14.
 @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}.
index 59fee8ce668c6a6dd9253c88568cb819598c4ace..7f2c29354998c83e575670c1b32942df22d7c13b 100644 (file)
@@ -8,6 +8,10 @@ Gnulib module: ---
 
 Portability problems fixed by Gnulib:
 @itemize
+@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 2 GiB and larger.
+@xref{Large File Support}.
 @end itemize
 
 Portability problems not fixed by Gnulib:
@@ -15,8 +19,4 @@ Portability problems not fixed by Gnulib:
 @item
 This function is missing on some platforms:
 FreeBSD 5.2.1, NetBSD 3.0, Minix 3.1.8, mingw, MSVC 14, Android 4.1.
-@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
index aa4f08b67d3decddd044b986d9116de2d8f9228f..2dc89d0a89ecff56f0c4686b696fe32a5813c5c8 100644 (file)
@@ -14,7 +14,7 @@ Some platforms do not support @code{O_CLOEXEC}:
 Mac OS X 10.6, FreeBSD 8.4, NetBSD 5.1, OpenBSD 4.9, Minix 3.1.8, AIX 7.1, HP-UX 11, IRIX 6.5, Solaris 10, Cygwin 1.7.x, mingw, MSVC 14.
 @item
 On platforms where @code{off_t} is a 32-bit type, @code{open} may not work
-correctly with files larger than 2 GB@.  (Cf. @code{AC_SYS_LARGEFILE}.)
+correctly with files 2 GiB and larger.  @xref{Large File Support}.
 @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
index 96b99f3e9511ce19f60ccb9badc9195cb69b1162..0d761e6f407098e4e5981267edf5425ff5989c05 100644 (file)
@@ -18,7 +18,7 @@ Some platforms do not support @code{O_CLOEXEC}:
 AIX 7.1, Solaris 10.
 @item
 On platforms where @code{off_t} is a 32-bit type, @code{open} may not work
-correctly with files larger than 2 GB@.  (Cf. @code{AC_SYS_LARGEFILE}.)
+correctly with files 2 GiB and larger.  @xref{Large File Support}.
 @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
index 906866ecd6891baffc3b681c1a7b51684ece4b0c..6882696be3435cc52f2aa5d4f97a1eed6efc9e8c 100644 (file)
@@ -13,9 +13,9 @@ This function is missing on some platforms:
 MSVC 14.
 @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
+work correctly on huge directories 2 GiB and larger.  Also, on platforms
 where @code{ino_t} is a 32-bit type, this function may report inode numbers
-incorrectly.  (Cf. @code{AC_SYS_LARGEFILE}.)
+incorrectly.  @xref{Large File Support}.
 @end itemize
 
 Portability problems not fixed by Gnulib:
index e6edb52b9ae24a3710043cea00623734fe7e981f..c05faff37a312518d7cc178f490a249e09f61efa 100644 (file)
@@ -8,6 +8,10 @@ Gnulib module: ---
 
 Portability problems fixed by Gnulib:
 @itemize
+@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 2 GiB and larger.
+@xref{Large File Support}.
 @end itemize
 
 Portability problems not fixed by Gnulib:
@@ -15,8 +19,4 @@ Portability problems not fixed by Gnulib:
 @item
 This function is missing on some platforms:
 macOS 11.1, FreeBSD 6.0, NetBSD 3.0, OpenBSD 6.7, Minix 3.1.8, AIX 5.1, HP-UX 11.23, IRIX 6.5, Solaris 10, Cygwin 1.5.x, mingw, MSVC 14, Android 4.4.
-@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
index 2f95bade519a2e259f9087df2b8a94588744759b..1902cab7b1dceb285d5f28c54863b72b91b0fb30 100644 (file)
@@ -8,6 +8,10 @@ Gnulib module: ---
 
 Portability problems fixed by Gnulib:
 @itemize
+@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 2 GiB and larger.
+@xref{Large File Support}.
 @end itemize
 
 Portability problems not fixed by Gnulib:
@@ -21,8 +25,4 @@ support the allocation operation directly.  glibc however emulates the file syst
 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.
 @end itemize
index 6dfe9772baed5d4812d1ceadf95bd1a87519a4ab..d2f53733b6436288dff5609d627db84272ba2cac 100644 (file)
@@ -13,7 +13,7 @@ This function is missing on some platforms:
 mingw, MSVC 14.
 @item
 On platforms where @code{off_t} is a 32-bit type, this function may not
-work correctly on files larger than 2 GB@.  (Cf. @code{AC_SYS_LARGEFILE}.)
+work correctly on files 2 GiB and larger.  @xref{Large File Support}.
 @item
 This function returns zero instead of positive values when large file support
 is enabled on some platforms:
index 3faf7263b2e1729a66cf5180b4b4016ffa51ae3b..b93664103daf2a462bcc9bc7ef220d1e6cbd9b0d 100644 (file)
@@ -13,7 +13,7 @@ This function is missing on some platforms:
 mingw, MSVC 14.
 @item
 On platforms where @code{off_t} is a 32-bit type, this function may not
-work correctly on files larger than 2 GB@.  (Cf. @code{AC_SYS_LARGEFILE}.)
+work correctly on files 2 GiB and larger.  @xref{Large File Support}.
 @item
 This function does not fail when an invalid (negative) offset is passed when
 large file support is enabled on some platforms:
index 195d16c363ebf5ac2a57fc5c26e6515d23e1aec6..896a81d85b6ad95e59ee645f9a72585e3f60e122 100644 (file)
@@ -13,10 +13,10 @@ This function is missing on some platforms:
 MSVC 14.
 @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
+work correctly on huge directories 2 GiB and larger.  Also, on platforms
 where @code{ino_t} is a 32-bit type, this function may report inode numbers
 incorrectly.  This can occur with file systems such as XFS (typically on
-large disks) and NFS@.  (Cf. @code{AC_SYS_LARGEFILE}.)
+large disks) and NFS@.  @xref{Large File Support}.
 @end itemize
 
 Portability problems not fixed by Gnulib:
index 5a7391bfd655192fde93540cf1e85921865c0285..9a175848e848ec090865c5b8ceea77dfa8d9ddf4 100644 (file)
@@ -14,6 +14,12 @@ in glibc.  Portable applications should use @code{readdir}.
 @item
 This function has an incompatible declaration on some platforms:
 Solaris 11.4 (when @code{_POSIX_PTHREAD_SEMANTICS} is not defined).
+@item
+On platforms where @code{off_t} is a 32-bit type, this function may not
+work correctly on huge directories 2 GiB and larger.  Also, on platforms
+where @code{ino_t} is a 32-bit type, this function may report inode numbers
+incorrectly.  This can occur with file systems such as XFS (typically on
+large disks) and NFS@.  @xref{Large File Support}.
 @end itemize
 
 Portability problems not fixed by Gnulib:
@@ -21,10 +27,4 @@ Portability problems not fixed by Gnulib:
 @item
 This function is missing on some platforms:
 Minix 3.1.8, mingw, MSVC 14.
-@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.  This can occur with file systems such as XFS (typically on
-large disks) and NFS@.  The fix is to use the @code{AC_SYS_LARGEFILE} macro.
 @end itemize
index b0202285acc2e4c92a2510d1cedddf80e4117f3b..d3370c2ed00e480bcf9ac40b110d352dd09f6bed 100644 (file)
@@ -13,8 +13,8 @@ This function is missing on some platforms:
 MSVC 14.
 @item
 On Mac OS X platforms where @code{long int} is a 32-bit type, this function may
-not work correctly on huge directories larger than 2 GB.
-(Cf. @code{AC_SYS_LARGEFILE}.)
+not work correctly on huge directories 2 GiB and larger.
+@xref{Large File Support}.
 @end itemize
 
 Portability problems not fixed by Gnulib:
index 216d0b382238d44cd454b75ffc934f3b7f17f8ea..b39386ff383aa7d5e987fe44d4e4fe9aeade560a 100644 (file)
@@ -13,9 +13,9 @@ This function is missing on some platforms:
 Minix 3.1.8, Solaris 9, mingw, MSVC 14.
 @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
+work correctly on huge directories 2 GiB and larger.  Also, on platforms
 where @code{ino_t} is a 32-bit type, this function may report inode numbers
-incorrectly.  (Cf. @code{AC_SYS_LARGEFILE}.)
+incorrectly.  @xref{Large File Support}.
 @end itemize
 
 Portability problems not fixed by Gnulib:
index d4e92ac85012dd975fae6980d1eebe05dea11c32..64e8ef58e8a1146fb4d3e07c4154935c2ef6ccf0 100644 (file)
@@ -8,6 +8,10 @@ Gnulib module: ---
 
 Portability problems 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 2 GiB and larger.
+@xref{Large File Support}.
 @end itemize
 
 Portability problems not fixed by Gnulib:
@@ -15,8 +19,4 @@ Portability problems not fixed by Gnulib:
 @item
 This function is missing on some platforms:
 MSVC 14, Android 5.1.
-@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 Mac OS X systems).
 @end itemize
index 8559d9ed578e805db7acba0417b6f5ba460d0cc6..e5b8eeeb5bf4a0a9fb063fac11f63e76f9cd4821 100644 (file)
@@ -10,6 +10,10 @@ Gnulib module: ---
 
 Portability problems fixed by Gnulib:
 @itemize
+@item
+On platforms where @code{rlim_t} is a 32-bit type, this function does not
+allow to set limits 4 GiB and larger, such as for RLIMIT_FSIZE@.
+@xref{Large File Support}.
 @end itemize
 
 Portability problems not fixed by Gnulib:
@@ -17,8 +21,4 @@ Portability problems not fixed by Gnulib:
 @item
 This function is missing on some platforms:
 Minix 3.1.8, mingw, MSVC 14.
-@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
index 0e3f56a96d1c510d6053e3aa89114deea34f2ebb..b64bdd3a016004a75c993cb5f4011f46c5476b77 100644 (file)
@@ -10,13 +10,13 @@ Portability problems fixed by Gnulib:
 @itemize
 @item
 On platforms where @code{off_t} is a 32-bit type, @code{stat} may not correctly
-report the size of files or block devices larger than 2 GB.
-(Cf. @code{AC_SYS_LARGEFILE}.)
+report the size of files or block devices 2 GiB and larger.
+@xref{Large File Support}.
 @item
 On Linux/x86 and Linux/x86_64, applications compiled in 32-bit mode cannot
 access files that happen to have a 64-bit inode number.  This can occur with
 file systems such as XFS (typically on large disks) and NFS.
-(Cf. @code{AC_SYS_LARGEFILE}.)
+@xref{Large File Support}.
 @item
 The @code{st_atime}, @code{st_ctime}, @code{st_mtime} fields are affected by
 the current time zone and by the DST flag of the current time zone on some
index 3515a01444c7c7c68ea90530efd7ad9112177e22..0c86f9244bed061b59504e3c201c9ef42e5a8e6f 100644 (file)
@@ -8,6 +8,11 @@ Gnulib module: ---
 
 Portability problems fixed by Gnulib:
 @itemize
+@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@.  @xref{Large File Support}.  This affects
+glibc/Hurd, HP-UX 11, Solaris.
 @end itemize
 
 Portability problems not fixed by Gnulib:
@@ -20,11 +25,6 @@ This function can hang if it stats all preceding
 entries in /proc/mounts, and any of those file systems
 are hard-mounted and not available.  This affects
 Linux < 2.6.36.
-@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
index 72ac57465e4bdfe7cf49aedd84d26bbe801c9004..620b20b5c4ab9f850eddf777ce5ba2bd12a42d2c 100644 (file)
@@ -8,6 +8,10 @@ Gnulib module: ---
 
 Portability problems 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 2 GiB and larger.
+@xref{Large File Support}.
 @end itemize
 
 Portability problems not fixed by Gnulib:
@@ -15,8 +19,4 @@ Portability problems not fixed by Gnulib:
 @item
 This function is missing on some platforms:
 MSVC 14, Android 5.1.
-@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 Mac OS X systems).
 @end itemize
index 0df5901dd19a42c2730056ec5d7e87bb7917bb43..73264438b16ed0c2cda5e23de6efdcf6561a6b37 100644 (file)
@@ -16,7 +16,7 @@ This function often fails for trivial reasons on some platforms:
 mingw, MSVC 14.
 @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@.  (Cf. @code{AC_SYS_LARGEFILE}.)
+correctly to create files 2 GiB and larger.  @xref{Large File Support}.
 @end itemize
 
 Portability problems not fixed by Gnulib:
index 8ee1fa7d18561e4e9c7a910cd287cff716c0afcb..1cfea6d40ffc6a43f3bdb4f6ce9924d1702965e6 100644 (file)
@@ -13,8 +13,8 @@ This function is missing on some platforms:
 mingw, MSVC 14, Android 4.4 with @code{AC_SYS_LARGEFILE} in effect.
 @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.
+applicable to arbitrary lengths for files 2 GiB and larger.
+@xref{Large File Support}.
 @item
 This function does not fail when the file name argument ends in a slash
 and (without the slash) names a non-directory, on some platforms:
index 78b423097b86f73b7b9b50c7afd199c03a2f0a68..afa3a1c9121b038a7a99922cd0d3817367884b1f 100644 (file)
@@ -37,12 +37,12 @@ Portability problems fixed by Gnulib module @code{sys_stat}, together with modul
 On Windows platforms (excluding Cygwin), @code{st_ino} is always 0.
 @end itemize
 
+@xref{Avoiding the year 2038 problem}, for portability issues with the
+@code{time_t} components of @code{struct stat}.
+
 Portability problems not fixed by Gnulib:
 @itemize
 @item
-@xref{time.h}, for general portability problems with the
-@code{time_t} components of @code{struct stat}.
-@item
 The macro @code{S_IFBLK} is missing on some platforms:
 MSVC 14.
 @item
index 4635cfe30c39834e50f6803d66d36e0615b91e0a..01283ca66059399533f5bcf40454aae240e62e59 100644 (file)
@@ -22,6 +22,9 @@ MSVC 14 in 64-bit mode,
 MSVC 14 in 32-bit mode when @code{_USE_32BIT_TIME_T} is not defined.
 @end itemize
 
+@xref{Avoiding the year 2038 problem}, for portability issues with
+@code{time_t} and the @code{time_t} component of @code{struct timeval}.
+
 Portability problems not fixed by Gnulib:
 @itemize
 @item
index 6b6f14aa1cd0873fae8fd8ca5fa9173606dea96e..7590e7869508b96b2091c56473ec1ce3542a4ea5 100644 (file)
@@ -27,6 +27,9 @@ avoid deprecation warnings from the versions in this header:
 glibc 2.25.
 @end itemize
 
+@xref{Avoiding the year 2038 problem}, for portability issues with
+@code{time_t}.
+
 Portability problems not fixed by Gnulib:
 @itemize
 @item
@@ -35,6 +38,7 @@ are signed integer types that are wider than @code{long}:
 glibc x32
 @end itemize
 
-This module, together with the module @code{largefile}, also defines the type
+This module, together with the modules @code{largefile-required}
+or @code{largefile}, also defines the type
 @code{off_t} to a 64-bit integer type on some platforms:
 mingw, MSVC 14.