]> git.ipfire.org Git - thirdparty/kernel/stable.git/commitdiff
blk-mq: Document tags_srcu member in blk_mq_tag_set structure
authorMing Lei <ming.lei@redhat.com>
Tue, 9 Sep 2025 12:33:10 +0000 (20:33 +0800)
committerJens Axboe <axboe@kernel.dk>
Tue, 9 Sep 2025 13:37:05 +0000 (07:37 -0600)
Add missing documentation for the tags_srcu member that was introduced
to defer freeing of tags page_list to prevent use-after-free when
iterating tags.

Fixes htmldocs warning:
WARNING: include/linux/blk-mq.h:536 struct member 'tags_srcu' not described in 'blk_mq_tag_set'

Reported-by: Stephen Rothwell <sfr@canb.auug.org.au>
Signed-off-by: Ming Lei <ming.lei@redhat.com>
Signed-off-by: Jens Axboe <axboe@kernel.dk>
include/linux/blk-mq.h

index 1325ceeb743a9cf4d0b4208aaffe4f81e3844d6d..b25d12545f46da3b962de59639349c3eebf7b5cc 100644 (file)
@@ -507,6 +507,8 @@ enum hctx_type {
  *                request_queue.tag_set_list.
  * @srcu:         Use as lock when type of the request queue is blocking
  *                (BLK_MQ_F_BLOCKING).
+ * @tags_srcu:    SRCU used to defer freeing of tags page_list to prevent
+ *                use-after-free when iterating tags.
  * @update_nr_hwq_lock:
  *                Synchronize updating nr_hw_queues with add/del disk &
  *                switching elevator.