b10105

ggml-org/llama.cppb10105Jul 24, 2026by github-actions[bot]same day as b10103

What changed since b10103

high risk

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 notes

Related Repositories