External/libvirt
1
0
Fork 0
mirror of https://gitlab.com/libvirt/libvirt.git synced 2025-01-18 10:35:20 +00:00
Code Issues Packages Projects Releases Wiki Activity

docs: Convert 'testtck' page to rST

Browse Source 
Signed-off-by: Peter Krempa <pkrempa@redhat.com>
Reviewed-by: Ján Tomko <jtomko@redhat.com>
This commit is contained in:
Peter Krempa 2022-03-10 16:34:51 +01:00
parent 1824ed94f7
commit 0b2dec6af9
3 changed files with 38 additions and 41 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
docs/meson.build
View File

@ -56,7 +56,6 @@ docs_html_in_files = [
'remote',
'storage',
'testsuites',
'testtck',
'tlscerts',
'uri',
'windows',
@ -112,6 +111,7 @@ docs_rst_files = [
'submitting-patches',
'support',
'testapi',
'testtck',
]
# list of web targets to build for docs/web rule

40
docs/testtck.html.in
View File

@ -1,40 +0,0 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml">
<body>
<h1>libvirt TCK : Technology Compatibility Kit</h1>
<p>The libvirt TCK provides a framework for performing testing
of the integration between libvirt drivers, the underlying virt
hypervisor technology, related operating system services and system
configuration. The idea (and name) is motivated by the Java TCK.</p>
<p>In particular the libvirt TCK is intended to address the following
scenarios:</p>
<ul>
<li>Validate that a new libvirt driver is in compliance
with the (possibly undocumented!) driver API semantics</li>
<li>Validate that an update to an existing driver does not
change the API semantics in a non-compliant manner</li>
<li>Validate that a new hypervisor release is still providing
compatibility with the corresponding libvirt driver usage</li>
<li>Validate that an OS distro deployment consisting of a
hypervisor and libvirt release is configured correctly</li>
</ul>
<p>Thus the libvirt TCK will allow developers, administrators and users
to determine the level of compatibility of their platform, and
evaluate whether it will meet their needs, and get awareness of any
regressions that may have occurred since a previous test run.</p>
<p>For more details you can look at:</p>
<ul>
<li> The initial
<a href="https://www.redhat.com/archives/libvir-list/2009-April/msg00176.html">mail
from Daniel Berrange</a> presenting the project.</li>
<li> The <a href="https://fedoraproject.org/wiki/Features/VirtTCK">page
describing VirtTCK</a> the inclusion of libvirt-TCK as a
Fedora Feature.</li>
</ul>
<p> Libvirt-TCK is maintained using
<a href="https://gitlab.com/libvirt/libvirt-tck">a GIT
repository</a>, and comment, patches and reviews are carried
on the <a href="contact.html">libvir-list</a> development list.</p>
</body>
</html>

37
docs/testtck.rst Normal file
View File

@ -0,0 +1,37 @@
==========================================
libvirt TCK : Technology Compatibility Kit
==========================================
The libvirt TCK provides a framework for performing testing of the integration
between libvirt drivers, the underlying virt hypervisor technology, related
operating system services and system configuration. The idea (and name) is
motivated by the Java TCK.
In particular the libvirt TCK is intended to address the following scenarios:
- Validate that a new libvirt driver is in compliance with the (possibly
undocumented!) driver API semantics
- Validate that an update to an existing driver does not change the API
semantics in a non-compliant manner
- Validate that a new hypervisor release is still providing compatibility with
the corresponding libvirt driver usage
- Validate that an OS distro deployment consisting of a hypervisor and libvirt
release is configured correctly
Thus the libvirt TCK will allow developers, administrators and users to
determine the level of compatibility of their platform, and evaluate whether it
will meet their needs, and get awareness of any regressions that may have
occurred since a previous test run.
For more details you can look at:
- The initial `mail from Daniel
Berrange <https://www.redhat.com/archives/libvir-list/2009-April/msg00176.html>`__
presenting the project.
- The `page describing
VirtTCK <https://fedoraproject.org/wiki/Features/VirtTCK>`__ the inclusion of
libvirt-TCK as a Fedora Feature.
Libvirt-TCK is maintained using `a GIT
repository <https://gitlab.com/libvirt/libvirt-tck>`__, and comment, patches and
reviews are carried on the `libvir-list <contact.html>`__ development list.