tree: https://gitee.com/openeuler/kernel.git OLK-6.6 head: 413c8958a89da414e792cff13c7ddb1217f8a693 commit: 394bc797fb96f1eda8dac440dd97e673115d7c78 [3508/3508] wifi: cfg80211: fix kernel-doc for wiphy_delayed_work_flush() reproduce: (https://download.01.org/0day-ci/archive/20251210/202512101158.SZfSVzDP-lkp@i...) 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/202512101158.SZfSVzDP-lkp@intel.com/ All warnings (new ones prefixed by >>): Error: Cannot open file ./include/linux/of_graph.h Error: Cannot open file ./include/linux/of_device.h Error: Cannot open file ./include/linux/of_device.h Error: Cannot open file ./include/linux/of_platform.h Error: Cannot open file ./include/linux/of_platform.h

...

./include/net/cfg80211.h:5891: warning: Excess function parameter 'work' description in 'wiphy_delayed_work_flush' ./include/net/cfg80211.h:5891: warning: Excess function parameter 'work' description in 'wiphy_delayed_work_flush' ./include/net/cfg80211.h:5891: warning: Excess function parameter 'work' description in 'wiphy_delayed_work_flush' ./include/net/cfg80211.h:5891: warning: Excess function parameter 'work' description in 'wiphy_delayed_work_flush' ./include/net/cfg80211.h:5891: warning: Excess function parameter 'work' description in 'wiphy_delayed_work_flush' ./include/net/cfg80211.h:5891: warning: Excess function parameter 'work' description in 'wiphy_delayed_work_flush' ./include/net/cfg80211.h:5891: warning: Excess function parameter 'work' description in 'wiphy_delayed_work_flush' ./include/net/cfg80211.h:5891: warning: Excess function parameter 'work' description in 'wiphy_delayed_work_flush' ./include/net/cfg80211.h:5891: warning: Excess function parameter 'work' description in 'wiphy_delayed_work_flush' ./include/net/cfg80211.h:5891: warning: Excess function parameter 'work' description in 'wiphy_delayed_work_flush' ./include/net/cfg80211.h:5891: warning: Excess function parameter 'work' description in 'wiphy_delayed_work_flush' ./include/net/cfg80211.h:5891: warning: Excess function parameter 'work' description in 'wiphy_delayed_work_flush' ./include/net/cfg80211.h:5891: warning: Excess function parameter 'work' description in 'wiphy_delayed_work_flush' ./include/net/cfg80211.h:5891: warning: Excess function parameter 'work' description in 'wiphy_delayed_work_flush' ./include/net/cfg80211.h:5891: warning: Excess function parameter 'work' description in 'wiphy_delayed_work_flush' ./include/net/cfg80211.h:5891: warning: Excess function parameter 'work' description in 'wiphy_delayed_work_flush' ./include/net/cfg80211.h:5891: warning: Excess function parameter 'work' description in 'wiphy_delayed_work_flush' Error: Cannot open file ./include/linux/aperture.h Error: Cannot open file ./include/linux/aperture.h Error: Cannot open file ./include/linux/auxiliary_bus.h Error: Cannot open file ./include/linux/auxiliary_bus.h Error: Cannot open file ./include/linux/auxiliary_bus.h

vim +5891 ./include/net/cfg80211.h a3ee4dc84c4e9d Johannes Berg 2023-06-06 5853 a3ee4dc84c4e9d Johannes Berg 2023-06-06 5854 /** a3ee4dc84c4e9d Johannes Berg 2023-06-06 5855 * wiphy_delayed_work_queue - queue delayed work for the wiphy a3ee4dc84c4e9d Johannes Berg 2023-06-06 5856 * @wiphy: the wiphy to queue for a3ee4dc84c4e9d Johannes Berg 2023-06-06 5857 * @dwork: the delayable worker a3ee4dc84c4e9d Johannes Berg 2023-06-06 5858 * @delay: number of jiffies to wait before queueing a3ee4dc84c4e9d Johannes Berg 2023-06-06 5859 * a3ee4dc84c4e9d Johannes Berg 2023-06-06 5860 * This is useful for work that must be done asynchronously, and work a3ee4dc84c4e9d Johannes Berg 2023-06-06 5861 * queued here has the special property that the wiphy mutex will be a3ee4dc84c4e9d Johannes Berg 2023-06-06 5862 * held as if wiphy_lock() was called, and that it cannot be running a3ee4dc84c4e9d Johannes Berg 2023-06-06 5863 * after wiphy_lock() was called. Therefore, wiphy_cancel_work() can a3ee4dc84c4e9d Johannes Berg 2023-06-06 5864 * use just cancel_work() instead of cancel_work_sync(), it requires a3ee4dc84c4e9d Johannes Berg 2023-06-06 5865 * being in a section protected by wiphy_lock(). a3ee4dc84c4e9d Johannes Berg 2023-06-06 5866 */ a3ee4dc84c4e9d Johannes Berg 2023-06-06 5867 void wiphy_delayed_work_queue(struct wiphy *wiphy, a3ee4dc84c4e9d Johannes Berg 2023-06-06 5868 struct wiphy_delayed_work *dwork, a3ee4dc84c4e9d Johannes Berg 2023-06-06 5869 unsigned long delay); a3ee4dc84c4e9d Johannes Berg 2023-06-06 5870 a3ee4dc84c4e9d Johannes Berg 2023-06-06 5871 /** a3ee4dc84c4e9d Johannes Berg 2023-06-06 5872 * wiphy_delayed_work_cancel - cancel previously queued delayed work a3ee4dc84c4e9d Johannes Berg 2023-06-06 5873 * @wiphy: the wiphy, for debug purposes a3ee4dc84c4e9d Johannes Berg 2023-06-06 5874 * @dwork: the delayed work to cancel a3ee4dc84c4e9d Johannes Berg 2023-06-06 5875 * a3ee4dc84c4e9d Johannes Berg 2023-06-06 5876 * Cancel the work *without* waiting for it, this assumes being a3ee4dc84c4e9d Johannes Berg 2023-06-06 5877 * called under the wiphy mutex acquired by wiphy_lock(). a3ee4dc84c4e9d Johannes Berg 2023-06-06 5878 */ a3ee4dc84c4e9d Johannes Berg 2023-06-06 5879 void wiphy_delayed_work_cancel(struct wiphy *wiphy, a3ee4dc84c4e9d Johannes Berg 2023-06-06 5880 struct wiphy_delayed_work *dwork); a3ee4dc84c4e9d Johannes Berg 2023-06-06 5881 8137a638e642a1 Johannes Berg 2023-11-23 5882 /** 394bc797fb96f1 Johannes Berg 2023-11-23 5883 * wiphy_delayed_work_flush - flush previously queued delayed work 8137a638e642a1 Johannes Berg 2023-11-23 5884 * @wiphy: the wiphy, for debug purposes 8137a638e642a1 Johannes Berg 2023-11-23 5885 * @work: the work to flush 8137a638e642a1 Johannes Berg 2023-11-23 5886 * 8137a638e642a1 Johannes Berg 2023-11-23 5887 * Flush the work (i.e. run it if pending). This must be called 8137a638e642a1 Johannes Berg 2023-11-23 5888 * under the wiphy mutex acquired by wiphy_lock(). 8137a638e642a1 Johannes Berg 2023-11-23 5889 */ 8137a638e642a1 Johannes Berg 2023-11-23 5890 void wiphy_delayed_work_flush(struct wiphy *wiphy, 8137a638e642a1 Johannes Berg 2023-11-23 @5891 struct wiphy_delayed_work *dwork); 8137a638e642a1 Johannes Berg 2023-11-23 5892 :::::: The code at line 5891 was first introduced by commit :::::: 8137a638e642a1f9d6511c3d2cb8d90bcfe45367 wifi: cfg80211: add flush functions for wiphy work :::::: TO: Johannes Berg <johannes.berg@intel.com> :::::: CC: Zheng Zengkai <zhengzengkai@huawei.com> -- 0-DAY CI Kernel Test Service https://github.com/intel/lkp-tests/wiki