man libvirt-tck (1): libvirt Technology Compatability Kit

SYNOPSIS

# libvirt-tck [OPTIONS]

Run with default config, probing for URI to use

 # libvirt-tck

Run with a custom config

 # libvirt-tck --config /etc/libvirt/other.cfg

Run with verbose progress information

 # libvirt-tck -v

Generate a formal XML document of results

 # libvirt-tck --format xml

Generate a JUnit XML document of results

 # libvirt-tck --format junit

DESCRIPTION

The "libvirt-tck" (libvirt Technology Compatability Kit) command provides the primary mechanism to run the functional, integration test suite for libvirt drivers.

WARNING

There now follows a few words of warning

The test suite needs to have a completely 'clean' initial starting state. If your host already has virtual machines defined and/or running this will cause problems. The test suite will detect this and refuse to run, allowing you to remove any preexisting guests. Alternatively you can pass the --force option and libvirt will DELETE EVERYTHING it finds.

To repeat: ALL YOUR EXISTING DOMAINS, NETWORKS, STORAGE POOLS WILL BE DELETED IF YOU USE THE --force OPTION.

The warning is now complete, continue reading

OPTIONS

If invoked without any arguments the test suite will run using the default configuration file from "/etc/libvirt-tck/default.cfg" and will allow libvirt to probe for the hypervisor driver to run. If a reliably repeatable test result set is desired, it is recommended to always give an explicit libvirt connection URI to choose the driver. The following options are available when running the "libvirt-tck" command

-v, --verbose: Display fine details of individual test progresss. Without this only the name of each test will be printed, along with details of failures.
-q, --quiet: Do not display any information about test progress, not even the name of each test case
-c, --config FILE: Specify the name of the configuration file to use, rather than the default "/etc/libvirt-tck/default.cfg"
--format text|html|xml|junit: Choose the output format for the test results. The default format is "text", producing human readable results on the console. The "html" option dumps an HTML file of results to STDOUT, while the "xml" option generates a formal XML document of results.
--force: Forcably remove all running guest domains and all persistent guest domain configuration files before running any tests. The test suite requires a pristine install, so all existing managed objects must be removed before running. This switch will instruct libvirt-tck to automatically remove all guest domains. YOU WILL NOT GET YOUR EXISTING GUEST DOMAINS BACK IF THIS HAPPENS. THEY WILL BE GONE FOREVER. USE AT YOUR OWN RISK.
-t, --testdir PATH: Specify an alternate directory path in which to find the test scripts to be run. If omitted, defaults to "/usr/share/libvirt-tck/tests"
-a, --archive FILE: Generate an archive containing all the raw test results. The filename given should end in either ".bz", ".tar.gz" or ".tgz"
--timer: Print elapsed time after each test.

AUTHORS

Written by Daniel P. Berrange <[email protected]>

BUGS

Probably. Report any bugs found to your OS distribution's bug tracker or the libvirt mailing list http://www.redhat.com/mailman/listinfo/libvir-list <http://www.redhat.com/mailman/listinfo/libvir-list>

LICENSE

"libvirt-tck" is distributed under the terms of the GNU GPL v2+. This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.