+2017-05-13 Bruno Haible <bruno@clisp.org>
+
+ largefile: Improve and document.
+ * m4/largefile.m4 (gl_LARGEFILE): Set WINDOWS_64_BIT_ST_SIZE to 0 if
+ the mingw headers already define 'stat' appropriately.
+ * modules/largefile (Description): Clarify.
+ * doc/largefile.texi: New file.
+ * doc/gnulib.texi: Include it.
+ * doc/posix-headers/sys_types.texi: Update.
+
2017-05-13 Bruno Haible <bruno@clisp.org>
truncate: New module.
@menu
* Libtool and Windows::
+* Large File Support::
* Precise file timestamps on Windows::
* Windows sockets::
* Native Windows Support without MSVC Support::
@include windows-libtool.texi
+@include largefile.texi
+
@include windows-stat-timespec.texi
@include windows-sockets.texi
--- /dev/null
+@node Large File Support
+@section Large File Support
+
+The module provides support for files larger than 2 GB.
+To this effect, it ensures that @code{off_t} is a 64-bit integer type
+at least on the following platforms:
+glibc, Mac OS X, FreeBSD, NetBSD, OpenBSD, AIX, HP-UX, IRIX, OSF/1, Solaris,
+Cygwin, mingw, MSVC.
This module, together with the module @code{largefile}, also defines the type
@code{off_t} to a 64-bit integer type on some platforms:
-mingw (except mingw64), MSVC 9.
+mingw, MSVC 9.
else
WINDOWS_64_BIT_OFF_T=0
fi
- dnl But all native Windows platforms (including mingw64) have a 32-bit
- dnl st_size member in 'struct stat'.
- WINDOWS_64_BIT_ST_SIZE=1
+ dnl Some mingw versions define, if _FILE_OFFSET_BITS=64, 'struct stat'
+ dnl to 'struct _stat32i64' or 'struct _stat64' (depending on
+ dnl _USE_32BIT_TIME_T), which has a 32-bit st_size member.
+ AC_CACHE_CHECK([for 64-bit st_size], [gl_cv_member_st_size_64],
+ [AC_COMPILE_IFELSE(
+ [AC_LANG_PROGRAM(
+ [[#include <sys/types.h>
+ struct stat buf;
+ int verify_st_size_size[sizeof (buf.st_size) >= 8 ? 1 : -1];
+ ]],
+ [[]])],
+ [gl_cv_member_st_size_64=yes], [gl_cv_member_st_size_64=no])
+ ])
+ if test $gl_cv_member_st_size_64 = no; then
+ WINDOWS_64_BIT_ST_SIZE=1
+ else
+ WINDOWS_64_BIT_ST_SIZE=0
+ fi
;;
*)
dnl Nothing to do on gnulib's side.
Description:
-Use large files.
+Support for files larger than 2 GB.
Files:
m4/largefile.m4