Enhanced PHP File Manager

⬆️ Go Up (..)

📊 Server Information

Server:

nginx/1.28.0

System:

Linux 6.8.0-90-generic

PHP Version:

8.4.15

User:

alqudsvolunteers

Directory:

/home/alqudsvolunteers/rootlink/proc/thread-self/root/usr/share/doc/varnish/html/reference

Free Space:

80.22 GB

🔧 Quick Actions

✏️ Editing: varnishtest.html

<!DOCTYPE html>

<title>varnishtest &#8212; Varnish version 7.5.0 documentation</title>
 <link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=fa44fd50" />
 <link rel="stylesheet" type="text/css" href="../_static/classic.css?v=e2714048" />
 
 <script src="../_static/documentation_options.js?v=8214db13"></script>
 <script src="../_static/doctools.js?v=888ff710"></script>
 <script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
 
 <link rel="index" title="Index" href="../genindex.html" />
 <link rel="search" title="Search" href="../search.html" />
 <link rel="next" title="VMOD vtc - Utility module for varnishtest" href="vmod_vtc.html" />
 <link rel="prev" title="VTC" href="vtc.html" /> 
 </head><body>
 <div class="related" role="navigation" aria-label="related navigation">
 <h3>Navigation</h3>
 <ul>
 <li class="right" style="margin-right: 10px">
 <a href="../genindex.html" title="General Index"
 accesskey="I">index</a></li>
 <li class="right" >
 <a href="vmod_vtc.html" title="VMOD vtc - Utility module for varnishtest"
 accesskey="N">next</a> |</li>
 <li class="right" >
 <a href="vtc.html" title="VTC"
 accesskey="P">previous</a> |</li>
 <li class="nav-item nav-item-0"><a href="../index.html">Varnish version 7.5.0 documentation</a> &#187;</li>
 <li class="nav-item nav-item-1"><a href="index.html" accesskey="U">The Varnish Reference Manual</a> &#187;</li>
 <li class="nav-item nav-item-this"><a href="">varnishtest</a></li> 
 </ul>
 </div>

<div class="document">
 <div class="documentwrapper">
 <div class="bodywrapper">
 <div class="body" role="main">
 
 <section id="varnishtest">
<h1>varnishtest<a class="headerlink" href="#varnishtest" title="Link to this heading">¶</a></h1>
<section id="test-program-for-varnish">
<h2>Test program for Varnish<a class="headerlink" href="#test-program-for-varnish" title="Link to this heading">¶</a></h2>
<dl class="field-list simple">
<dt class="field-odd">Manual section:</dt>
<dd class="field-odd">1
</dd>
</dl>
<section id="synopsis">
<h3>SYNOPSIS<a class="headerlink" href="#synopsis" title="Link to this heading">¶</a></h3>
varnishtest [-hikLlqv] [-b size] [-D name=val] [-j jobs] [-n iter] [-t duration] file [file …]
</section>
<section id="description">
<h3>DESCRIPTION<a class="headerlink" href="#description" title="Link to this heading">¶</a></h3>
The varnishtest program is a script driven program used to test the
Varnish Cache.
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.
The following options are available:
<dl class="option-list">
<dt><kbd>-b <var>size</var></kbd></dt>
<dd>Set internal buffer size (default: 1M)
</dd>
</dl>
-D name=val Define macro for use in scripts
<dl class="option-list">
<dt><kbd>-h</kbd></dt>
<dd>Show help
</dd>
<dt><kbd>-i</kbd></dt>
<dd>Set PATH and vmod_path to find varnish binaries in build tree
</dd>
<dt><kbd>-j <var>jobs</var></kbd></dt>
<dd>Run this many tests in parallel
</dd>
<dt><kbd>-k</kbd></dt>
<dd>Continue on test failure
</dd>
<dt><kbd>-L</kbd></dt>
<dd>Always leave temporary vtc.*
</dd>
<dt><kbd>-l</kbd></dt>
<dd>Leave temporary vtc.* if test fails
</dd>
<dt><kbd>-n <var>iterations</var></kbd></dt>
<dd>Run tests this many times
</dd>
</dl>
-p name=val Pass parameters to all varnishd command lines
<dl class="option-list">
<dt><kbd>-q</kbd></dt>
<dd>Quiet mode: report only failures
</dd>
<dt><kbd>-t <var>duration</var></kbd></dt>
<dd>Time tests out after this long (default: 60s)
</dd>
<dt><kbd>-v</kbd></dt>
<dd>Verbose mode: always report test log
</dd>
</dl>
file File to use as a script
If <cite>TMPDIR</cite> is set in the environment, varnishtest creates temporary
<cite>vtc.*</cite> directories for each test in <cite>$TMPDIR</cite>, otherwise in <cite>/tmp</cite>.
</section>
<section id="scripts">
<h3>SCRIPTS<a class="headerlink" href="#scripts" title="Link to this heading">¶</a></h3>
The vtc syntax is documented at length in <a class="reference internal" href="vtc.html#vtc-7">VTC</a>. Should you want more
examples than the one below, you can have a look at the Varnish source code
repository, under <cite>bin/varnishtest/tests/</cite>, where all the regression tests for
Varnish are kept.
An example:
<div class="highlight-default notranslate"><div class="highlight"><pre>varnishtest &quot;#1029&quot;

server s1 {
 rxreq
 expect req.url == &quot;/bar&quot;
 txresp -gzipbody {[bar]}

rxreq
 expect req.url == &quot;/foo&quot;
 txresp -body {&lt;h1&gt;FOO&lt;esi:include src=&quot;/bar&quot;/&gt;BARF&lt;/h1&gt;}

} -start

varnish v1 -vcl+backend {
 sub vcl_backend_response {
 set beresp.do_esi = true;
 if (bereq.url == &quot;/foo&quot;) {
 set beresp.ttl = 0s;
 } else {
 set beresp.ttl = 10m;
 }
 }
} -start

client c1 {
 txreq -url &quot;/bar&quot; -hdr &quot;Accept-Encoding: gzip&quot;
 rxresp
 gunzip
 expect resp.bodylen == 5

txreq -url &quot;/foo&quot; -hdr &quot;Accept-Encoding: gzip&quot;
 rxresp
 expect resp.bodylen == 21
} -run
</pre></div>
</div>
When run, the above script will simulate a server (s1) that expects
two different requests. It will start a Varnish server (v1) and add the
backend definition to the VCL specified (-vcl+backend). Finally it starts
the c1-client, which is a single client sending two requests.
</section>
<section id="testing-a-build-tree">
<h3>TESTING A BUILD TREE<a class="headerlink" href="#testing-a-build-tree" title="Link to this heading">¶</a></h3>
Whether you are building a VMOD or trying to use one that you freshly
built, you can tell <code class="docutils literal notranslate">varnishtest</code> to pass a vmod_path to <code class="docutils literal notranslate">varnishd</code>
instances started using the <code class="docutils literal notranslate">varnish -start</code> command in your test case:
<div class="highlight-default notranslate"><div class="highlight"><pre>varnishtest -p vmod_path=... /path/to/*.vtc
</pre></div>
</div>
This way you can use the same test cases on both installed and built
VMODs:
<div class="highlight-default notranslate"><div class="highlight"><pre>server s1 {...} -start

...
} -start

...
</pre></div>
</div>
You are not limited to the vmod_path and can pass any parameter,
allowing you to run a build matrix without changing the test suite. You
can achieve the same with macros, but then they need to be defined on
each run.
You can see the actual <code class="docutils literal notranslate">varnishd</code> command lines in test outputs,
they look roughly like this:
<div class="highlight-default notranslate"><div class="highlight"><pre>exec varnishd [varnishtest -p params] [testing params] [vtc -arg params]
</pre></div>
</div>
Parameters you define with <code class="docutils literal notranslate">varnishtest -p</code> may be overridden by
parameters needed by <code class="docutils literal notranslate">varnishtest</code> to run properly, and they may in
turn be overridden by parameters set in test scripts.
There’s also a special mode in which <code class="docutils literal notranslate">varnishtest</code> builds itself a
PATH and a vmod_path in order to find Varnish binaries (programs and
VMODs) in the build tree surrounding the <code class="docutils literal notranslate">varnishtest</code> binary. This
is meant for testing of Varnish under development and will disregard
your vmod_path if you set one.
If you need to test your VMOD against a Varnish build tree, you must
install it first, in a temp directory for instance. With information
provided by the installation’s pkg-config(1) you can build a proper
PATH in order to access Varnish programs, and a vmod_path to access
both your VMOD and the built-in VMODs:
<div class="highlight-default notranslate"><div class="highlight"><pre>export PKG_CONFIG_PATH=/path/to/install/lib/pkgconfig

BINDIR=&quot;$(pkg-config --variable=bindir varnishapi)&quot;
SBINDIR=&quot;$(pkg-config --variable=sbindir varnishapi)&quot;
PATH=&quot;SBINDIR:BINDIR:$PATH&quot;

VMODDIR=&quot;$(pkg-config --variable=vmoddir varnishapi)&quot;
VMOD_PATH=&quot;/path/to/your/vmod/build/dir:$VMODDIR&quot;

varnishtest -p vmod_path=&quot;$VMOD_PATH&quot; ...
</pre></div>
</div>
</section>
<section id="see-also">
<h3>SEE ALSO<a class="headerlink" href="#see-also" title="Link to this heading">¶</a></h3>
<ul class="simple">
<li>varnishtest source code repository with tests</li>
<li><a class="reference internal" href="varnishhist.html#varnishhist-1">varnishhist</a></li>
<li><a class="reference internal" href="varnishlog.html#varnishlog-1">varnishlog</a></li>
<li><a class="reference internal" href="varnishncsa.html#varnishncsa-1">varnishncsa</a></li>
<li><a class="reference internal" href="varnishstat.html#varnishstat-1">varnishstat</a></li>
<li><a class="reference internal" href="varnishtop.html#varnishtop-1">varnishtop</a></li>
<li><a class="reference internal" href="vcl.html#vcl-7">VCL</a></li>
<li><a class="reference internal" href="vtc.html#vtc-7">VTC</a></li>
<li><a class="reference internal" href="vmod_vtc.html#vmod-vtc-3">VMOD vtc - Utility module for varnishtest</a></li>
</ul>
</section>
<section id="history">
<h3>HISTORY<a class="headerlink" href="#history" title="Link to this heading">¶</a></h3>
The varnishtest program was developed by Poul-Henning Kamp
&lt;<a class="reference external" href="mailto:phk&#37;&#52;&#48;phk&#46;freebsd&#46;dk">phk&#64;phk&#46;freebsd&#46;dk</a>&gt; in cooperation with Varnish Software AS. This manual
page was originally written by Stig Sandbeck Mathisen &lt;<a class="reference external" href="mailto:ssm&#37;&#52;&#48;linpro&#46;no">ssm&#64;linpro&#46;no</a>&gt;
and updated by Kristian Lyngstøl &lt;<a class="reference external" href="mailto:kristian&#37;&#52;&#48;varnish-cache&#46;org">kristian&#64;varnish-cache&#46;org</a>&gt;.
</section>
<section id="copyright">
<h3>COPYRIGHT<a class="headerlink" href="#copyright" title="Link to this heading">¶</a></h3>
This document is licensed under the same licence as Varnish
itself. See LICENCE for details.
<ul class="simple">
<li>Copyright (c) 2007-2016 Varnish Software AS</li>
</ul>
</section>
</section>
</section>

<div class="clearer"></div>
 </div>
 </div>
 </div>
 <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
 <div class="sphinxsidebarwrapper">
 <div>
 <h3><a href="../index.html">Table of Contents</a></h3>
 <ul>
<li><a class="reference internal" href="#">varnishtest</a><ul>
<li><a class="reference internal" href="#test-program-for-varnish">Test program for Varnish</a><ul>
<li><a class="reference internal" href="#synopsis">SYNOPSIS</a></li>
<li><a class="reference internal" href="#description">DESCRIPTION</a></li>
<li><a class="reference internal" href="#scripts">SCRIPTS</a></li>
<li><a class="reference internal" href="#testing-a-build-tree">TESTING A BUILD TREE</a></li>
<li><a class="reference internal" href="#see-also">SEE ALSO</a></li>
<li><a class="reference internal" href="#history">HISTORY</a></li>
<li><a class="reference internal" href="#copyright">COPYRIGHT</a></li>
</ul>
</li>
</ul>
</li>
</ul>

</div>
 <div>
 <h4>Previous topic</h4>
 <a href="vtc.html"
 title="previous chapter">VTC</a>
 </div>
 <div>
 <h4>Next topic</h4>
 <a href="vmod_vtc.html"
 title="next chapter">VMOD vtc - Utility module for varnishtest</a>
 </div>
 <div role="note" aria-label="source link">
 <h3>This Page</h3>
 <ul class="this-page-menu">
 <li><a href="../_sources/reference/varnishtest.rst.txt"
 rel="nofollow">Show Source</a></li>
 </ul>
 </div>
<div id="searchbox" style="display: none" role="search">
 <h3 id="searchlabel">Quick search</h3>
 <div class="searchformwrapper">
 <form class="search" action="../search.html" method="get">
 <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
 <input type="submit" value="Go" />
 </form>
 </div>
</div>
<script>document.getElementById('searchbox').style.display = "block"</script>
 </div>
 </div>
 <div class="clearer"></div>
 </div>
 <div class="related" role="navigation" aria-label="related navigation">
 <h3>Navigation</h3>
 <ul>
 <li class="right" style="margin-right: 10px">
 <a href="../genindex.html" title="General Index"
 >index</a></li>
 <li class="right" >
 <a href="vmod_vtc.html" title="VMOD vtc - Utility module for varnishtest"
 >next</a> |</li>
 <li class="right" >
 <a href="vtc.html" title="VTC"
 >previous</a> |</li>
 <li class="nav-item nav-item-0"><a href="../index.html">Varnish version 7.5.0 documentation</a> &#187;</li>
 <li class="nav-item nav-item-1"><a href="index.html" >The Varnish Reference Manual</a> &#187;</li>
 <li class="nav-item nav-item-this"><a href="">varnishtest</a></li> 
 </ul>
 </div>
 <div class="footer" role="contentinfo">
 &#169; Copyright 2010-2014, Varnish Software AS.
 Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 7.2.6.
 </div>
 </body>
</html>

❌ Cancel

🗂️ Enhanced PHP File Manager

📊 Server Information

🔧 Quick Actions

✏️ Editing: varnishtest.html

📤 Upload File

📁 Create Folder

📄 Create File

✏️ Rename Item

🗑️ Delete Confirmation