opnsense-src/tools/regression/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 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.

Base system regression tests should prefix their test results with 'PASS' or
'FAIL' accordingly, to make checking for failed tests easier.  For now the
tests are very free-form, and it's up to you to do that.  Eventually, it
should be a part of the regression test framework.

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_unaligned	Tests unaligned reads on the IA64
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
These are regression tests for the P1003.1B scheduler. Approved by: jkh 2000-02-16 09:28:42 -05:00			$FreeBSD$

README reads: This directory is for regression test programs. A regression test program is one that will excercise a particular bit of the system to check that we have not reintroduced an old bug. Please make a subdir per program, and add a brief description to this file. 1995-10-15 07:27:40 -04:00			`This directory is for regression test programs.`

Fix a couple of typos. 1997-03-06 20:48:24 -05:00			`A regression test program is one that will exercise a particular bit of the`
README reads: This directory is for regression test programs. A regression test program is one that will excercise a particular bit of the system to check that we have not reintroduced an old bug. Please make a subdir per program, and add a brief description to this file. 1995-10-15 07:27:40 -04:00			`system to check that we have not reintroduced an old bug.`

Start adding framework for userland regression tests, and tests for uuencode and uudecode. 2002-04-20 13:20:21 -04:00			`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.`

Prefix tests with PASS and FAIL, to make grepping easier, and note this in the README. This affects only the base-system regression tests, of course. 2002-04-26 22:26:23 -04:00			`Base system regression tests should prefix their test results with 'PASS' or`
			`'FAIL' accordingly, to make checking for failed tests easier. For now the`
			`tests are very free-form, and it's up to you to do that. Eventually, it`
			`should be a part of the regression test framework.`

Start adding framework for userland regression tests, and tests for uuencode and uudecode. 2002-04-20 13:20:21 -04:00			`Please make a subdir per other regression test, and add a brief description to`
			`this file.`
Add a couple of test cases for mmap over NFS. 1997-05-18 06:03:48 -04:00
Describe ia64_unaligned and geom directories. I hope I got these right. 2002-06-07 01:41:15 -04:00			`geom Some tests and an out-of-kernel simulator for the GEOM code`
			`ia64_unaligned Tests unaligned reads on the IA64`
Add a couple of test cases for mmap over NFS. 1997-05-18 06:03:48 -04:00			`nfsmmap Some tests to exercise some tricky cases in NFS and mmap`
These are regression tests for the P1003.1B scheduler. Approved by: jkh 2000-02-16 09:28:42 -05:00			`p1003_1b Exercise 1003.1B scheduler`
Add a regression test for the big pipe bug. Suggested by: silby 2003-07-31 08:40:56 -04:00			`pipe Pipe code regression test`
Add Apple's filesystem exercising tool. Submitted by: Conrad Minshall <conrad@apple.com> Obtained from: Apple Computer 2001-12-19 23:15:57 -05:00			`fsx General filesystem exerciser`
Add regression tests for sysvipc. Submitted by: Hiten Pandya <hiten@uk.FreeBSD.org> Obtained from: NetBSD 2002-08-15 02:34:37 -04:00			`sysvmsg SysV IPC Message Queue Regression Utility`
			`sysvsem SysV IPC Semaphore Regression Utility`
			`sysvshm SysV IPC Shared Memory Regression Utility`
Add my getaddrinfo(3) stress-tester as gaithrstress. The most obvious regressions would be to see the program or your kernel crashing. If you want to give it something to really test out, try a much more reentrant version of the resolver. <URL:http://green.homeunix.org/~green/reentrant_resolver.patch> Any Mozilla-based browser would show you a clear difference. 2004-02-20 11:54:01 -05:00			`gaithrstress General threaded getaddrinfo(3) exerciser`