libvirt/docs/platforms.rst
Andrea Bolognani 78cffd450a docs: Spell out our policy concerning minor releases
We've already applied this policy on multiple occasions, but it's
good to have it written down so that there can be no confusion.

Signed-off-by: Andrea Bolognani <abologna@redhat.com>
Reviewed-by: Erik Skultety <eskultet@redhat.com>
2021-03-04 18:28:44 +01:00

3.4 KiB

Supported host platforms

Libvirt aims to support building and executing on multiple host OS platforms, as well as working with multiple hypervisors. This document outlines which platforms are targeted for each of these areas.

Build targets

These platforms are used as the basis for deciding upon the minimum required versions of 3rd party software libvirt depends on. If a platform is not listed here, it does not imply that libvirt won't work. If an unlisted platform has comparable software versions to a listed platform, there is every expectation that it will work. Bug reports are welcome for problems encountered on unlisted platforms unless they are clearly older vintage than what is described here.

Note that when considering software versions shipped in distros as support targets, libvirt considers only the version number, and assumes the features in that distro match the upstream release with the same version. In other words, if a distro backports extra features to the software in their distro, libvirt upstream code will not add explicit support for those backports, unless the feature is auto-detectable in a manner that works for the upstream releases too.

The Repology site is a useful resource to identify currently shipped versions of software in various operating systems, though it does not cover all distros listed below.

Linux, FreeBSD and macOS

The project aims to support the most recent major version at all times. Support for the previous major version will be dropped 2 years after the new major version is released or when the vendor itself drops support, whichever comes first. In this context, third-party efforts to extend the lifetime of a distro are not considered, even when they are endorsed by the vendor (eg. Debian LTS). Within each major release, only the most recent minor release is considered.

For the purposes of identifying supported software versions available on Linux, the project will look at CentOS, Debian, Fedora, openSUSE, RHEL, SLES and Ubuntu LTS. Other distros will be assumed to ship similar software versions.

For FreeBSD, decisions will be made based on the contents of the ports tree; for macOS, HomeBrew will be used, although MacPorts is expected to carry similar versions.

Windows

The project supports building with current versions of the MinGW toolchain, hosted on Linux.

The version of the Windows API that's currently targeted is Vista / Server 2008.

Virtualization platforms

For hypervisor drivers which execute locally (QEMU, LXC, VZ, libxl, etc), the set of supported operating system platforms listed above will inform choices as to the minimum required versions of 3rd party libraries and hypervisor management APIs.

If a hypervisor is not commonly shipped directly by any distro listed above, (VMware ESX, HyperV, VZ), the project aims to support versions up to 5 years, or until the vendor discontinues support, whichever comes first.