diff options
| author | Darrick J. Wong <darrick.wong@oracle.com> | 2016-10-17 18:54:27 -0700 |
|---|---|---|
| committer | Michael Kerrisk <mtk.manpages@gmail.com> | 2016-10-18 08:05:34 +0200 |
| commit | 63a599c657d82a6374272aa4c8f31b5cc1bd9a58 (patch) | |
| tree | 07c7a6a35497097d192520d758590c752579db0c | |
| parent | 3b3d46e7cf1a9949da668db7b686bd968a80f137 (diff) | |
| download | man-pages-63a599c657d82a6374272aa4c8f31b5cc1bd9a58.tar.gz | |
man2/fallocate.2: Document behavior with shared blocks
Note that FALLOC_FL_UNSHARE may use CoW to unshare blocks to
guarantee that a disk write won't fail with ENOSPC.
Signed-off-by: Darrick J. Wong <darrick.wong@oracle.com>
| -rw-r--r-- | man2/fallocate.2 | 10 |
1 files changed, 10 insertions, 0 deletions
diff --git a/man2/fallocate.2 b/man2/fallocate.2 index 54d634096a..3ed14601d8 100644 --- a/man2/fallocate.2 +++ b/man2/fallocate.2 @@ -79,6 +79,16 @@ but the file size will not be changed even if is greater than the file size. Preallocating zeroed blocks beyond the end of the file in this manner is useful for optimizing append workloads. + +If the +.B FALLOC_FL_UNSHARE +flag is specified in +.IR mode , +shared file data extents will be made private to the file to guarantee +that a subsequent write will not fail due to lack of space. +Typically, this will be done by performing a copy-on-write operation on +all shared data in the file. +This flag may not be supported by all filesystems. .PP Because allocation is done in block size chunks, .BR fallocate () |