Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

fs: Introduce FALLOC_FL_ZERO_RANGE flag for fallocate

Introduce new FALLOC_FL_ZERO_RANGE flag for fallocate. This has the same
functionality as xfs ioctl XFS_IOC_ZERO_RANGE.

It can be used to convert a range of file to zeros preferably without
issuing data IO. Blocks should be preallocated for the regions that span
holes in the file, and the entire range is preferable converted to
unwritten extents - even though file system may choose to zero out the
extent or do whatever which will result in reading zeros from the range
while the range remains allocated for the file.

This can be also used to preallocate blocks past EOF in the same way as
with fallocate. Flag FALLOC_FL_KEEP_SIZE which should cause the inode
size to remain the same.

Signed-off-by: Lukas Czerner <lczerner@redhat.com>
Reviewed-by: Dave Chinner <dchinner@redhat.com>
Signed-off-by: Dave Chinner <david@fromorbit.com>

authored by

Lukas Czerner and committed by
Dave Chinner
409332b6 e1d8fb88

+20 -1
+6 -1
fs/open.c
··· 232 232 233 233 /* Return error if mode is not supported */ 234 234 if (mode & ~(FALLOC_FL_KEEP_SIZE | FALLOC_FL_PUNCH_HOLE | 235 - FALLOC_FL_COLLAPSE_RANGE)) 235 + FALLOC_FL_COLLAPSE_RANGE | FALLOC_FL_ZERO_RANGE)) 236 + return -EOPNOTSUPP; 237 + 238 + /* Punch hole and zero range are mutually exclusive */ 239 + if ((mode & (FALLOC_FL_PUNCH_HOLE | FALLOC_FL_ZERO_RANGE)) == 240 + (FALLOC_FL_PUNCH_HOLE | FALLOC_FL_ZERO_RANGE)) 236 241 return -EOPNOTSUPP; 237 242 238 243 /* Punch hole must have keep size set */
+14
include/uapi/linux/falloc.h
··· 27 27 */ 28 28 #define FALLOC_FL_COLLAPSE_RANGE 0x08 29 29 30 + /* 31 + * FALLOC_FL_ZERO_RANGE is used to convert a range of file to zeros preferably 32 + * without issuing data IO. Blocks should be preallocated for the regions that 33 + * span holes in the file, and the entire range is preferable converted to 34 + * unwritten extents - even though file system may choose to zero out the 35 + * extent or do whatever which will result in reading zeros from the range 36 + * while the range remains allocated for the file. 37 + * 38 + * This can be also used to preallocate blocks past EOF in the same way as 39 + * with fallocate. Flag FALLOC_FL_KEEP_SIZE should cause the inode 40 + * size to remain the same. 41 + */ 42 + #define FALLOC_FL_ZERO_RANGE 0x10 43 + 30 44 #endif /* _UAPI_FALLOC_H_ */