b10105
ggml-org/llama.cppb10105Jul 24, 2026by github-actions[bot]same day as b10103
What changed since b10103
CLI flags mmap, mlock, and directio are consolidated into a single `load-mode` argument, changing command-line usage.
Breaking changes
- The `--mmap`, `--mlock`, and `--directio` flags are replaced by a unified `--load-mode` argument, so existing scripts using the old flags must be updated.
- Argument parsing behavior changed, including how `+` modifiers and inverse commands are interpreted, which may alter existing command semantics.
New features
- A single `load-mode` argument now controls mmap, mlock, and directio behavior.
- Deprecated flags are still accepted for backward compatibility, though they map onto the new load-mode system.
Improvements
- Argument handling was overhauled and unified across llama-cli and llama-bench for consistency.
- Documentation was regenerated to reflect the new argument scheme.
- Internal cleanup and comments were added around the argument parsing code.
Bug fixes
- Fixed deprecated flag support so legacy flags continue to work after the refactor.
- Corrected variable behavior and the llama-bench `lm` column sizing.
- Fixed missing modifiers for deprecated flags and an incorrect dash in llama-bench.
Upgrade notes
Update any scripts or tooling that pass `--mmap`, `--mlock`, or `--directio` to use `--load-mode` instead; deprecated flags are still accepted but should be migrated. Verify behavior of `+` modifiers and inverse commands, as their semantics were tightened in this refactor. Re-check llama-bench invocations for the corrected flag parsing.
Analyzed Nov 1, 2026
Upgrading?
Release notes summary
Refactors mmap, mlock, and directio arguments into a single unified `load-mode` argument, requiring a change in command-line usage.
Key Highlights
- Refactor mlock/mmap/directio into load-mode
- Deprecated flags support
- Unified argument handling
Release Notes (excerpt)
<details open> args: refactor mlock/mmap/directio into load-mode (#20834) * args: overhaul mmap/mlock/dio into single arg Signed-off-by: Aaron Teo <aaron.teo1@ibm.com> * docs: update docs with llama-gen-docs Signed-off-by: Aaron Teo <aaron.teo1@ibm.com> * chore: satisfy code quality Signed-off-by: Aaron Teo <aaron.teo1@ibm.com> * args: make the `+` sign an actual modifier now Signed-off-by: Aaron Teo <aaron.teo1@ibm.com> * chore: general code clean up + comments…
Published by ggml-org on GitHub.
Read the full release notesRelated Repositories
:electron: Build cross-platform desktop apps with JavaScript, HTML, and CSS
Godot Engine – Multi-platform 2D and 3D game engine
ClickHouse® is a real-time analytics database management system
Self-hosted game stream host for Moonlight.
DuckDB is a high-performance analytical database system