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 8958EC77B7C for ; Tue, 24 Jun 2025 13:39:33 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id D5F4B6B008A; Tue, 24 Jun 2025 09:39:32 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id D10476B00AE; Tue, 24 Jun 2025 09:39:32 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id BD7976B00AF; Tue, 24 Jun 2025 09:39:32 -0400 (EDT) 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 A623D6B008A for ; Tue, 24 Jun 2025 09:39:32 -0400 (EDT) Received: from smtpin05.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay10.hostedemail.com (Postfix) with ESMTP id 429C9C089A for ; Tue, 24 Jun 2025 13:39:32 +0000 (UTC) X-FDA: 83590401384.05.D7C171B Received: from mail-wr1-f50.google.com (mail-wr1-f50.google.com [209.85.221.50]) by imf17.hostedemail.com (Postfix) with ESMTP id 5BE4040012 for ; Tue, 24 Jun 2025 13:39:30 +0000 (UTC) Authentication-Results: imf17.hostedemail.com; dkim=pass header.d=suse.com header.s=google header.b=G62mhpM4; spf=pass (imf17.hostedemail.com: domain of ptesarik@suse.com designates 209.85.221.50 as permitted sender) smtp.mailfrom=ptesarik@suse.com; dmarc=pass (policy=quarantine) header.from=suse.com ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1750772370; 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-transfer-encoding:content-transfer-encoding: in-reply-to:references:dkim-signature; bh=fxjDIBXMuvdPXWJmF9qZYgeWhojZt27wnvO4wkpwI2w=; b=R+2HqiUgJCW/wIjd7gkk3M59bMDqHnhTBcB9khPzVnhaBCWioOr5PjxhZ4m8EImraFvpv5 dHJlBXXJb32noxgz+9K4NCtZG1x11JeD5/MtTv+ZmS1OswQOAfwFDk5lxB3DYQKkkteT/X 9hucSWynvkvQ/nhWVXItVkeptI4iRHQ= ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1750772370; a=rsa-sha256; cv=none; b=f3jqlAEqnWVwxxyoCNGIjbR/ww/ps2ohC1Zed7yvsul72q9ghP1vFk39vaNh4iGiZLB+48 K4HuygGX4gM2GbV9UAuc5PTwMuEBsuTDjmKMLNTgExGuu5D3eb3cqhbM289C8fkIpsVWz1 wcjkiAHo8cntqnv3WF482yeDnh3VshI= ARC-Authentication-Results: i=1; imf17.hostedemail.com; dkim=pass header.d=suse.com header.s=google header.b=G62mhpM4; spf=pass (imf17.hostedemail.com: domain of ptesarik@suse.com designates 209.85.221.50 as permitted sender) smtp.mailfrom=ptesarik@suse.com; dmarc=pass (policy=quarantine) header.from=suse.com Received: by mail-wr1-f50.google.com with SMTP id ffacd0b85a97d-3a52878d37aso814963f8f.2 for ; Tue, 24 Jun 2025 06:39:29 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=suse.com; s=google; t=1750772369; x=1751377169; darn=kvack.org; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:from:to:cc:subject:date:message-id:reply-to; bh=fxjDIBXMuvdPXWJmF9qZYgeWhojZt27wnvO4wkpwI2w=; b=G62mhpM49UMA3gQ6sfx9+S1PZiUx6qolZdS/2KUxq7c3hTxJ8HfkHXaKFEdCWqx9ho PmgCxvxmmlSqEqMBGIqVPSV0P6zVtx0i3Y3UCdB3mgmflxrMfNyYYzOl2z2ceiYoINbB mpFIZDdbpKBkHGz8bVHLZ6E3oxkyZBwBx9paiwZvgoPcCoyTmcBXhilOeT4y7IwlA1FB grP/7wKwooKD9/N1wJgsGse4XLpPGdQC+X2sF+cJRFpqIDtcrAXN38YGDh4I6+B9BYMd Nc0vjFaOPxiVAfxGDuKEdH8P85htVv6KtQN8T/Wqz04m2qFZ8UiRWj9sxsi+cATL29ZS skww== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1750772369; x=1751377169; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:x-gm-message-state:from:to:cc:subject:date:message-id :reply-to; bh=fxjDIBXMuvdPXWJmF9qZYgeWhojZt27wnvO4wkpwI2w=; b=HrgAZvHsueqFANOdnv1X2+jSjiO+Ud6zE4UowlT1iEOb7LkPRJegY0mNZ2pT+c7EGF 1AlJKO6yQPYEdj/V201Ckgs5k3cbVfWvREh8QSALIp6UGuOMW6OFUVopIUvQceFtwf65 wZEFjkw4Dddj9dzl/kschjfSrPvVeeZNwUg+1fQDDpVEixg923j62Am5Ufs4YO0L9A0g SuFu0YOBgzcRpgPJk5bTSy3tJjmEau7Z7h041tmtW9NqJVXvqCBDBr3fF196Y2oxRFTS roDKaXTwsFNDSKsyverit2YVtLJNrO6PfroQ6UJAV1QUKt8K8bH+aMbIGMi0bqmBMTnX JeXQ== X-Forwarded-Encrypted: i=1; AJvYcCVnV/nC4p1hLjri56pGI1T+wLQhW9NaDdTWSIKiN2ipp/UxJ9LpjyNcUUQAM74EvncSUeVjVGHJVw==@kvack.org X-Gm-Message-State: AOJu0YySjub68sk5OgoPybjyMyC2l4li5XVszfRz2KmsxJovrM0vetMm GDJGp5YuqpZ5fMfeKYCzjvkPYMcJ3s9hDbyIstCFH41XcVwycNrdqGZhoe/VD5yBvzc= X-Gm-Gg: ASbGncs0P20bMl77BFb085UbHH+T4QDw54/UOM7pgQElrOp3LMIJoYj4Uk9ZFUPtOQB iZxApHgEsOpO5PLIgkSl+bqnNPHTE9FgZ2ry5PgzEa1e+S+V33QdCFMWokUvs/Qeig2v1oy6aNu YIas5a7xdRBvQrBkIrG5hB/9P3JkIlwQML2RfrqX3kIuUZ/4VkcScozTmA5Sb3aQz1+MGMAfjcd qJ3jywj9d0juRLa0jWPJXEcFIhDQq98bqT+Qug/ncRB5GQqQSvH7B4EOVN7PtdPgYfng/F/Gu+5 WdRyTdx6iI3e3KPbR4GMGAbYHtxjWiDJWee8wiQz5Ui1jHGpM/oKZ8Orebox66dJgs98zwLocri 7VTls1T/f9OIh2b+Wsj8PclZylGU9u1xfwILSka6RfkMFqKsQw17m X-Google-Smtp-Source: AGHT+IHQyrO4iqMSd7VpKmuXfo0VLyy363LPzuPbS8DTxE31tKkFh26zo1Cks2a5Rs5oGEGjiBKI2A== X-Received: by 2002:a05:6000:2211:b0:3a5:7875:576 with SMTP id ffacd0b85a97d-3a6d12d737bmr4870971f8f.1.1750772368675; Tue, 24 Jun 2025 06:39:28 -0700 (PDT) Received: from localhost (dynamic-2a00-1028-83b8-1e7a-3010-3bd6-8521-caf1.ipv6.o2.cz. [2a00:1028:83b8:1e7a:3010:3bd6:8521:caf1]) by smtp.gmail.com with UTF8SMTPSA id ffacd0b85a97d-3a6e805e828sm2040400f8f.32.2025.06.24.06.39.27 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 24 Jun 2025 06:39:28 -0700 (PDT) From: Petr Tesarik To: Jonathan Corbet , Morton Cc: Marek Szyprowski , Leon Romanovsky , Keith Busch , Caleb Sander Mateos , Sagi Grimberg , Jens Axboe , John Garry , linux-doc@vger.kernel.org (open list:DOCUMENTATION), linux-kernel@vger.kernel.org (open list), linux-mm@kvack.org (open list:MEMORY MANAGEMENT), Petr Tesarik Subject: [PATCH 0/8] update DMA API documentation Date: Tue, 24 Jun 2025 15:39:15 +0200 Message-ID: <20250624133923.1140421-1-ptesarik@suse.com> X-Mailer: git-send-email 2.49.0 MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Rspamd-Server: rspam12 X-Rspamd-Queue-Id: 5BE4040012 X-Stat-Signature: mjk97u6opd8mt6xaprj6hsbtg7yh3tbr X-Rspam-User: X-HE-Tag: 1750772370-868384 X-HE-Meta: U2FsdGVkX19hYR/frP6pgt0XlOBcKNlTdGxgwcX0ZuUHXgaGUyZWKYuYme7/s98SVWVKawRTJ0RRmPcQ3A18CDixS8JMy6uVAT2e5qpS2/ma1saG5C+b08Ib5g6DwJdbGdlhzV8a3wsoG2cCLrBPSc34UrlVyfRAt29Vv/M/WOWYx9R9oa8fnjW/Ew4bOiNfyDxlB3hlrROb2j833dtS8q3QUqQfFdxgZWiQ8DoQvUzHXKomN56tGDzMAIcGE8RiF5BMFO/GKpC1ZfJ9U/t6SxB5Ai8HzX9ssEfFuGMXZZMijVmddFw07B03dBaUmm63VS2a+CnVi75M/x/uBGqUGUWvTeVmGq9ABhiyMtczq6Spmxy738KYgGpQ+68KNwpvLOR8y4K9dpYSPoCAxZHVIUfpo21iEXDLITHLRrtd4IpN22/o+y8hGd2cJwq89NVs8prNqgcmyD2Km5jXKHjf0GZklTIXrfPk0hTtVghdq4QpCjvCL1W7QWqLHd0lojZnL/kwxVy3lrkUb6SB96SquTIkGKjvUT4fjUyCGax7IjC6R6BEc/niF9CEsUP+vdkHSa2ph691MvGiKRi+pb0PoX/K5Omsgqq8VGXUr1nQQBx78SRGVo9+y1ESukBu3Ne1jfyJjKlPVHDNtwHV32eTOKm8kPF5GOX16porHTwayH1KYIIcAND3kor5mouClVttogohdRmOaUGTd8NSYeSHyf6clmjSU/q8uG5QtuygTTMXMAKilDelltKmlX1qfRwQDWasgCSiijuaTbOhugUg+Nx+pq4bJB7Ibih08ZU0NSOf6Z/rqGVcPQbPQeOmwuFlPskdCSgT0xzulAv0sX8/Yqx7eX3bnVAOVDtPPnfHZjZROLgC15Qqdub/uqMaVH1gQzmykgK0nMsGt9d+rmAgS87MKaa0tMNDuEO07hjChvb0KEyAxwa1BDm3P/CnH4mm8NLY0wURb7U9asGzWeL xiHH/btk aGH3e/YcUz/elqZU+pYiEjorpMw== 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: A few documentation updates: * remove outdated and confusing parts * reduce duplicates * update streaming DMA API expectations 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 API physical address constraints docs: dma-api: clean up documentation of dma_map_sg() Documentation/core-api/dma-api-howto.rst | 36 ++--- Documentation/core-api/dma-api.rst | 173 +++++++---------------- Documentation/core-api/mm-api.rst | 4 + include/linux/dmapool.h | 8 ++ mm/dmapool.c | 6 +- 5 files changed, 85 insertions(+), 142 deletions(-) -- 2.49.0