All of lore.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 an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.