[Metal] Fix copy_buffer_1byte dispatch grid (#24640) copy_buffer_1byte silently dropped the trailing ~3/4 of every copy that fell back to the compute-kernel path. The kernel copies one byte per thread, but its dispatch grid was sized as ceil(length / (workgroup_size * 4)) -- a quarter of the required ceil(length / workgroup_size) workgroups -- so only the first min(ceil(length/128)*32, length) bytes were written and the tail was left untouched. The bounds guard `if (id >= spec.length) return` prevents over-run but cannot launch the missing threads. On macOS the compute path is taken whenever the source offset, target offset, or length is not a multiple of 4 (the Metal blit fast-path requires all three 4-byte aligned). It is also the path behind the staging->device upload (iree_hal_metal_command_buffer_prepare_update_buffer), so non-4-aligned source uploads were truncated too -- a device copy then read a zeroed source tail. The *4 multiplier is correct for the fill kernels (fill_buffer_16byte / fill_buffer_4byte / fill_buffer_1byte process 16/4/4 bytes per thread respectively), which is where it was copied from; copy_buffer_1byte is a flat 1-byte-per-thread loop with no such expansion. Fix (dispatch only -- the copy_buffer_1byte.metal kernel is unchanged): size the grid as ceil(length / workgroup_size) so the launched thread count (ceil(length/32) * 32) covers every byte. The existing `if (id >= spec.length) return` guard masks the surplus threads in the final workgroup. Verified: CTS/CommandBufferCopyBufferTest.CopySizeAndAlignmentClasses/metal now passes all alignment/size sub-cases that previously truncated (offset/length not a multiple of 4; lengths 31/32/33/.../65536 across all alignment classes). The aligned16_mib sub-case still fails, independently, from a staging-buffer capacity issue (128 KiB staging buffer vs. a 1 MiB single-command-buffer upload), not from this dispatch sizing. Signed-off-by: Alex Vasile <48962821+Alex-Vasile@users.noreply.github.com> Signed-off-by: Alex Vasile <48962821+Alex-Vasile@users.noreply.github.com>
IREE (Intermediate Representation Execution Environment, pronounced as “eerie”) is an MLIR-based end-to-end compiler and runtime that lowers Machine Learning (ML) models to a unified IR that scales up to meet the needs of the datacenter and down to satisfy the constraints and special considerations of mobile and edge deployments.
See our website for project details, user guides, and instructions on building from source.
Releases notes are published on GitHub releases.
| Package | Release status |
|---|---|
| GitHub release (stable) | |
| GitHub release (nightly) | |
iree-base-compiler | |
iree-base-runtime |
For more details on the release process, see https://iree.dev/developers/general/release-management/.
| Operating system | Build status |
|---|---|
| Linux | |
| macOS | |
| macOS |
For the full list of workflows see https://iree.dev/developers/general/github-actions/.
See our website for more information.
Community meeting recordings: IREE YouTube channel
| Date | Title | Recording | Slides |
|---|---|---|---|
| 2025-06-10 | Data-Tiling in IREE: Achieving High Performance Through Compiler Design (AsiaLLVM) | recording | slides |
| 2025-05-17 | Introduction to GPU architecture and IREE's GPU CodeGen Pipeline | recording | slides |
| 2025-02-12 | The Long Tail of AI: SPIR-V in IREE and MLIR (Vulkanised) | recording | slides |
| 2024-10-01 | Unveiling the Inner Workings of IREE: An MLIR-Based Compiler for Diverse Hardware | recording | |
| 2021-06-09 | IREE Runtime Design Tech Talk | recording | slides |
| 2020-08-20 | IREE CodeGen (MLIR Open Design Meeting) | recording | slides |
| 2020-03-18 | Interactive HAL IR Walkthrough | recording | |
| 2020-01-31 | End-to-end MLIR Workflow in IREE (MLIR Open Design Meeting) | recording | slides |
IREE is licensed under the terms of the Apache 2.0 License with LLVM Exceptions. See LICENSE for more information.