lighttpd1.4

lighttpd

lighttpd1.4

You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

History

Glenn Strauss a2bfccd1be [tests] force Fcntl::F_SETFD() autovivification (#3110 ) x-ref: "RPM build fails at Lighttest.pm" https://redmine.lighttpd.net/issues/3110		2 years ago
..
docroot	[tests] move tests/docroot/www contents up 1 level	2 years ago
CMakeLists.txt	[tests] combine *.t using tests/condition.conf	2 years ago
LightyTest.pm	[tests] force Fcntl::F_SETFD() autovivification (#3110 )	2 years ago
Makefile.am	[tests] combine *.t using tests/condition.conf	2 years ago
README	[tests] remove FastCGI test dependency on PHP	2 years ago
SConscript	[tests] remove FastCGI test dependency on libfcgi	2 years ago
cleanup.sh	[scons] various improvements	8 years ago
condition.conf	[tests] combine *.t using tests/condition.conf	2 years ago
core-condition.t	[tests] combine *.t using tests/condition.conf	2 years ago
fastcgi-responder.conf	[tests] combine *.t using tests/lighttpd.conf	2 years ago
fcgi-responder.c	[tests] ignore SIGINT, SIGUSR1 in fcgi-responder	2 years ago
lighttpd.conf	[tests] t/test_mod_indexfile	2 years ago
lighttpd.htpasswd	[mod_auth] skip blank lines and comment lines (fixes #2327 )	7 years ago
lighttpd.user	moved everything below trunk/ and added branches/ and tags/	19 years ago
meson.build	[tests] combine *.t using tests/condition.conf	2 years ago
mod-fastcgi.t	[tests] skip time-sensitive test during CI testing	2 years ago
mod-scgi.t	[tests] skip time-sensitive test during CI testing	2 years ago
prepare.sh	[tests] move tests/docroot/www contents up 1 level	2 years ago
proxy.conf	[tests] use ephemeral ports in tests	2 years ago
request.t	[tests] t/test_mod_indexfile	2 years ago
run-tests.pl	Fix request parser to handle packets with splitted \r\n\r\n (fixes #2105 )	14 years ago
scgi-responder.c	[tests] remove FastCGI test dependency on PHP	2 years ago
scgi-responder.conf	[tests] combine *.t using tests/lighttpd.conf	2 years ago
var-include-sub.conf	[tests] search for perl in PATH instead of /usr/bin; whitespace + test config cleanups	8 years ago
wrapper.sh	Add static-file.disable-pathinfo option to prevent handling of urls like .../secret.php/image.jpg as static file	12 years ago

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