1*f3478392SPeter Maydell.. _Supported-build-platforms: 2*f3478392SPeter Maydell 3*f3478392SPeter MaydellSupported build platforms 4*f3478392SPeter Maydell========================= 5*f3478392SPeter Maydell 6*f3478392SPeter MaydellQEMU aims to support building and executing on multiple host OS 7*f3478392SPeter Maydellplatforms. This appendix outlines which platforms are the major build 8*f3478392SPeter Maydelltargets. These platforms are used as the basis for deciding upon the 9*f3478392SPeter Maydellminimum required versions of 3rd party software QEMU depends on. The 10*f3478392SPeter Maydellsupported platforms are the targets for automated testing performed by 11*f3478392SPeter Maydellthe project when patches are submitted for review, and tested before and 12*f3478392SPeter Maydellafter merge. 13*f3478392SPeter Maydell 14*f3478392SPeter MaydellIf a platform is not listed here, it does not imply that QEMU won't 15*f3478392SPeter Maydellwork. If an unlisted platform has comparable software versions to a 16*f3478392SPeter Maydelllisted platform, there is every expectation that it will work. Bug 17*f3478392SPeter Maydellreports are welcome for problems encountered on unlisted platforms 18*f3478392SPeter Maydellunless they are clearly older vintage than what is described here. 19*f3478392SPeter Maydell 20*f3478392SPeter MaydellNote that when considering software versions shipped in distros as 21*f3478392SPeter Maydellsupport targets, QEMU considers only the version number, and assumes the 22*f3478392SPeter Maydellfeatures in that distro match the upstream release with the same 23*f3478392SPeter Maydellversion. In other words, if a distro backports extra features to the 24*f3478392SPeter Maydellsoftware in their distro, QEMU upstream code will not add explicit 25*f3478392SPeter Maydellsupport for those backports, unless the feature is auto-detectable in a 26*f3478392SPeter Maydellmanner that works for the upstream releases too. 27*f3478392SPeter Maydell 28*f3478392SPeter MaydellThe `Repology`_ site is a useful resource to identify 29*f3478392SPeter Maydellcurrently shipped versions of software in various operating systems, 30*f3478392SPeter Maydellthough it does not cover all distros listed below. 31*f3478392SPeter Maydell 32*f3478392SPeter MaydellLinux OS, macOS, FreeBSD, NetBSD, OpenBSD 33*f3478392SPeter Maydell----------------------------------------- 34*f3478392SPeter Maydell 35*f3478392SPeter MaydellThe project aims to support the most recent major version at all times. Support 36*f3478392SPeter Maydellfor the previous major version will be dropped 2 years after the new major 37*f3478392SPeter Maydellversion is released or when the vendor itself drops support, whichever comes 38*f3478392SPeter Maydellfirst. In this context, third-party efforts to extend the lifetime of a distro 39*f3478392SPeter Maydellare not considered, even when they are endorsed by the vendor (eg. Debian LTS). 40*f3478392SPeter Maydell 41*f3478392SPeter MaydellFor the purposes of identifying supported software versions available on Linux, 42*f3478392SPeter Maydellthe project will look at CentOS, Debian, Fedora, openSUSE, RHEL, SLES and 43*f3478392SPeter MaydellUbuntu LTS. Other distros will be assumed to ship similar software versions. 44*f3478392SPeter Maydell 45*f3478392SPeter MaydellFor FreeBSD and OpenBSD, decisions will be made based on the contents of the 46*f3478392SPeter Maydellrespective ports repository, while NetBSD will use the pkgsrc repository. 47*f3478392SPeter Maydell 48*f3478392SPeter MaydellFor macOS, `HomeBrew`_ will be used, although `MacPorts`_ is expected to carry 49*f3478392SPeter Maydellsimilar versions. 50*f3478392SPeter Maydell 51*f3478392SPeter MaydellWindows 52*f3478392SPeter Maydell------- 53*f3478392SPeter Maydell 54*f3478392SPeter MaydellThe project supports building with current versions of the MinGW toolchain, 55*f3478392SPeter Maydellhosted on Linux (Debian/Fedora). 56*f3478392SPeter Maydell 57*f3478392SPeter MaydellThe version of the Windows API that's currently targeted is Vista / Server 58*f3478392SPeter Maydell2008. 59*f3478392SPeter Maydell 60*f3478392SPeter Maydell.. _HomeBrew: https://brew.sh/ 61*f3478392SPeter Maydell.. _MacPorts: https://www.macports.org/ 62*f3478392SPeter Maydell.. _Repology: https://repology.org/ 63