[5.2] 126a456 Add a blurb about VMOD blob to What's New in 5.2.

PÃ¥l Hermunn Johansen hermunn at varnish-software.com
Fri Sep 15 11:17:20 UTC 2017


commit 126a456ea85af0c9eea089ab23f62f606340e424
Author: Geoff Simmons <geoff at uplex.de>
Date:   Tue Sep 12 10:59:38 2017 +0200

    Add a blurb about VMOD blob to What's New in 5.2.

diff --git a/doc/sphinx/whats-new/changes-5.2.rst b/doc/sphinx/whats-new/changes-5.2.rst
index 0c0140c..a07b1c3 100644
--- a/doc/sphinx/whats-new/changes-5.2.rst
+++ b/doc/sphinx/whats-new/changes-5.2.rst
@@ -37,7 +37,19 @@ VMOD vtc
 VMOD blob
 ---------
 
-*XXX: about VMOD blob*
+We have added the variables ``req.hash`` and ``bereq.hash`` to VCL,
+which contain the hash value computed by Varnish for the current
+request, for use in cache lookup. Their data type is BLOB, which
+represents arbitrary data of any length -- the new variables contain
+the raw binary hashes.
+
+This is the first time that an element of standard VCL has the BLOB
+type (BLOBs have only been used in third-party VMODs until now). So we
+have added VMOD blob to facilitate their use. In particular, the VMOD
+implements binary-to-text encodings, for example so that you can
+assign the hash to a header as a base64 or hex string. It also
+provides some other utilities such as getting the length of a BLOB or
+testing BLOBs for equality. See :ref:`vmod_blob(3)`.
 
 XXX: Any other headline changes ...
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~


More information about the varnish-commit mailing list