.TH VARNISHTEST "" "" "" .SH NAME varnishtest \- Test program for Varnish .\" Man page generated from reStructeredText. . .SH SYNOPSIS .INDENT 0.0 .INDENT 3.5 varnishtest [\-iklLqv] [\-n iter] [\-D name=val] [\-j jobs] [\-t duration] file [file ...] .UNINDENT .UNINDENT .SH DESCRIPTION .sp The varnishtest program is a script driven program used to test the Varnish Cache. .sp The varnishtest program, when started and given one or more script files, can create a number of threads representing backends, some threads representing clients, and a varnishd process. This is then used to simulate a transaction to provoke a specific behavior. .sp The following options are available: .sp \-D name=val Define macro for use in scripts .INDENT 0.0 .TP .B \-i Find varnishd in build tree .TP .BI \-j \ jobs Run this many tests in parallel .TP .B \-k Continue on test failure .TP .B \-l Leave temporary vtc.* if test fails .TP .B \-L Always leave temporary vtc.* .TP .BI \-n \ iterations Run tests this many times .TP .B \-q Quiet mode: report only failures .TP .BI \-t \ duration Time tests out after this long .TP .B \-v Verbose mode: always report test log .TP .B \-h Show help .UNINDENT .sp file File to use as a script .sp Macro definitions that can be overridden. .sp varnishd Path to varnishd to use [varnishd] .sp If \fITMPDIR\fP is set in the environment, varnishtest creates temporary \fIvtc.*\fP directories for each test in \fI$TMPDIR\fP, otherwise in \fI/tmp\fP. .SH SCRIPTS .sp The script language used for Varnishtest is not a strictly defined language. The best reference for writing scripts is the varnishtest program itself. In the Varnish source code repository, under \fIbin/varnishtest/tests/\fP, all the regression tests for Varnish are kept. .sp An example: .sp .nf .ft C varnishtest "#1029" server s1 { rxreq expect req.url == "/bar" txresp \-gzipbody {[bar]} rxreq expect req.url == "/foo" txresp \-body {