VMOD_STD(3) VMOD_STD(3)
NAME
vmod_std - Varnish Standard Module
SYNOPSIS
import std
DESCRIPTION
The Varnish standard module contains useful, generic function that don't quite fit in the VCL core, but are still considered very useful to
a broad audience.
FUNCTIONS
toupper
Prototype
toupper(STRING S)
Return value
String
Description
Converts the STRING S to upper case.
Example
set beresp.http.x-scream = std.toupper("yes!");
tolower
Prototype
tolower(STRING S)
Return value
String
Description
Converts the STRING to lower case.
Example
set beresp.http.x-nice = std.tolower("VerY");
set_up_tos
Prototype
set_ip_tos(INT I)
Return value
Void
Description
Sets the Type-of-Service flag for the current session. Please note that the TOS flag is not removed by the end of the request so
probably want to set it on every request should you utilize it.
Example
if (req.url ~ ^/slow/) {
std.set_up_tos(0x0);
}
random
Prototype
random(REAL a, REAL b)
Return value
Real
Description
Returns a random REAL number between a and b.
Example
set beresp.http.x-random-number = std.random(1, 100);
log
Prototype
log(STRING string)
Return value
Void
Description
Logs string to the shared memory log.
Example
std.log("Something fishy is going on with the vhost " + req.host);
syslog
Prototype
syslog(INT priority, STRING string)
Return value
Void
Description
Logs string to syslog marked with priority.
Example
std.syslog( LOG_USER|LOG_ALERT, "There is serious troble");
fileread
Prototype
fileread(STRING filename)
Return value
String
Description
Reads a file and returns a string with the content. Please note that it is not recommended to send variables to this function the
caching in the function doesn't take this into account. Also, files are not re-read.
Example
set beresp.http.x-served-by = std.fileread("/etc/hostname");
duration
Prototype
duration(STRING s, DURATION fallback)
Return value
Duration
Description
Converts the string s to seconds. s can be quantified with the usual s (seconds), m (minutes), h (hours), d (days) and w (weeks)
units. If it fails to parse the string fallback will be used
Example
set beresp.ttl = std.duration("1w", 3600);
integer
Prototype
integer(STRING s, INT fallback)
Return value
Int
Description
Converts the string s to an integer. If it fails to parse the string fallback will be used
Example
if (std.integer(beresp.http.x-foo, 0) > 5) { }
collect
Prototype
collect(HEADER header)
Return value
Void
Description
Collapses the header, joining the headers into one.
Example
std.collect(req.http.cookie); This will collapse several Cookie: headers into one, long cookie header.
SEE ALSO
o vcl(7)
o varnishd(1)
HISTORY
The Varnish standard module was released along with Varnish Cache 3.0. This manual page was written by Per Buer with help from Martin Blix
Grydeland.
COPYRIGHT
This document is licensed under the same licence as Varnish itself. See LICENCE for details.
o Copyright (c) 2011 Varnish Software
AUTHOR
Per Buer
1.0 2011-05-19 VMOD_STD(3)