Commit f403034e authored Jan 10, 2025 by Randy Dunlap Committed by Jens Axboe Jan 13, 2025

blk-cgroup: rwstat: fix kernel-doc warnings in header file

Correct the function parameters to eliminate kernel-doc warnings:

blk-cgroup-rwstat.h:63: warning: Function parameter or struct member 'opf' not described in 'blkg_rwstat_add'
blk-cgroup-rwstat.h:63: warning: Excess function parameter 'op' description in 'blkg_rwstat_add'
blk-cgroup-rwstat.h:91: warning: Function parameter or struct member 'result' not described in 'blkg_rwstat_read'

Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
Cc: Tejun Heo <tj@kernel.org>
Cc: Josef Bacik <josef@toxicpanda.com>
Cc: Jens Axboe <axboe@kernel.dk>
Cc: cgroups@vger.kernel.org
Link: https://lore.kernel.org/r/20250111062748.910442-1-rdunlap@infradead.org

Signed-off-by: Jens Axboe <axboe@kernel.dk>

parent 4fa5c370

block/blk-cgroup-rwstat.h

+3 −2

Original line number	Diff line number	Diff line
		@@ -52,7 +52,7 @@ void blkg_rwstat_recursive_sum(struct blkcg_gq blkg, struct blkcg_policy pol,
		/**
		* blkg_rwstat_add - add a value to a blkg_rwstat
		* @rwstat: target blkg_rwstat
		* @op: REQ_OP and flags
		* @opf: REQ_OP and flags
		* @val: value to add
		*
		* Add @val to @rwstat. The counters are chosen according to @rw. The
		@@ -83,8 +83,9 @@ static inline void blkg_rwstat_add(struct blkg_rwstat *rwstat,
		/**
		* blkg_rwstat_read - read the current values of a blkg_rwstat
		* @rwstat: blkg_rwstat to read
		* @result: where to put the current values
		*
		* Read the current snapshot of @rwstat and return it in the aux counts.
		* Read the current snapshot of @rwstat and return it in the @result counts.
		*/
		static inline void blkg_rwstat_read(struct blkg_rwstat *rwstat,
		struct blkg_rwstat_sample *result)