[PATCH v2 00/11] f2fs: prepare metadata layouts for runtime block sizes

From: Xinping Zhang

Date: Sat Aug 29 2026 - 13:49:15 EST


F2FS currently describes several on-disk metadata layouts and filesystem
geometry values with constants derived from PAGE_SIZE or a fixed 4KB block
size. This series derives those values from the mounted filesystem's block
size instead, as preparation for supporting filesystem blocks smaller than
PAGE_SIZE.

The patches initialize sb_info early, describe the SIT, NAT, orphan, dentry,
node, and xattr layouts dynamically, parameterize sector/byte/block
conversion helpers, and derive node-tree geometry at runtime.

This series does not relax the block-size mount check or enable subpage I/O.
It is intended to be a behavior-preserving refactoring for currently
supported 4KB-block filesystems.

Changes since v1:
- rebase onto f2fs/dev at c966d29e01bb
- drop the unrelated free-NID underflow fix from this series
- split the preparatory changes into 11 focused patches
- initialize sb_info earlier and describe the xattr layout explicitly
- separate sector, byte/block, and block-size macro parameterization
- update commit messages and address checkpatch warnings

v1: https://lore.kernel.org/linux-f2fs-devel/CAH=xXfFVAwQ3r_NdUDtmXhtg6Lw8kDWoNTzGL5oy4mwHMsJLJw@xxxxxxxxxxxxxx/

Tested with:
- x86_64 F2FS build at every patch
- arm64 16KB-page F2FS build at the series tip
- scripts/checkpatch.pl --strict (no errors or warnings)

Kelvin Zhang (11):
f2fs: initialize sb_info early in f2fs_fill_super
f2fs: describe SIT block layout dynamically
f2fs: describe NAT block layout dynamically
f2fs: describe orphan block layout dynamically
f2fs: describe dentry block layout dynamically
f2fs: describe {i,d,id}node block layout dynamically
f2fs: describe xattr block layout dynamically
f2fs: parameterize sector conversion macros
f2fs: parameterize byte and block conversion macros
f2fs: parameterize block size and mask macros
f2fs: describe node tree geometry dynamically

fs/f2fs/checkpoint.c | 75 ++++++++++--------
fs/f2fs/data.c | 85 +++++++++++---------
fs/f2fs/debug.c | 4 +-
fs/f2fs/dir.c | 51 ++++++------
fs/f2fs/extent_cache.c | 6 +-
fs/f2fs/f2fs.h | 122 +++++++++++++++++++++-------
fs/f2fs/file.c | 84 +++++++++++---------
fs/f2fs/gc.c | 27 ++++---
fs/f2fs/inline.c | 11 ++-
fs/f2fs/inode.c | 22 +++---
fs/f2fs/node.c | 171 +++++++++++++++++++++-------------------
fs/f2fs/node.h | 89 +++++++++++----------
fs/f2fs/recovery.c | 4 +-
fs/f2fs/segment.c | 60 +++++++-------
fs/f2fs/segment.h | 32 ++++----
fs/f2fs/shrinker.c | 2 +-
fs/f2fs/super.c | 83 +++++++++++++------
fs/f2fs/sysfs.c | 10 +--
fs/f2fs/verity.c | 6 +-
fs/f2fs/xattr.c | 10 ++-
fs/f2fs/xattr.h | 15 ++--
include/linux/f2fs_fs.h | 131 ++++++++++++++++--------------
22 files changed, 636 insertions(+), 464 deletions(-)


base-commit: c966d29e01bbf829f8bb4a39a49811c56cdb49c3
--
2.53.0