tests(7) manual page

Some test cases in the FreeBSD Test Suite require manual configuration by the administrator before they can be run. Unless certain properties are defined, the tests that require them will be skipped.

Test suites are configured by defining their configuration variables in /usr/local/etc/kyua/kyua.conf. The format of this file is detailed in kyua.conf(5).

The following configuration variables are available in the FreeBSD Test Suite:

allow_devfs_side_effects If defined, enables tests that may destroy and recreate semipermanent device nodes, like disk devices. Without this variable, tests may still create and destroy devices nodes that are normally transient, like /dev/tap* and /dev/pts*, as long as they clean them up afterwards. However, tests that require this variable have a relaxed cleanup requirement; they must recreate any devices that they destroyed, but not necessarily with the same devnames.

allow_sysctl_side_effects

Enables tests that change globally significant sysctl(8) variables. The tests will undo any changes in their cleanup phases.

disks Must be set to a space delimited list of disk device nodes. Tests that need destructive access to disks must use these devices. Tests are not required to preserve any data present on these disks.

fibs Must be set to a space delimited list of FIBs (routing tables). Tests that need to modify a routing table may use any of these. Tests will cleanup any new routes that they create.

`/usr/local/etc/kyua/kyua.conf`	System-wide configuration file for kyua(1).
`~/.kyua/kyua.conf`	User-specific configuration file for kyua(1); overrides the system file.
`~/.kyua/store.db`	Default result database used by Kyua.
`/usr/tests/`	Location of the FreeBSD Test Suite.
`/usr/tests/Kyuafile`	Top-level test suite definition file.

Manual Pages — TESTS

NAME

CONTENTS

DESCRIPTION

Installing the test suite

When to run the tests?

Running the tests

Obtaining reports of the tests execution

Configuring the tests

What to do if something fails?

FILES

SEE ALSO

HISTORY

AUTHORS

allow_devfs_side_effects	If defined, enables tests that may destroy and recreate semipermanent device nodes, like disk devices. Without this variable, tests may still create and destroy devices nodes that are normally transient, like /dev/tap* and /dev/pts*, as long as they clean them up afterwards. However, tests that require this variable have a relaxed cleanup requirement; they must recreate any devices that they destroyed, but not necessarily with the same devnames.
allow_sysctl_side_effects
	Enables tests that change globally significant sysctl(8) variables. The tests will undo any changes in their cleanup phases.
disks	Must be set to a space delimited list of disk device nodes. Tests that need destructive access to disks must use these devices. Tests are not required to preserve any data present on these disks.
fibs	Must be set to a space delimited list of FIBs (routing tables). Tests that need to modify a routing table may use any of these. Tests will cleanup any new routes that they create.