Received: by 2002:a05:6358:d09b:b0:dc:cd0c:909e with SMTP id jc27csp10135085rwb; Fri, 25 Nov 2022 01:12:36 -0800 (PST) X-Google-Smtp-Source: AA0mqf6cimp153I8R1vbtWRYTy48d4NEqRLTkuu+H5Sw+0tsKvhJr3WX98y4FGqYzlr0vO8azvvw X-Received: by 2002:a17:906:6bd8:b0:78b:a8d:e76a with SMTP id t24-20020a1709066bd800b0078b0a8de76amr31885776ejs.725.1669367556064; Fri, 25 Nov 2022 01:12:36 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1669367556; cv=none; d=google.com; s=arc-20160816; b=rTclm/L2UYGf8NIastRXWqmcbLK+0YGj9+E7Bi7jPgVbWrTz63jX5pEkobgDE1Kv6O l3JLI5DhrYv7oD/PQSQ3PyvO9uIA1I0HrveGpTrQiLaLIb21N8Ps98qTTANlgv0/SunK vDGOizDxddxkVtzpw/2Ju4KGnhjiFt7YXYZnah2bcHAyAXgfnWQPJ8eAQcvDst+QEqH7 WydcLCnF8Rmp4S54ro0nMVyEMDUt7dS10RDRCuolL4hT28/OuHFXxYiN9tbyjNaEwTEP 9te6hpTJ9noXa2irKi+LFsHzQfSmEvZ7h/19a0yXFRfg0hbuZmH2MJNOHQi7mjqpPGOR Xozw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:date:user-agent:message-id:from:cc:to:subject :references:in-reply-to:content-transfer-encoding:mime-version :dkim-signature; bh=7RGeCEHG1G53Xom7o/juk/OP7d5IJEctJeBMolf8ohE=; b=RhLQKn67P1pJXt2EDC5CXFzw8HUDg2rQLH8X1sH6Tt04bPSt4GJP0QcHBWaEgn7uYm 18ZBLeRrG02CbTS7KiJ2CRXX3gIocM3JMDX3w1GO+wcn2QV/eNzo8q5eJcHguEnqJguJ EQaeVf4HQWi6V3rRduaOx0ZyO0sgAm0gsSNmxfsPSJm8eOSAVOU6yWBiZB3A59aJv9nb V6OCDPZEXOtxr33EaRQ15XGhrbBPSUXkNRbWp63L304rFZ+ejZPQtRScTtn58bS8Ai9W BeOG0hPnb+hWOsoVUNPX2812XcjUYfCvvprL1gr/Jnx9J6IaMiynwqQYeUM7Go98ePtd 3JIQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@ibm.com header.s=pp1 header.b=jtXj+Qa0; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=REJECT sp=NONE dis=NONE) header.from=ibm.com Return-Path: Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id v7-20020a1709064e8700b007ae0211844dsi2834651eju.937.2022.11.25.01.12.15; Fri, 25 Nov 2022 01:12:36 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20; Authentication-Results: mx.google.com; dkim=pass header.i=@ibm.com header.s=pp1 header.b=jtXj+Qa0; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=REJECT sp=NONE dis=NONE) header.from=ibm.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S229727AbiKYIwc (ORCPT + 86 others); Fri, 25 Nov 2022 03:52:32 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:35780 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229541AbiKYIwb (ORCPT ); Fri, 25 Nov 2022 03:52:31 -0500 Received: from mx0a-001b2d01.pphosted.com (mx0a-001b2d01.pphosted.com [148.163.156.1]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 866BBCE9; Fri, 25 Nov 2022 00:52:28 -0800 (PST) Received: from pps.filterd (m0098396.ppops.net [127.0.0.1]) by mx0a-001b2d01.pphosted.com (8.17.1.19/8.17.1.19) with ESMTP id 2AP8nmiJ006687; Fri, 25 Nov 2022 08:52:25 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=ibm.com; h=content-type : mime-version : content-transfer-encoding : in-reply-to : references : subject : to : cc : from : message-id : date; s=pp1; bh=7RGeCEHG1G53Xom7o/juk/OP7d5IJEctJeBMolf8ohE=; b=jtXj+Qa0Hw49rdLzDKaQKmWe6taT9UacpCAKpRHwij/B3D8wIrJKqMMcgVCIIAgf19k9 T77Jev2X23zV8KN2aUovjCQG3CjwXtrD5kig7Cb7j1UWRqZWg9iR0GowUNnDPAztnzB1 zDxmZz0Fodtw8uqtd+PS2ezUEnnWDnVY80ftIiZ1pZi6/vp+pkfs+7o3L7uNRBgL0Z1M t+c7p70gKAsnciqPCRauo5MPozEo/wvaQUwLEyXGd1o61hqzxgJr70MSGAVZEvAdbq99 oDGNNX4RsspzR1OBTwNAxLLxUS03V+yXjyw1wXlszudVyXyTHbPUWN7vhv8pOBTP90sk lA== Received: from pps.reinject (localhost [127.0.0.1]) by mx0a-001b2d01.pphosted.com (PPS) with ESMTPS id 3m2thrr1ny-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT); Fri, 25 Nov 2022 08:52:25 +0000 Received: from m0098396.ppops.net (m0098396.ppops.net [127.0.0.1]) by pps.reinject (8.17.1.5/8.17.1.5) with ESMTP id 2AP8oqN1009927; Fri, 25 Nov 2022 08:52:24 GMT Received: from ppma03ams.nl.ibm.com (62.31.33a9.ip4.static.sl-reverse.com [169.51.49.98]) by mx0a-001b2d01.pphosted.com (PPS) with ESMTPS id 3m2thrr1nf-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT); Fri, 25 Nov 2022 08:52:24 +0000 Received: from pps.filterd (ppma03ams.nl.ibm.com [127.0.0.1]) by ppma03ams.nl.ibm.com (8.16.1.2/8.16.1.2) with SMTP id 2AP8pOZC017679; Fri, 25 Nov 2022 08:52:22 GMT Received: from b06cxnps4076.portsmouth.uk.ibm.com (d06relay13.portsmouth.uk.ibm.com [9.149.109.198]) by ppma03ams.nl.ibm.com with ESMTP id 3kxps91ar3-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT); Fri, 25 Nov 2022 08:52:22 +0000 Received: from d06av24.portsmouth.uk.ibm.com (d06av24.portsmouth.uk.ibm.com [9.149.105.60]) by b06cxnps4076.portsmouth.uk.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id 2AP8qI8c63766992 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Fri, 25 Nov 2022 08:52:18 GMT Received: from d06av24.portsmouth.uk.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id CD47B42042; Fri, 25 Nov 2022 08:52:18 +0000 (GMT) Received: from d06av24.portsmouth.uk.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id A76B04203F; Fri, 25 Nov 2022 08:52:18 +0000 (GMT) Received: from t14-nrb (unknown [9.171.26.223]) by d06av24.portsmouth.uk.ibm.com (Postfix) with ESMTP; Fri, 25 Nov 2022 08:52:18 +0000 (GMT) Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable In-Reply-To: References: <20221117221758.66326-1-scgl@linux.ibm.com> <20221117221758.66326-3-scgl@linux.ibm.com> Subject: Re: [PATCH v3 2/9] Documentation: KVM: s390: Describe KVM_S390_MEMOP_F_CMPXCHG To: Alexander Gordeev , Christian Borntraeger , Claudio Imbrenda , Heiko Carstens , Janis Schoetterl-Glausch , Janosch Frank , Thomas Huth , Vasily Gorbik Cc: David Hildenbrand , Jonathan Corbet , kvm@vger.kernel.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, linux-kselftest@vger.kernel.org, linux-s390@vger.kernel.org, Paolo Bonzini , Shuah Khan , Sven Schnelle From: Nico Boehr Message-ID: <166936633695.19077.13372353298394327779@t14-nrb.local> User-Agent: alot/0.8.1 Date: Fri, 25 Nov 2022 09:52:18 +0100 X-TM-AS-GCONF: 00 X-Proofpoint-ORIG-GUID: tHcF3P8PfsqF7PEYaJjzK5zOowVa2Wef X-Proofpoint-GUID: FNGyPJvbxGrMU8e6_jYyAt9gb_ciObwx X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.219,Aquarius:18.0.895,Hydra:6.0.545,FMLib:17.11.122.1 definitions=2022-11-25_02,2022-11-24_01,2022-06-22_01 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 phishscore=0 mlxlogscore=676 priorityscore=1501 adultscore=0 spamscore=0 clxscore=1015 bulkscore=0 mlxscore=0 lowpriorityscore=0 impostorscore=0 suspectscore=0 malwarescore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2210170000 definitions=main-2211250069 X-Spam-Status: No, score=-2.0 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_EF,RCVD_IN_MSPIKE_H2,SPF_HELO_NONE,SPF_PASS autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on lindbergh.monkeyblade.net Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Quoting Janis Schoetterl-Glausch (2022-11-22 14:10:41) > On Tue, 2022-11-22 at 08:47 +0100, Thomas Huth wrote: > > On 17/11/2022 23.17, Janis Schoetterl-Glausch wrote: [...] > > > Supported flags: > > > * ``KVM_S390_MEMOP_F_CHECK_ONLY`` > > > * ``KVM_S390_MEMOP_F_SKEY_PROTECTION`` > > > + * ``KVM_S390_MEMOP_F_CMPXCHG`` > > > + > > > +The semantics of the flags common with logical acesses are as for lo= gical > > > +accesses. > > > + > > > +For write accesses, the KVM_S390_MEMOP_F_CMPXCHG might be supported. > >=20 > > I'd maybe merge this with the last sentence: > >=20 > > For write accesses, the KVM_S390_MEMOP_F_CMPXCHG flag is supported if=20 > > KVM_CAP_S390_MEM_OP_EXTENSION has bit 1 (i.e. bit with value 2) set. >=20 > Ok. > >=20 > > ... and speaking of that, I wonder whether it's maybe a good idea to=20 > > introduce some #defines for bit 1 / value 2, to avoid the confusion ? >=20 > Not sure, I don't feel it's too complicated. Where would you define it? > Next to the mem_op struct? KVM_S390_MEMOP_EXTENSION_CAP_CMPXCHG? I think the define would be a good idea. Location and name sound good to me. You could also replace the hard-coded 0x3 in kvm_vm_ioctl_check_extension()= when you have the define.