From mboxrd@z Thu Jan 1 00:00:00 1970 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 77562D1813A for ; Mon, 14 Oct 2024 18:04:22 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 120DA6B0089; Mon, 14 Oct 2024 14:04:22 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id 0AA556B008A; Mon, 14 Oct 2024 14:04:22 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id E657B6B008C; Mon, 14 Oct 2024 14:04:21 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0015.hostedemail.com [216.40.44.15]) by kanga.kvack.org (Postfix) with ESMTP id C3E206B0089 for ; Mon, 14 Oct 2024 14:04:21 -0400 (EDT) Received: from smtpin08.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay09.hostedemail.com (Postfix) with ESMTP id A3A1681019 for ; Mon, 14 Oct 2024 18:04:14 +0000 (UTC) X-FDA: 82672982070.08.F455DB7 Received: from mx0b-001b2d01.pphosted.com (mx0b-001b2d01.pphosted.com [148.163.158.5]) by imf05.hostedemail.com (Postfix) with ESMTP id F1FD2100009 for ; Mon, 14 Oct 2024 18:04:06 +0000 (UTC) Authentication-Results: imf05.hostedemail.com; dkim=pass header.d=ibm.com header.s=pp1 header.b=q7e0q4gU; spf=pass (imf05.hostedemail.com: domain of hca@linux.ibm.com designates 148.163.158.5 as permitted sender) smtp.mailfrom=hca@linux.ibm.com; dmarc=pass (policy=none) header.from=ibm.com ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1728928916; 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-type:content-transfer-encoding: in-reply-to:in-reply-to:references:references:dkim-signature; bh=8xiOAnxSdyu4+TwMLojb8uRtGgHcpSJojTKbAe3+Zfc=; b=KFtT6kf8alBW69R3dON63/OkDtMc9mkeo0fXBOhGVbV4Tu73ABgbhxy4u26OOyDpZzQG53 O3v5cG1MNNMV6zFI53QUR4gTtFlgQd9cj1Cbs0VbkdKdVH0nNfuyAX5Eh9TG2jwExJWXpM Dn9aolGdnvi9d33N9REX8BwgkoIWBmQ= ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1728928916; a=rsa-sha256; cv=none; b=uh9EfLae67AdoFTYyFVFkJtfloy45YmYYe1Uc95FlZjv+zsr09BlIyOebRi7ah7AsTxjnp sgXP9Hpc9Fgh8O5U9ZOZ26V2gKQCuFInW1ouNFUrhLGE4oqrXQg03SMh+Q7svBUxGe+m6B 7IvgIXkf4M5cVjd6dLrr/dRmyBMul2k= ARC-Authentication-Results: i=1; imf05.hostedemail.com; dkim=pass header.d=ibm.com header.s=pp1 header.b=q7e0q4gU; spf=pass (imf05.hostedemail.com: domain of hca@linux.ibm.com designates 148.163.158.5 as permitted sender) smtp.mailfrom=hca@linux.ibm.com; dmarc=pass (policy=none) header.from=ibm.com Received: from pps.filterd (m0353725.ppops.net [127.0.0.1]) by mx0a-001b2d01.pphosted.com (8.18.1.2/8.18.1.2) with ESMTP id 49EHLg4D026615; Mon, 14 Oct 2024 18:04:18 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=ibm.com; h=date :from:to:cc:subject:message-id:references:mime-version :content-type:in-reply-to; s=pp1; bh=8xiOAnxSdyu4+TwMLojb8uRtGgH cpSJojTKbAe3+Zfc=; b=q7e0q4gUB0e5gGeqE1i4IP6FAi/TA9U+3HUGibUu/ZK 6Iw2ZZwxq4Mgef20pGP9Y9TOIKKqQfsQxuz4JX6h8POTlMGPHaE3MD7bRwSVePAa JSgEaCbiNDeQhkdKePuj9URoQvudq+RRJFAlvekc6Z3bTD74hT6SvW3aIBD2BQ1o ZsC0KtjV9iCq6jXnfU3ehZsfhhVhOP3FZDbGhAYAuR5wEytAAbDZ9y7deaiZ79MF t7vQSxpiR7kMz9ADJ2OJnmYSlJshOir1hQyfRKMTjKkti0n8GyG1qWaSutpzQSnA Kl60k3w5aVpex1ywVVNUjUJM288oNNnF3jmWcT3qSZw== Received: from pps.reinject (localhost [127.0.0.1]) by mx0a-001b2d01.pphosted.com (PPS) with ESMTPS id 4297mh0693-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT); Mon, 14 Oct 2024 18:04:17 +0000 (GMT) Received: from m0353725.ppops.net (m0353725.ppops.net [127.0.0.1]) by pps.reinject (8.18.0.8/8.18.0.8) with ESMTP id 49EI4Hv6021968; Mon, 14 Oct 2024 18:04:17 GMT Received: from ppma23.wdc07v.mail.ibm.com (5d.69.3da9.ip4.static.sl-reverse.com [169.61.105.93]) by mx0a-001b2d01.pphosted.com (PPS) with ESMTPS id 4297mh068y-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT); Mon, 14 Oct 2024 18:04:17 +0000 (GMT) Received: from pps.filterd (ppma23.wdc07v.mail.ibm.com [127.0.0.1]) by ppma23.wdc07v.mail.ibm.com (8.18.1.2/8.18.1.2) with ESMTP id 49EEuaSf007025; Mon, 14 Oct 2024 18:04:16 GMT Received: from smtprelay04.fra02v.mail.ibm.com ([9.218.2.228]) by ppma23.wdc07v.mail.ibm.com (PPS) with ESMTPS id 4284xjyssc-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT); Mon, 14 Oct 2024 18:04:16 +0000 Received: from smtpav04.fra02v.mail.ibm.com (smtpav04.fra02v.mail.ibm.com [10.20.54.103]) by smtprelay04.fra02v.mail.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id 49EI4CWL17367318 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Mon, 14 Oct 2024 18:04:12 GMT Received: from smtpav04.fra02v.mail.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 7F40020043; Mon, 14 Oct 2024 18:04:12 +0000 (GMT) Received: from smtpav04.fra02v.mail.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 7D82320040; Mon, 14 Oct 2024 18:04:11 +0000 (GMT) Received: from osiris (unknown [9.171.66.174]) by smtpav04.fra02v.mail.ibm.com (Postfix) with ESMTPS; Mon, 14 Oct 2024 18:04:11 +0000 (GMT) Date: Mon, 14 Oct 2024 20:04:10 +0200 From: Heiko Carstens To: David Hildenbrand Cc: linux-kernel@vger.kernel.org, linux-mm@kvack.org, linux-s390@vger.kernel.org, virtualization@lists.linux.dev, linux-doc@vger.kernel.org, kvm@vger.kernel.org, Vasily Gorbik , Alexander Gordeev , Christian Borntraeger , Sven Schnelle , Thomas Huth , Cornelia Huck , Janosch Frank , Claudio Imbrenda , "Michael S. Tsirkin" , Jason Wang , Xuan Zhuo , Eugenio =?iso-8859-1?Q?P=E9rez?= , Andrew Morton , Jonathan Corbet Subject: Re: [PATCH v2 2/7] Documentation: s390-diag.rst: make diag500 a generic KVM hypercall Message-ID: <20241014180410.10447-C-hca@linux.ibm.com> References: <20241014144622.876731-1-david@redhat.com> <20241014144622.876731-3-david@redhat.com> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20241014144622.876731-3-david@redhat.com> X-TM-AS-GCONF: 00 X-Proofpoint-ORIG-GUID: jXoQsbGwi2M09wVIau-wlOgpnwDPXmRm X-Proofpoint-GUID: riwysc8s6Iq-tjcvsxftDgfGdw7fL_8J X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.293,Aquarius:18.0.1051,Hydra:6.0.680,FMLib:17.12.62.30 definitions=2024-10-14_12,2024-10-11_01,2024-09-30_01 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 mlxscore=0 malwarescore=0 spamscore=0 impostorscore=0 priorityscore=1501 lowpriorityscore=0 clxscore=1015 mlxlogscore=577 bulkscore=0 adultscore=0 suspectscore=0 phishscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.19.0-2409260000 definitions=main-2410140128 X-Rspam-User: X-Rspamd-Server: rspam04 X-Rspamd-Queue-Id: F1FD2100009 X-Stat-Signature: psmxyqterfb793chxymtkodjiqs7f8r1 X-HE-Tag: 1728929046-938578 X-HE-Meta: U2FsdGVkX1+g+r/SlOSmj//05rWW8kfvzNp86XGDiyy3Wsf75dBd4qFq/PKApxQtefZnnrvqJBd9tu17FyCZZikpB3Vtn+XTrIlYL7mEGe8VpRGlh3Hu7eJA1GhSIXvmUp8Pf3WwrJ6T3AqQwE8BCa34xZeHsRtblFI+gIgvAxFRZ9521ByZkz5MgBJ/NK0eEpt17a8K+RORykavz0Dq7mAQfjmxlNhJSHG5cCho29JKXkuD4nJlGGclpCVGzNFmU+cqC7xYWTcjctOVY6FkUaAKZX8wambaC7/NdvgBSE3mz7TTQ/es8NR7ZVnxtGQf5qpiJ2SPURblMij46XudvBm+vzovGt3pEJ8RpnVx7Lk/ldYjNUgw1yeqrYDcuiGhse/lSC0mzm6YAvDXwCxbTFJrXV8f7E+lLDPDUXgtjxFQAruPatJlIeLzoCDRVAbIkCE6++ln3fl/VBaQwF+yHH0bGgNW1QMSlLLJqCU3ngfs+dtZ9bUQUYkXXGUhs+qAjDcI6iN2xMxr3Qa9nq6YJW3GNiR0dR7BMJC09VR0kastToBM8DWLZnqYxkx4tWUhHu9+6UIzr5SJDlNHYwwSNi01TrMZp94apfATohUh2+Oca7wi8jzOp0+jhKcAc0ldngPvlXFixK3zHz4Au5EVolmwLge8nPGukhzLz0irOxlntE5AAk7sVcyGBDXfbcHgrs4oAoULaMQwgrTwjlIJa4lYhINJvFFhI/ol6XXlcMBS86XLgYZbWbF6lDevBR+3N4Ha7adxtzETjOyQV07cwpTLezTWV+SOLBdNhQOyaKPeRs70YNDRf0Og5C8Ud6GMWkI6qbQ5dgRimnJxMipfslL1dssSyzCUK1jmgiPaoUttiWIUv4J2np2InewqjAXAcEB/MvEmrn3oisehOI3WICgmTZWzc/O2WAx3vaumGiYIdE7ZGLPvcCDUXhmEYrOZnfI18bE3kI+LV9EKCmF of0qOMYy RTPhhkPKY50oL9pNU0IxCbBu3kIJ6+AyFBcyKYtgF12H1bwyDA3O2P0r2tgJQTnyiu/2ZX7J9++b0qBJ/6VIQM9Hoo7o/TYs1ZYuNxnjeyL2na14Inh+6WzqRaoVaToprok7dR0/U1tU5l1ESqUoCcrd0dWQgAP+/hbpR+rp31bvMSjFcTJZnpdELjaU0Q7duN5ZH6ZPAEwOoMwB8yrO0Z7vfziXiJUfbCQkRgxx1oNOrx9sAiaX5jM1AXA== 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: On Mon, Oct 14, 2024 at 04:46:14PM +0200, David Hildenbrand wrote: > 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(-) ... > -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). Reading this file leaves a number of questions open: how does one know which subcodes are supported, and what happens if an unsupported subcode is used? I'm afraid there is no indication available and the only way to figure out is to try and if it is unsupported the result is a specification exception. Is that correct? If so, it would be nice to document that too; but that is not necessarily your problem. I guess we won't see too many new diag 500 subcodes, or would it make sense to implement some query subcode?