Use correct syntax for quotes, emphasis and punctuation in varnishd.1

git-svn-id: http://www.varnish-cache.org/svn/trunk/varnish-cache@4121 d4fa192b-c00b-0410-8231-f00ffab90ce4
parent bb0fee00
......@@ -375,15 +375,18 @@ and either
or
.Va server.ip
depending on the presence of a Host: header in the request sent by the
client. The object hash may be modified further by
client.
The object hash may be modified further by
.Va VCL.
.It Cm purge.list
Display the purge list.
.Pp
All requests for objects from the cache are matched against items on
the purge list. If an object in the cache is older than a matching
purge list item, it is considered "purged", and will be fetched from
the backend instead.
the purge list.
If an object in the cache is older than a matching purge list item, it
is considered
.Qq purged ,
and will be fetched from the backend instead.
.Pp
When a purge expression is older than all the objects in the cache, it
is removed from the list.
......@@ -633,9 +636,10 @@ The default is
.Dv off .
.El
.Ss Purge expressions
A purge expression consists of one or more conditions. A condition
consists of a field, a operator, and an argument. Conditions can be
ANDed together with "&&".
A purge expression consists of one or more conditions.
A condition consists of a field, an operator, and an argument.
Conditions can be ANDed together with
.Qq && .
.Pp
A field can be any of the variables from VCL, for instance
.Va req.url ,
......@@ -643,13 +647,27 @@ A field can be any of the variables from VCL, for instance
or
.Va obj.set-cookie .
.Pp
Operators are "==" for direct comparision, "~" for a regular
expression match, and ">" or "<" for size comparisons. Prepending an
operator with "!" negates the expression.
Operators are
.Qq ==
for direct comparision,
.Qq ~
for a regular expression match, and
.Qq >
or
.Qq <
for size comparisons.
Prepending an operator with
.Qq \&!
negates the expression.
.Pp
The argument could be a quoted string, a regexp, or an integer.
Integers can have "KB", "MB", "GB" or "TB" appended for size related
fields.
Integers can have
.Qq KB ,
.Qq MB ,
.Qq GB
or
.Qq TB
appended for size related fields.
.Pp
Simple example: All requests where
.Va req.url
......@@ -660,15 +678,19 @@ are purged from the cache.
req.url == "/news"
.Ed
.Pp
Example: Purge all documents where the name does not end with ".ogg",
Example: Purge all documents where the name does not end with
.Qq .ogg ,
and where the size of the object is greater than 10 megabytes.
.Bd -literal -offset 4n
req.url !~ "\\.ogg$" && obj.size > 10MB
.Ed
.Pp
Example: Purge all documents where the serving host is "example.com"
or "www.example.com", and where the Set-Cookie header received from
the backend contains "USERID=1663".
Example: Purge all documents where the serving host is
.Qq example.com
or
.Qq www.example.com ,
and where the Set-Cookie header received from the backend contains
.Qq USERID=1663 .
.Bd -literal -offset 4n
req.http.host ~ "^(www\\.)example.com$" && obj.set-cookie ~ "USERID=1663"
.Ed
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment