public inbox for linux-kernel@vger.kernel.org
 help / color / mirror / Atom feed
From: kernel test robot <lkp@intel.com>
To: Randy Dunlap <rdunlap@infradead.org>
Cc: oe-kbuild-all@lists.linux.dev, linux-kernel@vger.kernel.org,
	Wolfram Sang <wsa-dev@sang-engineering.com>
Subject: drivers/i2c/busses/i2c-axxia.c:150: warning: Function parameter or member 'slave' not described in 'axxia_i2c_dev'
Date: Wed, 18 Oct 2023 10:24:52 +0800	[thread overview]
Message-ID: <202310181049.Vo62moV1-lkp@intel.com> (raw)

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@intel.com/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@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@intel.com>
| Closes: https://lore.kernel.org/oe-kbuild-all/202310181049.Vo62moV1-lkp@intel.com/

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@avagotech.com>
:::::: CC: Wolfram Sang <wsa@the-dreams.de>

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

                 reply	other threads:[~2023-10-18  2:25 UTC|newest]

Thread overview: [no followups] expand[flat|nested]  mbox.gz  Atom feed

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=202310181049.Vo62moV1-lkp@intel.com \
    --to=lkp@intel.com \
    --cc=linux-kernel@vger.kernel.org \
    --cc=oe-kbuild-all@lists.linux.dev \
    --cc=rdunlap@infradead.org \
    --cc=wsa-dev@sang-engineering.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox