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 2807CC83038 for ; Tue, 1 Jul 2025 19:53:38 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id AC1286B00B8; Tue, 1 Jul 2025 15:53:37 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id A72F06B00BA; Tue, 1 Jul 2025 15:53:37 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 9877C6B00BC; Tue, 1 Jul 2025 15:53:37 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0011.hostedemail.com [216.40.44.11]) by kanga.kvack.org (Postfix) with ESMTP id 85AB86B00B8 for ; Tue, 1 Jul 2025 15:53:37 -0400 (EDT) Received: from smtpin30.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay10.hostedemail.com (Postfix) with ESMTP id E5E99C05F1 for ; Tue, 1 Jul 2025 19:53:36 +0000 (UTC) X-FDA: 83616745632.30.DB058E3 Received: from ms.lwn.net (ms.lwn.net [45.79.88.28]) by imf14.hostedemail.com (Postfix) with ESMTP id 523ED100005 for ; Tue, 1 Jul 2025 19:53:35 +0000 (UTC) Authentication-Results: imf14.hostedemail.com; dkim=pass header.d=lwn.net header.s=20201203 header.b=QgndKRvi; spf=pass (imf14.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=1751399615; 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=y0sLUQ1C5YQs1dUp/IT5tY58RMmgyjuJ+9hflrM8yMY=; b=5V+bemfNYJrOpwWD9axV6QPGpMUpcrmwhQLAl1coocv/LV35/kJFejjKQYcBEBlb94BesD JrGY76nUpVq16Hsl92U33zH/FR3uN3j4DN+oZ0fJ7zRD2mZfijS4PafcT0VyXX2gQaX4pK uIeG3hmiZTJea1Cwi4C3i6NDtG+QSHA= ARC-Authentication-Results: i=1; imf14.hostedemail.com; dkim=pass header.d=lwn.net header.s=20201203 header.b=QgndKRvi; spf=pass (imf14.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-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1751399615; a=rsa-sha256; cv=none; b=MqN0JDakJRh/V1Dy7rUM60u5UBnXEC7ILzeNwqdf7D+easFh0uUSjPZhM++0Wrm/dJ9tU8 bDKwvMRZap8GvSY2dMZZaUQHOGlJ1dIZKXHw2K50wJaJkISLMYbJMGnM7aYinMr/bR9sAc JylN0UcSFNCrVr53sT0MXGCBzPym4Ec= DKIM-Filter: OpenDKIM Filter v2.11.0 ms.lwn.net 4AB44406FC DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=lwn.net; s=20201203; t=1751399613; bh=y0sLUQ1C5YQs1dUp/IT5tY58RMmgyjuJ+9hflrM8yMY=; h=From:To:Cc:Subject:In-Reply-To:References:Date:From; b=QgndKRvi38RE8TaqBdFQ+QjbFu0wA1qni3mUAOnDIeSX81fz6NjZbuJ9DAH0uK7bp DY8DknLvFl/xjJFz5LsMEon1S6FTCGw9OlgQ3uWEd2EVKH72SGtaplIY4mOlDPLbN4 kle7ADc1Zmqig+/MvQCAQzkpaO26l849eLz8NUOB1YdzPYQqOEoRuIK2KVfSvKFext orcbfooIxhfx2CRZOHy+i5L6vd6Xp+Vxvt9LwJs7rXc4c+bfp0nD+uJrVIj1W7jE91 v4pFFNd9ywq5oEw2xrF8e6tZL7bs+HPA2xQ7k6yk/pQlKB+QkO4xUpV1tcoj7eagYS 15HzI4jFkKZFQ== Received: from localhost (unknown [IPv6:2601:280:4600:2da9::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 4AB44406FC; Tue, 1 Jul 2025 19:53:33 +0000 (UTC) From: Jonathan Corbet To: Petr Tesarik , Randy Dunlap , Robin Murphy , Marek Szyprowski Cc: Andrew Morton , Keith Busch , Jens Axboe , Bagas Sanjaya , "open list:DOCUMENTATION" , open list , "open list:MEMORY MANAGEMENT" , Petr Tesarik Subject: Re: [PATCH v2 0/8] update DMA API documentation In-Reply-To: <20250627101015.1600042-1-ptesarik@suse.com> References: <20250627101015.1600042-1-ptesarik@suse.com> Date: Tue, 01 Jul 2025 13:53:32 -0600 Message-ID: <87cyajr8lf.fsf@trenco.lwn.net> MIME-Version: 1.0 Content-Type: text/plain X-Rspam-User: X-Rspamd-Server: rspam05 X-Rspamd-Queue-Id: 523ED100005 X-Stat-Signature: onb1ec5feacfseoskt85hroz6pcsm36q X-HE-Tag: 1751399615-704684 X-HE-Meta: U2FsdGVkX19SFkgaGyYGIITY7x6Ri/LTrnn68NGTW2t1O+b/utPw54XPMpryGqHkV/5aTA1PInHTUxVZ81h8Zh4avXHuiXvP4iu1IwR+2i/zKGn2WrjLMYPr7Q9LfXand152NBA9qe6VGum5rt8Wy2QYaBxqkh6ymTF1CJBf92Js5ygo++ZDXh7yBXNzAftwUa1CLnJoiRwQHyAnfVujhQIpIq4s69uGQde7Cpy+Co7YvsMyK5BDfXZchDnc+/19vziUoymVv0p/LZ0L3TTNStErbiRD0FxgWLS/OE0YwTij6ZkTXlwVz58oixj92njlJW2XEHUbEu/wESlBF7GesQeEHJhlCRZuXUINPXnEfCwGdGx/nmixmuM1O/uWYIxOYhcjsCvyxfjhBmyw9xT+CdrEuMXdYK0oJCgmL3kCL8xywo2iVqDVE0pLmTsB75hOI1i55e+EW5oJmMp05Jc8fkYVp+Z3ljPetnEIpwrXDEcbZV2BfB7OktXZQDMgKmbLFeSRoNDGT7ORWtFRH1e2Y1sqJlxPF2mKsE0StH52NoMk3vuqJsbL6aTyVelQF7vcUXX3K0fJA6uJhdwgMfFq/6CZZk1Ks8Zbxb89BvuKHONhXd6BmwiTQVMiiC7LLROl454QMg9oCIx17+lW8k+hKd/hs3zHWLCBuIOBb7uzHdSkn4uxfINbTObyPRFwmJbwQWXom/JZCgd5t5O+j6AecV6DGBo9hVEzsMkE6YCtjFBm1rndiodz4AbrybZ2WnnYW5wgkel0goXMcLycV0ogUqW+JTQ/dhg/RTSjw8zexxr+Cz1KnNLaujbyYoBQFTjFGUUAZhyGrQK8tK+8NBQfpjIx/S8DM+puqz+mZfCTTv66JGEDIz1fhebuLC2l8CE4R0Ka2N+ZN6ZtGDXdSr+3oEi2UbzNzyXgg9PEJsLAMS4xoibH3QFA9KyCByueCsfmNg6QJm3bbU14+J1SeBk 4ReUfypt RlM1F0Hy2gKAKgDg= 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: Petr Tesarik writes: > A few documentation updates: > > * remove outdated and confusing parts > * reduce duplicates > * update streaming DMA API expectations > > Changes from v1: > > * move DMA Pools to dma-api.rst > * improve streaming DMA addressing constraints > > Petr Tesarik (8): > docs: dma-api: use "DMA API" consistently throughout the document > docs: dma-api: replace consistent with coherent > docs: dma-api: remove remnants of PCI DMA API > docs: dma-api: add a kernel-doc comment for dma_pool_zalloc() > docs: dma-api: remove duplicate description of the DMA pool API > docs: dma-api: clarify DMA addressing limitations > docs: dma-api: update streaming DMA physical address constraints > docs: dma-api: clean up documentation of dma_map_sg() OK, I have applied these - thanks. jon