VINYLTEST(1)                General Commands Manual               VINYLTEST(1)

<?><?><?> (NAME)
       vinyltest - <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> Vinyl
       Cache

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       vinyltest [-hikLlqv] [-b size] [-D name=val] [-j jobs] [-n iter] [-t
       duration] file [file ...]

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?><?> vinyltest <?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?> Vinyl Cache <?><?> <?><?><?> <?><?><?><?><?><?>.

       <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> vinyltest <?><?><?><?>
       <?><?><?> <?> <?><?> <?><?> <?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> (thread)
       <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       (backends)<?> <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> (clients) <?> <?><?> <?><?><?><?><?><?>
       vinyld <?><?><?><?><?> <?><?><?>. <?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>.

       <?><?><?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?>:

       -b size
              <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
              (<?><?><?><?><?><?><?>: 1M)

       -D name=val      <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?>

       -h     <?><?><?><?><?> <?><?><?><?><?><?>

       -i     <?><?><?><?><?> PATH <?> vmod_path <?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?> Vinyl Cache <?><?> <?><?><?><?>
              <?><?><?><?> (build tree)

       -j jobs
              <?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?>

       -k     <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?>
              <?><?><?><?><?>

       -L     <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> vtc.*

       -l     <?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> vtc.*
              <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?>

       -n iterations
              <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?>
              <?><?><?><?><?> <?><?><?><?><?>

       -p name=val      <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?><?><?> vinyld

       -q     <?><?><?><?> <?><?><?><?><?><?>: <?><?><?><?><?> <?><?><?><?>
              <?><?> <?><?><?><?> <?><?><?><?>

       -t duration
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> (timeout)
              <?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?> <?><?><?>
              (<?><?><?><?><?><?><?>: 60s)

       -v     <?><?><?><?> <?><?><?><?>: <?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?>

       file             <?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>

       <?><?><?> TMPDIR <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?> vinyltest
       <?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> vtc.* <?><?>
       <?><?> $TMPDIR <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?> <?><?> /tmp
       <?><?><?><?><?><?><?>.

<?><?><?><?><?><?><?><?><?><?> (SCRIPTS)
       <?><?><?><?><?><?> vtc <?><?><?><?><?><?> <?><?><?><?> <?><?> vtc(7)
       <?><?><?><?><?> <?><?><?> <?><?><?>. <?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?> <?><?><?><?>
       Vinyl Cache <?><?> <?><?><?><?> bin/vinyltest/tests/ <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> (regression tests)
       <?><?><?><?> Vinyl Cache <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>.

       <?><?> <?><?><?><?>:

          vinyltest "#1029"

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

                  rxreq
                  expect req.url == "/foo"
                  txresp -body {<h1>FOO<esi:include src="/bar"/>BARF</h1>}

          } -start

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

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

                  txreq -url "/foo" -hdr "Accept-Encoding: gzip"
                  rxresp
                  expect resp.bodylen == 21
          } -run

       <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?> <?><?><?><?> (s1) <?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?>. <?><?><?> <?><?><?><?><?><?><?> <?><?>
       vinyld (v1) <?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?> VCL
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       (-vcl+backend). <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?> c1 <?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?><?> <?><?><?> <?> <?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>.

<?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> (TESTING A BUILD TREE)
       <?><?> <?><?> <?><?><?> <?><?><?><?> <?><?> VMOD <?><?><?><?><?> <?>
       <?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> vinyltest <?><?><?><?><?><?> <?><?>
       <?><?> vmod_path <?><?> <?><?> <?><?><?><?><?><?><?><?><?> vinyld
       <?><?> <?><?> <?><?><?><?><?> vinyl -start <?><?> <?><?><?><?>
       <?><?><?><?><?> (test case) <?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?>:

          vinyltest -p vmod_path=... /path/to/*.vtc

       <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?> <?><?><?><?> VMOD<?><?><?> <?><?><?><?><?><?><?> <?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>:

          server s1 {...} -start

          vinyl v1 -vcl+backend {
              import wossname;

              ...
          } -start

          ...

       <?><?><?> <?><?> vmod_path <?><?><?><?><?> <?><?><?><?><?><?> <?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?> (build matrix) <?><?> <?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> (test suite) <?><?><?><?>
       <?><?><?><?>. <?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
       <?><?><?> <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?> <?><?> <?><?> <?><?><?><?>
       <?><?><?><?> <?><?> <?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?>.

       <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> vinyld <?><?> <?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?>:

          exec vinyld [vinyltest -p params] [testing params] [vtc -arg params]

       <?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?> vinyltest -p
       <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?> vinyltest
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> (override) <?><?><?><?><?> <?> <?><?><?><?><?>
       <?><?><?> <?><?><?><?> <?><?><?> <?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?>.

       <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?> <?><?> <?><?> vinyltest <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> Vinyl Cache
       (<?><?><?><?><?><?><?><?><?> <?> VMOD<?><?>) <?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> vinyltest<?>
       <?><?><?><?><?><?> PATH <?> vmod_path <?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?>. <?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?> Vinyl Cache <?><?> <?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?> <?> <?><?> <?><?><?><?>
       <?><?><?><?><?> vmod_path <?><?><?><?> <?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>.

       <?><?><?> <?><?><?><?> <?><?><?><?><?> VMOD <?><?><?> <?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?> Vinyl Cache
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?>
       <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>. <?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
       pkg-config(1) <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?>
       PATH <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?> Vinyl <?> <?><?> vmod_path <?><?><?><?>
       <?><?><?><?><?><?> <?><?> VMOD <?><?><?> <?> <?><?><?><?><?><?>
       VMOD<?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>:

          export PKG_CONFIG_PATH=/path/to/install/lib/pkgconfig

          BINDIR="$(pkg-config --variable=bindir vinylapi)"
          SBINDIR="$(pkg-config --variable=sbindir vinylapi)"
          PATH="SBINDIR:BINDIR:$PATH"

          VMODDIR="$(pkg-config --variable=vmoddir vinylapi)"
          VMOD_PATH="/path/to/your/vmod/build/dir:$VMODDIR"

          vinyltest -p vmod_path="$VMOD_PATH" ...

<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)

       o <?><?><?><?> <?><?> <?><?><?><?> vinyltest <?><?><?><?><?> <?><?>
         <?><?><?><?><?><?><?><?>

       o vinylhist(1)

       o vinyllog(1)

       o vinylncsa(1)

       o vinylstat(1)

       o vinyltop(1)

       o vcl(7)

       o vtc(7)

       o vmod_vtc(3)

<?><?><?><?><?><?><?> (HISTORY)
       <?><?><?><?><?><?> vinyltest <?><?><?><?> Poul-Henning Kamp <
       <phk@phk.freebsd.dk> > <?><?> <?><?><?><?><?><?> Redpill-Linpro
       <?><?><?><?><?> <?><?><?><?> <?><?>. <?><?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> Stig Sandbeck
       Mathisen < <ssm@linpro.no> > <?><?><?><?><?> <?><?><?> <?> <?><?><?>
       <?><?><?><?> Kristian Lyngstol < <kristian@varnish-cache.org> >
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?>.

<?><?><?><?><?><?><?><?> <?> <?><?><?><?><?> (COPYRIGHT)
       <?><?><?> <?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?> Vinyl
       Cache <?><?><?><?><?><?><?> <?><?><?> <?><?><?>. <?><?><?><?>
       <?><?><?><?><?><?> <?><?> LICENCE <?><?><?><?><?><?> <?><?><?><?>.

       o <?><?> <?><?><?> (c) 2007-2016 <?><?><?><?><?> <?><?> Varnish
         Software AS

                                                                  VINYLTEST(1)