diff options
| author | Michael Kerrisk <mtk.manpages@gmail.com> | 2016-06-08 12:10:48 +0200 |
|---|---|---|
| committer | Michael Kerrisk <mtk.manpages@gmail.com> | 2016-06-08 12:34:54 +0200 |
| commit | 1d691addc217ec5757561b8f8aa7462e29bbe0c5 (patch) | |
| tree | 0b20e2ecaef61532149f207333d99dd20237c4ad | |
| parent | 9eb18e174c65475d6530809e2b262ff26e703c7b (diff) | |
| download | man-pages-1d691addc217ec5757561b8f8aa7462e29bbe0c5.tar.gz | |
ioctl_ficlonerange.2: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
| -rw-r--r-- | man2/ioctl_ficlonerange.2 | 25 |
1 files changed, 16 insertions, 9 deletions
diff --git a/man2/ioctl_ficlonerange.2 b/man2/ioctl_ficlonerange.2 index c5c72aadbe..eee2a3f4c0 100644 --- a/man2/ioctl_ficlonerange.2 +++ b/man2/ioctl_ficlonerange.2 @@ -35,9 +35,11 @@ system call can be used to make some of the data in the file appear in the .B dest_fd file by sharing the underlying storage, which is faster than making a separate -physical copy of the data. If a file write should occur to a shared region, +physical copy of the data. +If a file write should occur to a shared region, the filesystem must ensure that the changes remain private to the file being -written. This behavior is commonly referred to as "copy on write". +written. +This behavior is commonly referred to as "copy on write". This ioctl reflinks up to .IR src_length @@ -49,7 +51,8 @@ into the file .IR dest_fd at offset .IR dest_offset ", -provided that both are files. This information is conveyed in a structure of +provided that both are files. +This information is conveyed in a structure of the following form: .in +4n .nf @@ -84,10 +87,12 @@ One of the files is a directory and the filesystem does not support shared regions in directories. .TP .B EINVAL -The filesystem does not support reflinking the ranges of the given files. This -error can also appear if either file descriptor represents a device, fifo, or -socket. Disk filesystems generally require the offset and length arguments -to be aligned to the fundamental block size. XFS and btrfs do not support +The filesystem does not support reflinking the ranges of the given files. +This error can also appear if either file descriptor represents +a device, fifo, or socket. +Disk filesystems generally require the offset and length arguments +to be aligned to the fundamental block size. +XFS and btrfs do not support overlapping reflink ranges in the same file. .TP .B EBADF @@ -104,7 +109,8 @@ resides on does not support reflink. is immutable. .TP .B ETXTBSY -One of the files is a swap file. Swap files cannot share storage. +One of the files is a swap file. +Swap files cannot share storage. .TP .B EOPNOTSUPP This can appear if the filesystem does not support reflinking either file @@ -115,7 +121,8 @@ Because a copy on write operation requires the allocation of new storage, the operation may un-share shared blocks to guarantee that subsequent writes will not fail because of lack of disk space. .SH CONFORMING TO -This API is Linux-specific. This ioctl was previously known as +This API is Linux-specific. +This ioctl was previously known as .B BTRFS_IOC_CLONE_RANGE and was private to btrfs. .fi |