[arnd-asm-generic:master 14/18] lib/iomem_copy.c:14: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



tree:   https://git.kernel.org/pub/scm/linux/kernel/git/arnd/asm-generic.git master
head:   a8cb1e92d29096b1fe58ef6fdcee699196eac1bd
commit: b660d0a2acb9053d627befbb259a397d26aa9582 [14/18] New implementation for IO memcpy and IO memset
config: x86_64-rhel-8.3 (https://download.01.org/0day-ci/archive/20241029/202410290907.0mDZVYPK-lkp@xxxxxxxxx/config)
compiler: gcc-12 (Debian 12.2.0-14) 12.2.0
reproduce (this is a W=1 build): (https://download.01.org/0day-ci/archive/20241029/202410290907.0mDZVYPK-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/202410290907.0mDZVYPK-lkp@xxxxxxxxx/

All warnings (new ones prefixed by >>):

>> lib/iomem_copy.c:14: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
    * memset_io            Set a range of I/O memory to a constant value
   lib/iomem_copy.c:55: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
    * memcpy_fromio        Copy a block of data from I/O memory
   lib/iomem_copy.c:97: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
    * memcpy_toio          Copy a block of data into I/O memory


vim +14 lib/iomem_copy.c

    11	
    12	#ifndef memset_io
    13	/**
  > 14	 * memset_io		Set a range of I/O memory to a constant value
    15	 * @addr:		The beginning of the I/O-memory range to set
    16	 * @val:		The value to set the memory to
    17	 * @count:		The number of bytes to set
    18	 *
    19	 * Set a range of I/O memory to a given value.
    20	 */
    21	void memset_io(volatile void __iomem *addr, int val, size_t count)
    22	{
    23		long qc = (u8)val;
    24	
    25		qc *= ~0UL / 0xff;
    26	
    27		while (count && !IS_ALIGNED((long)addr, sizeof(long))) {
    28			__raw_writeb(val, addr);
    29			addr++;
    30			count--;
    31		}
    32	
    33		while (count >= sizeof(long)) {
    34	#ifdef CONFIG_64BIT
    35			__raw_writeq(qc, addr);
    36	#else
    37			__raw_writel(qc, addr);
    38	#endif
    39	
    40			addr += sizeof(long);
    41			count -= sizeof(long);
    42		}
    43	
    44		while (count) {
    45			__raw_writeb(val, addr);
    46			addr++;
    47			count--;
    48		}
    49	}
    50	EXPORT_SYMBOL(memset_io);
    51	#endif
    52	

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




[Index of Archives]     [Linux Kernel]     [Kernel Newbies]     [x86 Platform Driver]     [Netdev]     [Linux Wireless]     [Netfilter]     [Bugtraq]     [Linux Filesystems]     [Yosemite Discussion]     [MIPS Linux]     [ARM Linux]     [Linux Security]     [Linux RAID]     [Samba]     [Device Mapper]

  Powered by Linux