lighttpd
/
lighttpd1.4
2
0
Fork 0
Code Issues Releases Wiki Activity
lighttpd1.4/tests
History
Glenn Strauss 63beba3a4c [core] allow redirect,rewrite ext subst w/o pcre 
allow redirect and rewrite extended substitution when lighttpd is built
without pcre.  When built without pcre, url.rewrite and url.redirect
always match first list entry as if it were "", and numerical
substitutions ($0 %0 $1 %1 etc) are always ignored, but other extended
substitutions (e.g. ${url.path}) may still occur.
 		2022-04-08 06:33:02 -04:00
..
docroot [core] permit env w/ blank value (fix regression) 2022-03-09 19:51:42 -05:00
CMakeLists.txt [build] Haiku build fix (fixes #3136) 2022-01-06 02:03:31 -05:00
LightyTest.pm [tests] revert _WIN32 adjustments in LightyTest.pm 2022-01-14 05:22:33 -05:00
Makefile.am [tests] combine *.t using tests/condition.conf 2021-09-04 08:08:26 -04:00
README [tests] remove FastCGI test dependency on PHP 2020-12-23 03:50:13 -05:00
SConscript [build] update tests/SConscript 2022-01-03 04:25:11 -05:00
cleanup.sh [scons] various improvements 2015-08-29 09:28:04 +00:00
condition.conf [tests] able to run tests when built w/o pcre 2022-04-08 06:33:02 -04:00
core-condition.t [core] allow redirect,rewrite ext subst w/o pcre 2022-04-08 06:33:02 -04:00
fastcgi-responder.conf [tests] able to run tests when built w/o pcre 2022-04-08 06:33:02 -04:00
fcgi-responder.c [core] define __EXTENSIONS__ on Illumos 2022-01-04 04:25:21 -05:00
lighttpd.conf [tests] able to run tests when built w/o pcre 2022-04-08 06:33:02 -04:00
lighttpd.htpasswd [mod_auth] skip blank lines and comment lines (fixes #2327) 2016-04-28 13:13:43 -04:00
lighttpd.user moved everything below trunk/ and added branches/ and tags/ 2005-02-20 14:27:00 +00:00
meson.build [build] Haiku build fix (fixes #3136) 2022-01-06 02:03:31 -05:00
mod-fastcgi.t [tests] skip time-sensitive test during CI testing 2021-09-09 04:55:26 -04:00
mod-scgi.t [tests] skip time-sensitive test during CI testing 2021-09-09 04:55:26 -04:00
prepare.sh [tests] revert _WIN32 adjustments in LightyTest.pm 2022-01-14 05:22:33 -05:00
proxy.conf [tests] able to run tests when built w/o pcre 2022-04-08 06:33:02 -04:00
request.t [tests] able to run tests when built w/o pcre 2022-04-08 06:33:02 -04:00
run-tests.pl Fix request parser to handle packets with splitted \r\n\r\n (fixes #2105) 2009-11-29 14:13:13 +00:00
scgi-responder.c [tests] remove FastCGI test dependency on PHP 2020-12-23 03:50:13 -05:00
scgi-responder.conf [core] allow tests/tmp/bind.conf override (#3137) 2022-01-10 22:38:32 -05:00
var-include-sub.conf [tests] able to run tests when built w/o pcre 2022-04-08 06:33:02 -04:00
wrapper.sh Add static-file.disable-pathinfo option to prevent handling of urls like .../secret.php/image.jpg as static file 2011-08-30 22:13:59 +00:00

README 

Running tests
-------------

  $ make check

If run from tests/ dir, tests will fail to run tests if lighttpd not built.
If run from top level, 'make' will build lighttpd exectuable if not yet built,
and then will run tests.


Running individual tests programs
---------------------------------

prep
  $ cd tests/
  $ ./prepare.sh

then, for any particular *.t such as request.t,
  $ ./request.t
or
  $ VERBOSE=1 RUNTESTS=request ./run-tests.pl

More information is output by tests with additional environment settings:
  $ TRACE_HTTP=1     ./request.t

See LightyTest.pm before trying TRACEME
  $ less LightyTest.pm

  $ TRACEME=strace   ./request.t   # output to file 'strace'
  $ TRACEME=truss    ./request.t   # output to file 'strace'
  $ TRACEME=gdb      ./request.t   # not for interactive debugging (see below)
  $ TRACEME=valgrind ./request.t

To reduce noise from valgrind --show-leak-kinds=all (or =reachable), avoid FAM.
Use server.stat-cache-engine = "simple" (not server.stat-cache-engine = "fam")
in lighttpd.conf.  (FAM creates /usr/libexec/gam_server as child process.)


Running lighttpd server with a config from tests/*.conf
-------------------------------------------------------

Each *.t loads the lighttpd server with one or more config files.
See each *.t for which config file is used, e.g. tests/lighttpd.conf

To run a specific config
  repo=$PWD      # from root of src repository
  cd tests/
  ./prepare.sh
  PERL=/usr/bin/perl SRCDIR=$repo/tests \
    $repo/src/lighttpd -D -f lighttpd.conf -m $repo/src/.libs

The PERL, PHP, and SRCDIR environment variables are set by LightyTest.pm
when 'make check' is run.  PERL and PHP can be set to paths to perl and php,
e.g. export PERL=/usr/bin/perl

To run a specific config under gdb
  repo=$PWD      # from root of src repository
  cd tests/
  ./prepare.sh
  PERL=/usr/bin/perl SRCDIR=$repo/tests \
    gdb --args $repo/src/lighttpd -D -f lighttpd.conf -m $repo/src/.libs

  (gdb) start
  (gdb) ...


Hints and tips
--------------
Q: What do I do if tests fail with:
     bind: Address already in use at LightyTest.pm line 429.
A: It is likely that something else on the machine is already using the port
   that tests are trying to use to run a backend.  Try exiting out of your web
   browser and then run the tests again.  (root can use 'netstat' or 'ss' to
   find out which process is using the port.)


Additional documentation
------------------------
https://redmine.lighttpd.net/projects/lighttpd/wiki/RunningUnitTests
https://redmine.lighttpd.net/projects/lighttpd/wiki/HowToReportABug
https://redmine.lighttpd.net/projects/lighttpd/wiki/DebugVariables