koboldcpp/docs
Nick Farrell cd8cdf397d
sycl: attribute device allocations by site (GGML_SYCL_MEMTRACE) (#27631)
define two new environment variables to better understand how much
memory is being allocated, and when. This has been invaluable in
inproving the --fit algorithm, and is likely to be useful when debugging
other memory-related issues.

`-lv 4` will be required to enable the following:

GGML_SYCL_MEMTRACE=1 will show per-site memory usage, updated whenever
it increases by more than 64MiB.
GGML_SYCL_MEMTRACE=2 will show every allocation and deallocation.

To change the default 64MiB threshold for reporting memory usage increases, use
GGML_SYCL_MEMTRACE_STEP.

A sample log line:
[SYCL-MEMTRACE] device memory query (dev): total 59493 MiB, free  4494, in use 54998; allocated     0 (buffers     0 + scratch     0), peak     0 MiB
2026-09-04 22:36:02 -04:00
..
android android: fix missing screenshots for Android.md (#18156) 2025-12-19 09:32:04 +02:00
backend sycl: attribute device allocations by site (GGML_SYCL_MEMTRACE) (#27631) 2026-09-04 22:36:02 -04:00
development model: use ggml_rope_set_offset() (#27382) 2026-08-21 18:54:29 +02:00
multimodal docs : fix duplicated "the" in granitevision and model-conversion docs (#23767) 2026-05-27 09:34:06 +02:00
ops ops: add Hexagon to ops.md and update main README.md (#28263) 2026-09-03 07:14:36 -07:00
android.md kleidiai : Update KleidiAI Documentation (#26078) 2026-09-01 10:45:13 +02:00
autoparser.md test: move tools/parser to tests (#27548) 2026-08-23 18:38:51 +02:00
build-riscv64-spacemit.md ci : update spacemit toolchain url and enhance curl command (#23642) 2026-05-25 10:43:24 +02:00
build-s390x.md docs: update s390x build docs (#19643) 2026-02-16 00:33:34 +08:00
build.md ggml : remove GGML_CUDA_PEER_MAX_BATCH_SIZE (#28177) 2026-09-04 10:22:01 +03:00
completions.md readme : refresh (#26280) 2026-07-30 16:14:37 +03:00
docker.md sycl : Improve SYCL doc (#23025) 2026-06-04 08:02:54 +03:00
function-calling.md docs: Update documentation with Granite 4.0/4.1 (#23404) 2026-05-22 20:35:46 +08:00
install.md docs: Adapt conda-forge package name (#26229) 2026-07-28 16:51:20 +02:00
llguidance.md llguidance build fixes for Windows (#11664) 2025-02-14 12:46:08 -08:00
models.md readme : refresh (#26280) 2026-07-30 16:14:37 +03:00
multi-gpu.md Write a readme on Multi-GPU usage in llama.cpp (#22729) 2026-05-07 17:48:40 +02:00
multimodal.md mtmd: refactor preprocessor, add mtmd_image_preproc_out (#24736) 2026-06-18 12:04:39 +02:00
ops.md ops: add Hexagon to ops.md and update main README.md (#28263) 2026-09-03 07:14:36 -07:00
preset.md common: add system-level config file (#26118) 2026-08-13 00:02:27 +02:00
release.md ci : allow make-release to target a specific commit (#27234) 2026-08-17 11:52:46 +03:00
speculative.md spec: Add benchmark-only synthetic speculative acceptance options (#27711) 2026-08-27 13:53:42 +03:00
xcframework.md readme : refresh (#26280) 2026-07-30 16:14:37 +03:00