• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1  #ifndef _UAPI_FALLOC_H_
2  #define _UAPI_FALLOC_H_
3  
4  #define FALLOC_FL_KEEP_SIZE	0x01 /* default is extend size */
5  #define FALLOC_FL_PUNCH_HOLE	0x02 /* de-allocates range */
6  #define FALLOC_FL_NO_HIDE_STALE	0x04 /* reserved codepoint */
7  
8  /*
9   * FALLOC_FL_COLLAPSE_RANGE is used to remove a range of a file
10   * without leaving a hole in the file. The contents of the file beyond
11   * the range being removed is appended to the start offset of the range
12   * being removed (i.e. the hole that was punched is "collapsed"),
13   * resulting in a file layout that looks like the range that was
14   * removed never existed. As such collapsing a range of a file changes
15   * the size of the file, reducing it by the same length of the range
16   * that has been removed by the operation.
17   *
18   * Different filesystems may implement different limitations on the
19   * granularity of the operation. Most will limit operations to
20   * filesystem block size boundaries, but this boundary may be larger or
21   * smaller depending on the filesystem and/or the configuration of the
22   * filesystem or file.
23   *
24   * Attempting to collapse a range that crosses the end of the file is
25   * considered an illegal operation - just use ftruncate(2) if you need
26   * to collapse a range that crosses EOF.
27   */
28  #define FALLOC_FL_COLLAPSE_RANGE	0x08
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  
44  
45  #endif /* _UAPI_FALLOC_H_ */
46