Alexander Barton 2ed1c3d511 Import upstream version 26.1 9 months ago
..
ssl 12d5ad5f27 Import upstream version 26 1 year ago
Makefile.am 2ed1c3d511 Import upstream version 26.1 9 months ago
Makefile.in 2ed1c3d511 Import upstream version 26.1 9 months ago
Makefile.ng 12d5ad5f27 Import upstream version 26 1 year ago
README 813f3b0206 Import upstream version 22.1 6 years ago
channel-test.e 813f3b0206 Import upstream version 22.1 6 years ago
check-idle.e 813f3b0206 Import upstream version 22.1 6 years ago
cleanup-server3 12d5ad5f27 Import upstream version 26 1 year ago
connect-ssl-cert1-test.e 12d5ad5f27 Import upstream version 26 1 year ago
connect-ssl-cert2-test.e 12d5ad5f27 Import upstream version 26 1 year ago
connect-test.e 813f3b0206 Import upstream version 22.1 6 years ago
functions.inc 4736aa9617 Import upstream version 0.9.2 16 years ago
getpid.sh 12d5ad5f27 Import upstream version 26 1 year ago
invite-test.e 813f3b0206 Import upstream version 22.1 6 years ago
join-test.e 12d5ad5f27 Import upstream version 26 1 year ago
kick-test.e 813f3b0206 Import upstream version 22.1 6 years ago
message-test.e a1970979f7 Import upstream version 24 4 years ago
misc-test.e 813f3b0206 Import upstream version 22.1 6 years ago
mode-test.e 813f3b0206 Import upstream version 22.1 6 years ago
ngircd-test1.conf 12d5ad5f27 Import upstream version 26 1 year ago
ngircd-test2.conf 3fafaf1490 Import upstream version 25 2 years ago
ngircd-test3.conf 12d5ad5f27 Import upstream version 26 1 year ago
opless-channel-test.e 813f3b0206 Import upstream version 22.1 6 years ago
prep-server3 12d5ad5f27 Import upstream version 26 1 year ago
reload-server.sh 2ed1c3d511 Import upstream version 26.1 9 months ago
reload-server3 12d5ad5f27 Import upstream version 26 1 year ago
server-link-test.e 813f3b0206 Import upstream version 22.1 6 years ago
server-login-test.e 12d5ad5f27 Import upstream version 26 1 year ago
start-server.sh 9360ed23a4 Import upstream version 22 7 years ago
start-server1 b9db8b1777 Import upstream version 15 12 years ago
start-server2 b9db8b1777 Import upstream version 15 12 years ago
start-server3 12d5ad5f27 Import upstream version 26 1 year ago
stop-server.sh 3610f8bac1 Import upstream version 20 8 years ago
stop-server1 b9db8b1777 Import upstream version 15 12 years ago
stop-server2 b9db8b1777 Import upstream version 15 12 years ago
stop-server3 12d5ad5f27 Import upstream version 26 1 year ago
stress-A.e 813f3b0206 Import upstream version 22.1 6 years ago
stress-B.e 9360ed23a4 Import upstream version 22 7 years ago
stress-server.sh 3610f8bac1 Import upstream version 20 8 years ago
switch-server3 12d5ad5f27 Import upstream version 26 1 year ago
test-loop.sh 4736aa9617 Import upstream version 0.9.2 16 years ago
tests.sh 9360ed23a4 Import upstream version 22 7 years ago
wait-tests.sh 0713fe23ff Import upstream version 0.10.0 15 years ago
who-test.e 813f3b0206 Import upstream version 22.1 6 years ago
whois-test.e 813f3b0206 Import upstream version 22.1 6 years ago

README


ngIRCd - Next Generation IRC Server

(c)2001-2008 Alexander Barton,
alex@barton.de, http://www.barton.de/

ngIRCd is free software and published under the
terms of the GNU General Public License.

-- README for the Test Suite --


I. Overview
~~~~~~~~~~~

The purpose of the "test suite" contained in this directory is to detect
bugs and incompatibilities in ngIRCd introduced during coding and after
building ngIRCd on a specific platform.

To run the "standard" tests call "make check" (which runs "make check" in
all the source directories, testing the "portab" library as well for example)
or "make testsuite" (which only runs the tests in this directory). Both will
build ngIRCd (if required) and run some tests on it. These tests should be
portable and run on all supported platforms without errors.

NOTE #1: most tests of this suite depend on the external tools expect(1)
and telnet(1), so make sure you have them installed. If not, the tests will
not fail but simply be skipped.

NOTE #2: the two test servers started by this test suite are configured to
run on port 6789 and 6790; so it will fail if one or both of these ports
are already used by some other daemons!


II. Shell Scripts
~~~~~~~~~~~~~~~~

getpid.sh

This script is used to detect the PID of the running process with
the given name in a portable manner. The result is echoed on the
console. It is a helper script for some other scripts of this suite.

start-server.sh []

start-server.sh starts up the test binary, "T-ngircd" (the default
for is 1) with configuration file "ngircd-test.conf" and the
console output redirected to "ngircd-test.log".
The script first makes sure that getpid.sh is available and working,
and that no other instance of the test binary is already running.
The exit code is 0 if the test binary could be started.

stop-server.sh []

This script uses getpid.sh to detect a running test binary
"T-ngircd" and then shuts it down using the TERM signal.
The exit code is 0 if the test binary could be stopped.

stress-server.sh [ []]

stress-server.sh starts clients that "stress" the
running test server (id 1); but no more than clients
are started at the same moment.

tests.sh

Most of the tests scripts are symlinked to tests.sh, which in turn
uses expect(1) to run the respective script .e and checks
its exit code.

test-loop.sh [ []]

This script runs all the tests times (default: 5) and pauses
seconds (default: 5) betweed runs.
It isn't used by "make check" or "make testsuite".

wait-tests.sh []

stress-server.sh uses this script to ensure that no more than
clients are connected to the test server (id 1).


III. Scripts for expect(1)
~~~~~~~~~~~~~~~~~~~~~~~~~~

channel-test.e
check-idle.e
connect-test.e
invite-test.e
join-test.e
kick-test.e
message-test.e
misc-test.e
mode-test.e
opless-channel-test.e
server-link-test.e
stress-A.e
stress-B.e
who-test.e
whois-test.e