From nobody Fri Nov 14 02:14:08 2025 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists.gnu.org; Authentication-Results: mx.zohomail.com; dkim=fail; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=fail(p=none dis=none) header.from=redhat.com ARC-Seal: i=1; a=rsa-sha256; t=1584528087; cv=none; d=zohomail.com; s=zohoarc; b=D2Kj6OnlbfJYD2Vrt1C5MZVeD9Cmi841di7j0W2so1+Ai1GbLSZZ5gLmNJt3ZlY+qEj/BKfpI+2yHppfvx/SnDLGU4Yo/5n4ATqiVaihPWMlFeBiHxfhEeztmt/DTfSZHEj5AIUV048nbZXoD84oHJsgNuhzMmzf3YlefqFdGlI= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1584528087; h=Content-Type:Content-Transfer-Encoding:Cc:Date:From:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:Sender:Subject:To; bh=SaTBPUdQkoCCikGcNwdhw1dsGFj1b33IkFqgMVECzWE=; b=Val7OP/PdLcb1+vLqGvGtdzeQ/ZPoq8fd4bWQBeNX0jO9FJZXn4NGZyPVYYmmOWAtaZHEKQi+JMIWG+UMQNnSoKjNO8uSy/V+RA/aURC+E/VRbEpfI0U0JEipYzPKWziUivHCST0EBhittIC9RWwP02Fp41dfo2Nf/49/UhaAII= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=fail; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=fail header.from= (p=none dis=none) header.from= Return-Path: Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) by mx.zohomail.com with SMTPS id 158452808738315.863149859102691; Wed, 18 Mar 2020 03:41:27 -0700 (PDT) Received: from localhost ([::1]:48374 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jEW8b-0007S1-1V for importer@patchew.org; Wed, 18 Mar 2020 06:41:25 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:49794) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jEW79-0006jI-9s for qemu-devel@nongnu.org; Wed, 18 Mar 2020 06:39:57 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1jEW76-0003v7-R8 for qemu-devel@nongnu.org; Wed, 18 Mar 2020 06:39:54 -0400 Received: from us-smtp-delivery-74.mimecast.com ([63.128.21.74]:44202) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1jEW75-0003po-SJ for qemu-devel@nongnu.org; Wed, 18 Mar 2020 06:39:52 -0400 Received: from mimecast-mx01.redhat.com (mimecast-mx01.redhat.com [209.132.183.4]) (Using TLS) by relay.mimecast.com with ESMTP id us-mta-448-4Q8EPbIPP0mnzlBktbhYMA-1; Wed, 18 Mar 2020 06:39:47 -0400 Received: from smtp.corp.redhat.com (int-mx01.intmail.prod.int.phx2.redhat.com [10.5.11.11]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx01.redhat.com (Postfix) with ESMTPS id E86C318FE864; Wed, 18 Mar 2020 10:39:45 +0000 (UTC) Received: from localhost (ovpn-113-129.ams2.redhat.com [10.36.113.129]) by smtp.corp.redhat.com (Postfix) with ESMTPS id 6CC519081B; Wed, 18 Mar 2020 10:39:45 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1584527990; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=SaTBPUdQkoCCikGcNwdhw1dsGFj1b33IkFqgMVECzWE=; b=DzMZEtvIMHUKdlKgZAOHu0cqiTWJmpi1zbAvWK7W8JSs4Hnx1a3ay2ugz3YJYc78Wx/svv H+1fgeAWI/deIrh4FgRxSF/jbVP1Zwvbr56TsrsmOkF2PGjmNS+hsuENgnQUV33EPpMH/v WsPzxoJGg6VZIKhE23TZp7YSA0Nr2O4= X-MC-Unique: 4Q8EPbIPP0mnzlBktbhYMA-1 From: Cornelia Huck To: qemu-devel@nongnu.org, qemu-s390x@nongnu.org Subject: [PATCH] Documentation: create/move s390x documentation Date: Wed, 18 Mar 2020 11:39:40 +0100 Message-Id: <20200318103940.1169-1-cohuck@redhat.com> MIME-Version: 1.0 X-Scanned-By: MIMEDefang 2.79 on 10.5.11.11 X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Transfer-Encoding: quoted-printable X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 63.128.21.74 X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Peter Maydell , Cornelia Huck , Janosch Frank Errors-To: qemu-devel-bounces+importer=patchew.org@nongnu.org Sender: "Qemu-devel" X-ZohoMail-DKIM: fail (Header signature does not verify) Content-Type: text/plain; charset="utf-8" Create a subdirectory for s390x under docs/system/ and move the existing vfio-ap documentation there. Create an initial document describing s390x system emulation. Suggested-by: Peter Maydell Signed-off-by: Cornelia Huck Acked-by: Christian Borntraeger --- Mostly an initial version so that Janosch can base his protected virt documentation on something; there's room for more here :) If this looks good, I'll queue it on my s390-next branch for 5.1. --- MAINTAINERS | 5 +++-- docs/system/index.rst | 1 - docs/system/{ =3D> s390x}/vfio-ap.rst | 0 docs/system/target-s390x.rst | 26 ++++++++++++++++++++++++++ docs/system/targets.rst | 1 + 5 files changed, 30 insertions(+), 3 deletions(-) rename docs/system/{ =3D> s390x}/vfio-ap.rst (100%) create mode 100644 docs/system/target-s390x.rst diff --git a/MAINTAINERS b/MAINTAINERS index 7364af0d8b07..dfbd5b0c5de9 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -101,7 +101,8 @@ F: include/hw/watchdog/wdt_diag288.h F: pc-bios/s390-ccw/ F: pc-bios/s390-ccw.img F: target/s390x/ -F: docs/vfio-ap.txt +F: docs/system/target-s390x.rst +F: docs/system/s390x/ F: tests/migration/s390x/ K: ^Subject:.*(?i)s390x? T: git https://github.com/cohuck/qemu.git s390-next @@ -1606,7 +1607,7 @@ F: hw/s390x/ap-bridge.c F: include/hw/s390x/ap-device.h F: include/hw/s390x/ap-bridge.h F: hw/vfio/ap.c -F: docs/system/vfio-ap.rst +F: docs/system/s390x/vfio-ap.rst L: qemu-s390x@nongnu.org =20 vhost diff --git a/docs/system/index.rst b/docs/system/index.rst index 6e5f20fa1333..c0f685b818e5 100644 --- a/docs/system/index.rst +++ b/docs/system/index.rst @@ -30,7 +30,6 @@ Contents: managed-startup targets security - vfio-ap deprecated build-platforms license diff --git a/docs/system/vfio-ap.rst b/docs/system/s390x/vfio-ap.rst similarity index 100% rename from docs/system/vfio-ap.rst rename to docs/system/s390x/vfio-ap.rst diff --git a/docs/system/target-s390x.rst b/docs/system/target-s390x.rst new file mode 100644 index 000000000000..4c8b7cdd6615 --- /dev/null +++ b/docs/system/target-s390x.rst @@ -0,0 +1,26 @@ +.. _s390x-System-emulator: + +s390x System emulator +--------------------- + +QEMU can emulate z/Architecture (in particular, 64 bit) s390x systems +via the ``qemu-system-s390x`` binary. Only one machine type, +``s390-ccw-virtio``, is supported (with versioning for compatibility +handling). + +When using KVM as accelerator, QEMU can emulate CPUs up to the generation +of the host. When using the default cpu model with TCG as accelerator, +QEMU will emulate a subset of z13 cpu features that should be enough to run +distributions built for the z13. + +Device support +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D + +QEMU will not emulate most of the traditional devices found under LPAR or +z/VM; virtio devices (especially using virtio-ccw) make up the bulk of +the available devices. Passthrough of host devices via vfio-pci, vfio-ccw, +or vfio-ap is also available. + +.. toctree:: + s390x/vfio-ap + diff --git a/docs/system/targets.rst b/docs/system/targets.rst index eba3111247f6..0d8f91580aa5 100644 --- a/docs/system/targets.rst +++ b/docs/system/targets.rst @@ -17,3 +17,4 @@ Contents: target-arm target-m68k target-xtensa + target-s390x --=20 2.21.1