mirror of https://lore.kernel.org/lkml/
 help / color / mirror / Atom feed
* [PATCH] docs: ext4 filesystems can be converted to 64-bit
@ 2026-10-14 16:29 Stephen Kitt
  2026-10-25 14:18 ` Daniel Pereira
  0 siblings, 1 reply; 2+ messages in thread
From: Stephen Kitt @ 2026-10-14 16:29 UTC (permalink / raw)
  To: Theodore Ts'o, Andreas Dilger
  Cc: Stephen Kitt, Jonathan Corbet, linux-ext4, linux-doc, linux-kernel

Since commit fe12931 ("resize2fs: convert fs to and from 64bit mode")
in e2fsprogs, which shipped in version 1.43, resize2fs can convert
filesystems from 32-bit to 64-bit and back, so the mention in the
checksum documentation that this is impossible is obsolete. This fixes
that.

Signed-off-by: Stephen Kitt <steve@sk2.org>
---
 Documentation/filesystems/ext4/checksums.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/Documentation/filesystems/ext4/checksums.rst b/Documentation/filesystems/ext4/checksums.rst
index e232749daf5f..51a2150a1bf8 100644
--- a/Documentation/filesystems/ext4/checksums.rst
+++ b/Documentation/filesystems/ext4/checksums.rst
@@ -10,9 +10,9 @@ of October 2012 the only supported algorithm is crc32c. Some data
 structures did not have space to fit a full 32-bit checksum, so only the
 lower 16 bits are stored. Enabling the 64bit feature increases the data
 structure size so that full 32-bit checksums can be stored for many data
-structures. However, existing 32-bit filesystems cannot be extended to
-enable 64bit mode, at least not without the experimental resize2fs
-patches to do so.
+structures. ``resize2fs`` in ``e2fsprogs`` 1.43 or later can be used to
+convert filesystems from 32-bit to 64-bit and back (using the ``-b``
+and ``-s`` options).
 
 Existing filesystems can have checksumming added by running
 ``tune2fs -O metadata_csum`` against the underlying device. If tune2fs
-- 
2.56.0


^ permalink raw reply	[flat|nested] 2+ messages in thread

* Re: [PATCH] docs: ext4 filesystems can be converted to 64-bit
  2026-10-14 16:29 [PATCH] docs: ext4 filesystems can be converted to 64-bit Stephen Kitt
@ 2026-10-25 14:18 ` Daniel Pereira
  0 siblings, 0 replies; 2+ messages in thread
From: Daniel Pereira @ 2026-10-25 14:18 UTC (permalink / raw)
  To: steve; +Cc: tytso, adilger.kernel, corbet, linux-ext4, linux-doc, linux-kernel

On Wed, Oct 14, 2026, Stephen Kitt wrote:
> Since commit fe12931 ("resize2fs: convert fs to and from 64bit mode")
> in e2fsprogs, which shipped in version 1.43, resize2fs can convert
> filesystems from 32-bit to 64-bit and back, so the mention in the
> checksum documentation that this is impossible is obsolete.

Hi Stephen,

I checked the claims against the e2fsprogs sources: commit fe12931 is
"resize2fs: convert fs to and from 64bit mode" (Darrick J. Wong), the
v1.43 RELEASE-NOTES say that resize2fs can now convert file systems
between 64-bit and 32-bit mode, and resize/main.c at v1.43 accepts -b
(enable 64bit) and -s (disable 64bit), which v1.42.13 does not have. So
the new text is accurate. This was also the only place in
Documentation/filesystems/ext4/ that mentioned the old limitation.

I built the documentation with the patch applied and it adds no new
warnings. checkpatch only complains about the unknown commit id, which
is expected since it is an e2fsprogs commit.

One optional suggestion, which does not change my review: in v1.43
resize2fs refuses to change the 64bit feature while the filesystem is
mounted ("Cannot change the 64bit feature while the filesystem is
mounted."), and enabling it also requires the extents feature. Since
the sentence replaces one that was about a limitation, it might be
worth saying that the conversion is done on an unmounted filesystem,
for example:

``resize2fs`` in ``e2fsprogs`` 1.43 or later can be used to convert
unmounted filesystems from 32-bit to 64-bit and back (using the
``-b`` and ``-s`` options).

Reviewed-by: Daniel Pereira <danielmaraboo@gmail.com>

Thanks,
Daniel

^ permalink raw reply	[flat|nested] 2+ messages in thread

end of thread, other threads:[~2026-10-25 14:19 UTC | newest]

Thread overview: 2+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2026-10-14 16:29 [PATCH] docs: ext4 filesystems can be converted to 64-bit Stephen Kitt
2026-10-25 14:18 ` Daniel Pereira

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox

all inboxes | Powered by JetHome®