From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from verein.lst.de (verein.lst.de [213.95.11.211]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 4638964C for ; Thu, 20 Jul 2023 06:38:22 +0000 (UTC) Received: by verein.lst.de (Postfix, from userid 2407) id B78E368AFE; Thu, 20 Jul 2023 08:38:19 +0200 (CEST) Date: Thu, 20 Jul 2023 08:38:19 +0200 From: Christoph Hellwig To: Petr Tesarik Cc: Stefano Stabellini , Russell King , Thomas Bogendoerfer , Thomas Gleixner , Ingo Molnar , Borislav Petkov , Dave Hansen , "maintainer:X86 ARCHITECTURE (32-BIT AND 64-BIT)" , "H. Peter Anvin" , Greg Kroah-Hartman , "Rafael J. Wysocki" , Juergen Gross , Oleksandr Tyshchenko , Christoph Hellwig , Marek Szyprowski , Robin Murphy , Petr Tesarik , Jonathan Corbet , Andy Shevchenko , Hans de Goede , James Seo , James Clark , Kees Cook , "moderated list:XEN HYPERVISOR ARM" , "moderated list:ARM PORT" , open list , "open list:MIPS" , "open list:XEN SWIOTLB SUBSYSTEM" , Roberto Sassu , Kefeng Wang , petr@tesarici.cz Subject: Re: [PATCH v4 2/8] swiotlb: add documentation and rename swiotlb_do_find_slots() Message-ID: <20230720063819.GB3842@lst.de> References: <11826bfbc148771ab36d0b485558aa52cbdd204f.1689261692.git.petr.tesarik.ext@huawei.com> Precedence: bulk X-Mailing-List: iommu@lists.linux.dev List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <11826bfbc148771ab36d0b485558aa52cbdd204f.1689261692.git.petr.tesarik.ext@huawei.com> User-Agent: Mutt/1.5.17 (2007-11-01) On Thu, Jul 13, 2023 at 05:23:13PM +0200, Petr Tesarik wrote: > From: Petr Tesarik > > Add some kernel-doc comments and move the existing documentation of struct > io_tlb_slot to its correct location. The latter was forgotten in commit > 942a8186eb445 ("swiotlb: move struct io_tlb_slot to swiotlb.c"). > > Use the opportunity to give swiotlb_do_find_slots() a more descriptive > name, which makes it clear how it differs from swiotlb_find_slots(). Please keep the swiotlb_ prefix. Otherwise this looks good to me.