Skip to content

Commit 9dacafc

Browse files
author
HAProxy Community
committed
Update docs for 3.2
1 parent 6c4f917 commit 9dacafc

3 files changed

Lines changed: 60 additions & 18 deletions

File tree

‎docs/3.2/configuration.html‎

Lines changed: 23 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
<html lang="en">
33
<head>
44
<meta charset="utf-8" />
5-
<title>HAProxy version 3.2.4-23 - Configuration Manual</title>
5+
<title>HAProxy version 3.2.4-93 - Configuration Manual</title>
66
<link href="https://cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/css/bootstrap.min.css" rel="stylesheet" />
77
<link href="https://raw.githubusercontent.com/thomaspark/bootswatch/v3.3.7/cerulean/bootstrap.min.css" rel="stylesheet" />
88
<link href="../css/page.css?0.4.2-15" rel="stylesheet" />
@@ -4616,7 +4616,7 @@
46164616
You can use <strong>left</strong> and <strong>right</strong> arrow keys to navigate between chapters.<br>
46174617
</p>
46184618
<p class="text-right">
4619-
<small>Converted with <a href="https://github.com/cbonte/haproxy-dconv">haproxy-dconv</a> v<b>0.4.2-15</b> on <b>2025/09/06</b></small>
4619+
<small>Converted with <a href="https://github.com/cbonte/haproxy-dconv">haproxy-dconv</a> v<b>0.4.2-15</b> on <b>2025/09/19</b></small>
46204620
</p>
46214621
</div>
46224622
<!-- /.sidebar -->
@@ -4627,7 +4627,7 @@
46274627
<div class="text-center">
46284628
<h1><a href="http://www.haproxy.org/" title="HAProxy"><img src="../img/HAProxyCommunityEdition_60px.png?0.4.2-15" /></a></h1>
46294629
<h2>Configuration Manual</h2>
4630-
<p><strong>version 3.2.4-23</strong></p>
4630+
<p><strong>version 3.2.4-93</strong></p>
46314631
<p>
46324632
2025/08/13<br>
46334633

@@ -7039,8 +7039,8 @@ <h2 id="chapter-2.4" data-target="2.4"><small><a class="small" href="#2.4">2.4.<
70397039
- .warning &quot;message&quot; : emit this message at level WARNING
70407040
- .alert &quot;message&quot; : emit this message at level ALERT
70417041

7042-
Messages emitted at level WARNING may cause the process to fail to start if the
7043-
&quot;<a href="#strict-mode">strict-mode</a>&quot; is enabled. Messages emitted at level ALERT will always cause a
7042+
Messages emitted at level WARNING may cause the process to fail to start if
7043+
&quot;<a href="#zero-warning">zero-warning</a>&quot; is enabled. Messages emitted at level ALERT will always cause a
70447044
fatal error. These can be used to detect some inappropriate conditions and
70457045
provide advice to the user.
70467046
</pre><div class="separator">
@@ -7270,6 +7270,11 @@ <h3 id="chapter-2.9.1" data-target="2.9.1"><small><a class="small" href="#2.9.1"
72707270
the FD from the unix socket and uses it as if it were the FD
72717271
of an accept(). Should be used carefully.
72727272

7273+
Bugs: This protocol is known to be unreliable on macOS because
7274+
of an issue in the macOS sendmsg(2) implementation. The
7275+
connection might not be accepted correctly.
7276+
7277+
72737278
'unix@&lt;path&gt;' following string is considered as a UNIX socket &lt;path&gt;. this
72747279
prefix is useful to declare an UNIX socket path which don't
72757280
start by slash '/'.
@@ -21012,9 +21017,13 @@ <h2 id="chapter-5.1" data-target="5.1"><small><a class="small" href="#5.1">5.1.<
2101221017
foo.crt [key bar.pem ocsp foo.ocsp ocsp-update on] foo.bar.com
2101321018
</code></pre>
2101421019
</div><a class="anchor" name="default-crt"></a><a class="anchor" name="5-default-crt"></a><a class="anchor" name="5.1-default-crt"></a><a class="anchor" name="default-crt (Bind and server options)"></a><a class="anchor" name="default-crt (Bind options)"></a><div class="keyword"><b><a class="anchor" name="default-crt"></a><a href="#5.1-default-crt">default-crt</a></b> <span style="color: #080">&lt;cert&gt;</span></div><pre class="text">This option does the same as the &quot;<span class="dropdown"><a class="dropdown-toggle" data-toggle="dropdown" href="#">crt<span class="caret"></span></a><ul class="dropdown-menu"><li class="dropdown-header">This keyword is available in sections :</li><li><a href="#crt%20%28Load%20options%29">Load options</a></li><li><a href="#crt%20%28Bind%20options%29">Bind options</a></li><li><a href="#crt%20%28Server%20and%20default-server%20options%29">Server and default-server options</a></li></ul></span>&quot; option, with the difference that this
21015-
certificate will be used as a default one. It is possible to add multiple
21016-
default certificates to have an ECDSA and an RSA one, having more is not
21017-
really useful.
21020+
certificate will be used as a default one as well. It is possible to add
21021+
multiple default certificates to have an ECDSA and an RSA one, having more is
21022+
not really useful.
21023+
21024+
This option does not disable implicit default certificates, if a 'crt'
21025+
certificate is declared first before any 'default-crt' or other 'crt' it will
21026+
still be used as a default certificate.
2101821027

2101921028
A default certificate is used when no &quot;<a href="#strict-sni">strict-sni</a>&quot; option is used on the bind
2102021029
line. A default certificate is provided when the servername extension was not
@@ -21023,7 +21032,11 @@ <h2 id="chapter-5.1" data-target="5.1"><small><a class="small" href="#5.1">5.1.<
2102321032
</pre><div class="separator">
2102421033
<span class="label label-success">Example:</span>
2102521034
<pre class="prettyprint">
21026-
<code>bind *:443 default-crt foobar.pem.rsa default-crt foobar.pem.ecdsa crt website.pem.rsa
21035+
<code><span class="comment"># this bind line has 2 default certificates</span>
21036+
bind *:443 default-crt foobar.pem.rsa default-crt foobar.pem.ecdsa crt website.pem.rsa
21037+
21038+
<span class="comment"># this bind line has 3 default certificates</span>
21039+
bind *:443 crt website.pem.rsa default-crt foobar.pem.rsa default-crt foobar.pem.ecdsa
2102721040
</code></pre>
2102821041
</div><pre class="text">See also the &quot;<span class="dropdown"><a class="dropdown-toggle" data-toggle="dropdown" href="#">crt<span class="caret"></span></a><ul class="dropdown-menu"><li class="dropdown-header">This keyword is available in sections :</li><li><a href="#crt%20%28Load%20options%29">Load options</a></li><li><a href="#crt%20%28Bind%20options%29">Bind options</a></li><li><a href="#crt%20%28Server%20and%20default-server%20options%29">Server and default-server options</a></li></ul></span>&quot; keyword.
2102921042
</pre><a class="anchor" name="curves"></a><a class="anchor" name="5-curves"></a><a class="anchor" name="5.1-curves"></a><a class="anchor" name="curves (Bind and server options)"></a><a class="anchor" name="curves (Bind options)"></a><div class="keyword"><b><a class="anchor" name="curves"></a><a href="#5.1-curves">curves</a></b> <span style="color: #080">&lt;curves&gt;</span></div><pre class="text">This setting is only available when support for OpenSSL was built in. It sets
@@ -33110,7 +33123,7 @@ <h2 id="chapter-12.9" data-target="12.9"><small><a class="small" href="#12.9">12
3311033123
<br>
3311133124
<hr>
3311233125
<div class="text-right">
33113-
HAProxy 3.2.4-23 &ndash; Configuration Manual<br>
33126+
HAProxy 3.2.4-93 &ndash; Configuration Manual<br>
3311433127
<small>, 2025/08/13</small>
3311533128
</div>
3311633129
</div>

‎docs/3.2/intro.html‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
<html lang="en">
33
<head>
44
<meta charset="utf-8" />
5-
<title>HAProxy version 3.2.4-23 - Starter Guide</title>
5+
<title>HAProxy version 3.2.4-93 - Starter Guide</title>
66
<link href="https://cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/css/bootstrap.min.css" rel="stylesheet" />
77
<link href="https://raw.githubusercontent.com/thomaspark/bootswatch/v3.3.7/cerulean/bootstrap.min.css" rel="stylesheet" />
88
<link href="../css/page.css?0.4.2-15" rel="stylesheet" />
@@ -484,7 +484,7 @@
484484
You can use <strong>left</strong> and <strong>right</strong> arrow keys to navigate between chapters.<br>
485485
</p>
486486
<p class="text-right">
487-
<small>Converted with <a href="https://github.com/cbonte/haproxy-dconv">haproxy-dconv</a> v<b>0.4.2-15</b> on <b>2025/09/06</b></small>
487+
<small>Converted with <a href="https://github.com/cbonte/haproxy-dconv">haproxy-dconv</a> v<b>0.4.2-15</b> on <b>2025/09/19</b></small>
488488
</p>
489489
</div>
490490
<!-- /.sidebar -->
@@ -495,7 +495,7 @@
495495
<div class="text-center">
496496
<h1><a href="http://www.haproxy.org/" title="HAProxy"><img src="../img/HAProxyCommunityEdition_60px.png?0.4.2-15" /></a></h1>
497497
<h2>Starter Guide</h2>
498-
<p><strong>version 3.2.4-23</strong></p>
498+
<p><strong>version 3.2.4-93</strong></p>
499499
<p>
500500
<br>
501501

@@ -2515,7 +2515,7 @@ <h2 id="chapter-4.4" data-target="4.4"><small><a class="small" href="#4.4">4.4.<
25152515
<br>
25162516
<hr>
25172517
<div class="text-right">
2518-
HAProxy 3.2.4-23 &ndash; Starter Guide<br>
2518+
HAProxy 3.2.4-93 &ndash; Starter Guide<br>
25192519
<small>, </small>
25202520
</div>
25212521
</div>

‎docs/3.2/management.html‎

Lines changed: 33 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
<html lang="en">
33
<head>
44
<meta charset="utf-8" />
5-
<title>HAProxy version 3.2.4-23 - Management Guide</title>
5+
<title>HAProxy version 3.2.4-93 - Management Guide</title>
66
<link href="https://cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/css/bootstrap.min.css" rel="stylesheet" />
77
<link href="https://raw.githubusercontent.com/thomaspark/bootswatch/v3.3.7/cerulean/bootstrap.min.css" rel="stylesheet" />
88
<link href="../css/page.css?0.4.2-15" rel="stylesheet" />
@@ -662,7 +662,7 @@
662662
You can use <strong>left</strong> and <strong>right</strong> arrow keys to navigate between chapters.<br>
663663
</p>
664664
<p class="text-right">
665-
<small>Converted with <a href="https://github.com/cbonte/haproxy-dconv">haproxy-dconv</a> v<b>0.4.2-15</b> on <b>2025/09/06</b></small>
665+
<small>Converted with <a href="https://github.com/cbonte/haproxy-dconv">haproxy-dconv</a> v<b>0.4.2-15</b> on <b>2025/09/19</b></small>
666666
</p>
667667
</div>
668668
<!-- /.sidebar -->
@@ -673,7 +673,7 @@
673673
<div class="text-center">
674674
<h1><a href="http://www.haproxy.org/" title="HAProxy"><img src="../img/HAProxyCommunityEdition_60px.png?0.4.2-15" /></a></h1>
675675
<h2>Management Guide</h2>
676-
<p><strong>version 3.2.4-23</strong></p>
676+
<p><strong>version 3.2.4-93</strong></p>
677677
<p>
678678
<br>
679679

@@ -2167,6 +2167,25 @@ <h2 id="chapter-9.1" data-target="9.1"><small><a class="small" href="#9.1">9.1.<
21672167
97. used_conn_cur [...S]: current number of connections in use
21682168
98. need_conn_est [...S]: estimated needed number of connections
21692169
99. uweight [..BS]: total user weight (backend), server user weight (server)
2170+
100. agg_server_status [..B.]: backend aggregated gauge of server's status
2171+
101. agg_server_status_check [..B.]: (deprecated)
2172+
102. agg_check_status [..B.]: backend aggregated gauge of server's state check
2173+
status
2174+
103. srid [...S]: server id revision
2175+
104. sess_other [.F..]: total number of sessions other than HTTP since process
2176+
started
2177+
105. h1_sess [.F..]: total number of HTTP/1 sessions since process started
2178+
106. h2_sess [.F..]: total number of HTTP/2 sessions since process started
2179+
107. h3_sess [.F..]: total number of HTTP/3 sessions since process started
2180+
108. req_other [.F..]: total number of sessions other than HTTP processed by
2181+
this object since the worker process started
2182+
109. h1req [.F..]: total number of HTTP/1 sessions processed by this object
2183+
since the worker process started
2184+
110. h2req [.F..]: total number of hTTP/2 sessions processed by this object
2185+
since the worker process started
2186+
111. h3req [.F..]: total number of HTTP/3 sessions processed by this object
2187+
since the worker process started
2188+
112. proto [L...]: protocol
21702189

21712190
For all other statistics domains, the presence or the order of the fields are
21722191
not guaranteed. In this case, the header line should always be used to parse
@@ -4943,6 +4962,11 @@ <h3 id="chapter-9.4.1" data-target="9.4.1"><small><a class="small" href="#9.4.1"
49434962
command and only this one will be sent to the designated process. In this
49444963
case the full command ends at the end of line or semi-colon like any regular
49454964
command.
4965+
4966+
Bugs: the sockpair@ protocol used to implement communication between the
4967+
master and the worker is known to not be reliable on macOS because of an
4968+
issue in the macOS sendmsg(2) implementation. A command might end up without
4969+
response because of that.
49464970
</pre><div class="separator">
49474971
<span class="label label-success">Examples:</span>
49484972
<pre class="prettyprint">
@@ -5009,6 +5033,11 @@ <h3 id="chapter-9.4.1" data-target="9.4.1"><small><a class="small" href="#9.4.1"
50095033
closing the connection or by quitting the worker process (using the &quot;<a href="#quit">quit</a>&quot;
50105034
command). In this case, the prompt mode of the master socket (interactive,
50115035
prompt, timed) is propagated into the worker process.
5036+
5037+
Bugs: the sockpair@ protocol used to implement communication between the
5038+
master and the worker is known to not be reliable on macOS because of an
5039+
issue in the macOS sendmsg(2) implementation. A command might end up without
5040+
response because of that.
50125041
</pre><div class="separator">
50135042
<span class="label label-success">Examples:</span>
50145043
<pre class="prettyprint">
@@ -5567,7 +5596,7 @@ <h2 id="chapter-13.1" data-target="13.1"><small><a class="small" href="#13.1">13
55675596
<br>
55685597
<hr>
55695598
<div class="text-right">
5570-
HAProxy 3.2.4-23 &ndash; Management Guide<br>
5599+
HAProxy 3.2.4-93 &ndash; Management Guide<br>
55715600
<small>, </small>
55725601
</div>
55735602
</div>

0 commit comments

Comments
 (0)