linux-kernel - arch/powerpc/platforms/pseries/plpks.c:186: 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: <202308040430.GxmPAnwZ-lkp@intel.com>
Date:   Fri, 4 Aug 2023 04:52:29 +0800
From:   kernel test robot <lkp@...el.com>
To:     Nayna Jain <nayna@...ux.ibm.com>
Cc:     oe-kbuild-all@...ts.linux.dev, linux-kernel@...r.kernel.org,
        Michael Ellerman <mpe@...erman.id.au>,
        linux-doc@...r.kernel.org
Subject: arch/powerpc/platforms/pseries/plpks.c:186: 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:   7bafbd4027ae86572f308c4ddf93120c90126332
commit: 2454a7af0f2a42918aa972147a0bec38e6656cd8 powerpc/pseries: define driver for Platform KeyStore
date:   1 year ago
config: powerpc-ppc64_defconfig (https://download.01.org/0day-ci/archive/20230804/202308040430.GxmPAnwZ-lkp@intel.com/config)
compiler: powerpc64-linux-gcc (GCC) 12.3.0
reproduce: (https://download.01.org/0day-ci/archive/20230804/202308040430.GxmPAnwZ-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/202308040430.GxmPAnwZ-lkp@intel.com/

All warnings (new ones prefixed by >>):

>> arch/powerpc/platforms/pseries/plpks.c:186: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
    * Label is combination of label attributes + name.


vim +186 arch/powerpc/platforms/pseries/plpks.c

   184	
   185	/**
 > 186	 * Label is combination of label attributes + name.
   187	 * Label attributes are used internally by kernel and not exposed to the user.
   188	 */
   189	static struct label *construct_label(char *component, u8 varos, u8 *name,
   190					     u16 namelen)
   191	{
   192		struct label *label;
   193		size_t slen;
   194	
   195		if (!name || namelen > MAX_NAME_SIZE)
   196			return ERR_PTR(-EINVAL);
   197	
   198		slen = strlen(component);
   199		if (component && slen > sizeof(label->attr.prefix))
   200			return ERR_PTR(-EINVAL);
   201	
   202		label = kzalloc(sizeof(*label), GFP_KERNEL);
   203		if (!label)
   204			return ERR_PTR(-ENOMEM);
   205	
   206		if (component)
   207			memcpy(&label->attr.prefix, component, slen);
   208	
   209		label->attr.version = LABEL_VERSION;
   210		label->attr.os = varos;
   211		label->attr.length = MAX_LABEL_ATTR_SIZE;
   212		memcpy(&label->name, name, namelen);
   213	
   214		label->size = sizeof(struct label_attr) + namelen;
   215	
   216		return label;
   217	}
   218	

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