linux-kernel - [l1k:smsc95xx_5.17 66/887] drivers/misc/bcm2835_smi.c:2: 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 for Android: free password hash cracker in your pocket

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

Date:   Fri, 8 Apr 2022 20:15:45 +0800
From:   kernel test robot <lkp@...el.com>
To:     Luke Wren <wren6991@...il.com>
Cc:     kbuild-all@...ts.01.org, linux-kernel@...r.kernel.org,
        Dom Cobley <popcornmix@...il.com>,
        Martin Sperl <kernel@...tin.sperl.org>,
        linux-doc@...r.kernel.org
Subject: [l1k:smsc95xx_5.17 66/887] drivers/misc/bcm2835_smi.c:2: warning:
 This comment starts with '/**', but isn't a kernel-doc comment. Refer
 Documentation/doc-guide/kernel-doc.rst

tree:   https://github.com/l1k/linux smsc95xx_5.17
head:   05d68ced287b30f62f18f95b5476135ef669804a
commit: 205736282d70963710608138c17b64717470161c [66/887] Add SMI driver
config: arm-multi_v7_defconfig (https://download.01.org/0day-ci/archive/20220408/202204082010.UUsMvtdZ-lkp@intel.com/config)
compiler: arm-linux-gnueabi-gcc (GCC) 11.2.0
reproduce (this is a W=1 build):
        wget https://raw.githubusercontent.com/intel/lkp-tests/master/sbin/make.cross -O ~/bin/make.cross
        chmod +x ~/bin/make.cross
        # https://github.com/l1k/linux/commit/205736282d70963710608138c17b64717470161c
        git remote add l1k https://github.com/l1k/linux
        git fetch --no-tags l1k smsc95xx_5.17
        git checkout 205736282d70963710608138c17b64717470161c
        # save the config file to linux build tree
        mkdir build_dir
        COMPILER_INSTALL_PATH=$HOME/0day COMPILER=gcc-11.2.0 make.cross O=build_dir ARCH=arm SHELL=/bin/bash drivers/dma/ drivers/misc/

If you fix the issue, kindly add following tag as appropriate
Reported-by: kernel test robot <lkp@...el.com>

All warnings (new ones prefixed by >>):

>> drivers/misc/bcm2835_smi.c:2: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
    * Broadcom Secondary Memory Interface driver


vim +2 drivers/misc/bcm2835_smi.c

   > 2	 * Broadcom Secondary Memory Interface driver
     3	 *
     4	 * Written by Luke Wren <luke@...pberrypi.org>
     5	 * Copyright (c) 2015, Raspberry Pi (Trading) Ltd.
     6	 *
     7	 * Redistribution and use in source and binary forms, with or without
     8	 * modification, are permitted provided that the following conditions
     9	 * are met:
    10	 * 1. Redistributions of source code must retain the above copyright
    11	 *    notice, this list of conditions, and the following disclaimer,
    12	 *    without modification.
    13	 * 2. Redistributions in binary form must reproduce the above copyright
    14	 *    notice, this list of conditions and the following disclaimer in the
    15	 *    documentation and/or other materials provided with the distribution.
    16	 * 3. The names of the above-listed copyright holders may not be used
    17	 *    to endorse or promote products derived from this software without
    18	 *    specific prior written permission.
    19	 *
    20	 * ALTERNATIVELY, this software may be distributed under the terms of the
    21	 * GNU General Public License ("GPL") version 2, as published by the Free
    22	 * Software Foundation.
    23	 *
    24	 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
    25	 * IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
    26	 * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
    27	 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
    28	 * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
    29	 * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
    30	 * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
    31	 * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
    32	 * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
    33	 * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
    34	 * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
    35	 */
    36	

-- 
0-DAY CI Kernel Test Service
https://01.org/lkp