From: Dragan Dosen <ddosen@haproxy.com>
Date: Thu, 16 Jun 2016 10:19:49 +0000 (+0200)
Subject: DOC: http: add documentation for url32 and url32+src
X-Git-Tag: v1.7-dev4~71
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=0070cd52c86db832c771d43a21355df966a5ce2e;p=thirdparty%2Fhaproxy.git

DOC: http: add documentation for url32 and url32+src

This patch needs to be backported to 1.6 and 1.5.
---

diff --git a/doc/configuration.txt b/doc/configuration.txt
index 678be4419c..00da5dfbcc 100644
--- a/doc/configuration.txt
+++ b/doc/configuration.txt
@@ -14137,6 +14137,18 @@ urlp_val([<name>[,<delim>])] : integer
   and converts it to an integer value. This can be used for session stickiness
   based on a user ID for example, or with ACLs to match a page number or price.
 
+url32 : integer
+  This returns a 32-bit hash of the value obtained by concatenating the first
+  Host header and the whole URL including parameters (not only the path part of
+  the request, as in the "base32" fetch above). This is useful to track per-URL
+  activity. A shorter hash is stored, saving a lot of memory. The output type
+  is an unsigned integer.
+
+url32+src : binary
+  This returns the concatenation of the "url32" fetch and the "src" fetch. The
+  resulting type is of type binary, with a size of 8 or 20 bytes depending on
+  the source address family. This can be used to track per-IP, per-URL counters.
+
 
 7.4. Pre-defined ACLs
 ---------------------