docs/system: convert Texinfo documentation to rST
[qemu.git] / docs / system / target-ppc.rst
1 .. _PowerPC-System-emulator:
2
3 PowerPC System emulator
4 -----------------------
5
6 Use the executable ``qemu-system-ppc`` to simulate a complete 40P (PREP)
7 or PowerMac PowerPC system.
8
9 QEMU emulates the following PowerMac peripherals:
10
11 -  UniNorth or Grackle PCI Bridge
12
13 -  PCI VGA compatible card with VESA Bochs Extensions
14
15 -  2 PMAC IDE interfaces with hard disk and CD-ROM support
16
17 -  NE2000 PCI adapters
18
19 -  Non Volatile RAM
20
21 -  VIA-CUDA with ADB keyboard and mouse.
22
23 QEMU emulates the following 40P (PREP) peripherals:
24
25 -  PCI Bridge
26
27 -  PCI VGA compatible card with VESA Bochs Extensions
28
29 -  2 IDE interfaces with hard disk and CD-ROM support
30
31 -  Floppy disk
32
33 -  PCnet network adapters
34
35 -  Serial port
36
37 -  PREP Non Volatile RAM
38
39 -  PC compatible keyboard and mouse.
40
41 Since version 0.9.1, QEMU uses OpenBIOS https://www.openbios.org/ for
42 the g3beige and mac99 PowerMac and the 40p machines. OpenBIOS is a free
43 (GPL v2) portable firmware implementation. The goal is to implement a
44 100% IEEE 1275-1994 (referred to as Open Firmware) compliant firmware.
45
46 The following options are specific to the PowerPC emulation:
47
48 ``-g WxH[xDEPTH]``
49    Set the initial VGA graphic mode. The default is 800x600x32.
50
51 ``-prom-env string``
52    Set OpenBIOS variables in NVRAM, for example:
53
54    ::
55
56       qemu-system-ppc -prom-env 'auto-boot?=false' \
57        -prom-env 'boot-device=hd:2,\yaboot' \
58        -prom-env 'boot-args=conf=hd:2,\yaboot.conf'
59
60 More information is available at
61 http://perso.magic.fr/l_indien/qemu-ppc/.