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