r1819 - trunk/varnish-cache/man

[des at projects.linpro.no]

Author: des
Date: 2007-08-09 16:58:56 +0200 (Thu, 09 Aug 2007)
New Revision: 1819

Modified:
   trunk/varnish-cache/man/vcl.7
Log:
Explain the meaning of obj.valid and obj.cacheable.


Modified: trunk/varnish-cache/man/vcl.7
===================================================================
--- trunk/varnish-cache/man/vcl.7	2007-08-09 12:12:12 UTC (rev 1818)
+++ trunk/varnish-cache/man/vcl.7	2007-08-09 14:58:56 UTC (rev 1819)
@@ -424,10 +424,17 @@
 .It Va obj.response
 The HTTP status message returned by the server.
 .It Va obj.valid
-True if the object was successfully retrieved.
+True if the request resulted in a valid HTTP response.
 .It Va obj.cacheable
-True if the object is cacheable.
-.\" XXX what are the criteria?
+True if the request resulted in a cacheable response.
+.\" see cache_center.c and rfc2616.c for details
+A response is considered cacheable if it is valid (see above), the
+HTTP status code is 200, 203, 300, 301, 302, 404 or 410 and it has a
+non-zero time-to-live when
+.Cm Expires
+and
+.Cm Cache-Control
+headers are taken into account.
 .It Va obj.ttl
 The object's remaining time to live, in seconds.
 .It Va obj.lastuse