|
2 | 2 | <html lang="en"> |
3 | 3 | <head> |
4 | 4 | <meta charset="utf-8" /> |
5 | | - <title>HAProxy version 3.2-dev6-23 - Configuration Manual</title> |
| 5 | + <title>HAProxy version 3.2-dev6-30 - Configuration Manual</title> |
6 | 6 | <link href="https://cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/css/bootstrap.min.css" rel="stylesheet" /> |
7 | 7 | <link href="https://raw.githubusercontent.com/thomaspark/bootswatch/v3.3.7/cerulean/bootstrap.min.css" rel="stylesheet" /> |
8 | 8 | <link href="../css/page.css?0.4.2-15" rel="stylesheet" /> |
|
3882 | 3882 |
|
3883 | 3883 | <a class="list-group-item" href="#strict-limits">strict-limits</a> |
3884 | 3884 |
|
| 3885 | + <a class="list-group-item" href="#strict-maxconn">strict-maxconn</a> |
| 3886 | + |
3885 | 3887 | <a class="list-group-item" href="#strict-mode">strict-mode</a> |
3886 | 3888 |
|
3887 | 3889 | <a class="list-group-item" href="#strict-sni">strict-sni</a> |
|
4275 | 4277 |
|
4276 | 4278 | <a class="list-group-item" href="#tune.stick-counters">tune.stick-counters</a> |
4277 | 4279 |
|
| 4280 | + <a class="list-group-item" href="#tune.takeover-other-tg-connections">tune.takeover-other-tg-connections</a> |
| 4281 | + |
4278 | 4282 | <a class="list-group-item" href="#tune.vars.global-max-size">tune.vars.global-max-size</a> |
4279 | 4283 |
|
4280 | 4284 | <a class="list-group-item" href="#tune.vars.proc-max-size">tune.vars.proc-max-size</a> |
|
4460 | 4464 | You can use <strong>left</strong> and <strong>right</strong> arrow keys to navigate between chapters.<br> |
4461 | 4465 | </p> |
4462 | 4466 | <p class="text-right"> |
4463 | | - <small>Converted with <a href="https://github.com/cbonte/haproxy-dconv">haproxy-dconv</a> v<b>0.4.2-15</b> on <b>2025/02/22</b></small> |
| 4467 | + <small>Converted with <a href="https://github.com/cbonte/haproxy-dconv">haproxy-dconv</a> v<b>0.4.2-15</b> on <b>2025/02/26</b></small> |
4464 | 4468 | </p> |
4465 | 4469 | </div> |
4466 | 4470 | <!-- /.sidebar --> |
|
4471 | 4475 | <div class="text-center"> |
4472 | 4476 | <h1><a href="http://www.haproxy.org/" title="HAProxy"><img src="../img/HAProxyCommunityEdition_60px.png?0.4.2-15" /></a></h1> |
4473 | 4477 | <h2>Configuration Manual</h2> |
4474 | | - <p><strong>version 3.2-dev6-23</strong></p> |
| 4478 | + <p><strong>version 3.2-dev6-30</strong></p> |
4475 | 4479 | <p> |
4476 | 4480 | 2025/02/19<br> |
4477 | 4481 |
|
@@ -7278,6 +7282,7 @@ <h2 id="chapter-2.9" data-target="2.9"><small><a class="small" href="#2.9">2.9.< |
7278 | 7282 | - <a href="#tune.ssl.ssl-ctx-cache-size">tune.ssl.ssl-ctx-cache-size</a> |
7279 | 7283 | - tune.ssl.ocsp-update.maxdelay (deprecated) |
7280 | 7284 | - tune.ssl.ocsp-update.mindelay (deprecated) |
| 7285 | + - <a href="#tune.takeover-other-tg-connections">tune.takeover-other-tg-connections</a> |
7281 | 7286 | - <a href="#tune.vars.global-max-size">tune.vars.global-max-size</a> |
7282 | 7287 | - <a href="#tune.vars.proc-max-size">tune.vars.proc-max-size</a> |
7283 | 7288 | - <a href="#tune.vars.reqres-max-size">tune.vars.reqres-max-size</a> |
@@ -9669,6 +9674,16 @@ <h2 id="chapter-3.2" data-target="3.2"><small><a class="small" href="#3.2">3.2.< |
9669 | 9674 | for each request, which does have measurable CPU impacts. Conversely, when |
9670 | 9675 | no "track-sc" rules are used, the value may be lowered (0 being valid to |
9671 | 9676 | entirely disable stick-counters). |
| 9677 | +</pre><a class="anchor" name="tune.takeover-other-tg-connections"></a><a class="anchor" name="3-tune.takeover-other-tg-connections"></a><a class="anchor" name="3.2-tune.takeover-other-tg-connections"></a><a class="anchor" name="tune.takeover-other-tg-connections (Global parameters)"></a><a class="anchor" name="tune.takeover-other-tg-connections (Performance tuning)"></a><div class="keyword"><b><a class="anchor" name="tune.takeover-other-tg-connections"></a><a href="#3.2-tune.takeover-other-tg-connections">tune.takeover-other-tg-connections</a></b> <span style="color: #080"><value></span></div><pre class="text">By default, we won't attempt to use idle connections from other thread groups. |
| 9678 | +This can however be changed. Valid values for <value> are : "none", the |
| 9679 | +default, if used, no attempt will be made to use idle connections from |
| 9680 | +other thread groups, "restricted" where we will only attempt to get an idle |
| 9681 | +connection from another thread if we're using protocols that can't create |
| 9682 | +new connections, such as reverse http, as well as when using strict-maxconn, |
| 9683 | +and "full" where we will always look in other thread groups for idle |
| 9684 | +connections. |
| 9685 | +Note that using connections from other thread groups can occur performance |
| 9686 | +penalties, so it should not be used unless really needed. |
9672 | 9687 | </pre><a class="anchor" name="tune.vars.global-max-size"></a><a class="anchor" name="3-tune.vars.global-max-size"></a><a class="anchor" name="3.2-tune.vars.global-max-size"></a><a class="anchor" name="tune.vars.global-max-size (Global parameters)"></a><a class="anchor" name="tune.vars.global-max-size (Performance tuning)"></a><div class="keyword"><b><a class="anchor" name="tune.vars.global-max-size"></a><a href="#3.2-tune.vars.global-max-size">tune.vars.global-max-size</a></b> <span style="color: #080"><size></span></div><a class="anchor" name="tune.vars.proc-max-size"></a><a class="anchor" name="3-tune.vars.proc-max-size"></a><a class="anchor" name="3.2-tune.vars.proc-max-size"></a><a class="anchor" name="tune.vars.proc-max-size (Global parameters)"></a><a class="anchor" name="tune.vars.proc-max-size (Performance tuning)"></a><div class="keyword"><b><a class="anchor" name="tune.vars.proc-max-size"></a><a href="#3.2-tune.vars.proc-max-size">tune.vars.proc-max-size</a></b> <span style="color: #080"><size></span></div><a class="anchor" name="tune.vars.reqres-max-size"></a><a class="anchor" name="3-tune.vars.reqres-max-size"></a><a class="anchor" name="3.2-tune.vars.reqres-max-size"></a><a class="anchor" name="tune.vars.reqres-max-size (Global parameters)"></a><a class="anchor" name="tune.vars.reqres-max-size (Performance tuning)"></a><div class="keyword"><b><a class="anchor" name="tune.vars.reqres-max-size"></a><a href="#3.2-tune.vars.reqres-max-size">tune.vars.reqres-max-size</a></b> <span style="color: #080"><size></span></div><a class="anchor" name="tune.vars.sess-max-size"></a><a class="anchor" name="3-tune.vars.sess-max-size"></a><a class="anchor" name="3.2-tune.vars.sess-max-size"></a><a class="anchor" name="tune.vars.sess-max-size (Global parameters)"></a><a class="anchor" name="tune.vars.sess-max-size (Performance tuning)"></a><div class="keyword"><b><a class="anchor" name="tune.vars.sess-max-size"></a><a href="#3.2-tune.vars.sess-max-size">tune.vars.sess-max-size</a></b> <span style="color: #080"><size></span></div><a class="anchor" name="tune.vars.txn-max-size"></a><a class="anchor" name="3-tune.vars.txn-max-size"></a><a class="anchor" name="3.2-tune.vars.txn-max-size"></a><a class="anchor" name="tune.vars.txn-max-size (Global parameters)"></a><a class="anchor" name="tune.vars.txn-max-size (Performance tuning)"></a><div class="keyword"><b><a class="anchor" name="tune.vars.txn-max-size"></a><a href="#3.2-tune.vars.txn-max-size">tune.vars.txn-max-size</a></b> <span style="color: #080"><size></span></div><pre class="text">These five tunes help to manage the maximum amount of memory used by the |
9673 | 9688 | variables system. "global" limits the overall amount of memory available for |
9674 | 9689 | all scopes. "<a href="#proc">proc</a>" limits the memory for the process scope, "sess" limits the |
@@ -22973,6 +22988,18 @@ <h2 id="chapter-5.2" data-target="5.2"><small><a class="small" href="#5.2">5.2.< |
22973 | 22988 | default value. |
22974 | 22989 | It may also be used as "<span class="dropdown"><a class="dropdown-toggle" data-toggle="dropdown" href="#">default-server<span class="caret"></span></a><ul class="dropdown-menu"><li class="dropdown-header">This keyword is available in sections :</li><li><a href="#default-server%20%28Peers%29">Peers</a></li><li><a href="#default-server%20%28Alphabetically%20sorted%20keywords%20reference%29">Alphabetically sorted keywords reference</a></li></ul></span>" setting to reset any previous |
22975 | 22990 | "<span class="dropdown"><a class="dropdown-toggle" data-toggle="dropdown" href="#">default-server<span class="caret"></span></a><ul class="dropdown-menu"><li class="dropdown-header">This keyword is available in sections :</li><li><a href="#default-server%20%28Peers%29">Peers</a></li><li><a href="#default-server%20%28Alphabetically%20sorted%20keywords%20reference%29">Alphabetically sorted keywords reference</a></li></ul></span>" "<a href="#non-stick">non-stick</a>" setting. |
| 22991 | +</pre><a class="anchor" name="strict-maxconn"></a><a class="anchor" name="5-strict-maxconn"></a><a class="anchor" name="5.2-strict-maxconn"></a><a class="anchor" name="strict-maxconn (Bind and server options)"></a><a class="anchor" name="strict-maxconn (Server and default-server options)"></a><div class="keyword"><b><a class="anchor" name="strict-maxconn"></a><a href="#5.2-strict-maxconn">strict-maxconn</a></b></div><pre class="text">May be used in the following contexts: tcp, http |
| 22992 | + |
| 22993 | +maxconn to servers is a bit of a misnomer, it actually configure the maximum |
| 22994 | +number of requests we send to a server, but with idle connections, we may |
| 22995 | +have more total connections to the server. If a strict limit of connections |
| 22996 | +to a server is required, then adding strict-maxconn can be used. We will |
| 22997 | +then never establish more connections to a server than maxconn, and try to |
| 22998 | +reuse or kill connections if needed. Please note, however, than it may lead |
| 22999 | +to failed requests in case we can't establish a new connection, and no |
| 23000 | +idle connection is available. This can happen when 'private" connections |
| 23001 | +are established, connections tied only to a session, because authentication |
| 23002 | +happened. |
22976 | 23003 | </pre><a class="anchor" name="socks4"></a><a class="anchor" name="5-socks4"></a><a class="anchor" name="5.2-socks4"></a><a class="anchor" name="socks4 (Bind and server options)"></a><a class="anchor" name="socks4 (Server and default-server options)"></a><div class="keyword"><b><a class="anchor" name="socks4"></a><a href="#5.2-socks4">socks4</a></b> <span style="color: #080"><addr></span>:<span style="color: #080"><port></span></div><pre class="text">May be used in the following contexts: tcp, http, log, peers, ring |
22977 | 23004 |
|
22978 | 23005 | This option enables upstream socks4 tunnel for outgoing connections to the |
@@ -31913,7 +31940,7 @@ <h2 id="chapter-11.3" data-target="11.3"><small><a class="small" href="#11.3">11 |
31913 | 31940 | <br> |
31914 | 31941 | <hr> |
31915 | 31942 | <div class="text-right"> |
31916 | | - HAProxy 3.2-dev6-23 – Configuration Manual<br> |
| 31943 | + HAProxy 3.2-dev6-30 – Configuration Manual<br> |
31917 | 31944 | <small>, 2025/02/19</small> |
31918 | 31945 | </div> |
31919 | 31946 | </div> |
|
0 commit comments