[<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