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 9C038C77B7F for ; Fri, 27 Jun 2025 10:10:22 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id F3EEC6B00C1; Fri, 27 Jun 2025 06:10:21 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id EEF796B00C2; Fri, 27 Jun 2025 06:10:21 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id E05956B00C3; Fri, 27 Jun 2025 06:10:21 -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 D30116B00C1 for ; Fri, 27 Jun 2025 06:10:21 -0400 (EDT) Received: from smtpin24.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay08.hostedemail.com (Postfix) with ESMTP id 5A4021405FA for ; Fri, 27 Jun 2025 10:10:21 +0000 (UTC) X-FDA: 83600760642.24.7320037 Received: from mail-wr1-f46.google.com (mail-wr1-f46.google.com [209.85.221.46]) by imf25.hostedemail.com (Postfix) with ESMTP id 636F2A000C for ; Fri, 27 Jun 2025 10:10:19 +0000 (UTC) Authentication-Results: imf25.hostedemail.com; dkim=pass header.d=suse.com header.s=google header.b=hD3szfKF; dmarc=pass (policy=quarantine) header.from=suse.com; spf=pass (imf25.hostedemail.com: domain of ptesarik@suse.com designates 209.85.221.46 as permitted sender) smtp.mailfrom=ptesarik@suse.com ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1751019019; a=rsa-sha256; cv=none; b=2OyG3dbHphOK5vWv8Zsu9ulzpMiCyFBCYgyVt4KpcHwROKdp9lqDtX61nVZQx17UdTn3Dy 7P4c4mqw33cI5nXGOINqsZShPaccmW59Z87S3N/5puUc9ZpsJmXeFOKoVVXfXfO1gVZG+k pcjWBWAAh9Li59apMcJZOeD9ranG2xE= ARC-Authentication-Results: i=1; imf25.hostedemail.com; dkim=pass header.d=suse.com header.s=google header.b=hD3szfKF; dmarc=pass (policy=quarantine) header.from=suse.com; spf=pass (imf25.hostedemail.com: domain of ptesarik@suse.com designates 209.85.221.46 as permitted sender) smtp.mailfrom=ptesarik@suse.com ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1751019019; 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=p2kHSsv+wfo3DML4q3PqZ9JAPNtZ/a1cxK7CHbHK+a0=; b=MIg5ZIMb/LzslQkbhQQ04BD8QlYeasxg4C5pT16Glo/DLRFhWyeJYyjUTs2tcM5rbS2ppT Yrkdn6tu3okHVWDEfPOqLd80G3M9XW8o08NPRdtIJ2bwMR8ZvD9MAzRHgxX27GaBZFwrg6 B+Jldi2zYTHhVSxmzWSu2zmXuSne30k= Received: by mail-wr1-f46.google.com with SMTP id ffacd0b85a97d-3a4eb4dfd8eso282901f8f.2 for ; Fri, 27 Jun 2025 03:10:19 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=suse.com; s=google; t=1751019018; x=1751623818; 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=p2kHSsv+wfo3DML4q3PqZ9JAPNtZ/a1cxK7CHbHK+a0=; b=hD3szfKFTAnYctprOqrEqwArWweCRG/pN938GZnsIMPZRDCW4535tSd+kBQM8I6seC lFbuJUXRVlm9SEMJ9Xuhf8/jy/moR1hUkhcvoAA8yFQN4BcdYZ+VMoGDSkDAR/55ExtX 7aGgk8W/LK6vFAfgMAxKnxCx4jBFadmHZzfNq+aiGA4BhiNhh0I8+jdKS1uiBe7oaLtP xcuMp2I1QkTNsGKahiVFlEBnLk52HjtGoCxpZQ325obgmTJHOkokE2GxxFKsG6vf9rb9 JC2NdVGJ0f96nZeuMXu1Ie03jVV5SPxTcwJCM0+9PJUebGbpebB9wW05WIuE1Eq2uBQ8 aK1Q== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1751019018; x=1751623818; 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=p2kHSsv+wfo3DML4q3PqZ9JAPNtZ/a1cxK7CHbHK+a0=; b=OefT0sWCG/8Q1aLVy7izVZsRY5WFGr0Wx7Qkj+8c87lgAyt7mjE034f+bH2IJiE1LT 7HwtYpSzUOT79DsbOHlO4Aq4ShHejpAt/ZFsOqERgDSUJCM7GWw7BoYs4pFVkyZbFTrq CZ44yrjeuHux4YLDpZu7sD9TTgqAxuvNuVZSXKBide+GvcxOr+pr/GlPrTvcJonvwMFx PMWAQy72toMKIWWQIzkqv4o7Fy2Unc1oD4onZcI1m2RJB3tqvNCET1sEalk2hoQ2SD5q SCm4F+WDmxfwIfceNs5Kz4pwPbQcENrsdFWIp0Lh/8oY8y5z5g2UZtjncGKyBBaFmFX/ E+CA== X-Forwarded-Encrypted: i=1; AJvYcCX7mAoeChgOvY4bDGOnZp1KOKXlvzWGI/p7hZjPOyfRy8GM897PmyvGNICALQqb7rdEmWqMOZJdKw==@kvack.org X-Gm-Message-State: AOJu0Yw6krht/C3eFOkF3BMxgygh+WhVBOCusaPeTzZQKLUWRY9utsRb +4FDvHkCL2eApFjugiIAW9muWcDbbO4BmN9BvIepVGpxoT/hRa+ZsAwSA2JFB1WroIs= X-Gm-Gg: ASbGncsr6V5EbI1mW2ofFm+88CmEeiHOFIVM/dUsWmJfu2KMx8HXWz/9pdYOmMGv90Q HA7pgZBX4wMACOkSrgd5grEpTsh2ix6zzhCzdOiU9EUfArQdnkyI1N46kOtAjRPUuFpf+Tnv5bk GyMiS4e2H80Wpj9KBagOxpT3dr/F+wGxgX2QRvrTprnEPu8E5Kp7h6VtpfeQqDOXQPqnsN1IDNe y4EFSY/JcwL5T68M/ErvG0Py/wX6PYO1czYVTuc4Rrt7t+U1SU++7FhXwHWcZ6UPaSZY5Vti584 6GRepmcYrgojsPe0LlLHFPZfUjvF9pT8V8Dgosv6hAMWy39FlPG35FXIC2fseLYDTmvAVFBs+Qo 3OVWxZI0hIDwFYaN8uwtIXheOr4Z0aDDcIFmZs2YHfwp7LEtwfblmZKm0i/AOrYw= X-Google-Smtp-Source: AGHT+IFVCTjSV+KDkAU40t12c+V1148+Xj9ejWeKM8rjPyQmHH2LgkyELVwiB8ZSxhmDLQhtUn+Ojg== X-Received: by 2002:adf:9ccb:0:b0:3a4:f7ae:7801 with SMTP id ffacd0b85a97d-3a8fe79bb3cmr805658f8f.8.1751019017581; Fri, 27 Jun 2025 03:10:17 -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-3a892e5f8absm2300301f8f.95.2025.06.27.03.10.16 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 27 Jun 2025 03:10:17 -0700 (PDT) From: Petr Tesarik To: Jonathan Corbet , Randy Dunlap , Robin Murphy , Marek Szyprowski Cc: Andrew Morton , Keith Busch , Jens Axboe , Bagas Sanjaya , 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 v2 0/8] update DMA API documentation Date: Fri, 27 Jun 2025 12:10:07 +0200 Message-ID: <20250627101015.1600042-1-ptesarik@suse.com> X-Mailer: git-send-email 2.49.0 MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Rspam-User: X-Stat-Signature: mynje8jmc4myiepagxsifagypknc91hh X-Rspamd-Server: rspam02 X-Rspamd-Queue-Id: 636F2A000C X-HE-Tag: 1751019019-772906 X-HE-Meta: U2FsdGVkX1+i0G6bBUAuQCKLpHB2/DfftuG1NF5+Zvhqy0NytJOY+j+jrW7oAh7p0FAc3LT4Lx3TDnasLNEipA1ONHH+LHnaxn/+2u12pV6JTDgDOkEU8Ruz4HfEabKixe0PvuSgBvvy4jX9l42pC8w+T6VnQCYGigMXXrxdCp0ISmp4IY5VoJf6mLIKGPDuW1F/HB0n/P0QTadxuurTUMETCDZ0TwOhvILH9KNh9tJuPTrNGsmmB8FX5oEFkJzk9P8gBp1EpJnO5trdCxfzaEhah3g/Bk1zmrLx+od/T0Dsr5bZfKLVCmdTP1u7XrpTaeH6mimz6ZaTl4lcswa8QuNsM0HNapuuzkbwheRI63VNsIiTURXg6F5jhz9Uz0nXnEaejLECXCIU3HvhUA18MaRc1Top4FXa/HCiVB5ZKOgzkZqF1gK+SGJfHcsvIuVOrrbt6Xm4UDLD8nl5pzp2GZaYl7IK61/0D4sQ9MWKNHIkcyHskoy3Wrs5igB0y/pIZUgFZJf4VbySRyzcCJeDE6UMzCDL9rl4maIUxOZNs7xUl93Or+AfcrAUXn+N56vnXmNV8/h2BtOxQTMhOw2aDP/55m9mlUMoHdrKhYtdXBWsd4CKkM0A2Xi+joZlPO/mtq6E1jcbie+llRO2QXqCENLdxSvyZ4JaC74AiWjtOgZ4Xegs4EfmytaxGIYvLs55CoSPHDHmKQoclH/SRkVnPNcH5usGSvnrohnnJbd1/j9SaAWIhlv8+qvGhBBTZJT/0n6k99a7wY9auPBz3/e1a5/7bllLtiGZtgdkfAbQK9Jh0PNaarjprB66sRAKXA+qYJpgHnPDyKQd0GSm68L78DXANsgdo/H+s+3/tnzJyE+D/gtpLIhjrbolbmET594SSV58UY/u+dfa1Zlhpb26kkHQX5SFtvcfWD24pyH1xt2uLJ+f60WIjyNa7ESygInKVTwAr9GJ73eG8druz+o QcvdKMrH IxvvCyB4nLF9F2Dm9nzR7seifdG24exXde+qk/t+jYCGUSQao9ohaJhbWMkn6QIzDkLvdYE8vrDCQBqxcaAWUiZ3ycflFqzZvYblVKPodbeqcwuFpkieA9V9dVbLFyFEeHDw5/QYNaJrDofOEZRJ08Rk09HgTQ9/z/xZcUZJJb+DP12+YMob5j7IfGYYPw6mSlrk7d7bJLvaJdQBFaulq7T4Vcz/m8ARMkfRQ5PUnS/EU0zkJ5ViTXyTN19urbhwV7/neZCqRz7FMvcaTF9L453dzdS9uMuVhBmtWo+TQbSGr4CYNmOEAAxEmODeCNhLZ0bsQ 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 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() Documentation/core-api/dma-api-howto.rst | 36 ++--- Documentation/core-api/dma-api.rst | 191 ++++++++--------------- Documentation/core-api/mm-api.rst | 6 - include/linux/dmapool.h | 8 + mm/dmapool.c | 6 +- 5 files changed, 97 insertions(+), 150 deletions(-) -- 2.49.0