From: des <des@d4fa192b-c00b-0410-8231-f00ffab90ce4>
Date: Thu, 9 Aug 2007 14:58:56 +0000 (+0000)
Subject: Explain the meaning of obj.valid and obj.cacheable.
X-Git-Url: https://err.no/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=92e54341276d7f474475f9671f4e45f153d3caac;p=varnish

Explain the meaning of obj.valid and obj.cacheable.


git-svn-id: svn+ssh://projects.linpro.no/svn/varnish/trunk@1819 d4fa192b-c00b-0410-8231-f00ffab90ce4
---

diff --git a/varnish-cache/man/vcl.7 b/varnish-cache/man/vcl.7
index 4ce39153..0b386729 100644
--- a/varnish-cache/man/vcl.7
+++ b/varnish-cache/man/vcl.7
@@ -424,10 +424,17 @@ The HTTP status code returned by the server.
 .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