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 A450FC7EE39 for ; Sat, 28 Jun 2025 19:04:21 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 461C46B00A2; Sat, 28 Jun 2025 15:04:21 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id 412CD6B00A3; Sat, 28 Jun 2025 15:04:21 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 34F436B00A4; Sat, 28 Jun 2025 15:04: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 25E366B00A2 for ; Sat, 28 Jun 2025 15:04:21 -0400 (EDT) Received: from smtpin05.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay04.hostedemail.com (Postfix) with ESMTP id ED6391A0637 for ; Sat, 28 Jun 2025 19:04:20 +0000 (UTC) X-FDA: 83605735080.05.32709DD Received: from casper.infradead.org (casper.infradead.org [90.155.50.34]) by imf30.hostedemail.com (Postfix) with ESMTP id 489B780005 for ; Sat, 28 Jun 2025 19:04:19 +0000 (UTC) Authentication-Results: imf30.hostedemail.com; dkim=pass header.d=infradead.org header.s=casper.20170209 header.b=QjHPWTmp ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1751137459; a=rsa-sha256; cv=none; b=uMwosBuzSicA/ueZKqhP+ubd34Jtiq/5L9nRxO1k36wLb7gqO9iZg0ZaRFcct0/msBTRUW 4a60PEPgEwHpDUhn0CjuH2EyWOCzixk0VbTSqHE1UmOc5iEeI9hwR+XQ62ELqtTapZAbZE Q8V/kzQMZ8xTtdNykgonfbPvgh0BEuI= ARC-Authentication-Results: i=1; imf30.hostedemail.com; dkim=pass header.d=infradead.org header.s=casper.20170209 header.b=QjHPWTmp; dmarc=none; spf=none (imf30.hostedemail.com: domain of rdunlap@infradead.org has no SPF policy when checking 90.155.50.34) smtp.mailfrom=rdunlap@infradead.org ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1751137459; 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=Nxz4kNnt/9AKFCXpu4ru2YmjSRfXH33QiY//BZtaPNU=; b=qPFZH0cHJzAuw7IHTu7b5v4cMeLKA9kf+b+oEyh+BDNYVE2+ZRQlqIlwYQraYZo9CZfnl+ XhbEWJIBsD30ULjid5MbMwxt3Ayoy1XDDr5vRyDJGF/XoYWXXu9YOQJpAmOJbMPREKgBoT ZP1ohinp5iSXPT71pawdK1cIwSvhhAw= DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=casper.20170209; h=Content-Transfer-Encoding:Content-Type: In-Reply-To:From:References:Cc:To:Subject:MIME-Version:Date:Message-ID:Sender :Reply-To:Content-ID:Content-Description; bh=Nxz4kNnt/9AKFCXpu4ru2YmjSRfXH33QiY//BZtaPNU=; b=QjHPWTmprCZU8ViCBaOUFC2UTB p90n+CFv8iCkFdxe9yqU6SvG80RnR9aqR0/nx1RjudgVzoqn/lHHFzPI6A3uQq+UdOnz/6JXDYZ4y Vhq6afuVBlddfrIqIjabDm6r9HoLy2IEt8tgiJ3oKwUSaYiHuzbtm07q/wvuZiAKxzHf81QPZgLBe Z653Bzp+SpC9SqaTxtXqkQd4k7Vuyzu4i1M4VUAVD8xSuH+g/yINhhpbjC7bBcUrl9ML1D4Tlx8R1 r+eFwaFQuBHT+LejmE0nTKWLESIHeKYaYPfH3Mvt9cRxPwwRoscz0wdzdEwkwYlljAZwmnEA+ZXC/ UJc7XRqQ==; Received: from [50.53.25.54] (helo=[192.168.254.17]) by casper.infradead.org with esmtpsa (Exim 4.98.2 #2 (Red Hat Linux)) id 1uVaqS-0000000H8Ou-1u3X; Sat, 28 Jun 2025 19:04:12 +0000 Message-ID: <5a997777-fd14-40e1-919b-2e61a6e8d570@infradead.org> Date: Sat, 28 Jun 2025 12:04:04 -0700 MIME-Version: 1.0 User-Agent: Mozilla Thunderbird Subject: Re: [PATCH v2 4/8] docs: dma-api: add a kernel-doc comment for dma_pool_zalloc() To: Petr Tesarik , Jonathan Corbet , Robin Murphy , Marek Szyprowski Cc: Andrew Morton , Keith Busch , Jens Axboe , Bagas Sanjaya , "open list:DOCUMENTATION" , open list , "open list:MEMORY MANAGEMENT" References: <20250627101015.1600042-1-ptesarik@suse.com> <20250627101015.1600042-5-ptesarik@suse.com> Content-Language: en-US From: Randy Dunlap In-Reply-To: <20250627101015.1600042-5-ptesarik@suse.com> Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 7bit X-Rspam-User: X-Rspamd-Server: rspam04 X-Rspamd-Queue-Id: 489B780005 X-Stat-Signature: gxn85e4n93uzbfntskmf9ccqqcw8fmdb X-HE-Tag: 1751137459-512233 X-HE-Meta: U2FsdGVkX1/a/RwEHS/Pq+ZsyqjTuVSO+egxeKMkG3X9Ydznmm5X1lJyKwogYrjDBys9QQa/LG/yXOrp1GrddJQP9mFxNtIoqEfX9PzQ7buxwYMTTy2Alcukw7yGGMYPC8w/ojgH/vb+ljQj0QuCXwAn5snXwP8fF74kW9JgNeMdMSrXDs55Tn4ylAc7IVhv4alQQP7VMs0eT0eWhIEPfPvf4HuDhIOQTVM/hX4o3WodFQ9fMQI/NUbrsW9BShkh6ZFZ5wJ9B30gDXoovFpKJoRkq8udDIRzqChHp7wtjyjPZ44hzzaYYh4YBuZ/+2OowDhXon66qXSEOH6J6b86qR5vbkV4je+m72yP3/G0Ean4VfvvT1qxXeEmxfScFUf+a2hwHraUMtX1EPgllBSm1DGeLd7eGbgEC64NyKHEMfO2Ozhh/GHgfYwCmM6Ez6nmja3Hg6I6wLiLCx1Qe86zj/H4O7aTXjvsg2CNx95FY05LA4B9e8J9DJFpDGtrnnhgNnf0gsGk3hkFJ5y0tV8AaNKqRlA7dQ79HNDlOvZqhJRyBl4zvarU8F/nEV8epatebjuiov4coD9X9h5w+Nu7TMnxQnltITdiaxkFULzSeTrYnDGycfUzeTYAUiWUOP93oHKIEpmcCSey6wY8JpfGvaYP44/z0887/4IkEm/+m3Xz81ZEapbtblj2RXHZ12PV7JYTvWyIwSWXasu0bzRYkJEU69qUt/nlLlTtiZtTMAEc5kq2PKMY5RScxjMBsKGovYU7ingFaMsulxLflqtp479VejV1CVjKIA2uQcnlA4ILV70RiAOLlevv5j69iKF4+wy6blNQon8FF6U9W8UXF6r98kv08ix2WSjvLDMZDOfZ7ZuummYcbCeiF6jFqKy7MasS7z8sCh+v2hj4pBlxxNYO4mIf6aFdbVAUn92dsVnWHw39vsqDkSIjlMzuObr1S7RYUeUJZ+CLQUf5unS kQkeTtNg 844gPKu9+J5z97ogKWPM/z+LY5V/kUPYcwnScrvKq7KzK35YdNO5immqIGpLDKoR0eKEXhkw2YchgVKdPPjoYExk2xJPp5j1EWZpla6QfeuwXKUi1Yhho1+Df24/fE9/ojeFML1S6Eeiqpl/p5Kq/S1itgZtZBsxAzVuy+7FBVts5StOq0hsoxsQB5LdIX1B5TioZvA5kXh6qhLM2ZW0uOAyzgbFtTu+8lxMOkJsskI4NaLy1zB9lTNUwue1Hg+WnhO/QNX2460JlixmKPr64lq/1ABrVmKTmR2yFd2RB1hhm62bXpR1N0GFn+C36/vXS00kDS5b1cIgg7eEZJS2aHh20c3lucjkmej2oxByYUQ2lQ43tSlDJqEv2njt6oySFOYwAD9bIWm6NUtwyI8EsswsAWc7dAYho4hHC 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: On 6/27/25 3:10 AM, Petr Tesarik wrote: > Document the dma_pool_zalloc() wrapper. > > Signed-off-by: Petr Tesarik > --- > Documentation/core-api/mm-api.rst | 2 ++ > include/linux/dmapool.h | 8 ++++++++ > 2 files changed, 10 insertions(+) > > diff --git a/Documentation/core-api/mm-api.rst b/Documentation/core-api/mm-api.rst > index af8151db88b28..a61766328ac06 100644 > --- a/Documentation/core-api/mm-api.rst > +++ b/Documentation/core-api/mm-api.rst > @@ -97,6 +97,8 @@ DMA pools > .. kernel-doc:: mm/dmapool.c > :export: > > +.. kernel-doc:: include/linux/dmapool.h > + > More Memory Management Functions > ================================ > > diff --git a/include/linux/dmapool.h b/include/linux/dmapool.h > index 06c4de602b2f3..c0c7717d3ae7b 100644 > --- a/include/linux/dmapool.h > +++ b/include/linux/dmapool.h > @@ -60,6 +60,14 @@ static inline struct dma_pool *dma_pool_create(const char *name, > NUMA_NO_NODE); > } > > +/** > + * dma_pool_zalloc - Get a zero-initialized block of DMA coherent memory. > + * @pool: dma pool that will produce the block > + * @mem_flags: GFP_* bitmask > + * @handle: pointer to dma address of block > + * > + * Same as @dma_pool_alloc, but the returned memory is zeroed. * Same as dma_pool_alloc(), but ... '@' is for function arguments. With that change: Reviewed-by: Randy Dunlap Tested-by: Randy Dunlap Thanks. > + */ > static inline void *dma_pool_zalloc(struct dma_pool *pool, gfp_t mem_flags, > dma_addr_t *handle) > { -- ~Randy