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 X-Spam-Level: X-Spam-Status: No, score=-9.5 required=3.0 tests=BAYES_00,DKIM_ADSP_CUSTOM_MED, DKIM_INVALID,DKIM_SIGNED,FREEMAIL_FORGED_FROMDOMAIN,FREEMAIL_FROM, HEADER_FROM_DIFFERENT_DOMAINS,INCLUDES_PATCH,MAILING_LIST_MULTI,SIGNED_OFF_BY, SPF_HELO_NONE,SPF_PASS,URIBL_BLOCKED autolearn=ham autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id EFC61C4727D for ; Thu, 24 Sep 2020 10:08:54 +0000 (UTC) Received: from lists.xenproject.org (lists.xenproject.org [192.237.175.120]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPS id 8C6BA2399A for ; Thu, 24 Sep 2020 10:08:54 +0000 (UTC) Authentication-Results: mail.kernel.org; dkim=fail reason="signature verification failed" (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="Ykfq9RhL" DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org 8C6BA2399A Authentication-Results: mail.kernel.org; dmarc=fail (p=none dis=none) header.from=gmail.com Authentication-Results: mail.kernel.org; spf=pass smtp.mailfrom=xen-devel-bounces@lists.xenproject.org Received: from localhost ([127.0.0.1] helo=lists.xenproject.org) by lists.xenproject.org with esmtp (Exim 4.92) (envelope-from ) id 1kLOBA-0002cz-Sl; Thu, 24 Sep 2020 10:08:44 +0000 Received: from us1-rack-iad1.inumbo.com ([172.99.69.81]) by lists.xenproject.org with esmtp (Exim 4.92) (envelope-from ) id 1kLOB9-0002cl-91 for xen-devel@lists.xenproject.org; Thu, 24 Sep 2020 10:08:43 +0000 X-Inumbo-ID: 3f9254da-1043-4c79-8399-3b45552b53b5 Received: from mail-wr1-x431.google.com (unknown [2a00:1450:4864:20::431]) by us1-rack-iad1.inumbo.com (Halon) with ESMTPS id 3f9254da-1043-4c79-8399-3b45552b53b5; Thu, 24 Sep 2020 10:08:41 +0000 (UTC) Received: by mail-wr1-x431.google.com with SMTP id z4so3158790wrr.4 for ; Thu, 24 Sep 2020 03:08:41 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:reply-to:to:cc:references:in-reply-to:subject:date:message-id :mime-version:content-transfer-encoding:content-language :thread-index; bh=PxjuONuSpgIe0qh4pw3LdtZtlWigqqYRuj4esJeg8Dw=; b=Ykfq9RhLr8rzG/jL62enGpUDm8zzpaKfHsT5eefZxFaPDL6oigZzWoN05tuBIjGEHN PV/YsjImoCr3ZFx24wfIlNk5JMOOqrC0TUX2F1poKERWzqEQ9newG3tyqgVTVAVg6LWN Hp/Re4+ilbMNWChrld2A5qGwychW/d9RWPb1rFuN8wucGsosyleeRLbFBmbMWLa4ry0Q 95C2gtZXVRXt6Q8J9Zuda26WIL+N+jBo2qgeGLXN2jL3GY5lvQ2E2pq4JP8w9hVi4A+H XNAxIe3WZ+rDzMSkZI9wA9b8sGBPcli1yzKadhBraESjPxbkc2YmnxEQX4YyQ2B6UlfG MOzA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:reply-to:to:cc:references:in-reply-to :subject:date:message-id:mime-version:content-transfer-encoding :content-language:thread-index; bh=PxjuONuSpgIe0qh4pw3LdtZtlWigqqYRuj4esJeg8Dw=; b=PBQ1S6zwIc6AiW6/fUOwDT84IymBJa6sIFqEME+OzublWlfv8FDSqrRRRB7OcaMz3H M93gHHT2lz6Yhl6OjfnUhQeAHjFdtO9mLpHKRbEqvJxNe19zhaZ3Hw4YFd0JC558YUBe ZHXNHiW+wxeMKWA91BD813csEgIlq8maJr4ElgOY1lXLKryp/+FbxXuLa7t/C40S7KYn ubqOERh80W/AMXlyRVE6iZuWbRVxNfyu/qHYYObSBJeBAjx+tHaCI+P4AXQlszLeS33B 4RTPWtw48ZttzaklqYl6Ncjv+aOws80gkHaO/hFHq36lSzmBsOxiaJiLS9CFObMIvEnU tuYQ== X-Gm-Message-State: AOAM533i/TF79nKAs53cEfz08ENW7qgOneEz638choz26eZ37sEaes5B 8r/h36e1+kOjXA+kQ3f0hmtA6Xgz7kv9mw== X-Google-Smtp-Source: ABdhPJzB8Uzo2vxNuj86Wxa9N8o/t3qXnr96rEEZ681vCmWdbNuDWUrv/4USL/eJpw4r0IYagQJNlw== X-Received: by 2002:adf:dccd:: with SMTP id x13mr4527492wrm.403.1600942120977; Thu, 24 Sep 2020 03:08:40 -0700 (PDT) Received: from CBGR90WXYV0 (host86-176-94-160.range86-176.btcentralplus.com. [86.176.94.160]) by smtp.gmail.com with ESMTPSA id h3sm3267314wrq.0.2020.09.24.03.08.39 (version=TLS1_2 cipher=ECDHE-ECDSA-AES128-GCM-SHA256 bits=128/128); Thu, 24 Sep 2020 03:08:40 -0700 (PDT) From: Paul Durrant X-Google-Original-From: "Paul Durrant" To: "'Andrew Cooper'" , "'Xen-devel'" Cc: "'George Dunlap'" , "'Ian Jackson'" , "'Jan Beulich'" , "'Stefano Stabellini'" , "'Wei Liu'" , "'Julien Grall'" , =?utf-8?Q?'Micha=C5=82_Leszczy=C5=84ski'?= , "'Hubert Jasudowicz'" , "'Tamas K Lengyel'" References: <20200922182444.12350-1-andrew.cooper3@citrix.com> <20200922182444.12350-7-andrew.cooper3@citrix.com> In-Reply-To: <20200922182444.12350-7-andrew.cooper3@citrix.com> Subject: RE: [PATCH v2 06/11] xen/memory: Clarify the XENMEM_acquire_resource ABI description Date: Thu, 24 Sep 2020 11:08:39 +0100 Message-ID: <003c01d6925a$ad0d99f0$0728cdd0$@xen.org> MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable X-Mailer: Microsoft Outlook 16.0 Content-Language: en-gb Thread-Index: AQIFh6M/JBUQh1P0MghANJzmhArOyAJ/cLEsqQWqE0A= X-BeenThere: xen-devel@lists.xenproject.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Xen developer discussion List-Unsubscribe: , List-Post: List-Help: List-Subscribe: , Reply-To: paul@xen.org Errors-To: xen-devel-bounces@lists.xenproject.org Sender: "Xen-devel" > -----Original Message----- > From: Andrew Cooper > Sent: 22 September 2020 19:25 > To: Xen-devel > Cc: Andrew Cooper ; George Dunlap = ; Ian > Jackson ; Jan Beulich ; Stefano = Stabellini > ; Wei Liu ; Julien Grall = ; Paul Durrant > ; Micha=C5=82 Leszczy=C5=84ski = ; Hubert Jasudowicz > ; Tamas K Lengyel > Subject: [PATCH v2 06/11] xen/memory: Clarify the = XENMEM_acquire_resource ABI description >=20 > This is how similar operations already operate, compatible with the = sole > implementation (in Linux), and explicitly gives us some flexibility. >=20 > Signed-off-by: Andrew Cooper Reviewed-by: Paul Durrant > --- > CC: George Dunlap > CC: Ian Jackson > CC: Jan Beulich > CC: Stefano Stabellini > CC: Wei Liu > CC: Julien Grall > CC: Paul Durrant > CC: Micha=C5=82 Leszczy=C5=84ski > CC: Hubert Jasudowicz > CC: Tamas K Lengyel > --- > xen/include/public/memory.h | 7 +++++-- > 1 file changed, 5 insertions(+), 2 deletions(-) >=20 > diff --git a/xen/include/public/memory.h b/xen/include/public/memory.h > index d7eb34f167..c4c47a0b38 100644 > --- a/xen/include/public/memory.h > +++ b/xen/include/public/memory.h > @@ -642,6 +642,7 @@ struct xen_mem_acquire_resource { > * IN/OUT > * > * As an IN parameter number of frames of the resource to be = mapped. > + * This value may be updated during the course of the operation. > * > * When frame_list is NULL and nr_frames is 0, this is = interpreted as a > * request for the size of the resource, which shall be returned = in the > @@ -656,7 +657,8 @@ struct xen_mem_acquire_resource { > uint32_t pad; > /* > * IN - the index of the initial frame to be mapped. This = parameter > - * is ignored if nr_frames is 0. > + * is ignored if nr_frames is 0. This value may be updated > + * during the course of the operation. > */ > uint64_t frame; >=20 > @@ -672,7 +674,8 @@ struct xen_mem_acquire_resource { > * If -EIO is returned then the frame_list has only been > * partially mapped and it is up to the caller to unmap = all > * the GFNs. > - * This parameter may be NULL if nr_frames is 0. > + * This parameter may be NULL if nr_frames is 0. This > + * value may be updated during the course of the = operation. > */ > XEN_GUEST_HANDLE(xen_pfn_t) frame_list; > }; > -- > 2.11.0