io_uring/io-wq.c:80: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst

From: kernel test robot
Date: Sat Apr 26 2025 - 07:08:14 EST


tree: https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git master
head: 02ddfb981de88a2c15621115dd7be2431252c568
commit: 751eedc4b4b79332ecf1a78c0dbeb47d573a8f59 io_uring/io-wq: move worker lists to struct io_wq_acct
date: 10 weeks ago
config: s390-randconfig-002-20250426 (https://download.01.org/0day-ci/archive/20250426/202504261846.jvwwfMUN-lkp@xxxxxxxxx/config)
compiler: clang version 21.0.0git (https://github.com/llvm/llvm-project f819f46284f2a79790038e1f6649172789734ae8)
reproduce (this is a W=1 build): (https://download.01.org/0day-ci/archive/20250426/202504261846.jvwwfMUN-lkp@xxxxxxxxx/reproduce)

If you fix the issue in a separate patch/commit (i.e. not just a new version of
the same patch/commit), kindly add following tags
| Reported-by: kernel test robot <lkp@xxxxxxxxx>
| Closes: https://lore.kernel.org/oe-kbuild-all/202504261846.jvwwfMUN-lkp@xxxxxxxxx/

All warnings (new ones prefixed by >>):

>> io_uring/io-wq.c:80: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
* Protects access to the worker lists.
io_uring/io-wq.c:89: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
* The list of free workers. Protected by #workers_lock
io_uring/io-wq.c:95: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
* The list of all workers. Protected by #workers_lock


vim +80 io_uring/io-wq.c

77
78 struct io_wq_acct {
79 /**
> 80 * Protects access to the worker lists.
81 */
82 raw_spinlock_t workers_lock;
83
84 unsigned nr_workers;
85 unsigned max_workers;
86 atomic_t nr_running;
87
88 /**
89 * The list of free workers. Protected by #workers_lock
90 * (write) and RCU (read).
91 */
92 struct hlist_nulls_head free_list;
93
94 /**
95 * The list of all workers. Protected by #workers_lock
96 * (write) and RCU (read).
97 */
98 struct list_head all_list;
99
100 raw_spinlock_t lock;
101 struct io_wq_work_list work_list;
102 unsigned long flags;
103 };
104

--
0-DAY CI Kernel Test Service
https://github.com/intel/lkp-tests/wiki