docs/system: convert Texinfo documentation to rST
[qemu/kevin.git] / docs / system / target-i386.rst
blob92e2038b11e1c956e4e75acee84e5015049ad51e
1 .. _QEMU-PC-System-emulator:
3 x86 (PC) System emulator
4 ------------------------
6 .. _pcsys_005fdevices:
8 Peripherals
9 ~~~~~~~~~~~
11 The QEMU PC System emulator simulates the following peripherals:
13 -  i440FX host PCI bridge and PIIX3 PCI to ISA bridge
15 -  Cirrus CLGD 5446 PCI VGA card or dummy VGA card with Bochs VESA
16    extensions (hardware level, including all non standard modes).
18 -  PS/2 mouse and keyboard
20 -  2 PCI IDE interfaces with hard disk and CD-ROM support
22 -  Floppy disk
24 -  PCI and ISA network adapters
26 -  Serial ports
28 -  IPMI BMC, either and internal or external one
30 -  Creative SoundBlaster 16 sound card
32 -  ENSONIQ AudioPCI ES1370 sound card
34 -  Intel 82801AA AC97 Audio compatible sound card
36 -  Intel HD Audio Controller and HDA codec
38 -  Adlib (OPL2) - Yamaha YM3812 compatible chip
40 -  Gravis Ultrasound GF1 sound card
42 -  CS4231A compatible sound card
44 -  PCI UHCI, OHCI, EHCI or XHCI USB controller and a virtual USB-1.1
45    hub.
47 SMP is supported with up to 255 CPUs.
49 QEMU uses the PC BIOS from the Seabios project and the Plex86/Bochs LGPL
50 VGA BIOS.
52 QEMU uses YM3812 emulation by Tatsuyuki Satoh.
54 QEMU uses GUS emulation (GUSEMU32 http://www.deinmeister.de/gusemu/) by
55 Tibor \"TS\" Schütz.
57 Note that, by default, GUS shares IRQ(7) with parallel ports and so QEMU
58 must be told to not have parallel ports to have working GUS.
60 .. parsed-literal::
62    |qemu_system_x86| dos.img -soundhw gus -parallel none
64 Alternatively:
66 .. parsed-literal::
68    |qemu_system_x86| dos.img -device gus,irq=5
70 Or some other unclaimed IRQ.
72 CS4231A is the chip used in Windows Sound System and GUSMAX products
74 .. include:: cpu-models-x86.rst.inc
76 .. _pcsys_005freq:
78 OS requirements
79 ~~~~~~~~~~~~~~~
81 On x86_64 hosts, the default set of CPU features enabled by the KVM
82 accelerator require the host to be running Linux v4.5 or newer. Red Hat
83 Enterprise Linux 7 is also supported, since the required
84 functionality was backported.