From patchwork Mon Oct 14 14:46:14 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: David Hildenbrand X-Patchwork-Id: 13835141 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from kanga.kvack.org (kanga.kvack.org [205.233.56.17]) by smtp.lore.kernel.org (Postfix) with ESMTP id DAAD8D1627E for ; Mon, 14 Oct 2024 14:46:55 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 4CF246B008C; Mon, 14 Oct 2024 10:46:55 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id 4581A6B0092; Mon, 14 Oct 2024 10:46:55 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 3204F6B0093; Mon, 14 Oct 2024 10:46:55 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0014.hostedemail.com [216.40.44.14]) by kanga.kvack.org (Postfix) with ESMTP id 0BE356B008C for ; Mon, 14 Oct 2024 10:46:55 -0400 (EDT) Received: from smtpin22.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay06.hostedemail.com (Postfix) with ESMTP id 45F3DABF06 for ; Mon, 14 Oct 2024 14:46:39 +0000 (UTC) X-FDA: 82672484580.22.251D331 Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.129.124]) by imf05.hostedemail.com (Postfix) with ESMTP id 4FEDB10000E for ; Mon, 14 Oct 2024 14:46:41 +0000 (UTC) Authentication-Results: imf05.hostedemail.com; dkim=pass header.d=redhat.com header.s=mimecast20190719 header.b=FGHN0stU; dmarc=pass (policy=none) header.from=redhat.com; spf=pass (imf05.hostedemail.com: domain of david@redhat.com designates 170.10.129.124 as permitted sender) smtp.mailfrom=david@redhat.com ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1728917056; h=from:from:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:dkim-signature; bh=a1gfpTnBaz7Rw8DDcy7+GcKNAbMQ0JDruhBEQq7xW1o=; b=ACdZAwNKccXTPXZs+bOTp5KYp21Rl2pCJxvyJaNlIIzKk9cHJ37ir8C87HdgPM2H1U+68v lDOpNri1WPYCMK/g7i33CdvFPMoMR1qGe2hCsLxoicDqKUAiHGKjwkgawGBGCkTER5fI4q DPFSGLSUUoagJzr+MSJPRIZ3y0Lj1lg= ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1728917056; a=rsa-sha256; cv=none; b=BV87T4jTEipiqxplbX/6ZmJ61g18oHGNzhPKDIsZpr9zlLGu8HfgfuD9njOvrJkqHOZf+N Wp7p5IVadCRCGl8ZWZXp16xX2lmQ4C+CaG6mP9zx0dRt5AIIhaczkxRKtEMRx2R29/8orZ OYlC/Eic3t4dTmx7yQJaizXwZ3Aeyzs= ARC-Authentication-Results: i=1; imf05.hostedemail.com; dkim=pass header.d=redhat.com header.s=mimecast20190719 header.b=FGHN0stU; dmarc=pass (policy=none) header.from=redhat.com; spf=pass (imf05.hostedemail.com: domain of david@redhat.com designates 170.10.129.124 as permitted sender) smtp.mailfrom=david@redhat.com DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1728917212; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=a1gfpTnBaz7Rw8DDcy7+GcKNAbMQ0JDruhBEQq7xW1o=; b=FGHN0stUZi/RwFtZYtrfyODBZ79YTTkJy97LjVxY8clo4dXTvNEr3s08iTY+zYirBPBIe6 xdLap9xYffiRppRGO/wDmgc57k/lmCkYUZCw01/az8wHn2mecrPv282ZL828hhBTS4xiYD CL3k5+4IMJVJm/nsjMcl7PLbxifYUzk= Received: from mx-prod-mc-01.mail-002.prod.us-west-2.aws.redhat.com (ec2-54-186-198-63.us-west-2.compute.amazonaws.com [54.186.198.63]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-571-YaPY5B82Mt2_929L_qPidA-1; Mon, 14 Oct 2024 10:46:49 -0400 X-MC-Unique: YaPY5B82Mt2_929L_qPidA-1 Received: from mx-prod-int-05.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-05.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.17]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by mx-prod-mc-01.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id 3531919560B5; Mon, 14 Oct 2024 14:46:47 +0000 (UTC) Received: from t14s.cit.tum.de (unknown [10.22.32.146]) by mx-prod-int-05.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id C0E941955E8F; Mon, 14 Oct 2024 14:46:39 +0000 (UTC) From: David Hildenbrand To: linux-kernel@vger.kernel.org Cc: linux-mm@kvack.org, linux-s390@vger.kernel.org, virtualization@lists.linux.dev, linux-doc@vger.kernel.org, kvm@vger.kernel.org, David Hildenbrand , Heiko Carstens , Vasily Gorbik , Alexander Gordeev , Christian Borntraeger , Sven Schnelle , Thomas Huth , Cornelia Huck , Janosch Frank , Claudio Imbrenda , "Michael S. Tsirkin" , Jason Wang , Xuan Zhuo , =?utf-8?q?Eugenio_P=C3=A9rez?= , Andrew Morton , Jonathan Corbet Subject: [PATCH v2 2/7] Documentation: s390-diag.rst: make diag500 a generic KVM hypercall Date: Mon, 14 Oct 2024 16:46:14 +0200 Message-ID: <20241014144622.876731-3-david@redhat.com> In-Reply-To: <20241014144622.876731-1-david@redhat.com> References: <20241014144622.876731-1-david@redhat.com> MIME-Version: 1.0 X-Scanned-By: MIMEDefang 3.0 on 10.30.177.17 X-Rspamd-Server: rspam07 X-Rspamd-Queue-Id: 4FEDB10000E X-Stat-Signature: 8w813jmwdqar7txwaa66t8awd7hkp63c X-Rspam-User: X-HE-Tag: 1728917201-634686 X-HE-Meta: U2FsdGVkX19k9Qys9WSHZ8hUGryaWXFSbIhg1jJxihsEW45Yrbu6UiIg8i1HTQSXpvCHj+DmNIFoVgS8Kb3JA2ZXj+Mtcn6LonANhmXaUuTdv5XVoP1nDCLCj3J9D9Fbj/6WBMPlTydelGT78Exsk2VpaMtjxly8DXXo2vyB8wl/1pEYscPcSqiGqJQpzzHtG5CJccp0dWyPYbl3Wd9O9GHgiZwKFYvPwU4Ush8YdSvtmu7sceKDloRVmJ9O9bIdV8FpJ+jaR1JW1sVNmlsyVLj02JqZXxNu5OV5PccGreQ2JRzdM0sW8Mb+2hsN106/6MaSBh0niZngiPY4xP78znuN2C0+NaO8n2kjBULLo1bJyen2wA8Hwtuxs7mXItA1mVs1P/J72qxmngNR3MxvavrHDePsm8+MtgyjFMozxUqD4g/Q81TKihrVc53uj7gk6+M4h5oqUkt0Q2VUDEw0yV7+AoALxpWqzz3AknWnpIrPe7X6QrasxPoMCcc3PQX5y9HWcqGtrEq2hI6GJ3dcl8ijWtX/nbHYvXaPM361MXBfE4hWsQqvZKnpqaBf1dAy/HK4DurIaTop9nb2DGuTLGPBJPHTtnvyqq0EYwBJfYOMdD4H4SIcGSBW+IGpTLNpme0DPTOhqVFWQT4j6/2qUw7vVk8alztxRRkqSLQZjnvG7h2NHYLyKC4GdHpVLANSr01PzIpgQ/qOKqMBNggg/EgN0x7s6OY/NKntFwmp1TndFcyCpR9Vcz50Rk3khVqLeSBG9rJzGC0k50IcOHjYj5pcqUEPbh7R4XZ57WVToZnuPvju36iJ4mUCjfEs6vjv4iiM/+d8wgU2JU+x+ooY6kiDQnfpuv/O1+/1XwnDvWwxKbOQ+mUOJN6UaUSzaasdAQzS8QdajH5gwemqKhyope6dj+cU2xyUbzk1VYhkoYoBYZrfeyZCS0o75wDJjnQeQcLCyXHxL9V9us0kYpX Gow0ofnO ug8DoYyw1ur+0eWQSGXJrdot0o4I3ZWNBE/U2t65OrN8YmvRq1m6gYFFRb+jzKw3Nhs5umB/HBExgYuS7rzYYhKezkiIN/sed4Xc2F06vuhS4VBS/5kBGvkVCEdaL8YLHKW8bTUKcOxd+8rTBuEueAA/webL4ewZL/MHDSuuwvYZCK7D1/zrMswVHgkUBgl2miypC8m2G0uN8osifi/X2RfCJGayUqFlfjbaQJnfW3zsOqw3YAdaiy23x4sN1LsuSuAxHES0sHCogC+8i32uZ4iesOeZdBqmapGmQPCwHotlfiFE/I5qcWyzNsCl57DlHwToqKLfGL3xRsiw= X-Bogosity: Ham, tests=bogofilter, spamicity=0.000000, version=1.2.4 Sender: owner-linux-mm@kvack.org Precedence: bulk X-Loop: owner-majordomo@kvack.org List-ID: List-Subscribe: List-Unsubscribe: Let's make it a generic KVM hypercall, allowing other subfunctions to be more independent of virtio. This is a preparation for documenting a new hypercall. Signed-off-by: David Hildenbrand --- Documentation/virt/kvm/s390/s390-diag.rst | 15 ++++++++------- 1 file changed, 8 insertions(+), 7 deletions(-) diff --git a/Documentation/virt/kvm/s390/s390-diag.rst b/Documentation/virt/kvm/s390/s390-diag.rst index ca85f030eb0b..d9b7c6cbc99e 100644 --- a/Documentation/virt/kvm/s390/s390-diag.rst +++ b/Documentation/virt/kvm/s390/s390-diag.rst @@ -35,15 +35,16 @@ DIAGNOSE function codes not specific to KVM, please refer to the documentation for the s390 hypervisors defining them. -DIAGNOSE function code 'X'500' - KVM virtio functions ------------------------------------------------------ +DIAGNOSE function code 'X'500' - KVM functions +---------------------------------------------- -If the function code specifies 0x500, various virtio-related functions -are performed. +If the function code specifies 0x500, various KVM-specific functions +are performed, including virtio functions. -General register 1 contains the virtio subfunction code. Supported -virtio subfunctions depend on KVM's userspace. Generally, userspace -provides either s390-virtio (subcodes 0-2) or virtio-ccw (subcode 3). +General register 1 contains the subfunction code. Supported subfunctions +depend on KVM's userspace. Regarding virtio subfunctions, generally +userspace provides either s390-virtio (subcodes 0-2) or virtio-ccw +(subcode 3). Upon completion of the DIAGNOSE instruction, general register 2 contains the function's return code, which is either a return code or a subcode