mirrors/haproxy
1
0
Fork 0
mirror of https://git.haproxy.org/git/haproxy.git/ synced 2025-08-07 15:47:01 +02:00
Code Issues Projects Releases Wiki Activity

DOC: management: add a paragraph about the limitations of the '@' prefix

Browse Source 
The '@' prefix permits to execute a single command at once in a worker.
It is very handy but comes with some limitations affecting rare commands,
which is better to be documented (one command per session, input closed)
since it can seldom have user-visible effects.
This commit is contained in:
Willy Tarreau 2025-04-08 11:36:59 +02:00
parent e8267d1ce2
commit b6a8abcd0b
1 changed files with 8 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
doc/management.txt
View File

@ -4354,6 +4354,14 @@ Example:
$ echo '@1; show info; show stat; @2; show info; show stat' | socat /var/run/haproxy-master.sock - $ echo '@1; show info; show stat; @2; show info; show stat' | socat /var/run/haproxy-master.sock -
[...] [...]
Note about limitations: a few rare commands alter a CLI session's state
(e.g. "set anon", "set timeout") and may not behave exactly similarly once
run from the master CLI due to commands being sent one at a time on their own
CLI session. Similarly, a few rare commands ("show events", "wait") actively
monitor the CLI for input or closure and are immediately interrupted when the
CLI is closed. These commands will not work as expected through the master
CLI because the command's input is closed after each command.
expert-mode [on|off] expert-mode [on|off]
This command activates the "expert-mode" for every worker accessed from the This command activates the "expert-mode" for every worker accessed from the
master CLI. Combined with "mcli-debug-mode" it also activates the command on master CLI. Combined with "mcli-debug-mode" it also activates the command on