autopkgtest -V (return code: 20)
usage: autopkgtest [options] [testbinary ...] testsrc -- virt-server [options]
autopkgtest: error: unrecognized arguments: --version
autopkgtest --help (return code: 20)
usage: autopkgtest [options] [testbinary ...] testsrc -- virt-server [options]
Test installed binary packages using the tests in testsrc.
testsrc can be one of a:
- Debian *.dsc source package
- Debian *.changes file containing a .dsc source package (and possibly binaries to test)
- Debian source package directory
- click source directory (optional if a *.click binary is given whose manifest points to the source)
- apt source package name (through apt-get source)
- Debian source package in git (url#branchname)
You can specify local *.deb packages or a single *.click package to test.
arguments for specifying and modifying the test:
--override-control PATH
run tests from control file/manifest PATH instead of
the source/click package
--test-name TESTNAME run only given test name. This replaces --testname,
which is deprecated.
-B, --no-built-binaries
do not build/use binaries from .dsc, git source, or
unbuilt tree
--installed-click CLICKNAME
Run tests from already installed click package (e. g.
"com.example.myapp"), from specified click source
directory or manifest's x-source.
packages testsrc source package and testbinary packages as
above
logging options:
-o OUTPUT_DIR, --output-dir OUTPUT_DIR
Write test artifacts (stdout/err, log, debs, etc) to
OUTPUT-DIR (must not exist or be empty)
-l LOGFILE, --log-file LOGFILE
Write the log LOGFILE, emptying it beforehand, instead
of using OUTPUT-DIR/log
--summary-file SUMMARY
Write a summary report to SUMMARY, emptying it
beforehand
-q, --quiet Suppress all messages from autopkgtest itself except
for the test results
test bed setup options:
--setup-commands COMMANDS_OR_PATH
Run these commands after opening the testbed (e. g.
"apt-get update" or adding apt sources); can be a
string with the commands, or a file containing the
commands
-U, --apt-upgrade Run apt update/dist-upgrade before the tests
--setup-commands-boot COMMANDS_OR_PATH
Run these commands after --setup-commands, and also
every time the testbed is rebooted
--apt-pocket POCKETNAME[=pkgname,src:srcname,...]
Enable additional apt source for POCKETNAME. If
packages are given, set up apt pinning to use only
those packages from POCKETNAME; src:srcname expands to
all binaries of srcname
--copy HOSTFILE:TESTBEDFILE
Copy file or dir from host into testbed after opening
--env VAR=value Set arbitrary environment variable for builds and test
user/privilege handling options:
-u USER, --user USER run tests as USER (needs root on testbed)
--gain-root GAINROOT Command to gain root during package build, passed to
dpkg-buildpackage -r
debugging options:
-d, --debug Show lots of internal autopkgtest debug messages
-s, --shell-fail Run a shell in the testbed after any failed build or
test
--shell Run a shell in the testbed after every test
timeout options:
--timeout-copy T set copy timeout to T seconds (default: 300s)
--timeout-build T set build timeout to T seconds (default: 100000s)
--timeout-test T set test timeout to T seconds (default: 10000s)
--timeout-install T set install timeout to T seconds (default: 3000s)
--timeout-short T set short timeout to T seconds (default: 100s)
--timeout-factor FACTOR
multiply all default timeouts by FACTOR
locale options:
--set-lang LANGVAL set LANG on testbed to LANGVAL (default: C.UTF-8
other options:
--no-auto-control Disable automatic test generation with autodep8
--build-parallel N Set "parallel=N" DEB_BUILD_OPTION for building
packages (default: number of available processors)
-h, --help show this help message and exit
The -- argument separates the autopkgtest actions and options
from the virt-server which provides the testbed. See e. g. man autopkgtest-schroot
for details.