1
0
mirror of https://git.FreeBSD.org/src.git synced 2024-12-22 11:17:19 +00:00
freebsd/tools/regression
Dag-Erling Smørgrav 75bd5e763f #ifdef out the lock-against-self test. I'm not sure it makes sense, and
it relies on non-portable flock(2) semantics.  Not only is flock(2) not
portable, but on some OSes that do have it, it is implemented in terms
of fcntl(2) locks, which are per-process rather than per-descriptor.
2008-10-20 17:26:30 +00:00
..
acct
aio Add the ability to do all read, all write, or random read/write. 2008-05-15 16:10:55 +00:00
atm Update README to reflect removal of netatm/harp test parts some time ago. 2008-08-31 11:41:31 +00:00
audit/audit_pipe_ioctl
bin Add a test for r182300. 2008-08-27 20:26:34 +00:00
bpf Connect a forgotten test case to Makefile. 2008-08-29 20:58:01 +00:00
ccd/layout
doat Simple testing program for *at family of syscalls. 2008-05-18 08:34:04 +00:00
environ Detect if the application has cleared the environ variable by setting 2008-08-02 02:34:35 +00:00
ethernet/ethermulti
execve
fifo Teach fifo_create regression test to also try to use mknod(2) to create 2008-06-22 21:03:26 +00:00
file Re-implement the client side of rpc.lockd in the kernel. This implementation 2008-06-26 10:21:54 +00:00
fstest
fsx getopt(3) returns -1, not EOF. 2008-02-19 07:09:19 +00:00
gaithrstress
geom Add sbuf_new_auto as a shortcut for the very common case of creating a 2008-08-09 11:14:05 +00:00
geom_concat
geom_eli By default backup geli metadata to a file. It is quite critical 512 bytes, 2008-08-29 18:10:18 +00:00
geom_gate
geom_gpt
geom_mirror
geom_nop
geom_raid3
geom_shsec
geom_stripe
geom_uzip
ia64
include/tgmath
ipsec
lib #ifdef out the lock-against-self test. I'm not sure it makes sense, and 2008-10-20 17:26:30 +00:00
mac/mac_bsdextended
mlock
mqueue
msdosfs
net80211
netatalk/simple_send
netinet Update udpzerobyte to understand that passing 0 as a length to recv(2) 2008-10-07 21:01:23 +00:00
netinet6 Remove extra comment that snuck in in last commit. 2008-07-29 18:38:37 +00:00
netipx
nfsmmap
p1003_1b
pipe
posixsem Rework the lifetime management of the kernel implementation of POSIX 2008-06-27 05:39:04 +00:00
posixshm Fix compile on 64-bit platforms. 2008-06-26 21:26:34 +00:00
priv
pthread mutex_islocked_np -> mutex_isowned_np 2008-02-06 19:41:05 +00:00
redzone9
security Add open_to_operation, a security regression test that opens files with 2008-02-14 20:57:38 +00:00
sigqueue
sockets Add very simple regression test for fstat(2) on sockets: make sure it 2008-10-06 19:42:03 +00:00
sysvmsg
sysvsem
sysvshm
tls
tmpfs
ufs/uprintf
usr.bin
usr.sbin
geom_subr.sh
README
TODO

$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.

To avoid the pre-commit check program complaining about the lack of
CVS keywords in test data files, use a .in suffix for input files and
a .out suffix for output files.

To execute individual regression tests for binaries that you are
developing, add their directory in the path before running the tests.
Example:
cd /usr/src/tools/regression/usr.bin
(PATH=/home/user/src/experimental/jot:$PATH ; make SUBDIR=jot)

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

acct		Exercise the integer to float conversion used in acct(5)
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