]> git.ipfire.org Git - thirdparty/haproxy.git/commitdiff
DOC: management: slightly clarify the prefix role of the '@' command
authorWilly Tarreau <w@1wt.eu>
Tue, 8 Apr 2025 09:26:33 +0000 (11:26 +0200)
committerWilly Tarreau <w@1wt.eu>
Fri, 11 Apr 2025 14:09:17 +0000 (16:09 +0200)
While the examples were clear, the text did not fully imply what was
reflected there. Better have the text explicitly mention that the
'@' command may be used as a prefix or wrapper in front of a command
as well as a standalone command.

doc/management.txt

index 5ede6d1aae55870687ba32a007a7afbfc252fa06..3430b5f05e33cfd33e35f556faa548a818f1545c 100644 (file)
@@ -4312,6 +4312,11 @@ Example:
   master. Leaving processes are only accessible with the PID as relative process
   number are only usable with the current processes.
 
+  This prefix may be used as a wrapper before a command, indicating that this
+  command and only this one will be sent to the designated process. In this
+  case the full command ends at the end of line or semi-colon like any regular
+  command.
+
   Examples:
 
     $ socat /var/run/haproxy-master.sock readline
@@ -4329,8 +4334,10 @@ Example:
     $ echo '@!1271 show info; @!1272 show info' | socat /var/run/haproxy-master.sock -
     [...]
 
-  A prefix could be use as a command, which will send every next commands to
-  the specified process.
+  The prefix may also be use as a standalone command to switch the default execution
+  context to the designated process, indicating that all subsequent commands will all
+  be executed in that process, until a new '@' command changes the execution context
+  again.
 
   Examples: