FreeBSD source tree
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 
Gordon Bergling 34f620f1d0 Fix a few typos in source code comments 5 months ago
..
aio/aiop Do a sweep and remove most WARNS=6 settings 1 year ago
atm Update README to reflect removal of netatm/harp test parts some time ago. 14 years ago
audit/audit_pipe_ioctl NO_MAN= has been deprecated in favor of MAN= for some time, go ahead 8 years ago
bpf Do a sweep and remove most WARNS=6 settings 1 year ago
capsicum/syscalls Don't add -Winline for WARNS=6 10 months ago
ccd/layout write pattern to /dev/ccd3 not /dev/ccd3c 19 years ago
doat Do a sweep and remove most WARNS=6 settings 1 year ago
environ NO_MAN= has been deprecated in favor of MAN= for some time, go ahead 8 years ago
ethernet/ethermulti NO_MAN= has been deprecated in favor of MAN= for some time, go ahead 8 years ago
fsx fsx: fix build with WARNS=6 1 year ago
gaithrstress Fix LDADD/DPADD that should be LIBADD. 6 years ago
geom Update flp test for new diskinfo output 1 year ago
geom_gpt Do a sweep and remove most WARNS=6 settings 1 year ago
include Do a sweep and remove most WARNS=6 settings 1 year ago
ipfw/fwd Add support for IPv6 to ipfw fwd: 11 years ago
ipsec Adding tests for Camellia which will be added to the tree soon. 15 years ago
iscsi Drop "All rights reserved" from all my stuff. This includes 1 year ago
kgssapi Fix LDADD/DPADD that should be LIBADD. 6 years ago
kthread/kld NO_MAN= has been deprecated in favor of MAN= for some time, go ahead 8 years ago
lib/libc/regex Integrate the remaining tools/regression/lib/msun testcases into the 6 years ago
mlock NO_MAN= has been deprecated in favor of MAN= for some time, go ahead 8 years ago
msdosfs Convert files over to UTF-8. 10 years ago
net/if_tap Add regression test for kern/172075. 9 years ago
net80211 Unbreak regression testing tools for net80211 crypto cipher modules 6 years ago
netinet Fix a few typos in source code comments 5 months ago
netinet6 NO_MAN= has been deprecated in favor of MAN= for some time, go ahead 8 years ago
nfsmmap NO_MAN= has been deprecated in favor of MAN= for some time, go ahead 8 years ago
p1003_1b spdx: initial adoption of licensing ID tags. 4 years ago
poll Update tools/regression/poll/sockpoll.c for POLLRDPOLL. 9 months ago
posixsem Make timespecadd(3) and friends public 4 years ago
posixsem2 sem: Don't free nameinfo that is still in list when open() fails. 6 years ago
priv Fix LDADD/DPADD that should be LIBADD. 6 years ago
pthread Fix LDADD/DPADD that should be LIBADD. 6 years ago
redzone9 Add simple tests which verify that redzone(9) works properly. 16 years ago
rpcsec_gss Do a sweep and remove most WARNS=6 settings 1 year ago
security Use nitems(x) instead of sizeof(x)/sizeof(x[0]) 6 years ago
sigqueue NO_MAN= has been deprecated in favor of MAN= for some time, go ahead 8 years ago
sockets Do a sweep and remove most WARNS=6 settings 1 year ago
sysvmsg NO_MAN= has been deprecated in favor of MAN= for some time, go ahead 8 years ago
sysvsem semget(): Check for [EEXIST] error first. 6 years ago
sysvshm Cosmetics: 7 years ago
tls Add missing stdlib.h header 6 years ago
tmpfs NO_MAN= has been deprecated in favor of MAN= for some time, go ahead 8 years ago
ufs/uprintf NO_MAN= has been deprecated in favor of MAN= for some time, go ahead 8 years ago
usb Add regression test for USB enumeration. 10 years ago
usr.bin env: Fix crash when -S string is not empty but no operand follows. 7 years ago
zfs Remove calls to `die` added for associated bugs 6 years ago
README Remove ia64. 8 years ago
TODO Switch over to a different, more flexible test output protocol that's 17 years ago

README

$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 netinet tests require 'options INET' in the kernel.
A test may be skipped by printing '# skip Reason for skipping' after the
test name. For example,

ok 1 - netinet # skip 'options INET' 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 occurrence. 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
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
date Date(1) + format string regression test