dschlueter/llamacppctl
1
0
Fork 0
Code Issues Pull requests Projects Releases 1 Packages Wiki Activity

docs(config): clarify profile names and make examples copy-paste safe

Browse source 
Rename the size-numbered profiles so the digits read as parameter count,
not Qwen version: qwen35 -> qwen35b (llama.cpp.config.example, build_archive
smoke test, SECURITY_AND_OPERATIONS.md) and qwen27 -> qwen27b
(llama.cpp.config).

Drop the misleading `--profile qwen35` from the README/man/install examples:
that profile only exists in the .example file, so pasted commands failed
against the real config. Primary examples now omit --profile (using the
[default] section, which always resolves), with one example plus a note
showing how to select a real [model.<name>] profile.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
Dieter Schlüter 2026-07-07 09:53:43 +02:00
commit d5a69e8bf8
7 changed files with 41 additions and 25 deletions
Download patch file Download diff file Expand all files Collapse all files

19
man/llamacppctl.1
View file

@ -273,32 +273,39 @@ HTTP request failed or server did not become ready in time.
Lock busy (a concurrent \fB\-\-change\fR is already running for the same \fBcontainer_name\fR).
.SH EXAMPLES
.PP
Start a profile and show the effective configuration first:
Start the default profile and show the effective configuration first:
.RS
.nf
llamacppctl \-\-print\-effective\-config \-\-config llama.cpp.config \-\-profile qwen35 \-\-start
llamacppctl \-\-start \-\-config llama.cpp.config \-\-profile qwen35
llamacppctl \-\-print\-effective\-config \-\-config llama.cpp.config \-\-start
llamacppctl \-\-start \-\-config llama.cpp.config
.fi
.RE
.PP
Preview the docker run command without executing it:
.RS
.nf
llamacppctl \-\-start \-\-config llama.cpp.config \-\-profile qwen35 \-\-dry\-run
llamacppctl \-\-start \-\-config llama.cpp.config \-\-dry\-run
.fi
.RE
.PP
Check status including a live chat completion:
.RS
.nf
llamacppctl \-\-check \-\-config llama.cpp.config \-\-profile qwen35 \-p "ping"
llamacppctl \-\-check \-\-config llama.cpp.config \-p "ping"
.fi
.RE
.PP
Select a named model profile from a \fB[model.<name>]\fR section:
.RS
.nf
llamacppctl \-\-start \-\-config llama.cpp.config \-\-profile qwopus
.fi
.RE
.PP
Switch models under lock protection:
.RS
.nf
llamacppctl \-\-change \-\-config llama.cpp.config \-\-profile deepseek
llamacppctl \-\-change \-\-config llama.cpp.config \-\-profile carnice
.fi
.RE
.SH AUTHOR