From: William Lallemand <wlallemand@haproxy.org>
Date: Sat, 24 Sep 2022 14:44:44 +0000 (+0200)
Subject: DOC: management: describe the new reload command behavior
X-Git-Tag: v2.7-dev7~32
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=70c5ad4425519296e344c3eed7181176a10ad921;p=thirdparty%2Fhaproxy.git

DOC: management: describe the new reload command behavior

The master CLI command now allows to do a synchronous reload with a
status.
---

diff --git a/doc/management.txt b/doc/management.txt
index 30209df906..7c3a1ce438 100644
--- a/doc/management.txt
+++ b/doc/management.txt
@@ -3886,11 +3886,24 @@ reload
   does the same as a `kill -USR2` on the master process, provided that the user
   has at least "operator" or "admin" privileges.
 
+  This command allows you to perform a synchronous reload, the command will
+  return a reload status, once the reload was performed. Be careful with the
+  timeout if a tool is used to parse it, it is only returned once the
+  configuration is parsed and the new worker is forked.
+
   Example:
 
     $ echo "reload" | socat /var/run/haproxy-master.sock stdin
+    Loading success.
+
+    $ echo "reload" | socat /var/run/haproxy-master.sock stdin
+    Loading failure!
+
+  The reload command is the last executed on the master CLI, every other
+  command after it are ignored. Once the reload command returns its status, it
+  will close the connection to the CLI.
 
-  Note that a reload will close the connection to the master CLI.
+  Note that a reload will close all connections to the master CLI.
 
 show proc
   The master CLI introduces a 'show proc' command to surpervise the