xfs
[Top] [All Lists]

[PATCH RESEND 7/7] manpage: update FALLOC_FL_COLLAPSE_RANGE flag in fall

To: viro@xxxxxxxxxxxxxxxxxx, mtk.manpages@xxxxxxxxx, tytso@xxxxxxx, adilger.kernel@xxxxxxxxx, bpm@xxxxxxx, elder@xxxxxxxxxx, hch@xxxxxxxxxxxxx, david@xxxxxxxxxxxxx
Subject: [PATCH RESEND 7/7] manpage: update FALLOC_FL_COLLAPSE_RANGE flag in fallocate
From: Namjae Jeon <linkinjeon@xxxxxxxxx>
Date: Mon, 7 Oct 2013 05:14:21 +0900
Cc: linux-fsdevel@xxxxxxxxxxxxxxx, linux-kernel@xxxxxxxxxxxxxxx, linux-ext4@xxxxxxxxxxxxxxx, xfs@xxxxxxxxxxx, a.sangwan@xxxxxxxxxxx, Namjae Jeon <linkinjeon@xxxxxxxxx>, Namjae Jeon <namjae.jeon@xxxxxxxxxxx>
Delivered-to: xfs@xxxxxxxxxxx
Dkim-signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=from:to:cc:subject:date:message-id; bh=nHncHT8I1mLtDeuBzBZmM/9dyYcFV9lUn12n+f6y0pc=; b=Xfk7iJgJVBkD+t2vg5QDaKuwWa/T4SdwsmUbsvLo7vxyaHdjQIzINYwjN2SLwLlmCq te7pS9zDcHAe/lnisN3xEEUzmzMevCIFydlypBydCupfnm/oVylKVdMc8CTuRjPVBFMU ZrGHZthv9CruszIbiZUNGC3js+Atc0rOl9PPkUdmEm8f9qKkKf61fOto4DJ7vjKLm90Z uTsYJyUvtvQvs63tCP4NAZ8NylUBotc+Bt0h56p6kuz/Xstm41EjH8Quhq1+godGf0EF GY1r5j+eKFWATFTuiMUYj0F1a2GJ/sRMtOy5+Zjt4EX4Lyv2/TOtpw/5n/Mv6iuOlBhr WXRQ==
From: Namjae Jeon <namjae.jeon@xxxxxxxxxxx>

Update FALLOC_FL_COLLAPSE_RANGE flag in fallocate.

Signed-off-by: Namjae Jeon <namjae.jeon@xxxxxxxxxxx>
Signed-off-by: Ashish Sangwan <a.sangwan@xxxxxxxxxxx>
---
 man2/fallocate.2 |   17 ++++++++++++++++-
 1 file changed, 16 insertions(+), 1 deletion(-)

diff --git a/man2/fallocate.2 b/man2/fallocate.2
index f5c395d..b042c59 100644
--- a/man2/fallocate.2
+++ b/man2/fallocate.2
@@ -7,6 +7,7 @@
 .\"
 .\" 2011-09-19: Added FALLOC_FL_PUNCH_HOLE
 .\" 2011-09-19: Substantial restructuring of the page
+.\" 2013-09-01: Added FALLOC_FL_COLLAPSE_RANGE
 .\"
 .TH FALLOCATE 2 2013-06-10 "Linux" "Linux Programmer's Manual"
 .SH NAME
@@ -109,6 +110,19 @@ does not change.
 Not all filesystems support
 .BR FALLOC_FL_PUNCH_HOLE ;
 if a filesystem doesn't support the operation, an error is returned.
+.SS Collapsing file space
+Specifiying the
+.BR FALLOC_FL_COLLAPSE_RANGE
+flag in
+.I mode
+collapse space in the byte range starting at
+.I offset
+and continuing for
+.I len
+bytes, where the offset and len are aligned with block size of filesystem.
+Within the specified range, it first de-allocates blocks and eliminates
+the hole created in this process by shifting data blocks into the hole.
+
 .SH RETURN VALUE
 On success,
 .BR fallocate ()
@@ -139,7 +153,8 @@ was less than 0, or
 .\" See "Re: [PATCH] fallocate.2: add FALLOC_FL_PUNCH_HOLE flag definition"
 .\" 21 Sep 2012
 .\" http://thread.gmane.org/gmane.linux.file-systems/48331/focus=1193526
-was less than or equal to 0.
+was less than or equal to 0 or in case of FALLOC_FL_COLLAPSE_RANGE
+offset and len are not aligned with file system's block size.
 .TP
 .B EIO
 An I/O error occurred while reading from or writing to a filesystem.
-- 
1.7.9.5

<Prev in Thread] Current Thread [Next in Thread>
  • [PATCH RESEND 7/7] manpage: update FALLOC_FL_COLLAPSE_RANGE flag in fallocate, Namjae Jeon <=