[anolis-intel-cloud:intel-6.6-CWF-RDT-ANBZ24559 25/25] drivers/net/ethernet/wangxun/ngbe/ngbe_main.c:2478: warning: Function parameter or member 'queues' not described in 'ngbe_irq_enable'

[anolis-intel-cloud:intel-6.6-CWF-RDT-ANBZ24559 25/25] drivers/net/ethernet/wangxun/ngbe/ngbe_main.c:2478: warning: Function parameter or member 'queues' not described in 'ngbe_irq_enable'

[kernel test robot]

tree:   https://gitee.com/anolis/intel-cloud-kernel.git intel-6.6-CWF-RDT-ANBZ24559
head:   48fa9d861c1eb99e9f682fb2623142fb456aa0eb
commit: 788b1c9f47ec15f115d5709c98220c2c17992476 [25/25] anolis:net: wangxun: ngbe: add support for wangxun 1G
config: x86_64-allyesconfig (https://download.01.org/0day-ci/archive/20251212/202512121658.oQFev7oJ-lkp@intel.com/config)
compiler: gcc-14 (Debian 14.2.0-19) 14.2.0
reproduce (this is a W=1 build): (https://download.01.org/0day-ci/archive/20251212/202512121658.oQFev7oJ-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/202512121658.oQFev7oJ-lkp@intel.com/

All warnings (new ones prefixed by >>):

>> drivers/net/ethernet/wangxun/ngbe/ngbe_ptp.c:190: warning: Function parameter or member 'timestamp' not described in 'ngbe_ptp_convert_to_hwtstamp'
   drivers/net/ethernet/wangxun/ngbe/ngbe_ptp.c:190: warning: Excess function parameter 'systim' description in 'ngbe_ptp_convert_to_hwtstamp'
   drivers/net/ethernet/wangxun/ngbe/ngbe_ptp.c:211: warning: expecting prototype for txgbe_ptp_adjfreq(). Prototype was for ngbe_ptp_adjfine() instead
   drivers/net/ethernet/wangxun/ngbe/ngbe_ptp.c:343: warning: Excess function parameter 'eicr' description in 'ngbe_ptp_check_pps_event'
   drivers/net/ethernet/wangxun/ngbe/ngbe_ptp.c:559: warning: Function parameter or member 'adapter' not described in 'ngbe_ptp_rx_hwtstamp'
   drivers/net/ethernet/wangxun/ngbe/ngbe_ptp.c:559: warning: expecting prototype for ngbe_ptp_rx_rgtstamp(). Prototype was for ngbe_ptp_rx_hwtstamp() instead
   drivers/net/ethernet/wangxun/ngbe/ngbe_ptp.c:586: warning: Function parameter or member 'ifr' not described in 'ngbe_ptp_get_ts_config'
   drivers/net/ethernet/wangxun/ngbe/ngbe_ptp.c:586: warning: Excess function parameter 'ifreq' description in 'ngbe_ptp_get_ts_config'
   drivers/net/ethernet/wangxun/ngbe/ngbe_ptp.c:726: warning: Function parameter or member 'ifr' not described in 'ngbe_ptp_set_ts_config'
   drivers/net/ethernet/wangxun/ngbe/ngbe_ptp.c:726: warning: Excess function parameter 'ifreq' description in 'ngbe_ptp_set_ts_config'
--
   drivers/net/ethernet/wangxun/ngbe/ngbe_main.c:637: warning: Function parameter or member 'quiet' not described in 'ngbe_read_reg'
   drivers/net/ethernet/wangxun/ngbe/ngbe_main.c:825: warning: Function parameter or member 'txqueue' not described in 'ngbe_tx_timeout'
>> drivers/net/ethernet/wangxun/ngbe/ngbe_main.c:2478: warning: Function parameter or member 'queues' not described in 'ngbe_irq_enable'
   drivers/net/ethernet/wangxun/ngbe/ngbe_main.c:2478: warning: Function parameter or member 'flush' not described in 'ngbe_irq_enable'
   drivers/net/ethernet/wangxun/ngbe/ngbe_main.c:2874: warning: Function parameter or member 'adapter' not described in 'ngbe_configure_msi_and_legacy'
   drivers/net/ethernet/wangxun/ngbe/ngbe_main.c:3047: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
    * Return a number of entries in the RSS indirection table
   drivers/net/ethernet/wangxun/ngbe/ngbe_main.c:3059: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
    * Write the RETA table to HW
   drivers/net/ethernet/wangxun/ngbe/ngbe_main.c:3270: warning: Function parameter or member 'adapter' not described in 'ngbe_configure_bridge_mode'
   drivers/net/ethernet/wangxun/ngbe/ngbe_main.c:3729: warning: Function parameter or member 'pool' not described in 'ngbe_write_uc_addr_list'
   drivers/net/ethernet/wangxun/ngbe/ngbe_main.c:4745: warning: cannot understand function prototype: 'const u32 def_rss_key[10] = '
>> drivers/net/ethernet/wangxun/ngbe/ngbe_main.c:5694: warning: Function parameter or member 'adapter' not described in 'ngbe_check_hang_subtask'
   drivers/net/ethernet/wangxun/ngbe/ngbe_main.c:5771: warning: Function parameter or member 'adapter' not described in 'ngbe_watchdog_update_link_status'
   drivers/net/ethernet/wangxun/ngbe/ngbe_main.c:5771: warning: expecting prototype for ngbe_watchdog_update_link(). Prototype was for ngbe_watchdog_update_link_status() instead
   drivers/net/ethernet/wangxun/ngbe/ngbe_main.c:5867: warning: Function parameter or member 'adapter' not described in 'ngbe_watchdog_link_is_up'
   drivers/net/ethernet/wangxun/ngbe/ngbe_main.c:5913: warning: Function parameter or member 'adapter' not described in 'ngbe_watchdog_link_is_down'
   drivers/net/ethernet/wangxun/ngbe/ngbe_main.c:5984: warning: Function parameter or member 'adapter' not described in 'ngbe_watchdog_flush_tx'
   drivers/net/ethernet/wangxun/ngbe/ngbe_main.c:6051: warning: Function parameter or member 'adapter' not described in 'ngbe_watchdog_subtask'
   drivers/net/ethernet/wangxun/ngbe/ngbe_main.c:6081: warning: Function parameter or member 't' not described in 'ngbe_service_timer'
>> drivers/net/ethernet/wangxun/ngbe/ngbe_main.c:6081: warning: Excess function parameter 'data' description in 'ngbe_service_timer'
>> drivers/net/ethernet/wangxun/ngbe/ngbe_main.c:6939: warning: Function parameter or member 'dev' not described in 'ngbe_setup_tc'
   drivers/net/ethernet/wangxun/ngbe/ngbe_main.c:6939: warning: Excess function parameter 'netdev' description in 'ngbe_setup_tc'


vim +2478 drivers/net/ethernet/wangxun/ngbe/ngbe_main.c

  2472	
  2473	/**
  2474	 * ngbe_irq_enable - Enable default interrupt generation settings
  2475	 * @adapter: board private structure
  2476	 **/
  2477	void ngbe_irq_enable(struct ngbe_adapter *adapter, bool queues, bool flush)
> 2478	{
  2479		u32 mask = 0;
  2480		struct ngbe_hw *hw = &adapter->hw;
  2481	
  2482		/* enable misc interrupt */
  2483		mask = NGBE_PX_MISC_IEN_MASK;
  2484	
  2485		if (adapter->flags2 & NGBE_FLAG2_TEMP_SENSOR_CAPABLE)
  2486			mask |= NGBE_PX_MISC_IEN_OVER_HEAT;
  2487	
  2488		mask |= NGBE_PX_MISC_IEN_TIMESYNC;
  2489	
  2490		if (hw->gpio_ctl == 1)
  2491			wr32(&adapter->hw, NGBE_GPIO_DDR, 0x1);
  2492		else
  2493			wr32(&adapter->hw, NGBE_GPIO_DDR, 0x0);
  2494	
  2495		wr32(&adapter->hw, NGBE_GPIO_INTEN, 0x3);
  2496		wr32(&adapter->hw, NGBE_GPIO_INTTYPE_LEVEL, 0x0);
  2497		if (adapter->hw.phy.type == ngbe_phy_yt8521s_sfi ||
  2498		    adapter->hw.phy.type == ngbe_phy_internal_yt8521s_sfi ||
  2499		    adapter->hw.phy.type == ngbe_phy_external)
  2500			wr32(&adapter->hw, NGBE_GPIO_POLARITY, 0x0);
  2501		else
  2502			wr32(&adapter->hw, NGBE_GPIO_POLARITY, 0x3);
  2503	
  2504		if (adapter->hw.phy.type == ngbe_phy_yt8521s_sfi ||
  2505		    adapter->hw.phy.type == ngbe_phy_internal_yt8521s_sfi ||
  2506		    adapter->hw.phy.type == ngbe_phy_external)
  2507			mask |= NGBE_PX_MISC_IEN_GPIO;
  2508		//		mask &= ~NGBE_PX_MISC_IEN_GPIO;
  2509	
  2510		wr32(hw, NGBE_PX_MISC_IEN, mask);
  2511	
  2512		/* unmask interrupt */
  2513		if (queues) {
  2514			ngbe_intr_enable(&adapter->hw, NGBE_INTR_ALL);
  2515		} else {
  2516			if (!(adapter->flags2 & NGBE_FLAG2_SRIOV_MISC_IRQ_REMAP))
  2517				ngbe_intr_enable(&adapter->hw, NGBE_INTR_MISC(adapter));
  2518			else
  2519				ngbe_intr_enable(&adapter->hw, NGBE_INTR_MISC_VMDQ(adapter));
  2520		}
  2521	
  2522		/* flush configuration */
  2523		if (flush)
  2524			NGBE_WRITE_FLUSH(&adapter->hw);
  2525	}
  2526	

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