From 1d691addc217ec5757561b8f8aa7462e29bbe0c5 Mon Sep 17 00:00:00 2001 From: Michael Kerrisk Date: Wed, 8 Jun 2016 12:10:48 +0200 Subject: [PATCH] ioctl_ficlonerange.2: srcfix Signed-off-by: Michael Kerrisk --- man2/ioctl_ficlonerange.2 | 25 ++++++++++++++++--------- 1 file changed, 16 insertions(+), 9 deletions(-) diff --git a/man2/ioctl_ficlonerange.2 b/man2/ioctl_ficlonerange.2 index c5c72aadb..eee2a3f4c 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