[master] 1cd4f0c explain the ban list

Per Andreas Buer perbu at varnish-cache.org
Fri May 20 11:12:11 CEST 2011

commit 1cd4f0ceaf07ce5dd8e35e59a0510377759c87d2
Author: Per Buer <perbu at varnish-software.com>
Date:   Thu May 19 12:36:45 2011 +0200

    explain the ban list

diff --git a/doc/sphinx/reference/varnish-cli.rst b/doc/sphinx/reference/varnish-cli.rst
index 145f960..a52713e 100644
--- a/doc/sphinx/reference/varnish-cli.rst
+++ b/doc/sphinx/reference/varnish-cli.rst
@@ -106,8 +106,6 @@ ban   *field operator argument* [&& field operator argument [...]]
-      Display the ban list.
       All requests for objects from the cache are matched against
       items on the ban list.  If an object in the cache is older than
       a matching ban list item, it is considered "banned", and will be
@@ -116,6 +114,28 @@ ban.list
       When a ban expression is older than all the objects in the
       cache, it is removed from the list.
+      ban.list displays the ban list. The output looks something like
+      this (broken into two lines):
+      0x7fea4fcb0580 1303835108.618863   131G   req.http.host ~ 
+      www.myhost.com && req.url ~ /some/url
+      The first field is the address of the ban. 
+      The second is the time of entry into the list, given
+      as a high precision timestamp.
+      The third field describes many objects point to this ban. When
+      an object is compared to a ban the object is marked with a
+      reference to the newest ban it was tested against. This isn't
+      really useful unless you're debugging.
+      A "G" marks that the ban is "Gone". Meaning it has been marked
+      as a duplicate or it is no longer valid. It stays in the list
+      for effiency reasons.
+      Then follows the actual ban it self.
 ban.url regexp
       Immediately invalidate all documents whose URL matches the
       specified regular expression. Please note that the Host part of

More information about the varnish-commit mailing list