From: Brian Foster <bfoster@redhat.com>
To: linux-xfs@vger.kernel.org
Subject: [PATCH v3 4/4] xfs: incorporate increased AGFL min requirement for minleft allocs
Date: Wed, 2 Sep 2026 13:40:25 -0400 [thread overview]
Message-ID: <20260902174025.284387-5-bfoster@redhat.com> (raw)
In-Reply-To: <20260902174025.284387-1-bfoster@redhat.com>
Matt Fleming reports a filesystem shutdown due to inobt block
allocation failure during sparse chunk allocation. Inode creation
can involve multiple allocations in a transaction: the initial chunk
allocation and inode btree blocks via inobt record insertion. This
is expected to be safe by using the minleft parameter on the chunk
allocation to guarantee the selected AG has blocks available for
a followup inobt insertion.
The sequence that leads to this failure is that the alloc and inode
btrees are all full (require a full split on next insertion) and the
AG has just enough free space to satisfy a sparse chunk allocation
with minleft set (i.e. 7 blocks in this example). The chunk
allocation splits a free extent, triggers full allocbt splits, and
consumes 4 free blocks for the chunk and 4 AGFL blocks for the
btrees.
Next, the inobt record insertion triggers an inobt split. The AG has
enough free blocks, but the allocbt splits caused by the chunk
allocation have increased the min AGFL requirement for the AG due to
btree level increases. The AGFL requirement as calculated by
xfs_alloc_fix_freelist() is:
free + AGFL - res - minfree - minleft = avail
This evaluates to the following on initial chunk allocation:
2514 + 8 - 2505 - 8 - 2 = 7
... and then after the chunk allocation but before the inobt block
allocation:
2510 + 4 - 2505 - 12 - 0 = -3
This causes the inobt alloc to fail despite minleft being set in the
first allocation. The error path cancels the dirty transaction and
shuts down the fs. The problem here is that while minleft ensures
free blocks are available for the inobt insert, it is not sufficient
to cover the increase of the AGFL min free requirement.
To address this, first have xfs_alloc_freelist() return both min and
max freelist values. The min value is the current AGFL requirement
and remains used for actual AGFL sizing. The max value calculates
the worst case AGFL requirement after potential allocbt splits
during the current allocation. Incorporate the max value into space
availability checks for AG selection and the longest free extent
calculation. The latter is necessary because callers like the bmap
layer can size allocation requests based on the longest free extent.
Without this, aligned allocs can end up oversized, prematurely fail,
and fall back to non-aligned to make up the difference.
This ensures the selected AG has enough blocks for both the caller's
minleft value and the worst case AGFL increase. In the example
above, the initial calculation now evaluates to 3 blocks available
instead of 7 and the inode allocation fails gracefully with -ENOSPC.
Assisted-by: LLM
Reported-by: Matt Fleming <matt@readmodwrite.com>
Signed-off-by: Brian Foster <bfoster@redhat.com>
---
fs/xfs/libxfs/xfs_alloc.c | 58 +++++++++++++++++++++++++++------------
fs/xfs/libxfs/xfs_alloc.h | 3 +-
fs/xfs/libxfs/xfs_bmap.c | 6 ++--
3 files changed, 47 insertions(+), 20 deletions(-)
diff --git a/fs/xfs/libxfs/xfs_alloc.c b/fs/xfs/libxfs/xfs_alloc.c
index 1377c65d694e..2ed269080bbb 100644
--- a/fs/xfs/libxfs/xfs_alloc.c
+++ b/fs/xfs/libxfs/xfs_alloc.c
@@ -2397,31 +2397,36 @@ xfs_alloc_compute_maxlevels(
}
/*
- * Find the length of the longest extent in an AG. The 'need' parameter
- * specifies how much space we're going to need for the AGFL and the
- * 'reserved' parameter tells us how many blocks in this AG are reserved for
+ * Find the length of the longest extent in an AG. The @min_free and @max_free
+ * parameters specify how much space we're going to need for the AGFL and the
+ * @reserved parameter tells us how many blocks in this AG are reserved for
* other callers.
*/
xfs_extlen_t
xfs_alloc_longest_free_extent(
struct xfs_perag *pag,
- xfs_extlen_t need,
+ xfs_extlen_t min_free,
+ xfs_extlen_t max_free,
xfs_extlen_t reserved)
{
xfs_extlen_t delta = 0;
/*
- * If the AGFL needs a recharge, we'll have to subtract that from the
- * longest extent.
+ * If the AGFL needs a recharge, subtract that from the longest extent
+ * because AGFL refill happens before the alloc.
*/
- if (need > pag->pagf_flcount)
- delta = need - pag->pagf_flcount;
+ if (min_free > pag->pagf_flcount)
+ delta = min_free - pag->pagf_flcount;
/*
- * If we cannot maintain others' reservations with space from the
- * not-longest freesp extents, we'll have to subtract /that/ from
- * the longest extent too.
+ * Extra AGFL blocks beyond the min are reserved by ->minleft during
+ * allocation. Similar to reserved, these blocks are not available to
+ * this allocation. Check if we can preserve the combined total without
+ * the longest extent. If not, deduct the necessary blocks from the
+ * longest extent.
*/
+ if (max_free > min_free)
+ reserved += max_free - min_free;
if (pag->pagf_freeblks - pag->pagf_longest < reserved)
delta += reserved - (pag->pagf_freeblks - pag->pagf_longest);
@@ -2519,6 +2524,7 @@ static bool
xfs_alloc_space_available(
struct xfs_alloc_arg *args,
xfs_extlen_t min_free,
+ xfs_extlen_t max_free,
int flags)
{
struct xfs_perag *pag = args->pag;
@@ -2526,15 +2532,32 @@ xfs_alloc_space_available(
xfs_extlen_t reservation; /* blocks that are still reserved */
int available;
xfs_extlen_t agflcount;
+ xfs_extlen_t minleft;
if (flags & XFS_ALLOC_FLAG_FREEING)
return true;
reservation = xfs_ag_resv_needed(pag, args->resv);
+ /*
+ * minleft implies a multi-alloc transaction. If set, the first alloc
+ * might cause btree splits that increase the AGFL requirement for the
+ * next. This worst case requirement is calculated in max_free.
+ *
+ * We don't prepopulate the AGFL because we don't know in advance if
+ * splits will occur. Instead, add the delta to minleft so it is
+ * accounted for in AG selection. This ensures the AG has enough space
+ * for the caller's minleft plus that needed to repopulate the AGFL on
+ * the next alloc if splits do occur.
+ */
+ minleft = args->minleft;
+ if (minleft)
+ minleft += max_free - min_free;
+
/* do we have enough contiguous free space for the allocation? */
alloc_len = args->minlen + (args->alignment - 1) + args->minalignslop;
- longest = xfs_alloc_longest_free_extent(pag, min_free, reservation);
+ longest = xfs_alloc_longest_free_extent(pag, min_free,
+ minleft ? max_free : min_free, reservation);
if (longest < alloc_len)
return false;
@@ -2545,7 +2568,7 @@ xfs_alloc_space_available(
*/
agflcount = min_t(xfs_extlen_t, pag->pagf_flcount, min_free);
available = (int)(pag->pagf_freeblks + agflcount -
- reservation - min_free - args->minleft);
+ reservation - min_free - minleft);
if (available < (int)max(args->total, alloc_len))
return false;
@@ -2859,6 +2882,7 @@ xfs_alloc_fix_freelist(
struct xfs_alloc_arg targs; /* local allocation arguments */
xfs_agblock_t bno; /* freelist block */
xfs_extlen_t min_free;/* total blocks needed in freelist */
+ xfs_extlen_t max_free; /* max freelist requirement */
int error = 0;
/* deferred ops (AGFL block frees) require permanent transactions */
@@ -2886,8 +2910,8 @@ xfs_alloc_fix_freelist(
goto out_agbp_relse;
}
- xfs_alloc_freelist(mp, pag, &min_free, NULL);
- if (!xfs_alloc_space_available(args, min_free, alloc_flags |
+ xfs_alloc_freelist(mp, pag, &min_free, &max_free);
+ if (!xfs_alloc_space_available(args, min_free, max_free, alloc_flags |
XFS_ALLOC_FLAG_CHECK))
goto out_agbp_relse;
@@ -2910,8 +2934,8 @@ xfs_alloc_fix_freelist(
xfs_agfl_reset(tp, agbp, pag);
/* If there isn't enough total space or single-extent, reject it. */
- xfs_alloc_freelist(mp, pag, &min_free, NULL);
- if (!xfs_alloc_space_available(args, min_free, alloc_flags))
+ xfs_alloc_freelist(mp, pag, &min_free, &max_free);
+ if (!xfs_alloc_space_available(args, min_free, max_free, alloc_flags))
goto out_agbp_relse;
if (IS_ENABLED(CONFIG_XFS_DEBUG) && args->alloc_minlen_only) {
diff --git a/fs/xfs/libxfs/xfs_alloc.h b/fs/xfs/libxfs/xfs_alloc.h
index 44a10f4a22a2..5812c9b5e609 100644
--- a/fs/xfs/libxfs/xfs_alloc.h
+++ b/fs/xfs/libxfs/xfs_alloc.h
@@ -70,7 +70,8 @@ unsigned int xfs_alloc_set_aside(struct xfs_mount *mp);
unsigned int xfs_alloc_ag_max_usable(struct xfs_mount *mp);
xfs_extlen_t xfs_alloc_longest_free_extent(struct xfs_perag *pag,
- xfs_extlen_t need, xfs_extlen_t reserved);
+ xfs_extlen_t min_free, xfs_extlen_t max_free,
+ xfs_extlen_t reserved);
void xfs_alloc_freelist(struct xfs_mount *mp, struct xfs_perag *pag,
unsigned int *min_free, unsigned int *max_free);
int xfs_alloc_get_freelist(struct xfs_perag *pag, struct xfs_trans *tp,
diff --git a/fs/xfs/libxfs/xfs_bmap.c b/fs/xfs/libxfs/xfs_bmap.c
index 17604e510ffc..d5b6b0592158 100644
--- a/fs/xfs/libxfs/xfs_bmap.c
+++ b/fs/xfs/libxfs/xfs_bmap.c
@@ -3151,6 +3151,7 @@ xfs_bmap_longest_free_extent(
{
xfs_extlen_t longest;
unsigned int min_free;
+ unsigned int max_free;
int error = 0;
if (!xfs_perag_initialised_agf(pag)) {
@@ -3160,8 +3161,9 @@ xfs_bmap_longest_free_extent(
return error;
}
- xfs_alloc_freelist(pag_mount(pag), pag, &min_free, NULL);
- longest = xfs_alloc_longest_free_extent(pag, min_free,
+ /* bmap allocs always have minleft set, so account for max_free */
+ xfs_alloc_freelist(pag_mount(pag), pag, &min_free, &max_free);
+ longest = xfs_alloc_longest_free_extent(pag, min_free, max_free,
xfs_ag_resv_needed(pag, XFS_AG_RESV_NONE));
if (*blen < longest)
*blen = longest;
--
2.55.0
next prev parent reply other threads:[~2026-09-02 17:40 UTC|newest]
Thread overview: 8+ messages / expand[flat|nested] mbox.gz Atom feed top
2026-09-02 17:40 [PATCH v3 0/4] xfs: fix a couple sparse chunk alloc problems Brian Foster
2026-09-02 17:40 ` [PATCH v3 1/4] xfs: set minleft correctly for sparse chunk errortag allocation Brian Foster
2026-09-02 17:40 ` [PATCH v3 2/4] xfs: support additional levels in the agfl minimum calculation Brian Foster
2026-09-03 16:58 ` [External] : " Mark Tinguely
2026-09-02 17:40 ` [PATCH v3 3/4] xfs: calculate AGFL max to support multiple-alloc transactions Brian Foster
2026-09-04 13:55 ` [External] : " Mark Tinguely
2026-09-02 17:40 ` Brian Foster [this message]
2026-09-04 14:00 ` [External] : [PATCH v3 4/4] xfs: incorporate increased AGFL min requirement for minleft allocs Mark Tinguely
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=20260902174025.284387-5-bfoster@redhat.com \
--to=bfoster@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 an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.