.\" 2011-09-19: Added FALLOC_FL_PUNCH_HOLE
.\" 2011-09-19: Substantial restructuring of the page
.\"
-.TH FALLOCATE 2 2016-12-12 "Linux" "Linux Programmer's Manual"
+.TH FALLOCATE 2 2018-04-30 "Linux" "Linux Programmer's Manual"
.SH NAME
fallocate \- manipulate file space
.SH SYNOPSIS
Within the specified range, partial filesystem blocks are zeroed,
and whole filesystem blocks are removed from the file.
After a successful call,
-subsequent reads from this range will return zeroes.
+subsequent reads from this range will return zeros.
.PP
The
.BR FALLOC_FL_PUNCH_HOLE
.IP *
Btrfs (since Linux 3.7)
.IP *
-.BR tmpfs "(5) (since Linux 3.5)"
+.BR tmpfs (5)
+(since Linux 3.5)"
.\" commit 83e4fa9c16e4af7122e31be3eca5d57881d236fe
.SS Collapsing file space
.\" commit 00f5e61998dd17f5375d9dfc01331f104b83f841
which varies according to the filesystem type and configuration.
If a filesystem has such a requirement,
.BR fallocate ()
-will fail with the error
+fails with the error
.BR EINVAL
if this requirement is violated.
.PP
.\" commit 409332b65d3ed8cfa7a8030f1e9d52f372219642
in
.I mode
-zeroes space in the byte range starting at
+zeros space in the byte range starting at
.I offset
and continuing for
.I len
Within the specified range, blocks are preallocated for the regions
that span the holes in the file.
After a successful call, subsequent
-reads from this range will return zeroes.
+reads from this range will return zeros.
.PP
Zeroing is done within the filesystem preferably by converting the range into
unwritten extents.
.IP *
SMB3 (since Linux 3.17)
.\" commit 30175628bf7f521e9ee31ac98fa6d6fe7441a556
+.IP *
+Btrfs (since Linux 4.16)
+.\" commit f27451f229966874a8793995b8e6b74326d125df
.SS Increasing file space
Specifying the
.BR FALLOC_FL_INSERT_RANGE
regarding the granularity of the operation.
If the granularity requirements are not met,
.BR fallocate ()
-will fail with the error
+fails with the error
.BR EINVAL.
If the
.I offset
but the file referred to by
.I fd
is not a regular file.
-.\" There was a inconsistency in 3.15-rc1, that should be resolved so that all
+.\" There was an inconsistency in 3.15-rc1, that should be resolved so that all
.\" filesystems use this error for this case. (Tytso says ex4 will change.)
.\" http://thread.gmane.org/gmane.comp.file-systems.xfs.general/60485/focus=5521
.\" From: Michael Kerrisk (man-pages <mtk.manpages@...>