← Back to branch summary

~ubuntu-branches/debian/sid/varnish/sid

« back to all changes in this revision

Viewing changes to doc/sphinx/=build/html/_sources/reference/vsl.txt

  • Committer: Package Import Robot
  • Author(s): Stig Sandbeck Mathisen
  • Date: 2011-10-29 15:23:24 UTC
  • mfrom: (0.1.15)
  • Revision ID: package-import@ubuntu.com-20111029152324-tdtlsurrv22ysknj
Tags: 3.0.2-1
* New upstream release
* Build from upstream tarball instead of git tag
* debian/watch: more specific regular expression

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/sphinx/=build/html/_sources/reference/vsl.txt
 
1
.. _reference-vsl:
 
2
 
 
3
=====================
 
4
Shared Memory Logging
 
5
=====================
 
6
 
 
7
TTL records
 
8
~~~~~~~~~~~
 
9
 
 
10
A TTL record is emitted whenever the ttl, grace or keep values for an
 
11
object is set.
 
12
 
 
13
The format is::
 
14
 
 
15
        %u %s %d %d %d %d %d [ %d %u %u ]
 
16
        |  |  |  |  |  |  |    |  |  |
 
17
        |  |  |  |  |  |  |    |  |  +- Max-Age from Cache-Control header
 
18
        |  |  |  |  |  |  |    |  +---- Expires header
 
19
        |  |  |  |  |  |  |    +------- Date header
 
20
        |  |  |  |  |  |  +------------ Age (incl Age: header value)
 
21
        |  |  |  |  |  +--------------- Reference time for TTL
 
22
        |  |  |  |  +------------------ Keep
 
23
        |  |  |  +--------------------- Grace
 
24
        |  |  +------------------------ TTL
 
25
        |  +--------------------------- "RFC" or "VCL"
 
26
        +------------------------------ object XID
 
27
 
 
28
The last three fields are only present in "RFC" headers.
 
29
 
 
30
Examples::
 
31
 
 
32
        1001 RFC 19 -1 -1 1312966109 4 0 0 23
 
33
        1001 VCL 10 -1 -1 1312966109 4
 
34
        1001 VCL 7 -1 -1 1312966111 6
 
35
        1001 VCL 7 120 -1 1312966111 6
 
36
        1001 VCL 7 120 3600 1312966111 6
 
37
        1001 VCL 12 120 3600 1312966113 8
 
38
 
 
39
Gzip records
 
40
~~~~~~~~~~~~
 
41
 
 
42
A Gzip record is emitted for each instance of gzip or gunzip work
 
43
performed.
 
44
Worst case, an ESI transaction stored in gzip'ed objects but delivered
 
45
gunziped, will run into many of these.
 
46
 
 
47
The format is::
 
48
 
 
49
        %c %c %c %d %d %d %d %d
 
50
        |  |  |  |  |  |  |  |
 
51
        |  |  |  |  |  |  |  +- Bit length of compressed data
 
52
        |  |  |  |  |  |  +---- Bit location of 'last' bit
 
53
        |  |  |  |  |  +------- Bit location of first deflate block
 
54
        |  |  |  |  +---------- Bytes output
 
55
        |  |  |  +------------- Bytes input
 
56
        |  |  +---------------- 'E' = ESI, '-' = Plain object
 
57
        |  +------------------- 'F' = Fetch, 'D' = Deliver
 
58
        +---------------------- 'G' = Gzip, 'U' = Gunzip, 'u' = Gunzip-test
 
59
 
 
60
Examples::
 
61
 
 
62
        U F E 182 159 80 80 1392
 
63
        G F E 159 173 80 1304 1314