build-platforms.rst (3618B)
1.. _Supported-build-platforms: 2 3Supported build platforms 4========================= 5 6QEMU aims to support building and executing on multiple host OS 7platforms. This appendix outlines which platforms are the major build 8targets. These platforms are used as the basis for deciding upon the 9minimum required versions of 3rd party software QEMU depends on. The 10supported platforms are the targets for automated testing performed by 11the project when patches are submitted for review, and tested before and 12after merge. 13 14If a platform is not listed here, it does not imply that QEMU won't 15work. If an unlisted platform has comparable software versions to a 16listed platform, there is every expectation that it will work. Bug 17reports are welcome for problems encountered on unlisted platforms 18unless they are clearly older vintage than what is described here. 19 20Note that when considering software versions shipped in distros as 21support targets, QEMU considers only the version number, and assumes the 22features in that distro match the upstream release with the same 23version. In other words, if a distro backports extra features to the 24software in their distro, QEMU upstream code will not add explicit 25support for those backports, unless the feature is auto-detectable in a 26manner that works for the upstream releases too. 27 28The `Repology`_ site is a useful resource to identify 29currently shipped versions of software in various operating systems, 30though it does not cover all distros listed below. 31 32Supported host architectures 33---------------------------- 34 35Those hosts are officially supported, with various accelerators: 36 37 .. list-table:: 38 :header-rows: 1 39 40 * - CPU Architecture 41 - Accelerators 42 * - Arm 43 - kvm (64 bit only), tcg, xen 44 * - MIPS 45 - kvm, tcg 46 * - PPC 47 - kvm, tcg 48 * - RISC-V 49 - tcg 50 * - s390x 51 - kvm, tcg 52 * - SPARC 53 - tcg 54 * - x86 55 - hax, hvf (64 bit only), kvm, nvmm, tcg, whpx (64 bit only), xen 56 57Other host architectures are not supported. It is possible to build QEMU on an 58unsupported host architecture using the configure ``--enable-tcg-interpreter`` 59option to enable the experimental TCI support, but note that this is very slow 60and is not recommended. 61 62Non-supported architectures may be removed in the future following the 63:ref:`deprecation process<Deprecated features>`. 64 65Linux OS, macOS, FreeBSD, NetBSD, OpenBSD 66----------------------------------------- 67 68The project aims to support the most recent major version at all times. Support 69for the previous major version will be dropped 2 years after the new major 70version is released or when the vendor itself drops support, whichever comes 71first. In this context, third-party efforts to extend the lifetime of a distro 72are not considered, even when they are endorsed by the vendor (eg. Debian LTS). 73 74For the purposes of identifying supported software versions available on Linux, 75the project will look at CentOS, Debian, Fedora, openSUSE, RHEL, SLES and 76Ubuntu LTS. Other distros will be assumed to ship similar software versions. 77 78For FreeBSD and OpenBSD, decisions will be made based on the contents of the 79respective ports repository, while NetBSD will use the pkgsrc repository. 80 81For macOS, `HomeBrew`_ will be used, although `MacPorts`_ is expected to carry 82similar versions. 83 84Windows 85------- 86 87The project supports building with current versions of the MinGW toolchain, 88hosted on Linux (Debian/Fedora). 89 90The version of the Windows API that's currently targeted is Vista / Server 912008. 92 93.. _HomeBrew: https://brew.sh/ 94.. _MacPorts: https://www.macports.org/ 95.. _Repology: https://repology.org/