Re: [PATCH v2 2/6] i3c: master: svc: add hot join support

From: kernel test robot
Date: Wed Oct 18 2023 - 21:28:12 EST


Hi Frank,

kernel test robot noticed the following build warnings:

[auto build test WARNING on linus/master]
[also build test WARNING on v6.6-rc6 next-20231018]
[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/Frank-Li/i3c-master-add-enable-disable-hot-join-in-sys-entry/20231019-051444
base: linus/master
patch link: https://lore.kernel.org/r/20231018205929.3435110-3-Frank.Li%40nxp.com
patch subject: [PATCH v2 2/6] i3c: master: svc: add hot join support
config: m68k-allyesconfig (https://download.01.org/0day-ci/archive/20231019/202310190611.b14M4mH3-lkp@xxxxxxxxx/config)
compiler: m68k-linux-gcc (GCC) 13.2.0
reproduce (this is a W=1 build): (https://download.01.org/0day-ci/archive/20231019/202310190611.b14M4mH3-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 <yujie.liu@xxxxxxxxx>
| Closes: https://lore.kernel.org/r/202310190611.b14M4mH3-lkp@xxxxxxxxx/

All warnings (new ones prefixed by >>):

drivers/i3c/master/svc-i3c-master.c:212: warning: Function parameter or member 'lock' not described in 'svc_i3c_master'
>> drivers/i3c/master/svc-i3c-master.c:212: warning: Function parameter or member 'enabled_events' not described in 'svc_i3c_master'
2 warnings as Errors


vim +212 drivers/i3c/master/svc-i3c-master.c

1c5ee2a77b1bac Clark Wang 2023-05-17 157
dd3c52846d5954 Miquel Raynal 2021-01-21 158 /**
dd3c52846d5954 Miquel Raynal 2021-01-21 159 * struct svc_i3c_master - Silvaco I3C Master structure
dd3c52846d5954 Miquel Raynal 2021-01-21 160 * @base: I3C master controller
dd3c52846d5954 Miquel Raynal 2021-01-21 161 * @dev: Corresponding device
dd3c52846d5954 Miquel Raynal 2021-01-21 162 * @regs: Memory mapping
5496eac6ad7428 Miquel Raynal 2023-08-17 163 * @saved_regs: Volatile values for PM operations
dd3c52846d5954 Miquel Raynal 2021-01-21 164 * @free_slots: Bit array of available slots
dd3c52846d5954 Miquel Raynal 2021-01-21 165 * @addrs: Array containing the dynamic addresses of each attached device
dd3c52846d5954 Miquel Raynal 2021-01-21 166 * @descs: Array of descriptors, one per attached device
dd3c52846d5954 Miquel Raynal 2021-01-21 167 * @hj_work: Hot-join work
dd3c52846d5954 Miquel Raynal 2021-01-21 168 * @ibi_work: IBI work
dd3c52846d5954 Miquel Raynal 2021-01-21 169 * @irq: Main interrupt
dd3c52846d5954 Miquel Raynal 2021-01-21 170 * @pclk: System clock
dd3c52846d5954 Miquel Raynal 2021-01-21 171 * @fclk: Fast clock (bus)
dd3c52846d5954 Miquel Raynal 2021-01-21 172 * @sclk: Slow clock (other events)
dd3c52846d5954 Miquel Raynal 2021-01-21 173 * @xferqueue: Transfer queue structure
dd3c52846d5954 Miquel Raynal 2021-01-21 174 * @xferqueue.list: List member
dd3c52846d5954 Miquel Raynal 2021-01-21 175 * @xferqueue.cur: Current ongoing transfer
dd3c52846d5954 Miquel Raynal 2021-01-21 176 * @xferqueue.lock: Queue lock
dd3c52846d5954 Miquel Raynal 2021-01-21 177 * @ibi: IBI structure
dd3c52846d5954 Miquel Raynal 2021-01-21 178 * @ibi.num_slots: Number of slots available in @ibi.slots
dd3c52846d5954 Miquel Raynal 2021-01-21 179 * @ibi.slots: Available IBI slots
dd3c52846d5954 Miquel Raynal 2021-01-21 180 * @ibi.tbq_slot: To be queued IBI slot
dd3c52846d5954 Miquel Raynal 2021-01-21 181 * @ibi.lock: IBI lock

* @lock: <description>
* @enabled_events: <description>

dd3c52846d5954 Miquel Raynal 2021-01-21 182 */
dd3c52846d5954 Miquel Raynal 2021-01-21 183 struct svc_i3c_master {
dd3c52846d5954 Miquel Raynal 2021-01-21 184 struct i3c_master_controller base;
dd3c52846d5954 Miquel Raynal 2021-01-21 185 struct device *dev;
dd3c52846d5954 Miquel Raynal 2021-01-21 186 void __iomem *regs;
1c5ee2a77b1bac Clark Wang 2023-05-17 187 struct svc_i3c_regs_save saved_regs;
dd3c52846d5954 Miquel Raynal 2021-01-21 188 u32 free_slots;
dd3c52846d5954 Miquel Raynal 2021-01-21 189 u8 addrs[SVC_I3C_MAX_DEVS];
dd3c52846d5954 Miquel Raynal 2021-01-21 190 struct i3c_dev_desc *descs[SVC_I3C_MAX_DEVS];
dd3c52846d5954 Miquel Raynal 2021-01-21 191 struct work_struct hj_work;
dd3c52846d5954 Miquel Raynal 2021-01-21 192 struct work_struct ibi_work;
dd3c52846d5954 Miquel Raynal 2021-01-21 193 int irq;
dd3c52846d5954 Miquel Raynal 2021-01-21 194 struct clk *pclk;
dd3c52846d5954 Miquel Raynal 2021-01-21 195 struct clk *fclk;
dd3c52846d5954 Miquel Raynal 2021-01-21 196 struct clk *sclk;
dd3c52846d5954 Miquel Raynal 2021-01-21 197 struct {
dd3c52846d5954 Miquel Raynal 2021-01-21 198 struct list_head list;
dd3c52846d5954 Miquel Raynal 2021-01-21 199 struct svc_i3c_xfer *cur;
dd3c52846d5954 Miquel Raynal 2021-01-21 200 /* Prevent races between transfers */
dd3c52846d5954 Miquel Raynal 2021-01-21 201 spinlock_t lock;
dd3c52846d5954 Miquel Raynal 2021-01-21 202 } xferqueue;
dd3c52846d5954 Miquel Raynal 2021-01-21 203 struct {
dd3c52846d5954 Miquel Raynal 2021-01-21 204 unsigned int num_slots;
dd3c52846d5954 Miquel Raynal 2021-01-21 205 struct i3c_dev_desc **slots;
dd3c52846d5954 Miquel Raynal 2021-01-21 206 struct i3c_ibi_slot *tbq_slot;
dd3c52846d5954 Miquel Raynal 2021-01-21 207 /* Prevent races within IBI handlers */
dd3c52846d5954 Miquel Raynal 2021-01-21 208 spinlock_t lock;
dd3c52846d5954 Miquel Raynal 2021-01-21 209 } ibi;
85bebb554b09b1 Frank Li 2023-10-16 210 struct mutex lock;
e00571e38f466c Frank Li 2023-10-18 211 int enabled_events;
dd3c52846d5954 Miquel Raynal 2021-01-21 @212 };
dd3c52846d5954 Miquel Raynal 2021-01-21 213

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