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>
85 lines
1.9 KiB
ReStructuredText
85 lines
1.9 KiB
ReStructuredText
.. _QEMU-PC-System-emulator:
|
|
|
|
x86 (PC) System emulator
|
|
------------------------
|
|
|
|
.. _pcsys_005fdevices:
|
|
|
|
Peripherals
|
|
~~~~~~~~~~~
|
|
|
|
The QEMU PC System emulator simulates the following peripherals:
|
|
|
|
- i440FX host PCI bridge and PIIX3 PCI to ISA bridge
|
|
|
|
- Cirrus CLGD 5446 PCI VGA card or dummy VGA card with Bochs VESA
|
|
extensions (hardware level, including all non standard modes).
|
|
|
|
- PS/2 mouse and keyboard
|
|
|
|
- 2 PCI IDE interfaces with hard disk and CD-ROM support
|
|
|
|
- Floppy disk
|
|
|
|
- PCI and ISA network adapters
|
|
|
|
- Serial ports
|
|
|
|
- IPMI BMC, either and internal or external one
|
|
|
|
- Creative SoundBlaster 16 sound card
|
|
|
|
- ENSONIQ AudioPCI ES1370 sound card
|
|
|
|
- Intel 82801AA AC97 Audio compatible sound card
|
|
|
|
- Intel HD Audio Controller and HDA codec
|
|
|
|
- Adlib (OPL2) - Yamaha YM3812 compatible chip
|
|
|
|
- Gravis Ultrasound GF1 sound card
|
|
|
|
- CS4231A compatible sound card
|
|
|
|
- PCI UHCI, OHCI, EHCI or XHCI USB controller and a virtual USB-1.1
|
|
hub.
|
|
|
|
SMP is supported with up to 255 CPUs.
|
|
|
|
QEMU uses the PC BIOS from the Seabios project and the Plex86/Bochs LGPL
|
|
VGA BIOS.
|
|
|
|
QEMU uses YM3812 emulation by Tatsuyuki Satoh.
|
|
|
|
QEMU uses GUS emulation (GUSEMU32 http://www.deinmeister.de/gusemu/) by
|
|
Tibor \"TS\" Schütz.
|
|
|
|
Note that, by default, GUS shares IRQ(7) with parallel ports and so QEMU
|
|
must be told to not have parallel ports to have working GUS.
|
|
|
|
.. parsed-literal::
|
|
|
|
|qemu_system_x86| dos.img -soundhw gus -parallel none
|
|
|
|
Alternatively:
|
|
|
|
.. parsed-literal::
|
|
|
|
|qemu_system_x86| dos.img -device gus,irq=5
|
|
|
|
Or some other unclaimed IRQ.
|
|
|
|
CS4231A is the chip used in Windows Sound System and GUSMAX products
|
|
|
|
.. include:: cpu-models-x86.rst.inc
|
|
|
|
.. _pcsys_005freq:
|
|
|
|
OS requirements
|
|
~~~~~~~~~~~~~~~
|
|
|
|
On x86_64 hosts, the default set of CPU features enabled by the KVM
|
|
accelerator require the host to be running Linux v4.5 or newer. Red Hat
|
|
Enterprise Linux 7 is also supported, since the required
|
|
functionality was backported.
|