adt-run -V (return code: 20)
adt-run: WARNING: "adt-run" is deprecated, please use "autopkgtest" (see manpage)
usage: adt-run [options] action [action ...] --- virt-server [options]
adt-run: error: You must specify --- <virt-server>...
adt-run -HELP (return code: 20)
adt-run: WARNING: "adt-run" is deprecated, please use "autopkgtest" (see manpage)
usage: adt-run [options] action [action ...] --- virt-server [options]
Test installed binary packages using the tests in the source package.
Actions specify the source and binary packages to test, or change
what happens with package arguments:
--unbuilt-tree DIR or DIR//
run tests from unbuilt Debian source tree DIR
--built-tree DIR or DIR/
run tests from built Debian source tree DIR
--source DSC or some/pkg.dsc
build DSC and use its tests and/or generated binary
packages
--git-source GITURL [branchname]
check out git URL (optionally a non-default branch),
build it if necessary, and run its tests
--binary DEB or some/pkg.deb
use binary package DEB for subsequent tests
--changes CHANGES or some/pkg.changes
run tests from dsc and binary debs from a .changes
file
--apt-source SRCPKG or somesrc
download with apt-get source in testbed and use its
tests
--click-source CLICKSRC or some/src
click source tree for subsequent --click package
--click CLICKPKG or some/pkg.click
install click package into testbed (path to *.click)
or use an already installed click package
("com.example.myapp") and run its tests (from
manifest's x-source or preceding --click-source)
--override-control CONTROL
run tests from control file/manifest CONTROL instead
in the next package
--testname TESTNAME run only given test name in the next package
-B, --no-built-binaries
do not use any binaries from subsequent --source,
--git-source, or --unbuilt-tree actions
--built-binaries use binaries from subsequent --source, --git-source,
or --unbuilt-tree actions
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 adt-run 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
--setup-commands-boot COMMANDS_OR_PATH
Run these commands after --setup-commands, and also
every time the testbed is rebooted
-U, --apt-upgrade Run apt update/dist-upgrade before the tests
--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 adt-run 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-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-copy T set copy timeout to T seconds (default: 300s)
--timeout-build T set build timeout to T seconds (default: 100000s)
--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 adt-run actions and options from the
virt-server which provides the testbed. See e. g. man autopkgtest-schroot for
details.