22<html lang="en">
33 <head>
44 <meta charset="utf-8" />
5- <title>HAProxy version 3.2.4-21 - Configuration Manual</title>
5+ <title>HAProxy version 3.2.4-23 - 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" />
14651465
14661466 <a class="list-group-item" href="#base">base</a>
14671467
1468+ <a class="list-group-item" href="#base2">base2</a>
1469+
14681470 <a class="list-group-item" href="#base32">base32</a>
14691471
14701472 <a class="list-group-item" href="#base32+src">base32+src</a>
23132315
23142316 <a class="list-group-item" href="#lat_ns_tot">lat_ns_tot</a>
23152317
2318+ <a class="list-group-item" href="#le2dec">le2dec</a>
2319+
23162320 <a class="list-group-item" href="#length">length</a>
23172321
23182322 <a class="list-group-item" href="#level">level</a>
46124616 You can use <strong>left</strong> and <strong>right</strong> arrow keys to navigate between chapters.<br>
46134617 </p>
46144618 <p class="text-right">
4615- <small>Converted with <a href="https://github.com/cbonte/haproxy-dconv">haproxy-dconv</a> v<b>0.4.2-15</b> on <b>2025/08/26 </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/06 </b></small>
46164620 </p>
46174621 </div>
46184622 <!-- /.sidebar -->
46234627 <div class="text-center">
46244628 <h1><a href="http://www.haproxy.org/" title="HAProxy"><img src="../img/HAProxyCommunityEdition_60px.png?0.4.2-15" /></a></h1>
46254629 <h2>Configuration Manual</h2>
4626- <p><strong>version 3.2.4-21 </strong></p>
4630+ <p><strong>version 3.2.4-23 </strong></p>
46274631 <p>
46284632 2025/08/13<br>
46294633
@@ -23854,8 +23858,10 @@ <h3 id="chapter-7.3.1" data-target="7.3.1"><small><a class="small" href="#7.3.1"
2385423858<tr><td ><a href="#7-aes_gcm_enc">aes_gcm_enc(bits,nonce,key,aead_tag)</a></td><td >binary</td><td >binary</td></tr>
2385523859<tr><td ><a href="#7-and">and(value)</a></td><td >integer</td><td >integer</td></tr>
2385623860<tr><td ><a href="#7-b64dec">b64dec</a></td><td >string</td><td >binary</td></tr>
23861+ <tr><td ><a href="#7-base2">base2</a></td><td >binary</td><td >string</td></tr>
2385723862<tr><td ><a href="#7-base64">base64</a></td><td >binary</td><td >string</td></tr>
2385823863<tr><td ><a href="#7-be2dec">be2dec(separator,chunk_size[,truncate])</a></td><td >binary</td><td >string</td></tr>
23864+ <tr><td ><a href="#7-le2dec">le2dec(separator,chunk_size[,truncate])</a></td><td >binary</td><td >string</td></tr>
2385923865<tr><td ><a href="#7-be2hex">be2hex([separator[,chunk_size[,truncate]]])</a></td><td >binary</td><td >string</td></tr>
2386023866<tr><td ><a href="#7-bool">bool</a></td><td >integer</td><td >boolean</td></tr>
2386123867<tr><td ><a href="#7-bytes">bytes(offset[,length])</a></td><td >binary</td><td >binary</td></tr>
@@ -23865,9 +23871,9 @@ <h3 id="chapter-7.3.1" data-target="7.3.1"><small><a class="small" href="#7.3.1"
2386523871<tr><td ><a href="#7-cpl">cpl</a></td><td >integer</td><td >integer</td></tr>
2386623872<tr><td ><a href="#7-crc32">crc32([avalanche])</a></td><td >binary</td><td >integer</td></tr>
2386723873<tr><td ><a href="#7-crc32c">crc32c([avalanche])</a></td><td >binary</td><td >integer</td></tr>
23874+ <thead><tr><th>keyword</th><th>input type</th><th>output type</th></tr></thead>
2386823875<tr><td ><a href="#7-cut_crlf">cut_crlf</a></td><td >string</td><td >string</td></tr>
2386923876<tr><td ><a href="#7-da-csv-conv">da-csv-conv(prop[,prop*])</a></td><td >string</td><td >string</td></tr>
23870- <thead><tr><th>keyword</th><th>input type</th><th>output type</th></tr></thead>
2387123877<tr><td ><a href="#7-date">date</a></td><td >string</td><td >integer</td></tr>
2387223878<tr><td ><a href="#7-debug">debug([prefix][,destination])</a></td><td >any</td><td >same</td></tr>
2387323879<tr><td ><a href="#7-digest">digest(algorithm)</a></td><td >binary</td><td >binary</td></tr>
@@ -23886,9 +23892,9 @@ <h3 id="chapter-7.3.1" data-target="7.3.1"><small><a class="small" href="#7.3.1"
2388623892<tr><td ><a href="#7-iif">iif(true,false)</a></td><td >boolean</td><td >string</td></tr>
2388723893<tr><td ><a href="#7-in_table">in_table([table])</a></td><td >any</td><td >boolean</td></tr>
2388823894<tr><td ><a href="#7-ipmask">ipmask(mask4[,mask6])</a></td><td >address</td><td >address</td></tr>
23895+ <thead><tr><th>keyword</th><th>input type</th><th>output type</th></tr></thead>
2388923896<tr><td ><a href="#7-json">json([input-code])</a></td><td >string</td><td >string</td></tr>
2389023897<tr><td ><a href="#7-json_query">json_query(json_path[,output_type])</a></td><td >string</td><td >_outtype_</td></tr>
23891- <thead><tr><th>keyword</th><th>input type</th><th>output type</th></tr></thead>
2389223898<tr><td ><a href="#7-jwt_header_query">jwt_header_query([json_path[,output_type]])</a></td><td >string</td><td >string</td></tr>
2389323899<tr><td ><a href="#7-jwt_payload_query">jwt_payload_query([json_path[,output_type]])</a></td><td >string</td><td >string</td></tr>
2389423900<tr><td ><a href="#7-jwt_verify">jwt_verify(alg,key)</a></td><td >string</td><td >integer</td></tr>
@@ -23907,9 +23913,9 @@ <h3 id="chapter-7.3.1" data-target="7.3.1"><small><a class="small" href="#7.3.1"
2390723913<tr><td ><a href="#7-ms_utime">ms_utime(format[,offset])</a></td><td >integer</td><td >string</td></tr>
2390823914<tr><td ><a href="#7-mul">mul(value)</a></td><td >integer</td><td >integer</td></tr>
2390923915<tr><td ><a href="#7-nbsrv">nbsrv</a></td><td >string</td><td >integer</td></tr>
23916+ <thead><tr><th>keyword</th><th>input type</th><th>output type</th></tr></thead>
2391023917<tr><td ><a href="#7-neg">neg</a></td><td >integer</td><td >integer</td></tr>
2391123918<tr><td ><a href="#7-not">not</a></td><td >integer</td><td >boolean</td></tr>
23912- <thead><tr><th>keyword</th><th>input type</th><th>output type</th></tr></thead>
2391323919<tr><td ><a href="#7-odd">odd</a></td><td >integer</td><td >boolean</td></tr>
2391423920<tr><td ><a href="#7-or">or(value)</a></td><td >integer</td><td >integer</td></tr>
2391523921<tr><td ><a href="#7-param">param(name[,delim])</a></td><td >string</td><td >string</td></tr>
@@ -23928,9 +23934,9 @@ <h3 id="chapter-7.3.1" data-target="7.3.1"><small><a class="small" href="#7.3.1"
2392823934<tr><td ><a href="#7-set-var">set-var(var[,cond...])</a></td><td >any</td><td >same</td></tr>
2392923935<tr><td ><a href="#7-sha1">sha1</a></td><td >binary</td><td >binary</td></tr>
2393023936<tr><td ><a href="#7-sha2">sha2([bits])</a></td><td >binary</td><td >binary</td></tr>
23937+ <thead><tr><th>keyword</th><th>input type</th><th>output type</th></tr></thead>
2393123938<tr><td ><a href="#7-srv_queue">srv_queue</a></td><td >string</td><td >integer</td></tr>
2393223939<tr><td ><a href="#7-strcmp">strcmp(var)</a></td><td >string</td><td >boolean</td></tr>
23933- <thead><tr><th>keyword</th><th>input type</th><th>output type</th></tr></thead>
2393423940<tr><td ><a href="#7-sub">sub(value)</a></td><td >integer</td><td >integer</td></tr>
2393523941<tr><td ><a href="#7-table_bytes_in_rate">table_bytes_in_rate([table])</a></td><td >any</td><td >integer</td></tr>
2393623942<tr><td ><a href="#7-table_bytes_out_rate">table_bytes_out_rate([table])</a></td><td >any</td><td >integer</td></tr>
@@ -23949,9 +23955,9 @@ <h3 id="chapter-7.3.1" data-target="7.3.1"><small><a class="small" href="#7.3.1"
2394923955<tr><td ><a href="#7-table_gpc1">table_gpc1([table])</a></td><td >any</td><td >integer</td></tr>
2395023956<tr><td ><a href="#7-table_gpc1_rate">table_gpc1_rate([table])</a></td><td >any</td><td >integer</td></tr>
2395123957<tr><td ><a href="#7-table_gpc_rate">table_gpc_rate(idx[,table])</a></td><td >any</td><td >integer</td></tr>
23958+ <thead><tr><th>keyword</th><th>input type</th><th>output type</th></tr></thead>
2395223959<tr><td ><a href="#7-table_gpt">table_gpt(idx[,table])</a></td><td >any</td><td >integer</td></tr>
2395323960<tr><td ><a href="#7-table_gpt0">table_gpt0([table])</a></td><td >any</td><td >integer</td></tr>
23954- <thead><tr><th>keyword</th><th>input type</th><th>output type</th></tr></thead>
2395523961<tr><td ><a href="#7-table_http_err_cnt">table_http_err_cnt([table])</a></td><td >any</td><td >integer</td></tr>
2395623962<tr><td ><a href="#7-table_http_err_rate">table_http_err_rate([table])</a></td><td >any</td><td >integer</td></tr>
2395723963<tr><td ><a href="#7-table_http_fail_cnt">table_http_fail_cnt([table])</a></td><td >any</td><td >integer</td></tr>
@@ -23970,9 +23976,9 @@ <h3 id="chapter-7.3.1" data-target="7.3.1"><small><a class="small" href="#7.3.1"
2397023976<tr><td ><a href="#7-table_trackers">table_trackers([table])</a></td><td >any</td><td >integer</td></tr>
2397123977<tr><td ><a href="#7-ub64dec">ub64dec</a></td><td >string</td><td >string</td></tr>
2397223978<tr><td ><a href="#7-ub64enc">ub64enc</a></td><td >string</td><td >string</td></tr>
23979+ <thead><tr><th>keyword</th><th>input type</th><th>output type</th></tr></thead>
2397323980<tr><td ><a href="#7-ungrpc">ungrpc(field_number[,field_type])</a></td><td >binary</td><td >binary / int</td></tr>
2397423981<tr><td ><a href="#7-unset-var">unset-var(var)</a></td><td >any</td><td >same</td></tr>
23975- <thead><tr><th>keyword</th><th>input type</th><th>output type</th></tr></thead>
2397623982<tr><td ><a href="#7-upper">upper</a></td><td >string</td><td >string</td></tr>
2397723983<tr><td ><a href="#7-url_dec">url_dec([in_form])</a></td><td >string</td><td >string</td></tr>
2397823984<tr><td ><a href="#7-url_enc">url_enc([enc_type])</a></td><td >string</td><td >string</td></tr>
@@ -24068,6 +24074,10 @@ <h3 id="chapter-7.3.1" data-target="7.3.1"><small><a class="small" href="#7.3.1"
2406824074representation. It performs the inverse operation of base64().
2406924075For base64url("URL and Filename Safe Alphabet" (RFC 4648)) variant
2407024076see "<a href="#ub64dec">ub64dec</a>".
24077+ </pre><a class="anchor" name="base2"></a><a class="anchor" name="7-base2"></a><a class="anchor" name="7.3.1-base2"></a><a class="anchor" name="base2 (Using ACLs and fetching samples)"></a><a class="anchor" name="base2 (Converters)"></a><div class="keyword"><b><a class="anchor" name="base2"></a><a href="#7.3.1-base2">base2</a></b></div><pre class="text">Converts a binary input sample to a binary string containing eight binary
24078+ digits per input byte. It is used to be able to perform longest prefix match
24079+ on types where the native representation does not allow prefix matching, for
24080+ example IP prefixes.
2407124081</pre><a class="anchor" name="base64"></a><a class="anchor" name="7-base64"></a><a class="anchor" name="7.3.1-base64"></a><a class="anchor" name="base64 (Using ACLs and fetching samples)"></a><a class="anchor" name="base64 (Converters)"></a><div class="keyword"><b><a class="anchor" name="base64"></a><a href="#7.3.1-base64">base64</a></b></div><pre class="text">Converts a binary input sample to a base64 string. It is used to log or
2407224082transfer binary content in a way that can be reliably transferred (e.g.
2407324083an SSL ID can be copied in a header). For base64url("URL and Filename
@@ -24085,6 +24095,19 @@ <h3 id="chapter-7.3.1" data-target="7.3.1"><small><a class="small" href="#7.3.1"
2408524095bin(01020304050607),be2dec(,2,1) <span class="comment"># 2587721286</span>
2408624096bin(7f000001),be2dec(.,1) <span class="comment"># 127.0.0.1</span>
2408724097</code></pre>
24098+ </div><a class="anchor" name="le2dec"></a><a class="anchor" name="7-le2dec"></a><a class="anchor" name="7.3.1-le2dec"></a><a class="anchor" name="le2dec (Using ACLs and fetching samples)"></a><a class="anchor" name="le2dec (Converters)"></a><div class="keyword"><b><a class="anchor" name="le2dec"></a><a href="#7.3.1-le2dec">le2dec</a></b>(<span style="color: #080"><separator></span>,<span style="color: #080"><chunk_size></span><span style="color: #008">[,<span style="color: #080"><truncate></span>]</span>)</div><pre class="text">Converts little-endian binary input sample to a string containing an unsigned
24099+ integer number per <chunk_size> input bytes. <separator> is inserted every
24100+ <chunk_size> binary input bytes if specified. The <truncate> flag indicates
24101+ whether the binary input is truncated at <chunk_size> boundaries. The maximum
24102+ value for <chunk_size> is limited by the size of long long int (8 bytes).
24103+ </pre><div class="separator">
24104+ <span class="label label-success">Example:</span>
24105+ <pre class="prettyprint">
24106+ <code>bin(01020304050607),le2dec(:,2) <span class="comment"># 513:1284:2055:7</span>
24107+ bin(01020304050607),le2dec(-,2,1) <span class="comment"># 513-1284-2055</span>
24108+ bin(01020304050607),le2dec(,2,1) <span class="comment"># 51312842055</span>
24109+ bin(7f000001),le2dec(.,1) <span class="comment"># 127.0.0.1</span>
24110+ </code></pre>
2408824111</div><a class="anchor" name="be2hex"></a><a class="anchor" name="7-be2hex"></a><a class="anchor" name="7.3.1-be2hex"></a><a class="anchor" name="be2hex (Using ACLs and fetching samples)"></a><a class="anchor" name="be2hex (Converters)"></a><div class="keyword"><b><a class="anchor" name="be2hex"></a><a href="#7.3.1-be2hex">be2hex</a></b>(<span style="color: #008">[<span style="color: #080"><separator></span><span style="color: #008">[,<span style="color: #080"><chunk_size></span><span style="color: #008">[,<span style="color: #080"><truncate></span>]</span>]</span>]</span>)</div><pre class="text">Converts big-endian binary input sample to a hex string containing two hex
2408924112digits per input byte. It is used to log or transfer hex dumps of some
2409024113binary input data in a way that can be reliably transferred (e.g. an SSL ID
@@ -33087,7 +33110,7 @@ <h2 id="chapter-12.9" data-target="12.9"><small><a class="small" href="#12.9">12
3308733110 <br>
3308833111 <hr>
3308933112 <div class="text-right">
33090- HAProxy 3.2.4-21 – Configuration Manual<br>
33113+ HAProxy 3.2.4-23 – Configuration Manual<br>
3309133114 <small>, 2025/08/13</small>
3309233115 </div>
3309333116 </div>
0 commit comments