From nobody Wed Dec 17 11:57:32 2025 Received: from dggsgout11.his.huawei.com (dggsgout11.his.huawei.com [45.249.212.51]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 2CECF7E9; Tue, 18 Mar 2025 07:40:40 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=45.249.212.51 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1742283644; cv=none; b=WuYqg2YvM5mTfkSOtCdnWgbfE8l9N272atiDweRDSVtHAfN4woMaaSbSYk/IcR685GbBIKBkdVT7C/T9lFUeFJZDVSK42zEKScNqfBSSyOJepzNSVVBUrdq7kMA3Q9lM67xPbEGTqi7usSsqcRHEDwTJ/BQrWPuEOVEtJN6lNkI= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1742283644; c=relaxed/simple; bh=K+XA7GFK0xb73WCV79w/cHUhfkLJzifDbaFT/ICcowg=; h=From:To:Cc:Subject:Date:Message-ID:MIME-Version; b=fLiZTVuCaEmEaCqdJrvohALDtbUB3eyrfwJx3TTY7agUgSz0Dgh1ZjG1EnRvkV+Hx8yZhkExIa3ak4sq01vY5sKtYw+q/ECD+xxora90qa4sdcIq3MsKIGkapxq5MSEsSJXhTHUrZkd/qkeeJkP0SYi1mKVV3djnE0jq0vlJGyU= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=huaweicloud.com; spf=pass smtp.mailfrom=huaweicloud.com; arc=none smtp.client-ip=45.249.212.51 Authentication-Results: smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=huaweicloud.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=huaweicloud.com Received: from mail.maildlp.com (unknown [172.19.163.216]) by dggsgout11.his.huawei.com (SkyGuard) with ESMTP id 4ZH3f60Hksz4f3m7R; Tue, 18 Mar 2025 15:40:14 +0800 (CST) Received: from mail02.huawei.com (unknown [10.116.40.128]) by mail.maildlp.com (Postfix) with ESMTP id 1A6041A1BDC; Tue, 18 Mar 2025 15:40:38 +0800 (CST) Received: from huaweicloud.com (unknown [10.175.112.188]) by APP4 (Coremail) with SMTP id gCh0CgBHq19uI9ln0aBYGw--.57558S4; Tue, 18 Mar 2025 15:40:37 +0800 (CST) From: Zhang Yi To: linux-fsdevel@vger.kernel.org, linux-ext4@vger.kernel.org, linux-block@vger.kernel.org, dm-devel@lists.linux.dev, linux-nvme@lists.infradead.org, linux-scsi@vger.kernel.org Cc: linux-xfs@vger.kernel.org, linux-kernel@vger.kernel.org, hch@lst.de, tytso@mit.edu, djwong@kernel.org, john.g.garry@oracle.com, bmarzins@redhat.com, chaitanyak@nvidia.com, shinichiro.kawasaki@wdc.com, yi.zhang@huawei.com, yi.zhang@huaweicloud.com, chengzhihao1@huawei.com, yukuai3@huawei.com, yangerkun@huawei.com Subject: [PATCH util-linux] fallocate: add FALLOC_FL_WRITE_ZEROES support Date: Tue, 18 Mar 2025 15:32:18 +0800 Message-ID: <20250318073218.3513262-1-yi.zhang@huaweicloud.com> X-Mailer: git-send-email 2.46.1 Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-CM-TRANSID: gCh0CgBHq19uI9ln0aBYGw--.57558S4 X-Coremail-Antispam: 1UD129KBjvJXoWxKF1DuF4DWw18Cry5KFW5GFg_yoW7Kw48pF W5tF18K3yFgw47Gwn7Aw4kWrn8Z395WrW5CrZ2grykAr13Ga17Ka1vgFyFgasrXrWvka15 XryaqFy3ur48AFJanT9S1TB71UUUUU7qnTZGkaVYY2UrUUUUjbIjqfuFe4nvWSU5nxnvy2 9KBjDU0xBIdaVrnRJUUU9I14x267AKxVW5JVWrJwAFc2x0x2IEx4CE42xK8VAvwI8IcIk0 rVWrJVCq3wAFIxvE14AKwVWUJVWUGwA2ocxC64kIII0Yj41l84x0c7CEw4AK67xGY2AK02 1l84ACjcxK6xIIjxv20xvE14v26F1j6w1UM28EF7xvwVC0I7IYx2IY6xkF7I0E14v26r4U JVWxJr1l84ACjcxK6I8E87Iv67AKxVW0oVCq3wA2z4x0Y4vEx4A2jsIEc7CjxVAFwI0_Gc CE3s1le2I262IYc4CY6c8Ij28IcVAaY2xG8wAqx4xG64xvF2IEw4CE5I8CrVC2j2WlYx0E 2Ix0cI8IcVAFwI0_JF0_Jw1lYx0Ex4A2jsIE14v26r1j6r4UMcvjeVCFs4IE7xkEbVWUJV W8JwACjcxG0xvY0x0EwIxGrwACjI8F5VA0II8E6IAqYI8I648v4I1lFIxGxcIEc7CjxVA2 Y2ka0xkIwI1lc7CjxVAaw2AFwI0_GFv_Wryl42xK82IYc2Ij64vIr41l4I8I3I0E4IkC6x 0Yz7v_Jr0_Gr1lx2IqxVAqx4xG67AKxVWUJVWUGwC20s026x8GjcxK67AKxVWUGVWUWwC2 zVAF1VAY17CE14v26r4a6rW5MIIYrxkI7VAKI48JMIIF0xvE2Ix0cI8IcVAFwI0_Gr0_Xr 1lIxAIcVC0I7IYx2IY6xkF7I0E14v26r4UJVWxJr1lIxAIcVCF04k26cxKx2IYs7xG6r1j 6r1xMIIF0xvEx4A2jsIE14v26r4j6F4UMIIF0xvEx4A2jsIEc7CjxVAFwI0_Gr1j6F4UJb IYCTnIWIevJa73UjIFyTuYvjTRMv31DUUUU X-CM-SenderInfo: d1lo6xhdqjqx5xdzvxpfor3voofrz/ Content-Type: text/plain; charset="utf-8" From: Zhang Yi The Linux kernel is planning to supports FALLOC_FL_WRITE_ZEROES in fallocate(2). Add FALLOC_FL_ZERO_RANGE support to fallocate utility by introducing a new option -w|--write-zeroes. Signed-off-by: Zhang Yi --- sys-utils/fallocate.1.adoc | 11 +++++++++-- sys-utils/fallocate.c | 20 ++++++++++++++++---- 2 files changed, 25 insertions(+), 6 deletions(-) diff --git a/sys-utils/fallocate.1.adoc b/sys-utils/fallocate.1.adoc index 44ee0ef4c..f9226b909 100644 --- a/sys-utils/fallocate.1.adoc +++ b/sys-utils/fallocate.1.adoc @@ -12,7 +12,7 @@ fallocate - preallocate or deallocate space to a file =20 =3D=3D SYNOPSIS =20 -*fallocate* [*-c*|*-p*|*-z*] [*-o* _offset_] *-l* _length_ [*-n*] _filenam= e_ +*fallocate* [*-c*|*-p*|*-z*|*-w*] [*-o* _offset_] *-l* _length_ [*-n*] _fi= lename_ =20 *fallocate* *-d* [*-o* _offset_] [*-l* _length_] _filename_ =20 @@ -28,7 +28,7 @@ The exit status returned by *fallocate* is 0 on success a= nd 1 on failure. =20 The _length_ and _offset_ arguments may be followed by the multiplicative = suffixes KiB (=3D1024), MiB (=3D1024*1024), and so on for GiB, TiB, PiB, Ei= B, ZiB, and YiB (the "iB" is optional, e.g., "K" has the same meaning as "K= iB") or the suffixes KB (=3D1000), MB (=3D1000*1000), and so on for GB, TB,= PB, EB, ZB, and YB. =20 -The options *--collapse-range*, *--dig-holes*, *--punch-hole*, *--zero-ran= ge* and *--posix* are mutually exclusive. +The options *--collapse-range*, *--dig-holes*, *--punch-hole*, *--zero-ran= ge*, *--write-zeroes* and *--posix* are mutually exclusive. =20 *-c*, *--collapse-range*:: Removes a byte range from a file, without leaving a hole. The byte range t= o be collapsed starts at _offset_ and continues for _length_ bytes. At the = completion of the operation, the contents of the file starting at the locat= ion __offset__+_length_ will be appended at the location _offset_, and the = file will be _length_ bytes smaller. The option *--keep-size* may not be sp= ecified for the collapse-range operation. @@ -76,6 +76,13 @@ Option *--keep-size* can be specified to prevent file le= ngth modification. + Available since Linux 3.14 for ext4 (only for extent-based files) and XFS. =20 +*-w*, *--write-zeroes*:: +Zeroes space in the byte range starting at _offset_ and continuing for _le= ngth_ bytes. Within the specified range, blocks are preallocated for the re= gions that span the holes in the file. After a successful call, subsequent = reads from this range will return zeroes. ++ +Zeroing is done within the filesystem by preferably submitting write zeore= s commands, the alternative way is submitting actual zeroed data, the speci= fied range will be converted into written extents. The write zeroes command= is significantly faster than write actual data if the device supports unma= p write zeroes, and the specified range will not be physically zeroed out o= n the device. ++ +Options *--keep-size* can not be specified for the write-zeroes operation. + include::man-common/help-version.adoc[] =20 =3D=3D AUTHORS diff --git a/sys-utils/fallocate.c b/sys-utils/fallocate.c index fff75b03f..69e1e1e5b 100644 --- a/sys-utils/fallocate.c +++ b/sys-utils/fallocate.c @@ -41,7 +41,7 @@ #if defined(HAVE_LINUX_FALLOC_H) && \ (!defined(FALLOC_FL_KEEP_SIZE) || !defined(FALLOC_FL_PUNCH_HOLE) || \ !defined(FALLOC_FL_COLLAPSE_RANGE) || !defined(FALLOC_FL_ZERO_RANGE) = || \ - !defined(FALLOC_FL_INSERT_RANGE)) + !defined(FALLOC_FL_INSERT_RANGE) || !defined(FALLOC_FL_WRITE_ZEROES)) # include /* non-libc fallback for FALLOC_FL_* flags */ #endif =20 @@ -66,6 +66,10 @@ # define FALLOC_FL_INSERT_RANGE 0x20 #endif =20 +#ifndef FALLOC_FL_WRITE_ZEROES +# define FALLOC_FL_WRITE_ZEROES 0x80 +#endif + #include "nls.h" #include "strutils.h" #include "c.h" @@ -95,6 +99,7 @@ static void __attribute__((__noreturn__)) usage(void) fputs(_(" -o, --offset offset for range operations, in bytes\n"),= out); fputs(_(" -p, --punch-hole replace a range with a hole (implies -n)\n= "), out); fputs(_(" -z, --zero-range zero and ensure allocation of a range\n"),= out); + fputs(_(" -w, --write-zeroes write zeroes and ensure allocation of a ra= nge\n"), out); #ifdef HAVE_POSIX_FALLOCATE fputs(_(" -x, --posix use posix_fallocate(3) instead of fallocat= e(2)\n"), out); #endif @@ -305,6 +310,7 @@ int main(int argc, char **argv) { "dig-holes", no_argument, NULL, 'd' }, { "insert-range", no_argument, NULL, 'i' }, { "zero-range", no_argument, NULL, 'z' }, + { "write-zeroes", no_argument, NULL, 'w' }, { "offset", required_argument, NULL, 'o' }, { "length", required_argument, NULL, 'l' }, { "posix", no_argument, NULL, 'x' }, @@ -313,8 +319,8 @@ int main(int argc, char **argv) }; =20 static const ul_excl_t excl[] =3D { /* rows and cols in ASCII order */ - { 'c', 'd', 'i', 'p', 'x', 'z'}, - { 'c', 'i', 'n', 'x' }, + { 'c', 'd', 'i', 'p', 'w', 'x', 'z'}, + { 'c', 'i', 'n', 'w', 'x' }, { 0 } }; int excl_st[ARRAY_SIZE(excl)] =3D UL_EXCL_STATUS_INIT; @@ -324,7 +330,7 @@ int main(int argc, char **argv) textdomain(PACKAGE); close_stdout_atexit(); =20 - while ((c =3D getopt_long(argc, argv, "hvVncpdizxl:o:", longopts, NULL)) + while ((c =3D getopt_long(argc, argv, "hvVncpdizwxl:o:", longopts, NULL)) !=3D -1) { =20 err_exclusive_options(c, longopts, excl, excl_st); @@ -354,6 +360,9 @@ int main(int argc, char **argv) case 'z': mode |=3D FALLOC_FL_ZERO_RANGE; break; + case 'w': + mode |=3D FALLOC_FL_WRITE_ZEROES; + break; case 'x': #ifdef HAVE_POSIX_FALLOCATE posix =3D 1; @@ -430,6 +439,9 @@ int main(int argc, char **argv) else if (mode & FALLOC_FL_ZERO_RANGE) fprintf(stdout, _("%s: %s (%ju bytes) zeroed.\n"), filename, str, length); + else if (mode & FALLOC_FL_WRITE_ZEROES) + fprintf(stdout, _("%s: %s (%ju bytes) write zeroed.\n"), + filename, str, length); else fprintf(stdout, _("%s: %s (%ju bytes) allocated.\n"), filename, str, length); --=20 2.46.1