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 5F428D12D51 for ; Mon, 11 Nov 2024 14:59:32 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id C5F476B007B; Mon, 11 Nov 2024 09:59:31 -0500 (EST) Received: by kanga.kvack.org (Postfix, from userid 40) id C0F766B0083; Mon, 11 Nov 2024 09:59:31 -0500 (EST) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id AB0256B0085; Mon, 11 Nov 2024 09:59:31 -0500 (EST) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0010.hostedemail.com [216.40.44.10]) by kanga.kvack.org (Postfix) with ESMTP id 901036B007B for ; Mon, 11 Nov 2024 09:59:31 -0500 (EST) Received: from smtpin22.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay03.hostedemail.com (Postfix) with ESMTP id 4A19FA17E5 for ; Mon, 11 Nov 2024 14:59:31 +0000 (UTC) X-FDA: 82774121724.22.2951DD7 Received: from ms.lwn.net (ms.lwn.net [45.79.88.28]) by imf01.hostedemail.com (Postfix) with ESMTP id C79B54000A for ; Mon, 11 Nov 2024 14:58:57 +0000 (UTC) Authentication-Results: imf01.hostedemail.com; dkim=pass header.d=lwn.net header.s=20201203 header.b=U7Qof0wu; spf=pass (imf01.hostedemail.com: domain of corbet@lwn.net designates 45.79.88.28 as permitted sender) smtp.mailfrom=corbet@lwn.net; dmarc=pass (policy=none) header.from=lwn.net ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1731337082; 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:content-transfer-encoding: in-reply-to:in-reply-to:references:references:dkim-signature; bh=GwVTmx4eIglWLWGHYmk31OoK5pzNvXaKVe73vYEWSTk=; b=hIKQLjZXDpBNkR6oC95yAbCkAUOkCMqERDNhbnjSvaGOfWEruMn84npWpBLBAdHNG81S3F MR2dRarKp7OjR4B6TAlcA6tqfs7J99ks+qALDq7wNpUk7nxgCmuL5GuyXhFfRKLmj9RMXQ Udnldsrp6bdBI+hi1QuesYZnESXB5GM= ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1731337082; a=rsa-sha256; cv=none; b=T0k5ZPkwk3Z6SFlZBBAGRotpWvIaThwfQH8rcyKOnSkKhDoZl9SKGOuMsI1Bm2eCKGN9kT pKI4+UgdBs2om9mV9Ty/ug9sTjLW2sUII5KmbWHQhIlfnEU6jSlP9xEhvpPEIXVyvCPWRM OLy9TqTR3TRxSwIghAJj4htojvPaliM= ARC-Authentication-Results: i=1; imf01.hostedemail.com; dkim=pass header.d=lwn.net header.s=20201203 header.b=U7Qof0wu; spf=pass (imf01.hostedemail.com: domain of corbet@lwn.net designates 45.79.88.28 as permitted sender) smtp.mailfrom=corbet@lwn.net; dmarc=pass (policy=none) header.from=lwn.net DKIM-Filter: OpenDKIM Filter v2.11.0 ms.lwn.net 45E36403F1 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=lwn.net; s=20201203; t=1731337167; bh=GwVTmx4eIglWLWGHYmk31OoK5pzNvXaKVe73vYEWSTk=; h=From:To:Cc:Subject:In-Reply-To:References:Date:From; b=U7Qof0wuVnJGcnP06ChHK+MJPNdREQXE7RLUzC2W70ULBaY9a9VnJ9vQEtqDAf9Ah A3HwpVCu8PJVyEMghvrqu/hNDOC8sGYBt3mN173rM33gAFqU2dKpLTqp9ac4bjnapP A1UN+AgpzI588tU7KIuantdLBUeWBgXdiFu11n7kGDH4ZxFGW1T97qYFC9t3FAzyYo fgA7YQdK+SYmrHtsukzfx/wT5vFef/DoXSOK38XKAVdsxtI+fq2uPWuv8CV5NUKrxx iQj4S70o2yK54j7jT8p8fewkBThJBXMBi2CZoLIkGaK5OJDLnfOOJSXDckk3X1rExZ HhL9BYc+PyPqw== Received: from localhost (unknown [IPv6:2601:280:5e00:625::1fe]) (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 ms.lwn.net (Postfix) with ESMTPSA id 45E36403F1; Mon, 11 Nov 2024 14:59:27 +0000 (UTC) From: Jonathan Corbet To: anish kumar , Christoph Hellwig Cc: Leon Romanovsky , Jens Axboe , Jason Gunthorpe , Robin Murphy , Joerg Roedel , Will Deacon , Sagi Grimberg , Keith Busch , Bjorn Helgaas , Logan Gunthorpe , Yishai Hadas , Shameer Kolothum , Kevin Tian , Alex Williamson , Marek Szyprowski , =?utf-8?B?SsOpcsO0bWU=?= Glisse , Andrew Morton , 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 In-Reply-To: References: <881ef0bcf9aa971e995fbdd00776c5140a7b5b3d.1730298502.git.leon@kernel.org> <87ttchwmde.fsf@trenco.lwn.net> <20241108200355.GC189042@unreal> <87h68hwkk8.fsf@trenco.lwn.net> <20241108202736.GD189042@unreal> <20241110104130.GA19265@unreal> <20241111063847.GB23992@lst.de> Date: Mon, 11 Nov 2024 07:59:26 -0700 Message-ID: <87o72lu88h.fsf@trenco.lwn.net> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Rspamd-Server: rspam10 X-Stat-Signature: qtti5d3y5usa5r57mupdj3tzjepshmw5 X-Rspamd-Queue-Id: C79B54000A X-Rspam-User: X-HE-Tag: 1731337137-606851 X-HE-Meta: U2FsdGVkX1/sgeULVWVI3IzHl6RbDbn0JEOiELsWttsFWwxpsBR11HkS6IUA8WqJsA7DjdkUaPmLNqUOL7VXxQ1RjV0/i0uQ3dOgIxIWxapspMjRwcPkkpNGDi4PWuqvncHLddte1baw5T/R9v7EsIOmqnZ6fTwpZxxVKlc37bTKSwg97Q0fO9R7yJ19vgQAjLIi9ywRPnctN2UTqQCPZQzXbGqi+xtU4ULviAmfAPtGjeeW7b1+X7phW0+5nnTJod7fALy39WlaOIoDKfzA3j7/juuDH/yRFjeOKyRZsvkc90pq/scGQ1x2PBZ6UO218QPHyJ5wCcWtg+DahW5MbUM184fSiyBe7edTYAKlKs5BY5SunP8VEF5nqOoEGzm6A1aGEENSjHAz+YgEmoDpEZLvwBpXow8d7QyqHbVFlhNMAYZSeMLt6CsxgCRQuCzXclctHoOZsx030vMt/iia1XzqHpy6g9bzEtys9ainqsvkrrcK8UNB9JfAj+u6xV/ezFjMm1ue0LDCIeLOhvBBe1BsAG4ofCTn0ScU0+GThDbO1ywwL/eDV8nNIwJsg46/H3YDB3yDamMGPDhhX/Ca9lfOcm2VV+S3GmoKUM+aQiHJC2fqh44SGIQrgqqF+V/SvkNpHpe7lVqUO0DpVF1HXygKwS+hEHkqfbf8gvv55R8hEiQlKlHAxr1inX2W76CTtcuUjsNxEUCn2aLy7gYNDRFo0fSKw5LWuE8bQhYjd4RG4rgmCEk91WbzT6tTfQ493k3h5vusmJBrPIT/uPLAGEMz5yfK4S/6YIQv1UKhVmZ7jgAwXFhAYxl5QEjqLnNqjxDbQarhWwSi+31ynRtMm2dFUkU787S3qAlaw2SZ2ISIxJyUhlRIp22Pp0GRbozM88rRHVVOaUiWplx0OWO3QnuUkncZ9WJX2yWsnW7mPSY9F9d3+cJCkTaioKEoW7RR5x2sIJHPQa6IYeq3RSe P04a9d+0 9jwPHgfJeJqNN26KW+7+5n/Y+69S7dmyU2812UujT8BWRhZY0Ue9QFf5DlWQ6N74RcnsbGT/wT+gJJJO7KgtkXBNnyfwCHHs/cTXn+iRyHwHBGRF2qTCQodrvxeqQMOOPsdM2BVhvLrVU6ODkuQkS90LeZ2S4IYTHKQ9RiV78bZS3ejnN5t1R0CbmHZaetubYPxhBuTK3UutWaCPOv0ZNn8H2wFylm3TcBHCF6yE9KycqOCc0VmbQlVLYkicXWHMMEVC9KjMmtQc1oF4MqJjdj15LJMbtWDusXF7t+5nvfKzSAAwsOrtj4UhLt23TrilB97w/ 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: anish kumar writes: > On Sun, Nov 10, 2024 at 10:39=E2=80=AFPM Christoph Hellwig w= rote: >> >> On Sun, Nov 10, 2024 at 12:41:30PM +0200, Leon Romanovsky wrote: >> > I tried this today and the output (HTML) in the new section looks >> > so different from the rest of dma-api.rst that I lean to leave >> > the current doc implementation as is. >> >> Yeah. The whole DMA API documentation shows it's age and could use >> a major revamp, but for now I'd prefer to stick to the way it is done. >> >> If we have any volunteers for bringing it up to standards I'd be glad >> to help with input and review. > > Jonathan, if you agree, I can take this up? I am happy to see help with the documentation, but agreement from the authors and maintainers of the DMA-mapping documentation is rather more important than agreement from me. jon