[PATCH v2 21/32] drm/gpusvm: Make drm_gpusvm_for_each_* macros public

[kernel test robot]

Hi Himal,

kernel test robot noticed the following build warnings:

[auto build test WARNING on drm-xe/drm-xe-next]
[cannot apply to linus/master v6.15-rc1 next-20250407]
[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/Himal-Prasad-Ghimiray/drm-xe-Introduce-xe_vma_op_prefetch_range-struct-for-prefetch-of-ranges/20250407-215536
base:   https://gitlab.freedesktop.org/drm/xe/kernel.git drm-xe-next
patch link:    https://lore.kernel.org/r/20250407101719.3350996-22-himal.prasad.ghimiray%40intel.com
patch subject: [PATCH v2 21/32] drm/gpusvm: Make drm_gpusvm_for_each_* macros public
config: alpha-allyesconfig (https://download.01.org/0day-ci/archive/20250408/202504080922.7Yz1JvEt-lkp@intel.com/config)
compiler: alpha-linux-gcc (GCC) 14.2.0
reproduce (this is a W=1 build): (https://download.01.org/0day-ci/archive/20250408/202504080922.7Yz1JvEt-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 at intel.com>
| Closes: https://lore.kernel.org/oe-kbuild-all/202504080922.7Yz1JvEt-lkp@intel.com/

All warnings (new ones prefixed by >>):

>> include/drm/drm_gpusvm.h:586: warning: Function parameter or struct member 'gpusvm__' not described in 'drm_gpusvm_for_each_notifier'
>> include/drm/drm_gpusvm.h:603: warning: Function parameter or struct member 'gpusvm__' not described in 'drm_gpusvm_for_each_notifier_safe'


vim +586 include/drm/drm_gpusvm.h

   573	
   574	/**
   575	 * drm_gpusvm_for_each_notifier() - Iterate over GPU SVM notifiers in a gpusvm
   576	 * @notifier__: Iterator variable for the notifiers
   577	 * @notifier__: Pointer to the GPU SVM notifier
   578	 * @start__: Start address of the notifier
   579	 * @end__: End address of the notifier
   580	 *
   581	 * This macro is used to iterate over GPU SVM notifiers in a gpusvm.
   582	 */
   583	#define drm_gpusvm_for_each_notifier(notifier__, gpusvm__, start__, end__)		\
   584		for ((notifier__) = notifier_iter_first(&(gpusvm__)->root, (start__), (end__) - 1);	\
   585		     (notifier__) && (drm_gpusvm_notifier_start(notifier__) < (end__));		\
 > 586		     (notifier__) = __drm_gpusvm_notifier_next(notifier__))
   587	
   588	/**
   589	 * drm_gpusvm_for_each_notifier_safe() - Safely iterate over GPU SVM notifiers in a gpusvm
   590	 * @notifier__: Iterator variable for the notifiers
   591	 * @next__: Iterator variable for the notifiers temporay storage
   592	 * @notifier__: Pointer to the GPU SVM notifier
   593	 * @start__: Start address of the notifier
   594	 * @end__: End address of the notifier
   595	 *
   596	 * This macro is used to iterate over GPU SVM notifiers in a gpusvm while
   597	 * removing notifiers from it.
   598	 */
   599	#define drm_gpusvm_for_each_notifier_safe(notifier__, next__, gpusvm__, start__, end__)	\
   600		for ((notifier__) = notifier_iter_first(&(gpusvm__)->root, (start__), (end__) - 1),	\
   601		     (next__) = __drm_gpusvm_notifier_next(notifier__);				\
   602		     (notifier__) && (drm_gpusvm_notifier_start(notifier__) < (end__));		\
 > 603		     (notifier__) = (next__), (next__) = __drm_gpusvm_notifier_next(notifier__))
   604	

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