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.
Glenn Strauss
9c9cd37320
On platforms where lighttpd gets SIGCHLD, lighttpd can quickly detect exit of backend process and can restart backend process |
2 years ago | |
|---|---|---|
| .. | ||
| docroot | 2 years ago | |
| CMakeLists.txt | 2 years ago | |
| LightyTest.pm | 2 years ago | |
| Makefile.am | 2 years ago | |
| README | 2 years ago | |
| SConscript | 2 years ago | |
| cleanup.sh | 8 years ago | |
| condition.conf | 2 years ago | |
| core-condition.t | 2 years ago | |
| fastcgi-responder.conf | 2 years ago | |
| fcgi-responder.c | 2 years ago | |
| lighttpd.conf | 2 years ago | |
| lighttpd.htpasswd | 7 years ago | |
| lighttpd.user | 18 years ago | |
| meson.build | 2 years ago | |
| mod-fastcgi.t | 2 years ago | |
| mod-scgi.t | 2 years ago | |
| prepare.sh | 2 years ago | |
| proxy.conf | 2 years ago | |
| request.t | 2 years ago | |
| run-tests.pl | 14 years ago | |
| scgi-responder.c | 2 years ago | |
| scgi-responder.conf | 2 years ago | |
| var-include-sub.conf | 8 years ago | |
| wrapper.sh | 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