Re: [PATCH] scripts/kernel-doc: restore warning for Excess struct/union

From: kernel test robot
Date: Fri Dec 15 2023 - 01:50:06 EST


Hi Randy,

kernel test robot noticed the following build warnings:

[auto build test WARNING on lwn/docs-next]
[also build test WARNING on linus/master v6.7-rc5 next-20231215]
[If your patch is applied to the wrong git tree, kindly drop us a note.
And when submitting patch, we suggest to use '--base' as documented in
https://git-scm.com/docs/git-format-patch#_base_tree_information]

url: https://github.com/intel-lab-lkp/linux/commits/Randy-Dunlap/scripts-kernel-doc-restore-warning-for-Excess-struct-union/20231214-150722
base: git://git.lwn.net/linux.git docs-next
patch link: https://lore.kernel.org/r/20231214070200.24405-1-rdunlap%40infradead.org
patch subject: [PATCH] scripts/kernel-doc: restore warning for Excess struct/union
config: arm64-defconfig (https://download.01.org/0day-ci/archive/20231215/202312151453.AaH01Gw5-lkp@xxxxxxxxx/config)
compiler: aarch64-linux-gcc (GCC) 13.2.0
reproduce (this is a W=1 build): (https://download.01.org/0day-ci/archive/20231215/202312151453.AaH01Gw5-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/202312151453.AaH01Gw5-lkp@xxxxxxxxx/

All warnings (new ones prefixed by >>):

>> drivers/mailbox/zynqmp-ipi-mailbox.c:92: warning: Excess struct member 'irq' description in 'zynqmp_ipi_mbox'
>> drivers/mailbox/zynqmp-ipi-mailbox.c:112: warning: Excess struct member 'ipi_mboxes' description in 'zynqmp_ipi_pdata'
--
>> drivers/pinctrl/pinctrl-zynqmp.c:60: warning: Excess struct member 'node' description in 'zynqmp_pmux_function'
--
>> drivers/pwm/pwm-mediatek.c:60: warning: Excess struct member 'clk_freq' description in 'pwm_mediatek_chip'
--
>> drivers/net/ipa/ipa_power.c:71: warning: Excess struct member 'interconnect' description in 'ipa_power'
--
>> drivers/media/platform/mediatek/vcodec/decoder/vdec/vdec_vp8_req_if.c:57: warning: Excess struct member 'wait_key_frame' description in 'vdec_vp8_slice_info'
--
>> drivers/media/platform/mediatek/vcodec/decoder/vdec/vdec_vp9_req_lat_if.c:166: warning: Excess struct member 'mv_joint' description in 'vdec_vp9_slice_counts_map'


vim +92 drivers/mailbox/zynqmp-ipi-mailbox.c

4981b82ba2ff87d Wendy Liang 2019-02-21 74
4981b82ba2ff87d Wendy Liang 2019-02-21 75 /**
4981b82ba2ff87d Wendy Liang 2019-02-21 76 * struct zynqmp_ipi_mbox - Description of a ZynqMP IPI mailbox
4981b82ba2ff87d Wendy Liang 2019-02-21 77 * platform data.
4981b82ba2ff87d Wendy Liang 2019-02-21 78 * @pdata: pointer to the IPI private data
4981b82ba2ff87d Wendy Liang 2019-02-21 79 * @dev: device pointer corresponding to the Xilinx ZynqMP
4981b82ba2ff87d Wendy Liang 2019-02-21 80 * IPI mailbox
4981b82ba2ff87d Wendy Liang 2019-02-21 81 * @remote_id: remote IPI agent ID
4981b82ba2ff87d Wendy Liang 2019-02-21 82 * @mbox: mailbox Controller
4981b82ba2ff87d Wendy Liang 2019-02-21 83 * @mchans: array for channels, tx channel and rx channel.
4981b82ba2ff87d Wendy Liang 2019-02-21 84 * @irq: IPI agent interrupt ID
4981b82ba2ff87d Wendy Liang 2019-02-21 85 */
4981b82ba2ff87d Wendy Liang 2019-02-21 86 struct zynqmp_ipi_mbox {
4981b82ba2ff87d Wendy Liang 2019-02-21 87 struct zynqmp_ipi_pdata *pdata;
4981b82ba2ff87d Wendy Liang 2019-02-21 88 struct device dev;
4981b82ba2ff87d Wendy Liang 2019-02-21 89 u32 remote_id;
4981b82ba2ff87d Wendy Liang 2019-02-21 90 struct mbox_controller mbox;
4981b82ba2ff87d Wendy Liang 2019-02-21 91 struct zynqmp_ipi_mchan mchans[2];
4981b82ba2ff87d Wendy Liang 2019-02-21 @92 };
4981b82ba2ff87d Wendy Liang 2019-02-21 93
4981b82ba2ff87d Wendy Liang 2019-02-21 94 /**
4981b82ba2ff87d Wendy Liang 2019-02-21 95 * struct zynqmp_ipi_pdata - Description of z ZynqMP IPI agent platform data.
4981b82ba2ff87d Wendy Liang 2019-02-21 96 *
4981b82ba2ff87d Wendy Liang 2019-02-21 97 * @dev: device pointer corresponding to the Xilinx ZynqMP
4981b82ba2ff87d Wendy Liang 2019-02-21 98 * IPI agent
4981b82ba2ff87d Wendy Liang 2019-02-21 99 * @irq: IPI agent interrupt ID
4981b82ba2ff87d Wendy Liang 2019-02-21 100 * @method: IPI SMC or HVC is going to be used
4981b82ba2ff87d Wendy Liang 2019-02-21 101 * @local_id: local IPI agent ID
4981b82ba2ff87d Wendy Liang 2019-02-21 102 * @num_mboxes: number of mailboxes of this IPI agent
4981b82ba2ff87d Wendy Liang 2019-02-21 103 * @ipi_mboxes: IPI mailboxes of this IPI agent
4981b82ba2ff87d Wendy Liang 2019-02-21 104 */
4981b82ba2ff87d Wendy Liang 2019-02-21 105 struct zynqmp_ipi_pdata {
4981b82ba2ff87d Wendy Liang 2019-02-21 106 struct device *dev;
4981b82ba2ff87d Wendy Liang 2019-02-21 107 int irq;
4981b82ba2ff87d Wendy Liang 2019-02-21 108 unsigned int method;
4981b82ba2ff87d Wendy Liang 2019-02-21 109 u32 local_id;
4981b82ba2ff87d Wendy Liang 2019-02-21 110 int num_mboxes;
c5225cd073c65a6 Kees Cook 2023-09-22 111 struct zynqmp_ipi_mbox ipi_mboxes[] __counted_by(num_mboxes);
4981b82ba2ff87d Wendy Liang 2019-02-21 @112 };
4981b82ba2ff87d Wendy Liang 2019-02-21 113

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