Linux XFS filesystem development
 help / color / mirror / Atom feed
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


             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