Merge tag 'pull-loongarch-20241016' of https://gitlab.com/gaosong/qemu into staging
[qemu/armbru.git] / docs / system / target-s390x.rst
blob94c981e732b3ab3056a6eaa53cd8e5886ec35801
1 .. _s390x-System-emulator:
3 s390x System emulator
4 ---------------------
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).
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.
16 Device support
17 ==============
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.
24 .. toctree::
25    s390x/vfio-ap
26    s390x/css
27    s390x/3270
28    s390x/vfio-ccw
29    s390x/pcidevices
31 Architectural features
32 ======================
34 .. toctree::
35    s390x/bootdevices
36    s390x/protvirt
37    s390x/cpu-topology