|
2 | 2 | <html lang="en"> |
3 | 3 | <head> |
4 | 4 | <meta charset="utf-8" /> |
5 | | - <title>HAProxy version 3.1-dev10-89 - Configuration Manual</title> |
| 5 | + <title>HAProxy version 3.1-dev10-102 - 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" /> |
|
4402 | 4402 | You can use <strong>left</strong> and <strong>right</strong> arrow keys to navigate between chapters.<br> |
4403 | 4403 | </p> |
4404 | 4404 | <p class="text-right"> |
4405 | | - <small>Converted with <a href="https://github.com/cbonte/haproxy-dconv">haproxy-dconv</a> v<b>0.4.2-15</b> on <b>2024/10/24</b></small> |
| 4405 | + <small>Converted with <a href="https://github.com/cbonte/haproxy-dconv">haproxy-dconv</a> v<b>0.4.2-15</b> on <b>2024/10/29</b></small> |
4406 | 4406 | </p> |
4407 | 4407 | </div> |
4408 | 4408 | <!-- /.sidebar --> |
|
4413 | 4413 | <div class="text-center"> |
4414 | 4414 | <h1><a href="http://www.haproxy.org/" title="HAProxy"><img src="../img/HAProxyCommunityEdition_60px.png?0.4.2-15" /></a></h1> |
4415 | 4415 | <h2>Configuration Manual</h2> |
4416 | | - <p><strong>version 3.1-dev10-89</strong></p> |
| 4416 | + <p><strong>version 3.1-dev10-102</strong></p> |
4417 | 4417 | <p> |
4418 | 4418 | 2024/10/16<br> |
4419 | 4419 |
|
@@ -10954,6 +10954,11 @@ <h2 id="chapter-4.2" data-target="4.2"><small><a class="small" href="#4.2">4.2.< |
10954 | 10954 | only in log-forward sections. |
10955 | 10955 | - 'unix@' -> address is a path to a local unix socket |
10956 | 10956 | - 'abns@' -> address is in abstract namespace (Linux only). |
| 10957 | + - 'abnsz@' -> address is in abstract namespace (Linux only) |
| 10958 | + but it is explicitly zero-terminated. This means no \0 |
| 10959 | + padding is used to complete sun_path. It is useful to |
| 10960 | + interconnect with programs that don't implement the |
| 10961 | + default abns naming logic that haproxy uses. |
10957 | 10962 | - 'fd@<n>' -> use file descriptor <n> inherited from the |
10958 | 10963 | parent. The fd must be bound and may or may not already |
10959 | 10964 | be listening. |
@@ -11047,11 +11052,12 @@ <h2 id="chapter-4.2" data-target="4.2"><small><a class="small" href="#4.2">4.2.< |
11047 | 11052 | listen h3_quic_proxy |
11048 | 11053 | bind [email protected]:8888 ssl crt /etc/mycrt |
11049 | 11054 | </code></pre> |
11050 | | -</div><pre class="text">Note: regarding Linux's abstract namespace sockets, HAProxy uses the whole |
11051 | | - sun_path length is used for the address length. Some other programs |
11052 | | - such as socat use the string length only by default. Pass the option |
11053 | | - ",unix-tightsocklen=0" to any abstract socket definition in socat to |
11054 | | - make it compatible with HAProxy's. |
| 11055 | +</div><pre class="text">Note: regarding Linux's abstract namespace sockets, "abns" HAProxy sockets |
| 11056 | + uses the whole sun_path length is used for the address length. Some |
| 11057 | + other programs such as socat use the string length only by default. |
| 11058 | + Pass the option ",unix-tightsocklen=0" to any abstract socket |
| 11059 | + definition in socat to make it compatible with HAProxy's, or use the |
| 11060 | + "abnsz" HAProxy socket family instead. |
11055 | 11061 | </pre><div class="page-header"><b>See also :</b> "<span class="dropdown"><a class="dropdown-toggle" data-toggle="dropdown" href="#">source<span class="caret"></span></a><ul class="dropdown-menu"><li class="dropdown-header">This keyword is available in sections :</li><li><a href="#source%20%28Alphabetically%20sorted%20keywords%20reference%29">Alphabetically sorted keywords reference</a></li><li><a href="#source%20%28Server%20and%20default-server%20options%29">Server and default-server options</a></li></ul></span>", "<a href="#option%20forwardfor">option forwardfor</a>", "<a href="#unix-bind">unix-bind</a>" and the PROXY protocol documentation, and <a href="#5">section 5</a> about bind options.</div> |
11056 | 11062 | <a class="anchor" name="capture"></a><a class="anchor" name="4-capture"></a><a class="anchor" name="4.2-capture"></a><a class="anchor" name="capture (Proxies)"></a><a class="anchor" name="capture (Alphabetically sorted keywords reference)"></a><a class="anchor" name="capture cookie"></a><a class="anchor" name="4-capture cookie"></a><a class="anchor" name="4.2-capture cookie"></a><a class="anchor" name="capture cookie (Proxies)"></a><a class="anchor" name="capture cookie (Alphabetically sorted keywords reference)"></a><div class="keyword"><b><a class="anchor" name="capture cookie"></a><a href="#4.2-capture%20cookie">capture cookie</a></b> <span style="color: #080"><name></span> len <span style="color: #080"><length></span></div><pre class="text">Capture and log a cookie in the request and in the response. |
11057 | 11063 |
|
@@ -16036,6 +16042,11 @@ <h2 id="chapter-4.2" data-target="4.2"><small><a class="small" href="#4.2">4.2.< |
16036 | 16042 | - 'ipv6@' -> address is always IPv6 |
16037 | 16043 | - 'unix@' -> address is a path to a local unix socket |
16038 | 16044 | - 'abns@' -> address is in abstract namespace (Linux only) |
| 16045 | + - 'abnsz@' -> address is in abstract namespace (Linux only) |
| 16046 | + but it is explicitly zero-terminated. This means no \0 |
| 16047 | + padding is used to complete sun_path. It is useful to |
| 16048 | + interconnect with programs that don't implement the |
| 16049 | + default abns naming logic that haproxy uses. |
16039 | 16050 | - 'sockpair@' -> address is the FD of a connected unix |
16040 | 16051 | socket or of a socketpair. During a connection, the |
16041 | 16052 | backend creates a pair of connected sockets, and passes |
@@ -16072,11 +16083,12 @@ <h2 id="chapter-4.2" data-target="4.2"><small><a class="small" href="#4.2">4.2.< |
16072 | 16083 | server www1_dc1 "${LAN_DC1}.101:80" |
16073 | 16084 | server www1_dc2 "${LAN_DC2}.101:80" |
16074 | 16085 | </code></pre> |
16075 | | -</div><pre class="text">Note: regarding Linux's abstract namespace sockets, HAProxy uses the whole |
16076 | | - sun_path length is used for the address length. Some other programs |
16077 | | - such as socat use the string length only by default. Pass the option |
16078 | | - ",unix-tightsocklen=0" to any abstract socket definition in socat to |
16079 | | - make it compatible with HAProxy's. |
| 16086 | +</div><pre class="text">Note: regarding Linux's abstract namespace sockets, "abns" HAProxy sockets |
| 16087 | + uses the whole sun_path length is used for the address length. Some |
| 16088 | + other programs such as socat use the string length only by default. |
| 16089 | + Pass the option ",unix-tightsocklen=0" to any abstract socket |
| 16090 | + definition in socat to make it compatible with HAProxy's, or use the |
| 16091 | + "abnsz" HAProxy socket family instead. |
16080 | 16092 | </pre><div class="page-header"><b>See also:</b> "<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="#http-send-name-header">http-send-name-header</a>" and <a href="#5">section 5</a> about server options</div> |
16081 | 16093 | <a class="anchor" name="server-state-file-name"></a><a class="anchor" name="4-server-state-file-name"></a><a class="anchor" name="4.2-server-state-file-name"></a><a class="anchor" name="server-state-file-name (Proxies)"></a><a class="anchor" name="server-state-file-name (Alphabetically sorted keywords reference)"></a><div class="keyword"><b><a class="anchor" name="server-state-file-name"></a><a href="#4.2-server-state-file-name">server-state-file-name</a></b> <span style="color: #008">[ <span style="color: #800">{ use-backend-name | <span style="color: #080"><file></span> }</span> ]</span></div><pre class="text">Set the server state file to read, load and apply to servers available in |
16082 | 16094 | this backend. |
@@ -16162,6 +16174,9 @@ <h2 id="chapter-4.2" data-target="4.2"><small><a class="small" href="#4.2">4.2.< |
16162 | 16174 | - 'ipv6@' -> address is always IPv6 |
16163 | 16175 | - 'unix@' -> address is a path to a local unix socket |
16164 | 16176 | - 'abns@' -> address is in abstract namespace (Linux only) |
| 16177 | + - 'abnsz@' -> address is in zero-terminated abstract namespace |
| 16178 | + (Linux only) |
| 16179 | + |
16165 | 16180 | You may want to reference some environment variables in the |
16166 | 16181 | address parameter, see <a href="#2.3">section 2.3</a> about environment variables. |
16167 | 16182 |
|
@@ -31113,6 +31128,9 @@ <h2 id="chapter-10.3" data-target="10.3"><small><a class="small" href="#10.3">10 |
31113 | 31128 | <h2 id="chapter-11.1" data-target="11.1"><small><a class="small" href="#11.1">11.1.</a></small> Address family prefixes</h2> |
31114 | 31129 | <div><pre class="text">'abns@<name>' following <name> is an abstract namespace (Linux only). |
31115 | 31130 |
|
| 31131 | +'abnsz@<name>' following <name> is a zero-terminated abstract namespace |
| 31132 | + (Linux only). |
| 31133 | + |
31116 | 31134 | 'fd@<n>' following address is a file descriptor <n> inherited from the |
31117 | 31135 | parent. The fd must be bound and may or may not already be |
31118 | 31136 | listening. |
@@ -31269,7 +31287,7 @@ <h2 id="chapter-11.3" data-target="11.3"><small><a class="small" href="#11.3">11 |
31269 | 31287 | <br> |
31270 | 31288 | <hr> |
31271 | 31289 | <div class="text-right"> |
31272 | | - HAProxy 3.1-dev10-89 – Configuration Manual<br> |
| 31290 | + HAProxy 3.1-dev10-102 – Configuration Manual<br> |
31273 | 31291 | <small>, 2024/10/16</small> |
31274 | 31292 | </div> |
31275 | 31293 | </div> |
|
0 commit comments