Query: vmod_std
OS: debian
Section: 3
Format: Original Unix Latex Style Formatted with HTML and a Horizontal Scroll Bar
VMOD_STD(3) VMOD_STD(3)NAMEvmod_std - Varnish Standard ModuleSYNOPSISimport stdDESCRIPTIONThe 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.FUNCTIONStoupper 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 ALSOo vcl(7) o varnishd(1)HISTORYThe 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.COPYRIGHTThis document is licensed under the same licence as Varnish itself. See LICENCE for details. o Copyright (c) 2011 Varnish SoftwareAUTHORPer Buer 1.0 2011-05-19 VMOD_STD(3)