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 DFF48C77B7C for ; Thu, 26 Jun 2025 01:46:17 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 3EA556B00C5; Wed, 25 Jun 2025 21:46:17 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id 3C2926B00C6; Wed, 25 Jun 2025 21:46:17 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 2FF2A6B00C9; Wed, 25 Jun 2025 21:46:17 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0014.hostedemail.com [216.40.44.14]) by kanga.kvack.org (Postfix) with ESMTP id 21AE46B00C5 for ; Wed, 25 Jun 2025 21:46:17 -0400 (EDT) Received: from smtpin23.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay04.hostedemail.com (Postfix) with ESMTP id 5DB7D1A0852 for ; Thu, 26 Jun 2025 01:46:16 +0000 (UTC) X-FDA: 83595861552.23.60EB3CB Received: from mail-pg1-f176.google.com (mail-pg1-f176.google.com [209.85.215.176]) by imf06.hostedemail.com (Postfix) with ESMTP id 891A2180006 for ; Thu, 26 Jun 2025 01:46:14 +0000 (UTC) Authentication-Results: imf06.hostedemail.com; dkim=pass header.d=gmail.com header.s=20230601 header.b=lDlU1jKH; spf=pass (imf06.hostedemail.com: domain of bagasdotme@gmail.com designates 209.85.215.176 as permitted sender) smtp.mailfrom=bagasdotme@gmail.com; dmarc=pass (policy=none) header.from=gmail.com ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1750902374; 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=lq3SiHnJ/sMr4QNwXyLgB3hBprROz+eEGhl/zVcI28w=; b=UILUp1LmJnAj/vQrQdhSTM9TftDrBqy/zKEmf5JgIS9prEkWmTmOk+gP63Kv2SUckiQquN W+DwA8B4pwu5Vk6H0FZp9kAv8a3yXio5EEVg/pscmxKB0UvbBcBw5BSb1TyHpvQjXhqekr jCHHRQIJ9/A/2MI2bBIjYFt5UqwwADs= ARC-Authentication-Results: i=1; imf06.hostedemail.com; dkim=pass header.d=gmail.com header.s=20230601 header.b=lDlU1jKH; spf=pass (imf06.hostedemail.com: domain of bagasdotme@gmail.com designates 209.85.215.176 as permitted sender) smtp.mailfrom=bagasdotme@gmail.com; dmarc=pass (policy=none) header.from=gmail.com ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1750902374; a=rsa-sha256; cv=none; b=wIwnTV9KQ4uegC39ViV8Qu7Za7RfQr/0yTyo95xCvaCWL/xJpWeGr3HZLdwGaJUDfs16Eu yMJaD8gUJDXfESL5+l8Pa9Iavsitxyaps3t1pz6SWtqpMJmnwdmjnZOpDk1ywrl4KhYERW nb0rkUM7GZ66dnC+Phho452BlJRx4vM= Received: by mail-pg1-f176.google.com with SMTP id 41be03b00d2f7-b31c84b8052so539901a12.1 for ; Wed, 25 Jun 2025 18:46:14 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1750902373; x=1751507173; darn=kvack.org; h=in-reply-to:content-disposition:mime-version:references:message-id :subject:cc:to:from:date:from:to:cc:subject:date:message-id:reply-to; bh=lq3SiHnJ/sMr4QNwXyLgB3hBprROz+eEGhl/zVcI28w=; b=lDlU1jKHrn9dZEsOwXSrZb7rTBQ0ueFugS46uRXylOzoyLfCaVZAt4A08ad4CTcQ4d mRTzedscL30Wmmu6ngCbL7lg5kTxeRNq+4lqHijPFI6zgS8osTHAOx1p8lCh1h1J+IPU JOcX+H98PlKS9jDByEIiEbYMsYXhGAtqaDM524A99QYzkz0DTHHfXcYt9rMguHiE3Wjj vQeyqzeGPzF31G0jHYd5pu+Xk4/gGhwG17VLk2UdIjnKhOZ27GB0cZH39Z13mNy0NgAl p/PQuG19uxmsH+DsV3HiWyDI/7OnW9Dse85EcBkawiSwDLiGw5Rek4L5uxU/vtP2okbB mrAw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1750902373; x=1751507173; h=in-reply-to:content-disposition:mime-version:references:message-id :subject:cc:to:from:date:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to; bh=lq3SiHnJ/sMr4QNwXyLgB3hBprROz+eEGhl/zVcI28w=; b=bVNTEWAkO3+olmnSZU5FSgwCyfEjKeg5D54zK9QLqPpvkTtKaL0oYSkys5qE3ctfLt 8Oe0JjWD0HKCVn9R+6UK72FN7hjhTLSh3fwH3AXa5u1S2cQKTO/3KCvdmIp7WXx3PI9C 8T3jD13/Ib2I1tJ9hg8ub4IeqaSy8BTOwbb1YXQF1p2i4kuq+zh3qMcIa6u/y7j6klX3 BVKYvtJU/svwNwQk2TYuGfoQJ3xHEKV33pWWOhPI9kYzXG6mxa/SFShAwIwKXjGCH2yH 1tZBwT1jn9KS7DcJXWjO1Hzy+sVCEJuHexqP6ugtBOxkzCf3DUGtuKnDmSzkm6qCwBe2 NoVg== X-Forwarded-Encrypted: i=1; AJvYcCXhkwAJVvMW12nSbVyGEjrQ/KCrV5UiHZ5vAcYNKlRD7VDIF39z1DpwyGeIWvxg4Gdu8EYMYAeUpw==@kvack.org X-Gm-Message-State: AOJu0YxN08YjRWF6sz4J6oKZ+uBRICc29/cB9z0fHLJkZLxZ83cqsFpR GI+60amA+KXKWx70LpQsR648Sv3Ev26F938EaS14SH8j1/Soz1BVQe86 X-Gm-Gg: ASbGncu2U9GAc/uS5EuEUHk62l/zms5F2B7gWyXbr1KC0BKbwPKFnx0EjVR50Y/TjTT Hj3y1ReAk2ocfz+TJ63m9kB2Y2rUGJoodRekSFxiMRj4xYNa0bZpnkrh4SpZmj3QxicXrcCnbOy 84Sll0eImczW6xKP26+rKoCUlcF2YCTBrr+WP/jdLtnIUrsxQ/9niCjwyx3iyymF6LVUEi6pmJQ 0opgi97ttPK87JJ5B9htYlMV3ReOLcoPnR2Ns+9P3qLDFgI1BD6Dg8osF1UX7bEPSEXv2Axd4ZI 6YHyADQtCiuXW9LloSSJ9L0siqOOf/I9MneQIAJb+xRON0r4pky1zziszGPFEg== X-Google-Smtp-Source: AGHT+IGyr80L4eOHv3yLu/dw1hnDWmf1wAOjqnPnOOGwaeNvDeEwtPUcQtn3Lwxiua7BosRBAt1eoQ== X-Received: by 2002:a05:6a21:1807:b0:21f:792c:dc75 with SMTP id adf61e73a8af0-2207f285d61mr9401593637.34.1750902373062; Wed, 25 Jun 2025 18:46:13 -0700 (PDT) Received: from archie.me ([103.124.138.155]) by smtp.gmail.com with ESMTPSA id 41be03b00d2f7-b34c431806fsm295313a12.31.2025.06.25.18.46.11 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 25 Jun 2025 18:46:12 -0700 (PDT) Received: by archie.me (Postfix, from userid 1000) id 0E031420A9A6; Thu, 26 Jun 2025 08:46:08 +0700 (WIB) Date: Thu, 26 Jun 2025 08:46:08 +0700 From: Bagas Sanjaya To: Petr Tesarik , Jonathan Corbet , Morton Cc: Marek Szyprowski , Leon Romanovsky , Keith Busch , Caleb Sander Mateos , Sagi Grimberg , Jens Axboe , John Garry , "open list:DOCUMENTATION" , open list , "open list:MEMORY MANAGEMENT" Subject: Re: [PATCH 3/8] docs: dma-api: remove remnants of PCI DMA API Message-ID: References: <20250624133923.1140421-1-ptesarik@suse.com> <20250624133923.1140421-4-ptesarik@suse.com> MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha512; protocol="application/pgp-signature"; boundary="/k8GDMthe5m94/ks" Content-Disposition: inline In-Reply-To: <20250624133923.1140421-4-ptesarik@suse.com> X-Rspam-User: X-Rspamd-Server: rspam04 X-Rspamd-Queue-Id: 891A2180006 X-Stat-Signature: u13oi4c7sf3rp8cag7k9p3bmemnyiawt X-HE-Tag: 1750902374-856677 X-HE-Meta: U2FsdGVkX1+3kQ2RI0khDsWWYUBkTCn3yYGRdIuV1FCHEmttXxQsv5AHp5F1OUiQVt1+KSYiDUhvdmX9MbTCjdQ4akR6z3bhbaciAWCFXn3a+f8DZeVMANx8YrLBRUE3GwQaiKapcgt7vSmlQI6E5p5JSRoax1MeEAWzdILQMSo0ZbOSPmQN+8tlEOGuH4qLaOEUrSesraEv5M8LAqp1FtR1munKtEcJa0gKZIa/Kpvkm0/McsFpUXGQ0aHCn8GekgABiEooxr8v/pTQTkwXyvhZbKnN/RRzfqOpqpoi256CQ92GACS81oU2TsPyBiHxaKfOuUfGiqn3jT20h7OoOIj+/xK1aXeQARJjbtfHRSeAKMg77zbBQHdAD9SzAFcshfzlwHJBUHsPtRWD2fmDXpZEWn5rv+saSUavJYe4GBwv5VW6Y+S0ujn7U4Zdhj24Oe20mLFtx9E/94d86vgfJ5FDA8H2+JjsXuLPEesZF6O86hDc4pvWlRp6V4/OuA+pXGbVPXBIm689NpwWCvdUHcSs3WmKQlTZ0B5cj+zqjqyfvOBdYH4iyV+svaD9CxCMOnuiSI+wQhPio7+pAylOlSqNOp8PnIcaDZ/pe02i8G45/Ke1l6GD1NAPqVHaq5izJEENz6tKQ4jQWpMoegrPuCkqawszx2Y+nYBXMshaNrnEZ6FDN45gJkGjyJEJ/FIVp3/pPHOi1uV/pg/IjddSlg8mbcOzIVVbLeDumAn26WmXJIBcr1BquJmq1QLi/jLzizXO9oD5ALXfEUTlUcE1bnSG0bkuoESQ5APt2X1qEzC1t+ZytmpX1Gb7aqHtMAvKi3OqXKT5MOagyEg2xeXoICffuWVKpOr3vPJQh/YBhoa9rYvn5XVwRNH0pQVCwDmg3p1hewD18SfGKLlpMFcSpg97VptiKG0DHBc+z3k1rQA0pp6JuyVoJCHcklwRoyZhYTDADjS1wIFV6ViE6lT cW53XUYR Irnf0pfKteVjpUa+pNVLl3GXr8qpfscBVRPJR/V9MnGpw7E8tvaVms4g/jiCUDyzssvEMbIoViVAwr54= 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: --/k8GDMthe5m94/ks Content-Type: text/plain; charset=utf-8 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Tue, Jun 24, 2025 at 03:39:18PM +0200, Petr Tesarik wrote: > diff --git a/Documentation/core-api/dma-api.rst b/Documentation/core-api/= dma-api.rst > index c0a2cc7d0b95..3e89e3b0ecfd 100644 > --- a/Documentation/core-api/dma-api.rst > +++ b/Documentation/core-api/dma-api.rst > @@ -53,10 +53,9 @@ minimum allocation length may be as big as a page, so = you should > consolidate your requests for coherent memory as much as possible. > The simplest way to do that is to use the dma_pool calls (see below). > =20 > -The flag parameter (dma_alloc_coherent() only) allows the caller to > -specify the ``GFP_`` flags (see kmalloc()) for the allocation (the > -implementation may choose to ignore flags that affect the location of > -the returned memory, like GFP_DMA). > +The flag parameter allows the caller to specify the ``GFP_`` flags (see > +kmalloc()) for the allocation (the implementation may ignore flags that = affect > +the location of the returned memory, like GFP_DMA). > =20 > :: > =20 > @@ -64,13 +63,12 @@ the returned memory, like GFP_DMA). > dma_free_coherent(struct device *dev, size_t size, void *cpu_addr, > dma_addr_t dma_handle) > =20 > -Free a region of coherent memory you previously allocated. dev, > -size and dma_handle must all be the same as those passed into > -dma_alloc_coherent(). cpu_addr must be the virtual address returned by > -the dma_alloc_coherent(). > +Free a previously allocated region of coherent memory. dev, size and dm= a_handle > +must all be the same as those passed into dma_alloc_coherent(). cpu_add= r must > +be the virtual address returned by dma_alloc_coherent(). > =20 > -Note that unlike their sibling allocation calls, these routines > -may only be called with IRQs enabled. > +Note that unlike the sibling allocation call, this routine may only be c= alled > +with IRQs enabled. > =20 > =20 > Part Ib - Using small DMA-coherent buffers > @@ -246,9 +244,7 @@ Part Id - Streaming DMA mappings > Maps a piece of processor virtual memory so it can be accessed by the > device and returns the DMA address of the memory. > =20 > -The direction for both APIs may be converted freely by casting. > -However the DMA API uses a strongly typed enumerator for its > -direction: > +The DMA API uses a strongly typed enumerator for its direction: > =20 > =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D = =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D > DMA_NONE no direction (used for debugging) > @@ -325,8 +321,7 @@ DMA_BIDIRECTIONAL direction isn't known > enum dma_data_direction direction) > =20 > Unmaps the region previously mapped. All the parameters passed in > -must be identical to those passed in (and returned) by the mapping > -API. > +must be identical to those passed to (and returned by) dma_map_single(). > =20 > :: > =20 LGTM, thanks! Reviewed-by: Bagas Sanjaya --=20 An old man doll... just what I always wanted! - Clara --/k8GDMthe5m94/ks Content-Type: application/pgp-signature; name=signature.asc -----BEGIN PGP SIGNATURE----- iHUEABYKAB0WIQSSYQ6Cy7oyFNCHrUH2uYlJVVFOowUCaFymWgAKCRD2uYlJVVFO o5drAP9fXYdw6+4fZYNwvXAgGezIFB9llc5nQyNnXWPwVbdB9QEA6e7hI2YkqCD3 JGNjhBlbhEfrMD7mZTXRieoVHwpNNgQ= =26Za -----END PGP SIGNATURE----- --/k8GDMthe5m94/ks--