summaryrefslogtreecommitdiff
path: root/doc/largefile.texi
blob: b5bfa5116a24c562f9e6a105bcc800ac6370c6ae (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
@node Large File Support
@section Large File Support

The Gnulib @samp{largefile-required} module provides support for files
2 GiB and larger, or with device or inode numbers exceeding 32 bits.
To this effect, it ensures that types like @code{off_t} and
@code{ino_t} are 64-bit,
at least on the following platforms:
glibc, Mac OS X, FreeBSD, NetBSD, OpenBSD, AIX, HP-UX, IRIX, Solaris,
Cygwin, mingw, MSVC.

The Gnulib @samp{largefile} module is similar, except that it gives
@command{configure} an option @samp{--disable-largefile} that
suppresses support for large files.  This may be useful if the package
links to other libraries whose user-facing ABIs still require
@code{off_t} or most other file-related types to be 32-bit on your
platform.

Both modules also add to @command{configure} an option
@code{--enable-year2038}, needed on some platforms to access files
with timestamps past the year 2038.  @xref{Avoiding the year 2038
problem}.