.\" Copyright (c) 2020-2022 by Alejandro Colomar <alx@kernel.org>
.\" and Copyright (c) 2020 by Michael Kerrisk <mtk.manpages@gmail.com>
.\"
.\" SPDX-License-Identifier: Linux-man-pages-copyleft
.\"
.\"
.TH off_t 3type (date) "Linux man-pages (unreleased)"
.SH NAME
off_t, off64_t, loff_t \- file sizes
.SH LIBRARY
Standard C library
.RI ( libc )
.SH SYNOPSIS
.nf
.B #include <sys/types.h>
.P
.BR typedef " /* ... */ " off_t;
.P
.B #define _LARGEFILE64_SOURCE
.B #include <sys/types.h>
.P
.BR typedef " /* ... */ " off64_t;
.P
.B #define _GNU_SOURCE
.B #include <sys/types.h>
.P
.BR typedef " /* ... */ " loff_t;
.fi
.SH DESCRIPTION
.I off_t
is used for describing file sizes.
It is a signed integer type.
.P
.I off64_t
is a 64-bit version of the type,
used in glibc.
.P
.I loff_t
is a 64-bit version of the type,
introduced by the Linux kernel.
.SH STANDARDS
.TP
.I off_t
POSIX.1-2008.
.TP
.I off64_t
GNU and some BSDs.
.TP
.I loff_t
Linux.
.SH VERSIONS
.TP
.I off_t
POSIX.1-2001.
.P
.I <aio.h>
and
.I <stdio.h>
define
.I off_t
since POSIX.1-2008.
.SH NOTES
On some architectures,
the width of
.I off_t
can be controlled with the feature test macro
.BR _FILE_OFFSET_BITS .
.P
The following headers also provide
.IR off_t :
.IR <aio.h> ,
.IR <fcntl.h> ,
.IR <stdio.h> ,
.IR <sys/mman.h> ,
.IR <sys/stat.h> ,
and
.IR <unistd.h> .
.SH SEE ALSO
.BR copy_file_range (2),
.BR llseek (2),
.BR lseek (2),
.BR mmap (2),
.BR posix_fadvise (2),
.BR pread (2),
.BR readahead (2),
.BR sync_file_range (2),
.BR truncate (2),
.BR fseeko (3),
.BR lockf (3),
.BR lseek64 (3),
.BR posix_fallocate (3),
.BR feature_test_macros (7)
