linux-kernel - 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

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [day] [month] [year] [list]

Message-ID: <202504261846.jvwwfMUN-lkp@intel.com>
Date: Sat, 26 Apr 2025 19:07:16 +0800
From: kernel test robot <lkp@...el.com>
To: Max Kellermann <max.kellermann@...os.com>
Cc: llvm@...ts.linux.dev, oe-kbuild-all@...ts.linux.dev,
	linux-kernel@...r.kernel.org, Jens Axboe <axboe@...nel.dk>,
	linux-doc@...r.kernel.org
Subject: 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

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@intel.com/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@intel.com/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@...el.com>
| Closes: https://lore.kernel.org/oe-kbuild-all/202504261846.jvwwfMUN-lkp@intel.com/

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