Merge remote-tracking branch 'remotes/rth/tags/pull-tcg-20211016' into staging
[qemu.git] / docs / system / target-s390x.rst
1 .. _s390x-System-emulator:
2
3 s390x System emulator
4 ---------------------
5
6 QEMU can emulate z/Architecture (in particular, 64 bit) s390x systems
7 via the ``qemu-system-s390x`` binary. Only one machine type,
8 ``s390-ccw-virtio``, is supported (with versioning for compatibility
9 handling).
10
11 When using KVM as accelerator, QEMU can emulate CPUs up to the generation
12 of the host. When using the default cpu model with TCG as accelerator,
13 QEMU will emulate a subset of z13 cpu features that should be enough to run
14 distributions built for the z13.
15
16 Device support
17 ==============
18
19 QEMU will not emulate most of the traditional devices found under LPAR or
20 z/VM; virtio devices (especially using virtio-ccw) make up the bulk of
21 the available devices. Passthrough of host devices via vfio-pci, vfio-ccw,
22 or vfio-ap is also available.
23
24 .. toctree::
25    s390x/vfio-ap
26    s390x/css
27    s390x/3270
28    s390x/vfio-ccw
29
30 Architectural features
31 ======================
32
33 .. toctree::
34    s390x/bootdevices
35    s390x/protvirt