From: Eric Sandeen <sandeen@redhat.com>
To: linux-xfs@vger.kernel.org
Cc: Eric Sandeen <sandeen@redhat.com>
Subject: [PATCH] mkfs: Emit a clearer message if too-small log is due to AG geometry
Date: Wed, 26 Aug 2026 22:42:28 -0500 [thread overview]
Message-ID: <20260827034228.938740-1-sandeen@redhat.com> (raw)
There is a constraint in mkfs.xfs that logs must not be smaller than
64MiB. We can arrive at a too-small log without specifying its size,
though, if we specify so many AGs (or such small AGs) that a single
AG cannot hold the minimum-sized log. This leads to confusing output:
$ truncate --size=500m testfile
$ mkfs.xfs -dagcount=10 testfile
Log size must be at least 64MiB.
Usage: mkfs.xfs
...
because the user did not specify the log size at all! If this error
occurs due to the AG geometry specification, make that clear with a
better error message.
Signed-off-by: Eric Sandeen <sandeen@redhat.com>
---
mkfs/xfs_mkfs.c | 19 ++++++++++++++++++-
1 file changed, 18 insertions(+), 1 deletion(-)
diff --git a/mkfs/xfs_mkfs.c b/mkfs/xfs_mkfs.c
index a4864c37..0c72422c 100644
--- a/mkfs/xfs_mkfs.c
+++ b/mkfs/xfs_mkfs.c
@@ -3456,8 +3456,25 @@ validate_supported(
*/
if (mp->m_sb.sb_logblocks <
XFS_MIN_REALISTIC_LOG_BLOCKS(mp->m_sb.sb_blocklog)) {
- fprintf(stderr,
+ /*
+ * An internal log must fit within a single allocation group.
+ * If the user constrained the AG geometry but didn't ask for a
+ * specific log size, the undersized log is a consequence of
+ * allocation groups that are too small, not a log size the user
+ * chose. Point them at the real cause.
+ */
+ if (!cli_opt_set(&lopts, L_SIZE) &&
+ (cli_opt_set(&dopts, D_AGCOUNT) ||
+ cli_opt_set(&dopts, D_AGSIZE))) {
+ fprintf(stderr,
+ _("Allocation group size (%lld MiB) is too small to hold the minimum 64MiB log.\n"
+ "Specify fewer or larger allocation groups, or use a larger data device.\n"),
+ ((long long)mp->m_sb.sb_agblocks <<
+ mp->m_sb.sb_blocklog) >> 20);
+ } else {
+ fprintf(stderr,
_("Log size must be at least 64MiB.\n"));
+ }
usage();
}
--
2.55.0
next reply other threads:[~2026-08-27 3:42 UTC|newest]
Thread overview: 5+ messages / expand[flat|nested] mbox.gz Atom feed top
2026-08-27 3:42 Eric Sandeen [this message]
2026-08-27 3:49 ` [PATCH V2] mkfs: Emit a clearer message if too-small log is due to AG geometry Eric Sandeen
2026-08-27 5:01 ` Darrick J. Wong
2026-08-27 13:19 ` Eric Sandeen
2026-08-27 14:38 ` Darrick J. Wong
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20260827034228.938740-1-sandeen@redhat.com \
--to=sandeen@redhat.com \
--cc=linux-xfs@vger.kernel.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox