]> git.ipfire.org Git - thirdparty/haproxy.git/commitdiff
DOC: management: add timeout on the "reload" command
authorWilliam Lallemand <wlallemand@haproxy.org>
Tue, 27 Sep 2022 09:38:10 +0000 (11:38 +0200)
committerWilliam Lallemand <wlallemand@haproxy.org>
Tue, 27 Sep 2022 09:48:59 +0000 (11:48 +0200)
Add some details about timeout during a reload on the master CLI.

doc/management.txt

index 7c3a1ce4383a12680ec1dba01159553f1c208dad..2561aee6bed5b702632127a248fe287f4852d5b0 100644 (file)
@@ -3889,14 +3889,16 @@ reload
   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.
+  configuration is parsed and the new worker is forked. The "socat" command uses
+  a timeout of 0.5s by default so it will quits before showing the message if
+  the reload is too long. "ncat" does not have a timeout by default.
 
   Example:
 
-    $ echo "reload" | socat /var/run/haproxy-master.sock stdin
+    $ echo "reload" | socat -t300 /var/run/haproxy-master.sock stdin
     Loading success.
 
-    $ echo "reload" | socat /var/run/haproxy-master.sock stdin
+    $ echo "reload" | socat -t300 /var/run/haproxy-master.sock stdin
     Loading failure!
 
   The reload command is the last executed on the master CLI, every other