|
2 | 2 | <html lang="en"> |
3 | 3 | <head> |
4 | 4 | <meta charset="utf-8" /> |
5 | | - <title>HAProxy version 3.1.10 - Configuration Manual</title> |
| 5 | + <title>HAProxy version 3.1.10-18 - 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" /> |
|
4432 | 4432 | You can use <strong>left</strong> and <strong>right</strong> arrow keys to navigate between chapters.<br> |
4433 | 4433 | </p> |
4434 | 4434 | <p class="text-right"> |
4435 | | - <small>Converted with <a href="https://github.com/cbonte/haproxy-dconv">haproxy-dconv</a> v<b>0.4.2-15</b> on <b>2025/11/07</b></small> |
| 4435 | + <small>Converted with <a href="https://github.com/cbonte/haproxy-dconv">haproxy-dconv</a> v<b>0.4.2-15</b> on <b>2025/12/05</b></small> |
4436 | 4436 | </p> |
4437 | 4437 | </div> |
4438 | 4438 | <!-- /.sidebar --> |
|
4443 | 4443 | <div class="text-center"> |
4444 | 4444 | <h1><a href="http://www.haproxy.org/" title="HAProxy"><img src="../img/HAProxyCommunityEdition_60px.png?0.4.2-15" /></a></h1> |
4445 | 4445 | <h2>Configuration Manual</h2> |
4446 | | - <p><strong>version 3.1.10</strong></p> |
| 4446 | + <p><strong>version 3.1.10-18</strong></p> |
4447 | 4447 | <p> |
4448 | 4448 | 2025/11/07<br> |
4449 | 4449 |
|
@@ -6102,6 +6102,8 @@ <h3 id="chapter-1.4.1" data-target="1.4.1"><small><a class="small" href="#1.4.1" |
6102 | 6102 | 408 when the request timeout strikes before the request is complete |
6103 | 6103 | 410 when the requested resource is no longer available and will not |
6104 | 6104 | be available again |
| 6105 | + 413 when a HTTP/1.0 GET/HEAD/DELETE requests has a payload, also see |
| 6106 | + the "<a href="#h1-accept-payload-with-any-method">h1-accept-payload-with-any-method</a>" option |
6105 | 6107 | 500 when HAProxy encounters an unrecoverable internal error, such as a |
6106 | 6108 | memory allocation failure, which should never happen |
6107 | 6109 | 501 when HAProxy is unable to satisfy a client request because of an |
@@ -6721,26 +6723,51 @@ <h2 id="chapter-2.4" data-target="2.4"><small><a class="small" href="#2.4">2.4.< |
6721 | 6723 | in the features list reported by "haproxy -vv" |
6722 | 6724 | (which means a <name> appears after a '+') |
6723 | 6725 |
|
6724 | | - - streq(<str1>,<str2>) : returns true only if the two strings are equal |
6725 | | - - strneq(<str1>,<str2>) : returns true only if the two strings differ |
6726 | | - - strstr(<str1>,<str2>) : returns true only if the second string is found in |
6727 | | - the first one. |
| 6726 | + - openssl_version_atleast(<ver>) : returns true if the current openssl |
| 6727 | + version is at least as recent as <ver> otherwise |
| 6728 | + false. |
| 6729 | + Libraries like LibreSSL, AWS-LC and WolfSSL also |
| 6730 | + provide a pseudo OpenSSL version. |
| 6731 | +</pre><div class="separator"> |
| 6732 | +<span class="label label-success">Example:</span> |
| 6733 | +<pre class="prettyprint"> |
| 6734 | +<code>ssllib_name_startswith(OpenSSL) && openssl_version_atleast(1.1.1) |
| 6735 | +</code></pre> |
| 6736 | +</div><pre class="text">- openssl_version_before(<ver>) : returns true if the current openssl |
| 6737 | + version is strictly older than <ver> otherwise |
| 6738 | + false. |
| 6739 | + Libraries like LibreSSL, AWS-LC and WolfSSL also |
| 6740 | + provide a pseudo OpenSSL version. |
| 6741 | +</pre><div class="separator"> |
| 6742 | +<span class="label label-success">Example:</span> |
| 6743 | +<pre class="prettyprint"> |
| 6744 | +<div class="example-desc">openssl_version_before(3.5.0)</div><code></code></pre> |
| 6745 | +</div><pre class="text">- ssllib_name_startswith(<name>) : return true if the SSL library name |
| 6746 | + HAProxy was linked with, starts with <name>. |
| 6747 | +</pre><div class="separator"> |
| 6748 | +<span class="label label-success">Example:</span> |
| 6749 | +<pre class="prettyprint"> |
| 6750 | +<div class="example-desc">ssllib_name_startswith(wolfSSL)</div><code></code></pre> |
| 6751 | +</div><pre class="text">- streq(<str1>,<str2>) : returns true only if the two strings are equal |
| 6752 | +- strneq(<str1>,<str2>) : returns true only if the two strings differ |
| 6753 | +- strstr(<str1>,<str2>) : returns true only if the second string is found in |
| 6754 | + the first one. |
6728 | 6755 |
|
6729 | | - - version_atleast(<ver>): returns true if the current haproxy version is |
6730 | | - at least as recent as <ver> otherwise false. The |
6731 | | - version syntax is the same as shown by "haproxy -v" |
6732 | | - and missing components are assumed as being zero. |
| 6756 | +- version_atleast(<ver>): returns true if the current haproxy version is |
| 6757 | + at least as recent as <ver> otherwise false. The |
| 6758 | + version syntax is the same as shown by "haproxy -v" |
| 6759 | + and missing components are assumed as being zero. |
6733 | 6760 |
|
6734 | | - - version_before(<ver>) : returns true if the current haproxy version is |
6735 | | - strictly older than <ver> otherwise false. The |
6736 | | - version syntax is the same as shown by "haproxy -v" |
6737 | | - and missing components are assumed as being zero. |
| 6761 | +- version_before(<ver>) : returns true if the current haproxy version is |
| 6762 | + strictly older than <ver> otherwise false. The |
| 6763 | + version syntax is the same as shown by "haproxy -v" |
| 6764 | + and missing components are assumed as being zero. |
6738 | 6765 |
|
6739 | | - - enabled(<opt>) : returns true if the option <opt> is enabled at |
6740 | | - run-time. Only a subset of options are supported: |
6741 | | - POLL, EPOLL, KQUEUE, EVPORTS, SPLICE, |
6742 | | - GETADDRINFO, REUSEPORT, FAST-FORWARD, |
6743 | | - SERVER-SSL-VERIFY-NONE |
| 6766 | +- enabled(<opt>) : returns true if the option <opt> is enabled at |
| 6767 | + run-time. Only a subset of options are supported: |
| 6768 | + POLL, EPOLL, KQUEUE, EVPORTS, SPLICE, |
| 6769 | + GETADDRINFO, REUSEPORT, FAST-FORWARD, |
| 6770 | + SERVER-SSL-VERIFY-NONE |
6744 | 6771 | </pre><div class="separator"> |
6745 | 6772 | <span class="label label-success">Example:</span> |
6746 | 6773 | <pre class="prettyprint"> |
@@ -7615,7 +7642,8 @@ <h2 id="chapter-3.1" data-target="3.1"><small><a class="small" href="#3.1">3.1.< |
7615 | 7642 | </div><div class="page-header"><b>See also:</b> hard-stop-after, monitor</div> |
7616 | 7643 | <a class="anchor" name="group"></a><a class="anchor" name="3-group"></a><a class="anchor" name="3.1-group"></a><a class="anchor" name="group (Global parameters)"></a><a class="anchor" name="group (Process management and security)"></a><div class="keyword"><b><a class="anchor" name="group"></a><a href="#3.1-group">group</a></b> <span style="color: #080"><group name></span></div><pre class="text">Similar to "<span class="dropdown"><a class="dropdown-toggle" data-toggle="dropdown" href="#">gid<span class="caret"></span></a><ul class="dropdown-menu"><li class="dropdown-header">This keyword is available in sections :</li><li><a href="#gid%20%28Process%20management%20and%20security%29">Process management and security</a></li><li><a href="#gid%20%28Bind%20options%29">Bind options</a></li></ul></span>" but uses the GID of group name <group name> from /etc/group. |
7617 | 7644 | See also "<span class="dropdown"><a class="dropdown-toggle" data-toggle="dropdown" href="#">gid<span class="caret"></span></a><ul class="dropdown-menu"><li class="dropdown-header">This keyword is available in sections :</li><li><a href="#gid%20%28Process%20management%20and%20security%29">Process management and security</a></li><li><a href="#gid%20%28Bind%20options%29">Bind options</a></li></ul></span>" and "<span class="dropdown"><a class="dropdown-toggle" data-toggle="dropdown" href="#">user<span class="caret"></span></a><ul class="dropdown-menu"><li class="dropdown-header">This keyword is available in sections :</li><li><a href="#user%20%28Process%20management%20and%20security%29">Process management and security</a></li><li><a href="#user%20%28Userlists%29">Userlists</a></li><li><a href="#user%20%28Programs%20%28deprecated%29%29">Programs (deprecated)</a></li><li><a href="#user%20%28Bind%20options%29">Bind options</a></li></ul></span>". |
7618 | | -</pre><a class="anchor" name="h1-accept-payload-with-any-method"></a><a class="anchor" name="3-h1-accept-payload-with-any-method"></a><a class="anchor" name="3.1-h1-accept-payload-with-any-method"></a><a class="anchor" name="h1-accept-payload-with-any-method (Global parameters)"></a><a class="anchor" name="h1-accept-payload-with-any-method (Process management and security)"></a><div class="keyword"><b><a class="anchor" name="h1-accept-payload-with-any-method"></a><a href="#3.1-h1-accept-payload-with-any-method">h1-accept-payload-with-any-method</a></b></div><pre class="text">Does not reject HTTP/1.0 GET/HEAD/DELETE requests with a payload. |
| 7645 | +</pre><a class="anchor" name="h1-accept-payload-with-any-method"></a><a class="anchor" name="3-h1-accept-payload-with-any-method"></a><a class="anchor" name="3.1-h1-accept-payload-with-any-method"></a><a class="anchor" name="h1-accept-payload-with-any-method (Global parameters)"></a><a class="anchor" name="h1-accept-payload-with-any-method (Process management and security)"></a><div class="keyword"><b><a class="anchor" name="h1-accept-payload-with-any-method"></a><a href="#3.1-h1-accept-payload-with-any-method">h1-accept-payload-with-any-method</a></b></div><pre class="text">Does not reject HTTP/1.0 GET/HEAD/DELETE requests with a payload with a |
| 7646 | +413 Payload Too Large HTTP response. |
7619 | 7647 |
|
7620 | 7648 | While It is explicitly allowed in HTTP/1.1, HTTP/1.0 is not clear on this |
7621 | 7649 | point and some old servers don't expect any payload and never look for body |
@@ -9229,7 +9257,8 @@ <h2 id="chapter-3.2" data-target="3.2"><small><a class="small" href="#3.2">3.2.< |
9229 | 9257 | the polling system. The default value is adapted to the operating system. It |
9230 | 9258 | has been noticed that reducing it below 200 tends to slightly decrease |
9231 | 9259 | latency at the expense of network bandwidth, and increasing it above 200 |
9232 | | -tends to trade latency for slightly increased bandwidth. |
| 9260 | +tends to trade latency for slightly increased bandwidth. The configured value |
| 9261 | +must be lower than or equal to 1000000. |
9233 | 9262 | </pre><a class="anchor" name="tune.maxrewrite"></a><a class="anchor" name="3-tune.maxrewrite"></a><a class="anchor" name="3.2-tune.maxrewrite"></a><a class="anchor" name="tune.maxrewrite (Global parameters)"></a><a class="anchor" name="tune.maxrewrite (Performance tuning)"></a><div class="keyword"><b><a class="anchor" name="tune.maxrewrite"></a><a href="#3.2-tune.maxrewrite">tune.maxrewrite</a></b> <span style="color: #080"><number></span></div><pre class="text">Sets the reserved buffer space to this size in bytes. The reserved space is |
9234 | 9263 | used for header rewriting or appending. The first reads on sockets will never |
9235 | 9264 | fill more than bufsize-maxrewrite. Historically it has defaulted to half of |
@@ -31843,7 +31872,7 @@ <h2 id="chapter-11.3" data-target="11.3"><small><a class="small" href="#11.3">11 |
31843 | 31872 | <br> |
31844 | 31873 | <hr> |
31845 | 31874 | <div class="text-right"> |
31846 | | - HAProxy 3.1.10 – Configuration Manual<br> |
| 31875 | + HAProxy 3.1.10-18 – Configuration Manual<br> |
31847 | 31876 | <small>, 2025/11/07</small> |
31848 | 31877 | </div> |
31849 | 31878 | </div> |
|
0 commit comments