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: <202504270023.hRD576RW-lkp@intel.com>
Date: Sun, 27 Apr 2025 00:48:52 +0800
From: kernel test robot <lkp@...el.com>
To: Roger Quadros <rogerq@...nel.org>
Cc: llvm@...ts.linux.dev, oe-kbuild-all@...ts.linux.dev,
	linux-kernel@...r.kernel.org, Simon Horman <horms@...nel.org>,
	linux-doc@...r.kernel.org
Subject: drivers/net/ethernet/ti/cpsw_ale.c:1360: 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: eb41dd76abce6a13bd7ad9c779dd560136caf60a net: ethernet: ti: cpsw_ale: add Policer and Thread control register fields
date:   8 months ago
config: arm64-randconfig-001-20250426 (https://download.01.org/0day-ci/archive/20250427/202504270023.hRD576RW-lkp@intel.com/config)
compiler: clang version 16.0.6 (https://github.com/llvm/llvm-project 7cbf1a2591520c2491aa35339f227775f4d3adf6)
reproduce (this is a W=1 build): (https://download.01.org/0day-ci/archive/20250427/202504270023.hRD576RW-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/202504270023.hRD576RW-lkp@intel.com/

All warnings (new ones prefixed by >>):

>> drivers/net/ethernet/ti/cpsw_ale.c:1360: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
            * REG_FIELDS not defined for this as fields cannot be correctly


vim +1360 drivers/net/ethernet/ti/cpsw_ale.c

  1319	
  1320	static const struct reg_field ale_fields_cpsw_nu[] = {
  1321		/* CPSW_ALE_IDVER_REG */
  1322		[MINOR_VER]	= REG_FIELD(ALE_IDVER, 0, 7),
  1323		[MAJOR_VER]	= REG_FIELD(ALE_IDVER, 8, 10),
  1324		/* CPSW_ALE_STATUS_REG */
  1325		[ALE_ENTRIES]	= REG_FIELD(ALE_STATUS, 0, 7),
  1326		[ALE_POLICERS]	= REG_FIELD(ALE_STATUS, 8, 15),
  1327		/* CPSW_ALE_POLICER_PORT_OUI_REG */
  1328		[POL_PORT_MEN]	= REG_FIELD(ALE_POLICER_PORT_OUI, 31, 31),
  1329		[POL_TRUNK_ID]	= REG_FIELD(ALE_POLICER_PORT_OUI, 30, 30),
  1330		[POL_PORT_NUM]	= REG_FIELD(ALE_POLICER_PORT_OUI, 25, 25),
  1331		[POL_PRI_MEN]	= REG_FIELD(ALE_POLICER_PORT_OUI, 19, 19),
  1332		[POL_PRI_VAL]	= REG_FIELD(ALE_POLICER_PORT_OUI, 16, 18),
  1333		[POL_OUI_MEN]	= REG_FIELD(ALE_POLICER_PORT_OUI, 15, 15),
  1334		[POL_OUI_INDEX]	= REG_FIELD(ALE_POLICER_PORT_OUI, 0, 5),
  1335	
  1336		/* CPSW_ALE_POLICER_DA_SA_REG */
  1337		[POL_DST_MEN]	= REG_FIELD(ALE_POLICER_DA_SA, 31, 31),
  1338		[POL_DST_INDEX]	= REG_FIELD(ALE_POLICER_DA_SA, 16, 21),
  1339		[POL_SRC_MEN]	= REG_FIELD(ALE_POLICER_DA_SA, 15, 15),
  1340		[POL_SRC_INDEX]	= REG_FIELD(ALE_POLICER_DA_SA, 0, 5),
  1341	
  1342		/* CPSW_ALE_POLICER_VLAN_REG */
  1343		[POL_OVLAN_MEN]		= REG_FIELD(ALE_POLICER_VLAN, 31, 31),
  1344		[POL_OVLAN_INDEX]	= REG_FIELD(ALE_POLICER_VLAN, 16, 21),
  1345		[POL_IVLAN_MEN]		= REG_FIELD(ALE_POLICER_VLAN, 15, 15),
  1346		[POL_IVLAN_INDEX]	= REG_FIELD(ALE_POLICER_VLAN, 0, 5),
  1347	
  1348		/* CPSW_ALE_POLICER_ETHERTYPE_IPSA_REG */
  1349		[POL_ETHERTYPE_MEN]	= REG_FIELD(ALE_POLICER_ETHERTYPE_IPSA, 31, 31),
  1350		[POL_ETHERTYPE_INDEX]	= REG_FIELD(ALE_POLICER_ETHERTYPE_IPSA, 16, 21),
  1351		[POL_IPSRC_MEN]		= REG_FIELD(ALE_POLICER_ETHERTYPE_IPSA, 15, 15),
  1352		[POL_IPSRC_INDEX]	= REG_FIELD(ALE_POLICER_ETHERTYPE_IPSA, 0, 5),
  1353	
  1354		/* CPSW_ALE_POLICER_IPDA_REG */
  1355		[POL_IPDST_MEN]		= REG_FIELD(ALE_POLICER_IPDA, 31, 31),
  1356		[POL_IPDST_INDEX]	= REG_FIELD(ALE_POLICER_IPDA, 16, 21),
  1357	
  1358		/* CPSW_ALE_POLICER_TBL_CTL_REG */
  1359		/**
> 1360		 * REG_FIELDS not defined for this as fields cannot be correctly
  1361		 * used independently
  1362		 */
  1363	
  1364		/* CPSW_ALE_POLICER_CTL_REG */
  1365		[POL_EN]		= REG_FIELD(ALE_POLICER_CTL, 31, 31),
  1366		[POL_RED_DROP_EN]	= REG_FIELD(ALE_POLICER_CTL, 29, 29),
  1367		[POL_YELLOW_DROP_EN]	= REG_FIELD(ALE_POLICER_CTL, 28, 28),
  1368		[POL_YELLOW_THRESH]	= REG_FIELD(ALE_POLICER_CTL, 24, 26),
  1369		[POL_POL_MATCH_MODE]	= REG_FIELD(ALE_POLICER_CTL, 22, 23),
  1370		[POL_PRIORITY_THREAD_EN] = REG_FIELD(ALE_POLICER_CTL, 21, 21),
  1371		[POL_MAC_ONLY_DEF_DIS]	= REG_FIELD(ALE_POLICER_CTL, 20, 20),
  1372	
  1373		/* CPSW_ALE_POLICER_TEST_CTL_REG */
  1374		[POL_TEST_CLR]		= REG_FIELD(ALE_POLICER_TEST_CTL, 31, 31),
  1375		[POL_TEST_CLR_RED]	= REG_FIELD(ALE_POLICER_TEST_CTL, 30, 30),
  1376		[POL_TEST_CLR_YELLOW]	= REG_FIELD(ALE_POLICER_TEST_CTL, 29, 29),
  1377		[POL_TEST_CLR_SELECTED]	= REG_FIELD(ALE_POLICER_TEST_CTL, 28, 28),
  1378		[POL_TEST_ENTRY]	= REG_FIELD(ALE_POLICER_TEST_CTL, 0, 4),
  1379	
  1380		/* CPSW_ALE_POLICER_HIT_STATUS_REG */
  1381		[POL_STATUS_HIT]	= REG_FIELD(ALE_POLICER_HIT_STATUS, 31, 31),
  1382		[POL_STATUS_HIT_RED]	= REG_FIELD(ALE_POLICER_HIT_STATUS, 30, 30),
  1383		[POL_STATUS_HIT_YELLOW]	= REG_FIELD(ALE_POLICER_HIT_STATUS, 29, 29),
  1384	
  1385		/* CPSW_ALE_THREAD_DEF_REG */
  1386		[ALE_DEFAULT_THREAD_EN]		= REG_FIELD(ALE_THREAD_DEF, 15, 15),
  1387		[ALE_DEFAULT_THREAD_VAL]	= REG_FIELD(ALE_THREAD_DEF, 0, 5),
  1388	
  1389		/* CPSW_ALE_THREAD_CTL_REG */
  1390		[ALE_THREAD_CLASS_INDEX] = REG_FIELD(ALE_THREAD_CTL, 0, 4),
  1391	
  1392		/* CPSW_ALE_THREAD_VAL_REG */
  1393		[ALE_THREAD_ENABLE]	= REG_FIELD(ALE_THREAD_VAL, 15, 15),
  1394		[ALE_THREAD_VALUE]	= REG_FIELD(ALE_THREAD_VAL, 0, 5),
  1395	};
  1396	

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

Powered by blists - more mailing lists

Powered by Openwall GNU/*/Linux Powered by OpenVZ