[PATCH] blk-mq-dma: fix kernel-doc function name for integrity DMA iterator

Kriish Sharma posted 1 patch 2 months, 3 weeks ago
block/blk-mq-dma.c | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
[PATCH] blk-mq-dma: fix kernel-doc function name for integrity DMA iterator
Posted by Kriish Sharma 2 months, 3 weeks ago
Documentation build reported:

  Warning: block/blk-mq-dma.c:373 expecting prototype for blk_rq_integrity_dma_map_iter_start(). Prototype was for blk_rq_integrity_dma_map_iter_next() instead

The kernel-doc comment above `blk_rq_integrity_dma_map_iter_next()` used
the wrong function name (`blk_rq_integrity_dma_map_iter_start`) in its
header. This patch corrects the function name in the kernel-doc block to
match the actual implementation, ensuring clean documentation builds.

Fixes: fec9b16dc555 ("blk-mq-dma: add scatter-less integrity data DMA mapping")
Signed-off-by: Kriish Sharma <kriish.sharma2006@gmail.com>
---
 block/blk-mq-dma.c | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/block/blk-mq-dma.c b/block/blk-mq-dma.c
index a7ef25843280..b4f456472961 100644
--- a/block/blk-mq-dma.c
+++ b/block/blk-mq-dma.c
@@ -351,7 +351,7 @@ bool blk_rq_integrity_dma_map_iter_start(struct request *req,
 EXPORT_SYMBOL_GPL(blk_rq_integrity_dma_map_iter_start);
 
 /**
- * blk_rq_integrity_dma_map_iter_start - map the next integrity DMA segment for
+ * blk_rq_integrity_dma_map_iter_next - map the next integrity DMA segment for
  * 					 a request
  * @req:	request to map
  * @dma_dev:	device to map to
-- 
2.34.1
Re: [PATCH] blk-mq-dma: fix kernel-doc function name for integrity DMA iterator
Posted by Chaitanya Kulkarni 2 months, 3 weeks ago
On 11/11/25 03:58, Kriish Sharma wrote:
> Documentation build reported:
>
>    Warning: block/blk-mq-dma.c:373 expecting prototype for blk_rq_integrity_dma_map_iter_start(). Prototype was for blk_rq_integrity_dma_map_iter_next() instead
>
> The kernel-doc comment above `blk_rq_integrity_dma_map_iter_next()` used
> the wrong function name (`blk_rq_integrity_dma_map_iter_start`) in its
> header. This patch corrects the function name in the kernel-doc block to
> match the actual implementation, ensuring clean documentation builds.
>
> Fixes: fec9b16dc555 ("blk-mq-dma: add scatter-less integrity data DMA mapping")
> Signed-off-by: Kriish Sharma<kriish.sharma2006@gmail.com>


Looks good.

Reviewed-by: Chaitanya Kulkarni <kch@nvidia.com>

-ck


Re: [PATCH] blk-mq-dma: fix kernel-doc function name for integrity DMA iterator
Posted by Jens Axboe 2 months, 3 weeks ago
On Tue, 11 Nov 2025 11:58:10 +0000, Kriish Sharma wrote:
> Documentation build reported:
> 
>   Warning: block/blk-mq-dma.c:373 expecting prototype for blk_rq_integrity_dma_map_iter_start(). Prototype was for blk_rq_integrity_dma_map_iter_next() instead
> 
> The kernel-doc comment above `blk_rq_integrity_dma_map_iter_next()` used
> the wrong function name (`blk_rq_integrity_dma_map_iter_start`) in its
> header. This patch corrects the function name in the kernel-doc block to
> match the actual implementation, ensuring clean documentation builds.
> 
> [...]

Applied, thanks!

[1/1] blk-mq-dma: fix kernel-doc function name for integrity DMA iterator
      commit: 6d7e3870af11c2b5966b2769f9e8a0d4764f52cc

Best regards,
-- 
Jens Axboe
Re: [PATCH] blk-mq-dma: fix kernel-doc function name for integrity DMA iterator
Posted by Christoph Hellwig 2 months, 3 weeks ago
Looks good:

Reviewed-by: Christoph Hellwig <hch@lst.de>