drivers/remoteproc/da8xx_remoteproc.c:80: warning: Function parameter or member 'dsp_reset' not described in 'da8xx_rproc'

[kernel test robot <lkp@intel.com>]

Hi Bartosz,

FYI, the error/warning still remains.

tree:   https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git master
head:   b78b18fb8ee19f7a05f20c3abc865b3bfe182884
commit: b2201ee554a5811f569f31280b0079e7d6177606 remoteproc/davinci: use the reset framework
date:   5 years ago
config: arm-randconfig-004-20230928 (https://download.01.org/0day-ci/archive/20231006/202310062044.AWGLMitV-lkp@intel.com/config)
compiler: arm-linux-gnueabi-gcc (GCC) 13.2.0
reproduce (this is a W=1 build): (https://download.01.org/0day-ci/archive/20231006/202310062044.AWGLMitV-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/202310062044.AWGLMitV-lkp@intel.com/

All warnings (new ones prefixed by >>):

>> drivers/remoteproc/da8xx_remoteproc.c:80: warning: Function parameter or member 'dsp_reset' not described in 'da8xx_rproc'
   drivers/remoteproc/da8xx_remoteproc.c:89: warning: Function parameter or member 'irq' not described in 'handle_event'
   drivers/remoteproc/da8xx_remoteproc.c:89: warning: Function parameter or member 'p' not described in 'handle_event'
   drivers/remoteproc/da8xx_remoteproc.c:109: warning: Function parameter or member 'irq' not described in 'da8xx_rproc_callback'
   drivers/remoteproc/da8xx_remoteproc.c:109: warning: Function parameter or member 'p' not described in 'da8xx_rproc_callback'


vim +80 drivers/remoteproc/da8xx_remoteproc.c

59b2355fc90e4a Suman Anna          2017-08-01  56  
13be5432d8721d Robert Tivy         2013-04-09  57  /**
13be5432d8721d Robert Tivy         2013-04-09  58   * struct da8xx_rproc - da8xx remote processor instance state
13be5432d8721d Robert Tivy         2013-04-09  59   * @rproc: rproc handle
59b2355fc90e4a Suman Anna          2017-08-01  60   * @mem: internal memory regions data
59b2355fc90e4a Suman Anna          2017-08-01  61   * @num_mems: number of internal memory regions
13be5432d8721d Robert Tivy         2013-04-09  62   * @dsp_clk: placeholder for platform's DSP clk
13be5432d8721d Robert Tivy         2013-04-09  63   * @ack_fxn: chip-specific ack function for ack'ing irq
13be5432d8721d Robert Tivy         2013-04-09  64   * @irq_data: ack_fxn function parameter
13be5432d8721d Robert Tivy         2013-04-09  65   * @chipsig: virt ptr to DSP interrupt registers (CHIPSIG & CHIPSIG_CLR)
13be5432d8721d Robert Tivy         2013-04-09  66   * @bootreg: virt ptr to DSP boot address register (HOST1CFG)
13be5432d8721d Robert Tivy         2013-04-09  67   * @irq: irq # used by this instance
13be5432d8721d Robert Tivy         2013-04-09  68   */
13be5432d8721d Robert Tivy         2013-04-09  69  struct da8xx_rproc {
13be5432d8721d Robert Tivy         2013-04-09  70  	struct rproc *rproc;
59b2355fc90e4a Suman Anna          2017-08-01  71  	struct da8xx_rproc_mem *mem;
59b2355fc90e4a Suman Anna          2017-08-01  72  	int num_mems;
13be5432d8721d Robert Tivy         2013-04-09  73  	struct clk *dsp_clk;
b2201ee554a581 Bartosz Golaszewski 2018-06-21  74  	struct reset_control *dsp_reset;
13be5432d8721d Robert Tivy         2013-04-09  75  	void (*ack_fxn)(struct irq_data *data);
13be5432d8721d Robert Tivy         2013-04-09  76  	struct irq_data *irq_data;
13be5432d8721d Robert Tivy         2013-04-09  77  	void __iomem *chipsig;
13be5432d8721d Robert Tivy         2013-04-09  78  	void __iomem *bootreg;
13be5432d8721d Robert Tivy         2013-04-09  79  	int irq;
13be5432d8721d Robert Tivy         2013-04-09 @80  };
13be5432d8721d Robert Tivy         2013-04-09  81  

:::::: The code at line 80 was first introduced by commit
:::::: 13be5432d8721d89cadae105663761f45f427842 remoteproc/davinci: add a remoteproc driver for OMAP-L13x DSP

:::::: TO: Robert Tivy <rtivy@ti.com>
:::::: CC: Ohad Ben-Cohen <ohad@wizery.com>

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