Skip to content

Fix silent Metal grid truncation in softmax, logsumexp, rms_norm and layer_norm past 2^27 rows - #4717

Open
ArupKantiDas wants to merge 2 commits into
ml-explore:mainfrom
ArupKantiDas:fix-row-kernel-grid-overflow
Open

ArupKantiDas wants to merge 2 commits into
ml-explore:mainfrom
ArupKantiDas:fix-row-kernel-grid-overflow

Conversation

@ArupKantiDas

Copy link
Copy Markdown

Issue

For running operations like softmax, logsumexp, rms_norm and layer_norm on the Mac GPU, each row used to get 1 threadgroup launched in one long grid, set up one after the other.
The grid passed 2^32 threads at somewhere around 2^27 rows (of 128 numbers or fewer).
Metal cuts the grid off silently, because of which most of the rows were never even computed and came back as 0.
The layer_norm gradient and the long-row rms_norm gradient have the exact same problem.

Fix

The new helper in utils.h named dispatch_threadgroups_in_slices splits the oversized launches into slices that actually fit, and each slice then binds the input and output at its first row, so the GPU kernels stay unchanged.
The inputs that already fit still use exactly one launch, which is the same idea as the reductions fix done in #4437.
The row counts changed from int to int64_t, and the rms_norm gradient for short rows is also untouched, since it already uses at most about 512 teams.

Test and Reproduction

First I reproduced the issue on my M5 Pro, 0.32.4, at the following boundaries: [2^27 - 1] rows correct, [2^27] rows all wrong, [2^27 + 1000] rows with only first 1000 correct.
Then 134M and 402M random rows compared against MLX's CPU result, of which there were 0 mismatches after the fix.
Added 3 new tests (softmax/logsumexp, rms_norm/layer_norm, layer_norm gradient). They fail on 0.32.4 and pass with the fix applied.
The gradient test is skipped in CI because it uses about 6.5 GB of memory.
The full suite ran with 996 of them, out of which 56 were skipped.

Fixes #4624

Benchmarks

Milliseconds per call, float16 inputs, both main and the fix built with Xcode, measured on my M5 Pro.

shape op main (ms) fix (ms)
(16384, 4096) softmax 1.216 1.207
(16384, 4096) layer_norm 1.218 1.200
(262144, 1024) rms_norm 4.184 4.175
(4194304, 64) logsumexp 4.434 4.414

The cross_entropy and the attention fallback use the same launch pattern and are not fixed in this PR. Can be taken up in a later PR.

  • ☑️ I understand it is strictly prohibited to use AI to write PR description
  • AI usage disclosure: Claude Code helped do the repro, write the fix and the tests on my guidance. I directed the work and reviewed the result.

@zcbenz zcbenz left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Would it worth replacing the dispatch_col_reduce introduced in #4437 with dispatch_threadgroups_in_slices?

@zcbenz zcbenz added the await response This pull request is waiting for response from the author. label Oct 23, 2026
@ArupKantiDas

Copy link
Copy Markdown
Author

Yes, it is, but only after one small extension: optional y/z grid sizes, default to 1.

The reduction's offset, which is set from the callback, stays as a kernel argument because it needs the absolute column for its bounds check.

The dispatch_col_reduce goes away, and its 4 callers in reduce.cpp use the shared helper.

Should I add it to this PR, or as a follow-up if you'd rather keep this one small.

softmax, logsumexp, rms_norm and layer_norm (and the layer_norm VJP and the
looped rms_norm VJP) launch one threadgroup per row in a 1D grid. Once
rows * threadgroup size passes 2^32, Metal truncates the grid width, so most
rows are never computed and silently come back as zeros.

Launch the rows in slices that each fit in one grid, and bind the input and
output buffers at each slice's first row. Launches that already fit are
unchanged and still use a single dispatch.

Fixes ml-explore#4624
dispatch_col_reduce from ml-explore#4437 does the same slicing as the new helper.
Give the helper optional grid_y and grid_z sizes, use it for the four
column reduction dispatches, and remove dispatch_col_reduce.

The reductions still set each slice's start as the column_offset kernel
argument (from the bind callback), because the kernel needs the absolute
column for its bounds check.
@zcbenz

zcbenz commented Oct 23, 2026

Copy link
Copy Markdown
Member

Please add it to this PR, thanks for looking into it!

@ArupKantiDas
ArupKantiDas force-pushed the fix-row-kernel-grid-overflow branch from 8c08681 to 6ca0320 Compare October 24, 2026 05:24
@ArupKantiDas

Copy link
Copy Markdown
Author

Thanks for the confirmation. It's done, I've added the change to this PR as a separate commit and also rebased onto the latest main.
Now the helper takes optional grid_y / grid_z (default 1) and the 4 column-reduction callers use it. Then dispatch_col_reduce is removed and column_offset is still set as kernel argument 11 from the callback.
For the correctness check on the looped path, a sum over axis 0 of a (32, 536870976) uint8 array, through the split launches. 0.32.3 (before #4437) gets 460M columns wrong whereas 0.32.4 and this branch get 0.
Ran the full suite: 1,004 tests ran, all passed (56 skipped).

Reduction benchmarks (float16, ms per call, M5 Pro):

case main branch
sum axis 0, (32, 1048576) 0.455 0.451
sum axis 0, (4096, 4096) 0.310 0.308
sum axis 0, (64, 512, 768) 0.354 0.355
sum axis 1, (8, 2048, 4096) 0.807 0.794
sum axis 0, (2048, 16) 0.167 0.166

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[BUG] Metal softmax / logsumexp / rms_norm / layer_norm drop rows when grid width exceeds 2^32

2 participants