docs/system: convert Texinfo documentation to rST
[qemu.git] / docs / system / target-i386.rst
1 .. _QEMU-PC-System-emulator:
2
3 x86 (PC) System emulator
4 ------------------------
5
6 .. _pcsys_005fdevices:
7
8 Peripherals
9 ~~~~~~~~~~~
10
11 The QEMU PC System emulator simulates the following peripherals:
12
13 -  i440FX host PCI bridge and PIIX3 PCI to ISA bridge
14
15 -  Cirrus CLGD 5446 PCI VGA card or dummy VGA card with Bochs VESA
16    extensions (hardware level, including all non standard modes).
17
18 -  PS/2 mouse and keyboard
19
20 -  2 PCI IDE interfaces with hard disk and CD-ROM support
21
22 -  Floppy disk
23
24 -  PCI and ISA network adapters
25
26 -  Serial ports
27
28 -  IPMI BMC, either and internal or external one
29
30 -  Creative SoundBlaster 16 sound card
31
32 -  ENSONIQ AudioPCI ES1370 sound card
33
34 -  Intel 82801AA AC97 Audio compatible sound card
35
36 -  Intel HD Audio Controller and HDA codec
37
38 -  Adlib (OPL2) - Yamaha YM3812 compatible chip
39
40 -  Gravis Ultrasound GF1 sound card
41
42 -  CS4231A compatible sound card
43
44 -  PCI UHCI, OHCI, EHCI or XHCI USB controller and a virtual USB-1.1
45    hub.
46
47 SMP is supported with up to 255 CPUs.
48
49 QEMU uses the PC BIOS from the Seabios project and the Plex86/Bochs LGPL
50 VGA BIOS.
51
52 QEMU uses YM3812 emulation by Tatsuyuki Satoh.
53
54 QEMU uses GUS emulation (GUSEMU32 http://www.deinmeister.de/gusemu/) by
55 Tibor \"TS\" Sch├╝tz.
56
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.
59
60 .. parsed-literal::
61
62    |qemu_system_x86| dos.img -soundhw gus -parallel none
63
64 Alternatively:
65
66 .. parsed-literal::
67
68    |qemu_system_x86| dos.img -device gus,irq=5
69
70 Or some other unclaimed IRQ.
71
72 CS4231A is the chip used in Windows Sound System and GUSMAX products
73
74 .. include:: cpu-models-x86.rst.inc
75
76 .. _pcsys_005freq:
77
78 OS requirements
79 ~~~~~~~~~~~~~~~
80
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.