drivers/i2c/busses/i2c-axxia.c:150: warning: Function parameter or member 'slave' not described in 'axxia_i2c_dev'
From: kernel test robot
Date: Tue Oct 17 2023 - 22:25:07 EST
tree: https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git master
head: 06dc10eae55b5ceabfef287a7e5f16ceea204aa0
commit: e49560f02716839a74a7907200a589c1f990261b i2c: axxia: use 'struct' for kernel-doc notation
date: 9 months ago
config: x86_64-buildonly-randconfig-006-20230906 (https://download.01.org/0day-ci/archive/20231018/202310181049.Vo62moV1-lkp@xxxxxxxxx/config)
compiler: gcc-12 (Debian 12.2.0-14) 12.2.0
reproduce (this is a W=1 build): (https://download.01.org/0day-ci/archive/20231018/202310181049.Vo62moV1-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/202310181049.Vo62moV1-lkp@xxxxxxxxx/
All warnings (new ones prefixed by >>):
>> drivers/i2c/busses/i2c-axxia.c:150: warning: Function parameter or member 'slave' not described in 'axxia_i2c_dev'
>> drivers/i2c/busses/i2c-axxia.c:150: warning: Function parameter or member 'irq' not described in 'axxia_i2c_dev'
drivers/i2c/busses/i2c-axxia.c:172: warning: Function parameter or member 'ns' not described in 'ns_to_clk'
drivers/i2c/busses/i2c-axxia.c:172: warning: Function parameter or member 'clk_mhz' not described in 'ns_to_clk'
drivers/i2c/busses/i2c-axxia.c:271: warning: Function parameter or member 'idev' not described in 'axxia_i2c_empty_rx_fifo'
drivers/i2c/busses/i2c-axxia.c:303: warning: Function parameter or member 'idev' not described in 'axxia_i2c_fill_tx_fifo'
vim +150 drivers/i2c/busses/i2c-axxia.c
08678b850cd0c4 Anders Berg 2014-10-03 119
08678b850cd0c4 Anders Berg 2014-10-03 120 /**
e49560f0271683 Randy Dunlap 2023-01-12 121 * struct axxia_i2c_dev - I2C device context
08678b850cd0c4 Anders Berg 2014-10-03 122 * @base: pointer to register struct
08678b850cd0c4 Anders Berg 2014-10-03 123 * @msg: pointer to current message
3035a66934dadc Adamski, Krzysztof (Nokia - PL/Wroclaw 2018-12-13 124) * @msg_r: pointer to current read message (sequence transfer)
3035a66934dadc Adamski, Krzysztof (Nokia - PL/Wroclaw 2018-12-13 125) * @msg_xfrd: number of bytes transferred in tx_fifo
3035a66934dadc Adamski, Krzysztof (Nokia - PL/Wroclaw 2018-12-13 126) * @msg_xfrd_r: number of bytes transferred in rx_fifo
08678b850cd0c4 Anders Berg 2014-10-03 127 * @msg_err: error code for completed message
08678b850cd0c4 Anders Berg 2014-10-03 128 * @msg_complete: xfer completion object
08678b850cd0c4 Anders Berg 2014-10-03 129 * @dev: device reference
08678b850cd0c4 Anders Berg 2014-10-03 130 * @adapter: core i2c abstraction
08678b850cd0c4 Anders Berg 2014-10-03 131 * @i2c_clk: clock reference for i2c input clock
08678b850cd0c4 Anders Berg 2014-10-03 132 * @bus_clk_rate: current i2c bus clock rate
530edb501ce476 Adamski, Krzysztof (Nokia - PL/Wroclaw 2019-03-28 133) * @last: a flag indicating is this is last message in transfer
08678b850cd0c4 Anders Berg 2014-10-03 134 */
08678b850cd0c4 Anders Berg 2014-10-03 135 struct axxia_i2c_dev {
08678b850cd0c4 Anders Berg 2014-10-03 136 void __iomem *base;
08678b850cd0c4 Anders Berg 2014-10-03 137 struct i2c_msg *msg;
3035a66934dadc Adamski, Krzysztof (Nokia - PL/Wroclaw 2018-12-13 138) struct i2c_msg *msg_r;
08678b850cd0c4 Anders Berg 2014-10-03 139 size_t msg_xfrd;
3035a66934dadc Adamski, Krzysztof (Nokia - PL/Wroclaw 2018-12-13 140) size_t msg_xfrd_r;
08678b850cd0c4 Anders Berg 2014-10-03 141 int msg_err;
08678b850cd0c4 Anders Berg 2014-10-03 142 struct completion msg_complete;
08678b850cd0c4 Anders Berg 2014-10-03 143 struct device *dev;
08678b850cd0c4 Anders Berg 2014-10-03 144 struct i2c_adapter adapter;
08678b850cd0c4 Anders Berg 2014-10-03 145 struct clk *i2c_clk;
08678b850cd0c4 Anders Berg 2014-10-03 146 u32 bus_clk_rate;
530edb501ce476 Adamski, Krzysztof (Nokia - PL/Wroclaw 2019-03-28 147) bool last;
f0b576801d83ce Adamski, Krzysztof (Nokia - PL/Wroclaw 2019-08-19 148) struct i2c_client *slave;
f0b576801d83ce Adamski, Krzysztof (Nokia - PL/Wroclaw 2019-08-19 149) int irq;
08678b850cd0c4 Anders Berg 2014-10-03 @150 };
08678b850cd0c4 Anders Berg 2014-10-03 151
:::::: The code at line 150 was first introduced by commit
:::::: 08678b850cd0c49cc49c7fed0c93f720f85368e8 i2c: axxia: Add I2C driver for AXM55xx
:::::: TO: Anders Berg <anders.berg@xxxxxxxxxxxxx>
:::::: CC: Wolfram Sang <wsa@xxxxxxxxxxxxx>
--
0-DAY CI Kernel Test Service
https://github.com/intel/lkp-tests/wiki