[experimental-ims] 1bddcfa Document hit_for_pass in the tutorial
Geoff Simmons
geoff at varnish-cache.org
Mon Jan 9 21:51:45 CET 2012
commit 1bddcfa742f5a48808429681b5df21520fadd0b4
Author: Kristian Lyngstol <kristian at bohemians.org>
Date: Thu Sep 1 15:20:36 2011 +0200
Document hit_for_pass in the tutorial
diff --git a/doc/sphinx/tutorial/vcl.rst b/doc/sphinx/tutorial/vcl.rst
index f52c1ed..3ed78c5 100644
--- a/doc/sphinx/tutorial/vcl.rst
+++ b/doc/sphinx/tutorial/vcl.rst
@@ -58,7 +58,15 @@ The most common actions to return are these:
*pass*
When you return pass the request and subsequent response will be passed to
and from the backend server. It won't be cached. pass can be returned from
- both vcl_recv and vcl_fetch.
+ vcl_recv
+
+*hit_for_pass*
+ Similar to pass, but accessible from vcl_fetch. Unlike pass, hit_for_pass
+ will create a hitforpass object in the cache. This has the side-effect of
+ caching the decision not to cache. This is to allow would-be uncachable
+ requests to be passed to the backend at the same time. The same logic is
+ not necessary in vcl_recv because this happens before any potential
+ queueing for an object takes place.
*lookup*
When you return lookup from vcl_recv you tell Varnish to deliver content
More information about the varnish-commit
mailing list