From nobody Sat Oct 4 01:38:59 2025 Received: from dggsgout12.his.huawei.com (dggsgout12.his.huawei.com [45.249.212.56]) (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 41AD414B06C; Thu, 21 Aug 2025 06:21:28 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=45.249.212.56 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1755757291; cv=none; b=FLDhuPufv4UVUSJ1orDeizHOFEHlih9VRQJXcs98Q3RilobQPYwvtc4doCfgMnXWWcP6KhjyESAegXIG1LhsIJG9EQJR/MIgnBJL5gleqqLimZwvZ0EXiKfpLHJT8Hhe1zXV+3tX52vF08pe3B3npKQH5h3meItFMmuUzbCWWHU= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1755757291; c=relaxed/simple; bh=3XaR4vmSB7jpSEvMaAX61qPKgqAZ/1lwztzPFQxpWpA=; h=From:To:Cc:Subject:Date:Message-Id:MIME-Version; b=B99Ta222PqrghSW9xS3ztAN14hEt4U02FvEPopXE2C1fAMjNIwjxt3Br2L20ZmOc1svVD0VhLvmKJ6JWhVO5r0NEEqKhpZIxivvH7/ICD9Y1YK9iWBiZGblNaQug1bTHxvoTtkK5NxTY/jQC1Y43PqBpHfZj08kVYx6hVEc2fGY= 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.56 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.93.142]) by dggsgout12.his.huawei.com (SkyGuard) with ESMTPS id 4c6tWB1YYDzKHNZS; Thu, 21 Aug 2025 14:21:26 +0800 (CST) Received: from mail02.huawei.com (unknown [10.116.40.128]) by mail.maildlp.com (Postfix) with ESMTP id A4D811A0AD1; Thu, 21 Aug 2025 14:21:25 +0800 (CST) Received: from huaweicloud.com (unknown [10.175.104.67]) by APP4 (Coremail) with SMTP id gCh0CgAHzw_duqZoIKmhEQ--.35680S4; Thu, 21 Aug 2025 14:21:24 +0800 (CST) From: Zhang Yi To: linux-fsdevel@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-kernel@vger.kernel.org, hch@lst.de, tytso@mit.edu, djwong@kernel.org, bmarzins@redhat.com, chaitanyak@nvidia.com, shinichiro.kawasaki@wdc.com, brauner@kernel.org, martin.petersen@oracle.com, yi.zhang@huawei.com, yi.zhang@huaweicloud.com, chengzhihao1@huawei.com, yukuai3@huawei.com, yangerkun@huawei.com Subject: [PATCH util-linux v4] fallocate: add FALLOC_FL_WRITE_ZEROES support Date: Thu, 21 Aug 2025 14:13:07 +0800 Message-Id: <20250821061307.1770368-1-yi.zhang@huaweicloud.com> X-Mailer: git-send-email 2.39.2 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: gCh0CgAHzw_duqZoIKmhEQ--.35680S4 X-Coremail-Antispam: 1UD129KBjvJXoWxtFW7XFyDWFyUCryrKF15Arb_yoWxAr48pF W5tF18K3yrWw4xGwn7Za1kWw15Zws5Wr45CrZ2grykAr13Wa17Ka1vgryFgasrXFWkCa15 Xr1avry3ur48AaDanT9S1TB71UUUUU7qnTZGkaVYY2UrUUUUjbIjqfuFe4nvWSU5nxnvy2 9KBjDU0xBIdaVrnRJUUU9Y14x267AKxVW5JVWrJwAFc2x0x2IEx4CE42xK8VAvwI8IcIk0 rVWrJVCq3wAFIxvE14AKwVWUJVWUGwA2ocxC64kIII0Yj41l84x0c7CEw4AK67xGY2AK02 1l84ACjcxK6xIIjxv20xvE14v26F1j6w1UM28EF7xvwVC0I7IYx2IY6xkF7I0E14v26r4U JVWxJr1l84ACjcxK6I8E87Iv67AKxVW0oVCq3wA2z4x0Y4vEx4A2jsIEc7CjxVAFwI0_Gc CE3s1le2I262IYc4CY6c8Ij28IcVAaY2xG8wAqx4xG64xvF2IEw4CE5I8CrVC2j2WlYx0E 2Ix0cI8IcVAFwI0_JrI_JrylYx0Ex4A2jsIE14v26r1j6r4UMcvjeVCFs4IE7xkEbVWUJV W8JwACjcxG0xvY0x0EwIxGrwACjI8F5VA0II8E6IAqYI8I648v4I1lFIxGxcIEc7CjxVA2 Y2ka0xkIwI1lc7CjxVAaw2AFwI0_GFv_Wryl42xK82IYc2Ij64vIr41l4I8I3I0E4IkC6x 0Yz7v_Jr0_Gr1lx2IqxVAqx4xG67AKxVWUJVWUGwC20s026x8GjcxK67AKxVWUGVWUWwC2 zVAF1VAY17CE14v26r4a6rW5MIIYrxkI7VAKI48JMIIF0xvE2Ix0cI8IcVAFwI0_Jr0_JF 4lIxAIcVC0I7IYx2IY6xkF7I0E14v26r4j6F4UMIIF0xvE42xK8VAvwI8IcIk0rVWUJVWU CwCI42IY6I8E87Iv67AKxVWUJVW8JwCI42IY6I8E87Iv6xkF7I0E14v26r4j6r4UJbIYCT nIWIevJa73UjIFyTuYvjTRRBT5DUUUU X-CM-SenderInfo: d1lo6xhdqjqx5xdzvxpfor3voofrz/ Content-Type: text/plain; charset="utf-8" From: Zhang Yi The Linux kernel (since version 6.17) supports FALLOC_FL_WRITE_ZEROES in fallocate(2). Add support for FALLOC_FL_WRITE_ZEROES to the fallocate utility by introducing a new option -w|--write-zeroes. Link: https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/co= mmit/?id=3D278c7d9b5e0c Signed-off-by: Zhang Yi Reviewed-by: "Darrick J. Wong" Reviewed-by: Chaitanya Kulkarni Reviewed-by: Martin K. Petersen --- v3->v4: - Fix a minor grammatical mistake. v2->v3: - Say less about what the filesystem actually implements as Darrick suggested and clarify the reason why "--keep-size" cannot be used together in the man page. - Modify the verbose output message. v1->v2: - Minor description modification to align with the kernel. 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..69602f01c 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, written blocks are preallocated fo= r the regions that span the holes in the file. After a successful call, sub= sequent reads from this range will return zeroes and subsequent writes to t= hat range do not require further changes to the file mapping metadata. ++ +Zeroing is done within the filesystem. The filesystem may use a hardware-a= ccelerated zeroing command or may submit regular writes. The behavior depen= ds on the filesystem design and the available hardware. ++ +Options *--keep-size* cannot be specified for the write-zeroes operation b= ecause allocating written blocks beyond the inode size is not permitted. + include::man-common/help-version.adoc[] =20 =3D=3D AUTHORS diff --git a/sys-utils/fallocate.c b/sys-utils/fallocate.c index 13bf52915..afd615537 100644 --- a/sys-utils/fallocate.c +++ b/sys-utils/fallocate.c @@ -40,7 +40,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 @@ -65,6 +65,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" @@ -94,6 +98,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 @@ -304,6 +309,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' }, @@ -312,8 +318,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; @@ -323,7 +329,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); @@ -353,6 +359,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; @@ -429,6 +438,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) written as zeroes.\n"), + filename, str, length); else fprintf(stdout, _("%s: %s (%ju bytes) allocated.\n"), filename, str, length); --=20 2.39.2