[android-common:android-mainline 1398/4922] drivers/dma-buf/dma-heap.c:45: warning: Function parameter or struct member 'refcount' not described in 'dma_heap'

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

tree:   https://android.googlesource.com/kernel/common android-mainline
head:   a1789984ea477a3d4b08364d2a38bb9f8e957236
commit: c700bdd2233e000f089ce54556f987acfc391c7b [1398/4922] ANDROID: dma-heap: Add proper kref handling on dma-buf heaps
config: i386-buildonly-randconfig-004-20240326 (https://download.01.org/0day-ci/archive/20240326/202403261908.BRsMs9AW-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/20240326/202403261908.BRsMs9AW-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/202403261908.BRsMs9AW-lkp@intel.com/

All warnings (new ones prefixed by >>):

   drivers/dma-buf/dma-heap.c:45: warning: Function parameter or struct member 'priv' not described in 'dma_heap'
   drivers/dma-buf/dma-heap.c:45: warning: Function parameter or struct member 'heap_devt' not described in 'dma_heap'
   drivers/dma-buf/dma-heap.c:45: warning: Function parameter or struct member 'list' not described in 'dma_heap'
   drivers/dma-buf/dma-heap.c:45: warning: Function parameter or struct member 'heap_cdev' not described in 'dma_heap'
   drivers/dma-buf/dma-heap.c:45: warning: Function parameter or struct member 'minor' not described in 'dma_heap'
>> drivers/dma-buf/dma-heap.c:45: warning: Function parameter or struct member 'refcount' not described in 'dma_heap'


vim +45 drivers/dma-buf/dma-heap.c

c02a81fba74fe3 Andrew F. Davis 2019-12-03  25  
c02a81fba74fe3 Andrew F. Davis 2019-12-03  26  /**
c02a81fba74fe3 Andrew F. Davis 2019-12-03  27   * struct dma_heap - represents a dmabuf heap in the system
c02a81fba74fe3 Andrew F. Davis 2019-12-03  28   * @name:		used for debugging/device-node name
c02a81fba74fe3 Andrew F. Davis 2019-12-03  29   * @ops:		ops struct for this heap
c02a81fba74fe3 Andrew F. Davis 2019-12-03  30   * @heap_devt		heap device node
c02a81fba74fe3 Andrew F. Davis 2019-12-03  31   * @list		list head connecting to list of heaps
c02a81fba74fe3 Andrew F. Davis 2019-12-03  32   * @heap_cdev		heap char device
c02a81fba74fe3 Andrew F. Davis 2019-12-03  33   *
c02a81fba74fe3 Andrew F. Davis 2019-12-03  34   * Represents a heap of memory from which buffers can be made.
c02a81fba74fe3 Andrew F. Davis 2019-12-03  35   */
c02a81fba74fe3 Andrew F. Davis 2019-12-03  36  struct dma_heap {
c02a81fba74fe3 Andrew F. Davis 2019-12-03  37  	const char *name;
c02a81fba74fe3 Andrew F. Davis 2019-12-03  38  	const struct dma_heap_ops *ops;
c02a81fba74fe3 Andrew F. Davis 2019-12-03  39  	void *priv;
c02a81fba74fe3 Andrew F. Davis 2019-12-03  40  	dev_t heap_devt;
c02a81fba74fe3 Andrew F. Davis 2019-12-03  41  	struct list_head list;
c02a81fba74fe3 Andrew F. Davis 2019-12-03  42  	struct cdev heap_cdev;
c700bdd2233e00 John Stultz     2020-07-25  43  	int minor;
c700bdd2233e00 John Stultz     2020-07-25  44  	struct kref refcount;
c02a81fba74fe3 Andrew F. Davis 2019-12-03 @45  };
c02a81fba74fe3 Andrew F. Davis 2019-12-03  46  

:::::: The code at line 45 was first introduced by commit
:::::: c02a81fba74fe3488ad6b08bfb5a1329005418f8 dma-buf: Add dma-buf heaps framework

:::::: TO: Andrew F. Davis <afd@ti.com>
:::::: CC: Sumit Semwal <sumit.semwal@linaro.org>

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