freebsd-dev/tools/regression
Pawel Jakub Dawidek 1897c44125 Add regression tests for pkill/pgrep.
MFC after:	3 days
2005-03-20 12:38:08 +00:00
..
aio This will not compile without: 2005-03-02 04:00:55 +00:00
atm Add a regression test for the ATM call control stuff. 2004-08-13 09:27:21 +00:00
ccd/layout write pattern to /dev/ccd3 not /dev/ccd3c 2003-06-02 19:49:09 +00:00
fsx Start the dreaded NOFOO -> NO_FOO conversion. 2004-12-21 08:47:35 +00:00
gaithrstress Start the dreaded NOFOO -> NO_FOO conversion. 2004-12-21 08:47:35 +00:00
geom Start the dreaded NOFOO -> NO_FOO conversion. 2004-12-21 08:47:35 +00:00
geom_concat Switch over to a different, more flexible test output protocol that's 2004-11-11 19:47:55 +00:00
geom_gate Switch over to a different, more flexible test output protocol that's 2004-11-11 19:47:55 +00:00
geom_mirror Wait a bit after creating device. 2004-12-21 19:03:10 +00:00
geom_nop Add regression tests for geom_stripe and geom_nop. 2004-05-22 10:58:53 +00:00
geom_raid3 Fix incorrect comment. 2005-01-11 14:11:14 +00:00
geom_shsec Introduce a new GEOM class - SHSEC. It provides sharing secret between 2005-01-11 18:06:44 +00:00
geom_stripe Change naming scheme from /dev/<name>.stripe to /dev/stripe/<name>. 2004-07-26 16:10:27 +00:00
geom_uzip Regen. 2004-08-13 09:56:22 +00:00
ia64/unaligned Wrap calls to memcpy(3) in a function called block_copy(). This way, 2005-01-28 02:58:32 +00:00
include/tgmath Start the dreaded NOFOO -> NO_FOO conversion. 2004-12-21 08:47:35 +00:00
lib - Replace fe[gs]etmask() with feenableexcept(), fedisableexcept(), and 2005-03-16 19:04:45 +00:00
mlock Add a simple regression test for mlock()/munlock() to make sure they 2005-01-03 19:56:20 +00:00
net80211 Loadable modules that run test vectors for net80211 crypto plugins. 2004-12-08 17:45:53 +00:00
netatalk/simple_send Start the dreaded NOFOO -> NO_FOO conversion. 2004-12-21 08:47:35 +00:00
netinet Use WARNS?= instead of WARNS= in Makefiles so that global warning 2005-01-22 22:42:39 +00:00
nfsmmap Start the dreaded NOFOO -> NO_FOO conversion. 2004-12-21 08:47:35 +00:00
p1003_1b Start the dreaded NOFOO -> NO_FOO conversion. 2004-12-21 08:47:35 +00:00
pipe Add two more pipe regression tests. Not yet hooked into the test framework. 2005-01-21 06:46:18 +00:00
security Start the dreaded NOFOO -> NO_FOO conversion. 2004-12-21 08:47:35 +00:00
sockets Check the return value of shutdown(). 2005-03-11 13:05:18 +00:00
sysvmsg Start the dreaded NOFOO -> NO_FOO conversion. 2004-12-21 08:47:35 +00:00
sysvsem Start the dreaded NOFOO -> NO_FOO conversion. 2004-12-21 08:47:35 +00:00
sysvshm Start the dreaded NOFOO -> NO_FOO conversion. 2004-12-21 08:47:35 +00:00
tls Start the dreaded NOFOO -> NO_FOO conversion. 2004-12-21 08:47:35 +00:00
usr.bin Add regression tests for pkill/pgrep. 2005-03-20 12:38:08 +00:00
README Replace a mention of the ia64_unaligned directory with one of the 2005-01-02 21:40:36 +00:00
TODO Switch over to a different, more flexible test output protocol that's 2004-11-11 19:47:55 +00:00

$FreeBSD$

This directory is for regression test programs.

A regression test program is one that will exercise a particular bit of the
system to check that we have not reintroduced an old bug.

Tests should be implemented in files with a .t extension.  Each .t file
can contain more than one test, and can be implemented in any scripting
language -- /bin/sh, Perl...

The test protocol is quite simple.  At its most basic, each .t file should, 
when run, print a line in this format:

   1..m

where m is the number of tests that will be run.

Each test should produce a single line of output.  This line should start
with one of

   ok n
   not ok n

to indicate whether or not the test succeeded.  'n' is the test's number.
Anything after this on the line (up to the first '#' if present) is 
considered to be the name of the test.  Naming tests is optional, but 
encouraged.

A test may be written which is conditional, and may need to be skipped.
For example, the netatalk tests require 'options NETATALK' in the kernel.
A test may be skipped by printing '# skip Reason for skipping' after the
test name.  For example,

    ok 1 - netatalk # skip 'options NETATALK' not compiled in

A test may be flagged as 'todo'.  This indicates that you expect the test
to fail (perhaps because the necessary functionality hasn't been written
yet).  'todo' tests are expected to fail, so when they start working the
test framework can alert you to this happy occurence.  Flag these tests 
with a '# TODO' comment after the test name

    not ok 1 - infiniteloop # TODO write test for an infinite loop

This is modelled on the protocol followed by the Test::Harness Perl
module (and therefore much of the automated testing carried out by the 
Perl community).  More documentation can be found at:

    http://search.cpan.org/~petdance/Test-Harness-2.42/lib/Test/Harness.pm

To run the tests and parse their output install the devel/p5-Test-Harness
port.  This includes the prove(1) command which is used to run the tests
and collate the output.

    prove geom_concat		# run all the tests in geom_concat
    prove -r lib		# run all tests in lib/, and subdirectories
    prove -r -v lib		# as above, with verbose output
    prove -r			# run *all* the tests

Tests that are for parts of the base system should go into a directory here
which is the same as their path relative to src/, for example the uuencode(1)
utility resides in src/usr.bin/uuencode so its regression test resides in
src/tools/regression/usr.bin/uuencode.

Please make a subdir per other regression test, and add a brief description to
this file.

geom		Some tests and an out-of-kernel simulator for the GEOM code
ia64		ia64 specific regression tests
nfsmmap		Some tests to exercise some tricky cases in NFS and mmap
p1003_1b	Exercise 1003.1B scheduler
pipe		Pipe code regression test
fsx		General filesystem exerciser
sysvmsg 	SysV IPC Message Queue Regression Utility
sysvsem 	SysV IPC Semaphore Regression Utility
sysvshm 	SysV IPC Shared Memory Regression Utility
gaithrstress	General threaded getaddrinfo(3) exerciser