From b6a8abcd0b8b036a8adb928473528f7931f319af Mon Sep 17 00:00:00 2001 From: Willy Tarreau Date: Tue, 8 Apr 2025 11:36:59 +0200 Subject: [PATCH] DOC: management: add a paragraph about the limitations of the '@' prefix 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. --- doc/management.txt | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/doc/management.txt b/doc/management.txt index 3430b5f05..e026cb6c5 100644 --- a/doc/management.txt +++ b/doc/management.txt @@ -4354,6 +4354,14 @@ Example: $ 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] 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