| 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 | s390x/pcidevices |
| 30 | |
| 31 | Architectural features |
| 32 | ====================== |
| 33 | |
| 34 | .. toctree:: |
| 35 | s390x/bootdevices |
| 36 | s390x/protvirt |
| 37 | s390x/cpu-topology |
| 38 | s390x/secure-ipl |