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 E6751E6B278 for ; Fri, 1 Nov 2024 13:56:56 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 759AC6B0096; Fri, 1 Nov 2024 09:56:56 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id 6E3316B00A4; Fri, 1 Nov 2024 09:56:56 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 55F486B00BB; Fri, 1 Nov 2024 09:56:56 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0016.hostedemail.com [216.40.44.16]) by kanga.kvack.org (Postfix) with ESMTP id 395F76B0096 for ; Fri, 1 Nov 2024 09:56:56 -0400 (EDT) Received: from smtpin02.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay02.hostedemail.com (Postfix) with ESMTP id DFB491202B5 for ; Fri, 1 Nov 2024 13:56:55 +0000 (UTC) X-FDA: 82737676896.02.490E068 Received: from dfw.source.kernel.org (dfw.source.kernel.org [139.178.84.217]) by imf03.hostedemail.com (Postfix) with ESMTP id 30FCF20007 for ; Fri, 1 Nov 2024 13:56:41 +0000 (UTC) Authentication-Results: imf03.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=YSE0qfi9; spf=pass (imf03.hostedemail.com: domain of leon@kernel.org designates 139.178.84.217 as permitted sender) smtp.mailfrom=leon@kernel.org; dmarc=pass (policy=quarantine) header.from=kernel.org ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1730469368; 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=fPdzghOCCuw7btylJtg39ro/fYH6tFP/dvjwHa8zWMM=; b=8hOVVpiDUUk0i4gvf2bqB51Pt4o+834MihH67zXo1fZdJ1h+S/IRnkm4ohyE2qhMY8iMAc bq4qefYRbGj19WSD4oNU1HYePk8Lk9gY6Ra9C/HxtvE/eWXRMbQ09kNfA9qcmgbGv6s9hs xYBGfoXum3/lGcmw/pwwSMPMJnGzcbA= ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1730469368; a=rsa-sha256; cv=none; b=2iRq4N8G7InVJUYFOkbaHaLA5VIvpVjywsEJSwZlpHPXRe0FdpjfsEPi5PWLzESzAJjELo zCfZ3udOHMTsrvvG7ECuYjNnRBOwhu5J0r2p/Bv8CrjfpoUCKj/HYlmpeR8d2u2ZTUTGqo SO/NM1sV8ptZ2V9knKquOy0utPR+6Eo= ARC-Authentication-Results: i=1; imf03.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=YSE0qfi9; spf=pass (imf03.hostedemail.com: domain of leon@kernel.org designates 139.178.84.217 as permitted sender) smtp.mailfrom=leon@kernel.org; dmarc=pass (policy=quarantine) header.from=kernel.org Received: from smtp.kernel.org (transwarp.subspace.kernel.org [100.75.92.58]) by dfw.source.kernel.org (Postfix) with ESMTP id 580F05C87E1; Thu, 31 Oct 2024 07:58:49 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 31A22C4CEC3; Thu, 31 Oct 2024 07:59:33 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1730361574; bh=r4WvFfTJfMdRUmFzrlSoIGEf8BKQg/IhRD4qnokJQvg=; h=Date:From:To:Cc:Subject:References:In-Reply-To:From; b=YSE0qfi9lLOBn1EH9BGdBYxYLpBIBHIK0QaNCb5Z2f/3ZU0SiPGduT5S8BZpZzVhE QsE8znEvky7HGyINHWNHZtUimXc0OyWjetPBBGPw4IpeX6whHRZ0Squq75I9D2OXoh Dj4A2PcDjtD53WxZ8CfoENNGNXS3uZ1vTjYJ05qe8rdIM0RAaKg01VZUsT2btH90gN 3IfJ20Y+iAFHW1y+lpY5HZMEPNs5tEjpoTUkB7qMwux7hxpqN1+o4tJ7RVpOBKxrIT w9KRIYFGI2KFLA4w2wF7IkinK0w9y+ewKYwfXPBFWw7JG53t4IL192NVOKYAlQAK8j 0+j+mdz3I8PxQ== Date: Thu, 31 Oct 2024 09:59:28 +0200 From: Leon Romanovsky To: Randy Dunlap Cc: Jens Axboe , Jason Gunthorpe , Robin Murphy , Joerg Roedel , Will Deacon , Christoph Hellwig , Sagi Grimberg , Keith Busch , Bjorn Helgaas , Logan Gunthorpe , Yishai Hadas , Shameer Kolothum , Kevin Tian , Alex Williamson , Marek Szyprowski , =?iso-8859-1?B?Suly9G1l?= Glisse , Andrew Morton , Jonathan Corbet , linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, linux-block@vger.kernel.org, linux-rdma@vger.kernel.org, iommu@lists.linux.dev, linux-nvme@lists.infradead.org, linux-pci@vger.kernel.org, kvm@vger.kernel.org, linux-mm@kvack.org Subject: Re: [PATCH v1 09/17] docs: core-api: document the IOVA-based API Message-ID: <20241031075928.GA7473@unreal> References: <881ef0bcf9aa971e995fbdd00776c5140a7b5b3d.1730298502.git.leon@kernel.org> <19cf7d58-4a28-4ce8-9524-8c99fdc79062@infradead.org> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <19cf7d58-4a28-4ce8-9524-8c99fdc79062@infradead.org> X-Stat-Signature: 7b7esn558p3kuxzuyar4y78qdb8gasgf X-Rspam-User: X-Rspamd-Queue-Id: 30FCF20007 X-Rspamd-Server: rspam02 X-HE-Tag: 1730469401-949068 X-HE-Meta: U2FsdGVkX1+R8IyZ4ortXbea048+5NkQWJEhjX5hB3B0KUHTdWBRvh8Lw83ye87gTrGQaXyh2UaUjBX+ocWuC+oV9Hs5bdQJHpJotT2+DYrO/Ea7HFteRWfai0+eIDyeyh4eS4BxuLFtBZzFCuD6h87g0HpMt2prGDNqYTygyfe9CZeUIvMDvoVIaCqWYq32vHWAp7KkVIHH1Zs37Pfo0Zfu0uMTZub5I/zyHUPxkzQZnFTfqvSUZ8RzIbJh+0pMmIfMl3/G48Bo11euQtKvOlOQJc1gNCfSzrgifhyK5OBi1Qt5L1IJicUHw6mRZN9bNzShHz2i9IAEbkeLBLenHDFP4bycH2WyMMvXTS3z4i4sfKaJQQytgJbLs44TA/MTojw7cMiJk3V+/jHjiYneCOz0woVAs0Z6C+ipBP2tT+QUyQUqyRLbncweU2eq/QtR7UQt1hGkdhYf5jswTFjgvikRZO5+VWH7PzWbdTOMGA9sKz9b0/ASghrnfMJMruet/ekYikCP3m0e/l2YNCYdN2Nv79weB8B0WR8mpk8g55PymAvWidB6NiMtCnDWheFfIqjB34g0PNWl+dxpVj/RCn93rDxQucrXGW4C1aVEfoo5WPcQGDYybcrAkELKFuDbCvYBYVLeGZAUiRDviVeW8hjnGMLASV6JvmmMsbJLQggNCHiO7QnabqOtYN6fSExE9D2f3LK63guecMxGQJ+AX+CDNWHW33O765DwuhXa85Fwblc/iZ+D8xqIpFIMa4bgHPOyS5s/beK1wkS9EEsPkac+2x438i/jBprCr+8efqBxqPWSEMfWxg0CodNCf9OgCSQ7UMIUXjJSfVPwtfPOmuRWIj/1S89ykuVw3/gdSoK57N2w4tRs+/fBYBxtVpql0ga96PuA61TFmG7r5KB2ChQCk/mYZWejte9gDeUmQ1Vf7WvMUlKYCqJOxWWZ040OcQXgBmePP+ojHecmtDg FlDJW4dG bjviMd+FBRSEV5Mly33e3ACElj4bV2LxMONTjKQhoJ6gsLenKwKCdnVTg9rXHICEdigpYFl0s+iM4Op38QX/RX6uCdcqlWYpBydi49aO8DRKeW34lPjnCl/n2mEwNiJ22kLMj0v408wkqSJfrsKKBtwrTuRV5C7vmRds4qfYgASocwarfBYlLmOklx7iITiu1opQl/irzyyELiOvtucmo+FgnpAVgVWI/5igccMAOj2rMfLmWMwUmMm58EB/kiWi8RLf4wq/ElLqxCQL3faPT2wqbzbzvlD/7jIeoOvZclb4QGzHQCB9icXeFEw== 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 Wed, Oct 30, 2024 at 06:41:21PM -0700, Randy Dunlap wrote: > (nits) > > On 10/30/24 8:12 AM, Leon Romanovsky wrote: > > From: Christoph Hellwig > > > > Add an explanation of the newly added IOVA-based mapping API. > > > > Signed-off-by: Christoph Hellwig > > Signed-off-by: Leon Romanovsky > > --- > > Documentation/core-api/dma-api.rst | 70 ++++++++++++++++++++++++++++++ > > 1 file changed, 70 insertions(+) <...> > > +These APIs allow a very efficient mapping when using an IOMMU. They are an > > +optional path that requires extra code and are only recommended for drivers > > +where DMA mapping performance, or the space usage for storing the DMA addresses > > +matter. All the consideration from the previous section apply here as well. > > considerations <...> > > +is used to unmap a range previous mapped, and > > previously Thanks