[master] e9b315e Document gzip VSL records

Poul-Henning Kamp phk at varnish-cache.org
Mon Jan 31 10:19:08 CET 2011


commit e9b315e3dfd6362d50eac83196a2cb0efda864af
Author: Poul-Henning Kamp <phk at FreeBSD.org>
Date:   Mon Jan 31 09:18:57 2011 +0000

    Document gzip VSL records

diff --git a/doc/sphinx/reference/index.rst b/doc/sphinx/reference/index.rst
index 2dd8c1b..38dbd4a 100644
--- a/doc/sphinx/reference/index.rst
+++ b/doc/sphinx/reference/index.rst
@@ -19,6 +19,7 @@ The Varnish Reference Manual
 	varnishtop.rst
 	shmem.rst
 	vmod.rst
+	vsl.rst
 
 .. todo::
         The programs:
diff --git a/doc/sphinx/reference/vsl.rst b/doc/sphinx/reference/vsl.rst
new file mode 100644
index 0000000..ac1026a
--- /dev/null
+++ b/doc/sphinx/reference/vsl.rst
@@ -0,0 +1,32 @@
+.. _reference-vsl:
+
+=====================
+Shared Memory Logging
+=====================
+
+Gzip records
+~~~~~~~~~~~~
+
+A Gzip record is emitted for each instance of gzip or gunzip work
+performed.
+Worst case, an ESI transaction stored in gzip'ed objects but delivered
+gunziped, will run into many of these.
+
+The format is::
+
+
+	%c %c %c %d %d %d %d %d
+	|  |  |  |  |  |  |  |
+	|  |  |  |  |  |  |  +- Bit length of compressed data
+	|  |  |  |  |  |  +---- Bit location of 'last' bit
+	|  |  |  |  |  +------- Bit location of first deflate block
+	|  |  |  |  +---------- Bytes output
+	|  |  |  +------------- Bytes input
+	|  |  +---------------- 'E' = ESI, '-' = Plain object
+	|  +------------------- 'F' = Fetch, 'D' = Deliver
+	+---------------------- 'G' = Gzip, 'U' = Gunzip, 'u' = Gunzip-test
+
+Which in practice could look like::
+
+	U F E 182 159 80 80 1392
+	G F E 159 173 80 1304 1314



More information about the varnish-commit mailing list