From: Willy Tarreau Date: Tue, 8 Apr 2025 09:36:59 +0000 (+0200) Subject: DOC: management: add a paragraph about the limitations of the '@' prefix X-Git-Tag: v3.2-dev11~105 X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=b6a8abcd0b8b036a8adb928473528f7931f319af;p=thirdparty%2Fhaproxy.git 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. --- 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