xref: /qemu/docs/system/target-s390x.rst (revision ebdf417220f5264475e0423b8016c1444f2cf406)
1f58f084eSCornelia Huck.. _s390x-System-emulator:
2f58f084eSCornelia Huck
3f58f084eSCornelia Hucks390x System emulator
4f58f084eSCornelia Huck---------------------
5f58f084eSCornelia Huck
6f58f084eSCornelia HuckQEMU can emulate z/Architecture (in particular, 64 bit) s390x systems
7f58f084eSCornelia Huckvia the ``qemu-system-s390x`` binary. Only one machine type,
8f58f084eSCornelia Huck``s390-ccw-virtio``, is supported (with versioning for compatibility
9f58f084eSCornelia Huckhandling).
10f58f084eSCornelia Huck
11f58f084eSCornelia HuckWhen using KVM as accelerator, QEMU can emulate CPUs up to the generation
12f58f084eSCornelia Huckof the host. When using the default cpu model with TCG as accelerator,
13f58f084eSCornelia HuckQEMU will emulate a subset of z13 cpu features that should be enough to run
14f58f084eSCornelia Huckdistributions built for the z13.
15f58f084eSCornelia Huck
16f58f084eSCornelia HuckDevice support
17f58f084eSCornelia Huck==============
18f58f084eSCornelia Huck
19f58f084eSCornelia HuckQEMU will not emulate most of the traditional devices found under LPAR or
20f58f084eSCornelia Huckz/VM; virtio devices (especially using virtio-ccw) make up the bulk of
21f58f084eSCornelia Huckthe available devices. Passthrough of host devices via vfio-pci, vfio-ccw,
22f58f084eSCornelia Huckor vfio-ap is also available.
23f58f084eSCornelia Huck
24f58f084eSCornelia Huck.. toctree::
25f58f084eSCornelia Huck   s390x/vfio-ap
26f31270d4SCornelia Huck   s390x/css
2761a3d5edSCornelia Huck   s390x/3270
288e75b835SCornelia Huck   s390x/vfio-ccw
29e59a59a4SSebastian Mitterle   s390x/pcidevices
30f58f084eSCornelia Huck
3142fc5eaeSJanosch FrankArchitectural features
3242fc5eaeSJanosch Frank======================
3342fc5eaeSJanosch Frank
3442fc5eaeSJanosch Frank.. toctree::
3570c04a7cSThomas Huth   s390x/bootdevices
3642fc5eaeSJanosch Frank   s390x/protvirt
37*0d177cddSPierre Morel   s390x/cpu-topology
38