bereq

bereq.backend

Type: BACKEND

Readable from: vcl_pipe, backend

Writeable frome: vcl_pipe, backend

bereq.between_bytes_timeout

Type: DURATION

Readable from: vcl_pipe, backend

Writeable frome: vcl_pipe, backend

The time in seconds to wait between each received byte from the backend. Not available in pipe mode.

bereq.connect_timeout

Type: DURATION

Readable from: vcl_pipe, backend

Writeable frome: vcl_pipe, backend

The time in seconds to wait for a backend connection.

bereq.first_byte_timeout

Type: DURATION

Readable from: vcl_pipe, backend

Writeable frome: vcl_pipe, backend

The time in seconds to wait for the first byte from the backend. Not available in pipe mode.

bereq.http.

Type: HEADER

Readable from: vcl_pipe, backend

Writeable frome: vcl_pipe, backend

The corresponding HTTP header.

bereq.method

Type: STRING

Readable from: vcl_pipe, backend

Writeable frome: vcl_pipe, backend

The request type (e.g. "GET", "HEAD").

bereq.proto

Type: STRING

Readable from: vcl_pipe, backend

Writeable frome: vcl_pipe, backend

The HTTP protocol version used to talk to the server.

bereq.retries

Type: INT

Readable from: backend

bereq.uncacheable

Type: BOOL

Readable from: backend

Writeable frome: backend

bereq.url

Type: STRING

Readable from: vcl_pipe, backend

Writeable frome: vcl_pipe, backend

The requested URL.

beresp

beresp.backend.ip

Type: IP

Readable from: vcl_backend_response

IP of the backend this response was fetched from.

beresp.backend.name

Type: STRING

Readable from: vcl_backend_response

Name of the backend this response was fetched from.

beresp.do_esi

Type: BOOL

Readable from: vcl_backend_response

Writeable frome: vcl_backend_response

Boolean. ESI-process the object after fetching it. Defaults to false. Set it to true to parse the object for ESI directives. Will only be honored if req.esi is true.

beresp.do_gunzip

Type: BOOL

Readable from: vcl_backend_response

Writeable frome: vcl_backend_response

Boolean. Unzip the object before storing it in the cache. Defaults to false.

beresp.do_gzip

Type: BOOL

Readable from: vcl_backend_response

Writeable frome: vcl_backend_response

Boolean. Gzip the object before storing it. Defaults to false. When http_gzip_support is on Varnish will request already compressed content from the backend and as such compression in Varnish is not needed.

beresp.do_stream

Type: BOOL

Readable from: vcl_backend_response

Writeable frome: vcl_backend_response

Deliver the object to the client directly without fetching the whole object into varnish. If this request is pass'ed it will not be stored in memory. As of Varnish Cache 3.0 the object will marked as busy as it is delivered so only client can access the object.

beresp.grace

Type: DURATION

Readable from: vcl_backend_response

Writeable frome: vcl_backend_response

Set to a period to enable grace.

beresp.http.

Type: HEADER

Readable from: vcl_backend_response

Writeable frome: vcl_backend_response

The corresponding HTTP header.

beresp.keep

Type: DURATION

Readable from: vcl_backend_response

Writeable frome: vcl_backend_response

beresp.proto

Type: STRING

Readable from: vcl_backend_response

Writeable frome: vcl_backend_response

The HTTP protocol version used the backend replied with.

beresp.reason

Type: STRING

Readable from: vcl_backend_response

Writeable frome: vcl_backend_response

The HTTP status message returned by the server.

beresp.status

Type: INT

Readable from: vcl_backend_response

Writeable frome: vcl_backend_response

The HTTP status code returned by the server.

beresp.storage

Type: STRING

Readable from: vcl_backend_response

Writeable frome: vcl_backend_response

Set to force Varnish to save this object to a particular storage backend.

beresp.ttl

Type: DURATION

Readable from: vcl_backend_response

Writeable frome: vcl_backend_response

The object's remaining time to live, in seconds. beresp.ttl is writable.

beresp.uncacheable

Type: BOOL

Readable from: vcl_backend_response

Writeable frome: vcl_backend_response

client

client.identity

Type: STRING

Readable from: client, backend

Writeable frome: client, backend

Identification of the client, used to load balance in the client director.

client.ip

Type: IP

Readable from: client, backend

The client's IP address.

now

now

Type: TIME

Readable from: vcl_all

The current time, in seconds since the epoch. When used in string context it returns a formatted string.

obj

obj.grace

Type: DURATION

Readable from: vcl_hit, vcl_error

Writeable frome: vcl_hit, vcl_error

The object's grace period in seconds. obj.grace is writable.

obj.hits

Type: INT

Readable from: vcl_hit, vcl_deliver

Writeable frome: vcl_hit, vcl_deliver

The approximate number of times the object has been delivered. A value of 0 indicates a cache miss. This variable is also available in vcl_deliver.

obj.http.

Type: HEADER

Readable from: vcl_hit, vcl_error

Writeable frome: vcl_error

The corresponding HTTP header.

obj.keep

Type: DURATION

Readable from: vcl_hit, vcl_error

Writeable frome: vcl_hit, vcl_error

obj.last_use

Type: TIME

Readable from: vcl_hit, vcl_deliver

Writeable frome: vcl_hit, vcl_deliver

The approximate time elapsed since the object was last requests, in seconds. This variable is also available in vcl_deliver.

obj.proto

Type: STRING

Readable from: vcl_hit, vcl_error

Writeable frome: vcl_hit, vcl_error

The HTTP protocol version used when the object was retrieved.

obj.reason

Type: STRING

Readable from: vcl_error

Writeable frome: vcl_error

The HTTP status message returned by the server.

obj.status

Type: INT

Readable from: vcl_error

Writeable frome: vcl_error

The HTTP status code returned by the server.

obj.ttl

Type: DURATION

Readable from: vcl_hit, vcl_error

Writeable frome: vcl_hit, vcl_error

The object's remaining time to live, in seconds. obj.ttl is writable.

obj.uncacheable

Type: BOOL

Readable from: vcl_hit, vcl_deliver, vcl_error

req

req.backend

Type: BACKEND

Readable from: client

Writeable frome: client

The backend to use to service the request.

req.can_gzip

Type: BOOL

Readable from: client

Does the client accept the gzip transfer encoding.

req.esi

Type: BOOL

Readable from: vcl_recv, vcl_backend_response, vcl_deliver, vcl_error

Writeable frome: vcl_recv, vcl_backend_response, vcl_deliver, vcl_error

Boolean. Set to false to disable ESI processing regardless of any value in beresp.do_esi. Defaults to true. This variable is subject to change in future versions, you should avoid using it.

req.esi_level

Type: INT

Readable from: client

A count of how many levels of ESI requests we're currently at.

req.hash_always_miss

Type: BOOL

Readable from: vcl_recv

Writeable frome: vcl_recv

Force a cache miss for this request. If set to true Varnish will disregard any existing objects and always (re)fetch from the backend.

req.hash_ignore_busy

Type: BOOL

Readable from: vcl_recv

Writeable frome: vcl_recv

Ignore any busy object during cache lookup. You would want to do this if you have two server looking up content from each other to avoid potential deadlocks.

req.http.

Type: HEADER

Readable from: client

Writeable frome: client

The corresponding HTTP header.

req.method

Type: STRING

Readable from: client

Writeable frome: client

The request type (e.g. "GET", "HEAD").

req.proto

Type: STRING

Readable from: client

Writeable frome: client

The HTTP protocol version used by the client.

req.restarts

Type: INT

Readable from: client

A count of how many times this request has been restarted.

req.ttl

Type: DURATION

Readable from: client

Writeable frome: client

req.url

Type: STRING

Readable from: client

Writeable frome: client

The requested URL.

req.xid

Type: STRING

Readable from: client

Unique ID of this request.

resp

resp.http.

Type: HEADER

Readable from: vcl_deliver

Writeable frome: vcl_deliver

The corresponding HTTP header.

resp.proto

Type: STRING

Readable from: vcl_deliver

Writeable frome: vcl_deliver

The HTTP protocol version to use for the response.

resp.reason

Type: STRING

Readable from: vcl_deliver

Writeable frome: vcl_deliver

The HTTP status message that will be returned.

resp.status

Type: INT

Readable from: vcl_deliver

Writeable frome: vcl_deliver

The HTTP status code that will be returned.

server

server.hostname

Type: STRING

Readable from: client

The host name of the server.

server.identity

Type: STRING

Readable from: client

The identity of the server, as set by the -i parameter. If the -i parameter is not passed to varnishd, server.identity will be set to the name of the instance, as specified by the -n parameter.

server.ip

Type: IP

Readable from: client

The IP address of the socket on which the client connection was received.

Table Of Contents

This Page