adt-run - test an installed binary package using the package's tests

adt-run options... --- virt-server [virt-server-arg...]

adt-run is the program for invoking the autopkgtest package testing machinery.

autopkgtest is a facility for testing binary packages, as installed on a system (such as a testbed system). The tests are those supplied in the source package.

adt-run runs each test supplied by a particular package and reports the results. It drives the specified virtualisation regime as appropriate, and parses the test description metadata, and arranges for data to be copied to and from the testbed as required.

adt-run should be invoked (unless options to the contrary are supplied) in the top level directory of the built source tree, on the host. The package should be installed on the testbed.

--build-tree[-tb] directory

Specifies that the built source tree can be found in directory. (Default: adt-run's current directory, on the host.)

--control[-tb] control

Specifies that control should be used as the test control file instead of debian/tests/control in the build tree. Note that it is not an error for this file not to exist; that just means that there are no tests.

--output-dir[-tb] output-dir

Specifies that stderr and stdout from the tests should be placed in output-dir. The files are named stderr-test and stdout-test for each test test.

-d | --debug

Enables debugging output. Probably not hugely interesting.

--- virt-server virt-server-arg...

Specifies the virtualisation regime server, as a command and arguments to invoke. All the remaining arguments and options after --- are passed to the virtualisation server program.

NOTES

During a normal test run, one line is printed for each test. This consists of the name of the test, some horizontal whitespace, and either PASS or FAIL reason or SKIP reason where the pass/fail indication is separated by any reason by some horizontal whitespace.

Sometimes a SKIP will be reported when the name of the test is not known or not applicable: for example, when there are no tests in the package, or a there is a test stanza which contains features not understood by this version of adt-run. In this case * will appear where the name of the test should be.

0 all tests passed

2 at least one test skipped

4 at least one test failed

6 at least one test failed and at least one test skipped

8 no tests in this package

12 erroneous package

16 testbed failure

20 other unexpected failures including bad usage

adt-virt-chroot(1)

This tool still lacks many important features.

This manpage is part of autopkgtest, a tool for testing Debian binary packages. autopkgtest is Copyright (C) 2006 Canonical Ltd and others.

See /usr/share/doc/autopkgtest/CREDITS for the list of contributors and full copying conditions.