324b2298fe
Apart from targets.rst, which was written by hand, this is an automated
conversion obtained with the following command:
makeinfo --force -o - --docbook \
-D 'qemu_system_x86 QEMU_SYSTEM_X86_MACRO' \
-D 'qemu_system QEMU_SYSTEM_MACRO' \
$texi | pandoc -f docbook -t rst+smart | perl -e '
$/=undef;
$_ = <>;
s/^- − /- /gm;
s/QEMU_SYSTEM_MACRO/|qemu_system|/g;
s/QEMU_SYSTEM_X86_MACRO/|qemu_system_x86|/g;
s/(?=::\n\n +\|qemu)/.. parsed-literal/g;
s/:\n\n::$/::/gm;
print' > $rst
In addition, the following changes were made manually:
- target-i386.rst and target-mips.rst: replace CPU model documentation with
an include directive
- monitor.rst: replace the command section with a comment
- images.rst: add toctree
- target-arm.rst: Replace use of :math: (which Sphinx complains
about) with :sup:, and hide it behind |I2C| and |I2C| substitutions.
Content that is not @included remains exclusive to qemu-doc.texi.
Signed-off-by: Paolo Bonzini <pbonzini@redhat.com>
Reviewed-by: Peter Maydell <peter.maydell@linaro.org>
Reviewed-by: Alex Bennée <alex.bennee@linaro.org>
Tested-by: Alex Bennée <alex.bennee@linaro.org>
Signed-off-by: Peter Maydell <peter.maydell@linaro.org>
Message-id: 20200228153619.9906-20-peter.maydell@linaro.org
Message-id: 20200226113034.6741-19-pbonzini@redhat.com
[PMM: Fixed target-arm.rst use of :math:; remove out of date
note about images.rst from commit message; fixed expansion
of |qemu_system_x86|; use parsed-literal in invocation.rst
when we want to use |qemu_system_x86|; fix incorrect subsection
level for "OS requirements" in target-i386.rst; fix incorrect
syntax for making links to other sections of the manual]
Reviewed-by: Peter Maydell <peter.maydell@linaro.org>
Signed-off-by: Peter Maydell <peter.maydell@linaro.org>
80 lines
2.9 KiB
ReStructuredText
80 lines
2.9 KiB
ReStructuredText
.. _Supported-build-platforms:
|
|
|
|
Supported build platforms
|
|
=========================
|
|
|
|
QEMU aims to support building and executing on multiple host OS
|
|
platforms. This appendix outlines which platforms are the major build
|
|
targets. These platforms are used as the basis for deciding upon the
|
|
minimum required versions of 3rd party software QEMU depends on. The
|
|
supported platforms are the targets for automated testing performed by
|
|
the project when patches are submitted for review, and tested before and
|
|
after merge.
|
|
|
|
If a platform is not listed here, it does not imply that QEMU 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, QEMU 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, QEMU 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 https://repology.org 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 OS
|
|
--------
|
|
|
|
For distributions with frequent, short-lifetime releases, the project
|
|
will aim to support all versions that are not end of life by their
|
|
respective vendors. For the purposes of identifying supported software
|
|
versions, the project will look at Fedora, Ubuntu, and openSUSE distros.
|
|
Other short- lifetime distros will be assumed to ship similar software
|
|
versions.
|
|
|
|
For distributions with long-lifetime releases, the project will aim 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 it reaches "end of life". For the purposes
|
|
of identifying supported software versions, the project will look at
|
|
RHEL, Debian, Ubuntu LTS, and SLES distros. Other long-lifetime distros
|
|
will be assumed to ship similar software versions.
|
|
|
|
Windows
|
|
-------
|
|
|
|
The project supports building with current versions of the MinGW
|
|
toolchain, hosted on Linux.
|
|
|
|
macOS
|
|
-----
|
|
|
|
The project supports building with the two most recent versions of
|
|
macOS, with the current homebrew package set available.
|
|
|
|
FreeBSD
|
|
-------
|
|
|
|
The project aims to support the all the versions which are not end of
|
|
life.
|
|
|
|
NetBSD
|
|
------
|
|
|
|
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.
|
|
|
|
OpenBSD
|
|
-------
|
|
|
|
The project aims to support the all the versions which are not end of
|
|
life.
|