Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

intel: clean up mismatched header comments

A bunch of header comments were showing warnings when compiling
with W=1. Fix them all at once. This changes only comments.

Signed-off-by: Jesse Brandeburg <jesse.brandeburg@intel.com>
Signed-off-by: Tony Nguyen <anthony.l.nguyen@intel.com>

authored by

Jesse Brandeburg and committed by
Tony Nguyen
262de08f 39da2cac

+61 -53
+2 -2
drivers/net/ethernet/intel/fm10k/fm10k_dcbnl.c
··· 105 105 } 106 106 107 107 /** 108 - * fm10k_dcbnl_ieee_getdcbx - get the DCBX configuration for the device 108 + * fm10k_dcbnl_getdcbx - get the DCBX configuration for the device 109 109 * @dev: netdev interface for the device 110 110 * 111 111 * Returns that we support only IEEE DCB for this interface ··· 116 116 } 117 117 118 118 /** 119 - * fm10k_dcbnl_ieee_setdcbx - get the DCBX configuration for the device 119 + * fm10k_dcbnl_setdcbx - get the DCBX configuration for the device 120 120 * @dev: netdev interface for the device 121 121 * @mode: new mode for this device 122 122 *
+1 -1
drivers/net/ethernet/intel/fm10k/fm10k_debugfs.c
··· 185 185 } 186 186 187 187 /** 188 - * fm10k_dbg_free_q_vector_dir - setup debugfs for the q_vectors 188 + * fm10k_dbg_q_vector_exit - setup debugfs for the q_vectors 189 189 * @q_vector: q_vector to allocate directories for 190 190 **/ 191 191 void fm10k_dbg_q_vector_exit(struct fm10k_q_vector *q_vector)
+2 -2
drivers/net/ethernet/intel/fm10k/fm10k_main.c
··· 1774 1774 } 1775 1775 1776 1776 /** 1777 - * f10k_reset_msix_capability - reset MSI-X capability 1777 + * fm10k_reset_msix_capability - reset MSI-X capability 1778 1778 * @interface: board private structure to initialize 1779 1779 * 1780 1780 * Reset the MSI-X capability back to its starting state ··· 1787 1787 } 1788 1788 1789 1789 /** 1790 - * f10k_init_msix_capability - configure MSI-X capability 1790 + * fm10k_init_msix_capability - configure MSI-X capability 1791 1791 * @interface: board private structure to initialize 1792 1792 * 1793 1793 * Attempt to configure the interrupts using the best available
+1 -1
drivers/net/ethernet/intel/fm10k/fm10k_mbx.c
··· 692 692 } 693 693 694 694 /** 695 - * fm10k_mbx_deqeueue_rx - Dequeues the message from the head in the Rx FIFO 695 + * fm10k_mbx_dequeue_rx - Dequeues the message from the head in the Rx FIFO 696 696 * @hw: pointer to hardware structure 697 697 * @mbx: pointer to mailbox 698 698 *
+1 -1
drivers/net/ethernet/intel/fm10k/fm10k_pf.c
··· 1417 1417 } 1418 1418 1419 1419 /** 1420 - * fm10k_update_stats_hw_pf - Updates hardware related statistics of PF 1420 + * fm10k_update_hw_stats_pf - Updates hardware related statistics of PF 1421 1421 * @hw: pointer to hardware structure 1422 1422 * @stats: pointer to the stats structure to update 1423 1423 *
+3 -3
drivers/net/ethernet/intel/i40e/i40e_common.c
··· 2332 2332 } 2333 2333 2334 2334 /** 2335 - * i40e_get_vsi_params - get VSI configuration info 2335 + * i40e_aq_get_vsi_params - get VSI configuration info 2336 2336 * @hw: pointer to the hw struct 2337 2337 * @vsi_ctx: pointer to a vsi context struct 2338 2338 * @cmd_details: pointer to command details structure or NULL ··· 2586 2586 } 2587 2587 2588 2588 /** 2589 - * i40e_updatelink_status - update status of the HW network link 2589 + * i40e_update_link_info - update status of the HW network link 2590 2590 * @hw: pointer to the hw struct 2591 2591 **/ 2592 2592 noinline_for_stack i40e_status i40e_update_link_info(struct i40e_hw *hw) ··· 5059 5059 } 5060 5060 5061 5061 /** 5062 - * i40e_blink_phy_led 5062 + * i40e_blink_phy_link_led 5063 5063 * @hw: pointer to the HW structure 5064 5064 * @time: time how long led will blinks in secs 5065 5065 * @interval: gap between LED on and off in msecs
+2 -2
drivers/net/ethernet/intel/i40e/i40e_dcb.c
··· 234 234 } 235 235 236 236 /** 237 - * i40e_parse_ieee_etsrec_tlv 237 + * i40e_parse_ieee_tlv 238 238 * @tlv: IEEE 802.1Qaz TLV 239 239 * @dcbcfg: Local store to update ETS REC data 240 240 * ··· 1588 1588 } 1589 1589 1590 1590 /** 1591 - * i40e_dcb_hw_rx_ets_bw_config 1591 + * i40e_dcb_hw_rx_up2tc_config 1592 1592 * @hw: pointer to the hw struct 1593 1593 * @prio_tc: priority to tc assignment indexed by priority 1594 1594 *
+1 -1
drivers/net/ethernet/intel/i40e/i40e_dcb_nl.c
··· 392 392 } 393 393 394 394 /** 395 - * i40e_dcbnl_set_pg_tc_cfg_tx - Set CEE PG Tx BW config 395 + * i40e_dcbnl_set_pg_bwg_cfg_tx - Set CEE PG Tx BW config 396 396 * @netdev: the corresponding netdev 397 397 * @pgid: the corresponding traffic class 398 398 * @bw_pct: the BW percentage for the specified traffic class
+1 -1
drivers/net/ethernet/intel/i40e/i40e_ddp.c
··· 77 77 } 78 78 79 79 /** 80 - * i40e_ddp_does_profiles_ - checks if DDP overlaps with existing one. 80 + * i40e_ddp_does_profile_overlap - checks if DDP overlaps with existing one. 81 81 * @hw: HW data structure 82 82 * @pinfo: DDP profile information structure 83 83 *
+2 -2
drivers/net/ethernet/intel/i40e/i40e_debugfs.c
··· 651 651 } 652 652 653 653 /** 654 - * i40e_dbg_dump_stats - handles dump stats write into command datum 654 + * i40e_dbg_dump_eth_stats - handles dump stats write into command datum 655 655 * @pf: the i40e_pf created in command write 656 656 * @estats: the eth stats structure to be dumped 657 657 **/ ··· 1638 1638 static char i40e_dbg_netdev_ops_buf[256] = ""; 1639 1639 1640 1640 /** 1641 - * i40e_dbg_netdev_ops - read for netdev_ops datum 1641 + * i40e_dbg_netdev_ops_read - read for netdev_ops datum 1642 1642 * @filp: the opened file 1643 1643 * @buffer: where to write the data for the user to read 1644 1644 * @count: the size of the user's buffer
+1 -1
drivers/net/ethernet/intel/i40e/i40e_ethtool.c
··· 212 212 } 213 213 214 214 /** 215 - * 40e_add_stat_strings - copy stat strings into ethtool buffer 215 + * i40e_add_stat_strings - copy stat strings into ethtool buffer 216 216 * @p: ethtool supplied buffer 217 217 * @stats: stat definitions array 218 218 *
+1 -1
drivers/net/ethernet/intel/i40e/i40e_lan_hmc.c
··· 511 511 } 512 512 513 513 /** 514 - * i40e_delete_hmc_object - remove hmc objects 514 + * i40e_delete_lan_hmc_object - remove hmc objects 515 515 * @hw: pointer to the HW structure 516 516 * @info: pointer to i40e_hmc_delete_obj_info struct 517 517 *
+3 -3
drivers/net/ethernet/intel/i40e/i40e_main.c
··· 2023 2023 } 2024 2024 2025 2025 /** 2026 - * i40e_next_entry - Get the next non-broadcast filter from a list 2026 + * i40e_next_filter - Get the next non-broadcast filter from a list 2027 2027 * @next: pointer to filter in list 2028 2028 * 2029 2029 * Returns the next non-broadcast filter in the list. Required so that we ··· 5191 5191 } 5192 5192 5193 5193 /** 5194 - * i40e_pf_get_pf_tc_map - Get bitmap for enabled traffic classes 5194 + * i40e_pf_get_tc_map - Get bitmap for enabled traffic classes 5195 5195 * @pf: PF being queried 5196 5196 * 5197 5197 * Return a bitmap for enabled traffic classes for this PF. ··· 9454 9454 } 9455 9455 9456 9456 /** 9457 - * i40e_get_current_atr_count - Get the count of total FD ATR filters programmed 9457 + * i40e_get_current_atr_cnt - Get the count of total FD ATR filters programmed 9458 9458 * @pf: board private structure 9459 9459 **/ 9460 9460 u32 i40e_get_current_atr_cnt(struct i40e_pf *pf)
+1 -1
drivers/net/ethernet/intel/i40e/i40e_nvm.c
··· 4 4 #include "i40e_prototype.h" 5 5 6 6 /** 7 - * i40e_init_nvm_ops - Initialize NVM function pointers 7 + * i40e_init_nvm - Initialize NVM function pointers 8 8 * @hw: pointer to the HW structure 9 9 * 10 10 * Setup the function pointers and the NVM info structure. Should be called
+1 -1
drivers/net/ethernet/intel/i40e/i40e_ptp.c
··· 216 216 } 217 217 218 218 /** 219 - * i40e_ptp_update_latch_events - Read I40E_PRTTSYN_STAT_1 and latch events 219 + * i40e_ptp_get_rx_events - Read I40E_PRTTSYN_STAT_1 and latch events 220 220 * @pf: the PF data structure 221 221 * 222 222 * This function reads I40E_PRTTSYN_STAT_1 and updates the corresponding timers
+1 -1
drivers/net/ethernet/intel/i40e/i40e_txrx.c
··· 3345 3345 } 3346 3346 3347 3347 /** 3348 - * i40e_create_tx_ctx Build the Tx context descriptor 3348 + * i40e_create_tx_ctx - Build the Tx context descriptor 3349 3349 * @tx_ring: ring to create the descriptor on 3350 3350 * @cd_type_cmd_tso_mss: Quad Word 1 3351 3351 * @cd_tunneling: Quad Word 0 - bits 0-31
+1 -1
drivers/net/ethernet/intel/i40e/i40e_xsk.c
··· 628 628 } 629 629 630 630 /** 631 - * i40e_xsk_clean_xdp_ring - Clean the XDP Tx ring on shutdown 631 + * i40e_xsk_clean_tx_ring - Clean the XDP Tx ring on shutdown 632 632 * @tx_ring: XDP Tx ring 633 633 **/ 634 634 void i40e_xsk_clean_tx_ring(struct i40e_ring *tx_ring)
+1 -1
drivers/net/ethernet/intel/iavf/iavf_main.c
··· 2546 2546 } 2547 2547 2548 2548 /** 2549 - * iavf_validate_channel_config - validate queue mapping info 2549 + * iavf_validate_ch_config - validate queue mapping info 2550 2550 * @adapter: board private structure 2551 2551 * @mqprio_qopt: queue parameters 2552 2552 *
+1 -1
drivers/net/ethernet/intel/iavf/iavf_txrx.c
··· 2098 2098 } 2099 2099 2100 2100 /** 2101 - * iavf_create_tx_ctx Build the Tx context descriptor 2101 + * iavf_create_tx_ctx - Build the Tx context descriptor 2102 2102 * @tx_ring: ring to create the descriptor on 2103 2103 * @cd_type_cmd_tso_mss: Quad Word 1 2104 2104 * @cd_tunneling: Quad Word 0 - bits 0-31
+2 -2
drivers/net/ethernet/intel/iavf/iavf_virtchnl.c
··· 1006 1006 } 1007 1007 1008 1008 /** 1009 - * iavf_enable_channel 1009 + * iavf_enable_channels 1010 1010 * @adapter: adapter structure 1011 1011 * 1012 1012 * Request that the PF enable channels as specified by ··· 1047 1047 } 1048 1048 1049 1049 /** 1050 - * iavf_disable_channel 1050 + * iavf_disable_channels 1051 1051 * @adapter: adapter structure 1052 1052 * 1053 1053 * Request that the PF disable channels that are configured
+1 -1
drivers/net/ethernet/intel/igb/e1000_mbx.c
··· 441 441 } 442 442 443 443 /** 444 - * e1000_init_mbx_params_pf - set initial values for pf mailbox 444 + * igb_init_mbx_params_pf - set initial values for pf mailbox 445 445 * @hw: pointer to the HW structure 446 446 * 447 447 * Initializes the hw->mbx struct to correct values for pf mailbox
+3 -3
drivers/net/ethernet/intel/igb/igb_main.c
··· 2037 2037 } 2038 2038 2039 2039 /** 2040 - * Detect and switch function for Media Auto Sense 2040 + * igb_check_swap_media - Detect and switch function for Media Auto Sense 2041 2041 * @adapter: address of the board private structure 2042 2042 **/ 2043 2043 static void igb_check_swap_media(struct igb_adapter *adapter) ··· 4020 4020 } 4021 4021 4022 4022 /** 4023 - * igb_open - Called when a network interface is made active 4023 + * __igb_open - Called when a network interface is made active 4024 4024 * @netdev: network interface device structure 4025 4025 * @resuming: indicates whether we are in a resume call 4026 4026 * ··· 4138 4138 } 4139 4139 4140 4140 /** 4141 - * igb_close - Disables a network interface 4141 + * __igb_close - Disables a network interface 4142 4142 * @netdev: network interface device structure 4143 4143 * @suspending: indicates we are in a suspend call 4144 4144 *
+1 -1
drivers/net/ethernet/intel/ixgbe/ixgbe_82599.c
··· 1351 1351 } 1352 1352 1353 1353 /** 1354 - * ixgbe_atr_add_signature_filter_82599 - Adds a signature hash filter 1354 + * ixgbe_fdir_add_signature_filter_82599 - Adds a signature hash filter 1355 1355 * @hw: pointer to hardware structure 1356 1356 * @input: unique input dword 1357 1357 * @common: compressed common input dword
+7 -8
drivers/net/ethernet/intel/ixgbe/ixgbe_common.c
··· 2707 2707 } 2708 2708 2709 2709 /** 2710 - * ixgbe_enable_rx_buff - Enables the receive data path 2710 + * ixgbe_enable_rx_buff_generic - Enables the receive data path 2711 2711 * @hw: pointer to hardware structure 2712 2712 * 2713 2713 * Enables the receive data path ··· 3029 3029 } 3030 3030 3031 3031 /** 3032 + * ixgbe_set_vmdq_san_mac_generic - Associate VMDq pool index with a rx address 3033 + * @hw: pointer to hardware struct 3034 + * @vmdq: VMDq pool index 3035 + * 3032 3036 * This function should only be involved in the IOV mode. 3033 3037 * In IOV mode, Default pool is next pool after the number of 3034 3038 * VFs advertized and not 0. 3035 3039 * MPSAR table needs to be updated for SAN_MAC RAR [hw->mac.san_mac_rar_index] 3036 - * 3037 - * ixgbe_set_vmdq_san_mac - Associate default VMDq pool index with a rx address 3038 - * @hw: pointer to hardware struct 3039 - * @vmdq: VMDq pool index 3040 3040 **/ 3041 3041 s32 ixgbe_set_vmdq_san_mac_generic(struct ixgbe_hw *hw, u32 vmdq) 3042 3042 { ··· 3896 3896 } 3897 3897 3898 3898 /** 3899 - * ixgbe_get_thermal_sensor_data - Gathers thermal sensor data 3899 + * ixgbe_get_thermal_sensor_data_generic - Gathers thermal sensor data 3900 3900 * @hw: pointer to hardware structure 3901 3901 * 3902 3902 * Returns the thermal sensor data structure ··· 4054 4054 } 4055 4055 4056 4056 /** 4057 - * ixgbe_get_oem_prod_version Etrack ID from EEPROM 4058 - * 4057 + * ixgbe_get_oem_prod_version - Etrack ID from EEPROM 4059 4058 * @hw: pointer to hardware structure 4060 4059 * @nvm_ver: pointer to output structure 4061 4060 *
+2 -2
drivers/net/ethernet/intel/ixgbe/ixgbe_main.c
··· 225 225 } 226 226 227 227 /** 228 - * ixgbe_check_from_parent - Determine whether PCIe info should come from parent 228 + * ixgbe_pcie_from_parent - Determine whether PCIe info should come from parent 229 229 * @hw: hw specific details 230 230 * 231 231 * This function is used by probe to determine whether a device's PCI-Express ··· 6156 6156 } 6157 6157 6158 6158 /** 6159 - * ixgbe_eee_capable - helper function to determine EEE support on X550 6159 + * ixgbe_set_eee_capable - helper function to determine EEE support on X550 6160 6160 * @adapter: board private structure 6161 6161 */ 6162 6162 static void ixgbe_set_eee_capable(struct ixgbe_adapter *adapter)
+3 -2
drivers/net/ethernet/intel/ixgbe/ixgbe_phy.c
··· 461 461 } 462 462 463 463 /** 464 - * ixgbe_read_phy_mdi - Reads a value from a specified PHY register without 465 - * the SWFW lock 464 + * ixgbe_read_phy_reg_mdi - read PHY register 466 465 * @hw: pointer to hardware structure 467 466 * @reg_addr: 32 bit address of PHY register to read 468 467 * @device_type: 5 bit device type 469 468 * @phy_data: Pointer to read data from PHY register 469 + * 470 + * Reads a value from a specified PHY register without the SWFW lock 470 471 **/ 471 472 s32 ixgbe_read_phy_reg_mdi(struct ixgbe_hw *hw, u32 reg_addr, u32 device_type, 472 473 u16 *phy_data)
+1 -1
drivers/net/ethernet/intel/ixgbe/ixgbe_x540.c
··· 701 701 } 702 702 703 703 /** 704 - * ixgbe_release_nvm_semaphore - Release hardware semaphore 704 + * ixgbe_release_swfw_sync_semaphore - Release hardware semaphore 705 705 * @hw: pointer to hardware structure 706 706 * 707 707 * This function clears hardware semaphore bits.
+1 -1
drivers/net/ethernet/intel/ixgbe/ixgbe_x550.c
··· 1248 1248 } 1249 1249 1250 1250 /** 1251 - * ixgbe_fw_recovery_mode - Check FW NVM recovery mode 1251 + * ixgbe_fw_recovery_mode_X550 - Check FW NVM recovery mode 1252 1252 * @hw: pointer t hardware structure 1253 1253 * 1254 1254 * Returns true if in FW NVM recovery mode.
+13 -5
drivers/net/ethernet/intel/ixgbevf/vf.c
··· 121 121 } 122 122 123 123 /** 124 + * ixgbevf_hv_reset_hw_vf - reset via Hyper-V 125 + * @hw: pointer to private hardware struct 126 + * 124 127 * Hyper-V variant; the VF/PF communication is through the PCI 125 128 * config space. 126 - * @hw: pointer to private hardware struct 127 129 */ 128 130 static s32 ixgbevf_hv_reset_hw_vf(struct ixgbe_hw *hw) 129 131 { ··· 515 513 } 516 514 517 515 /** 518 - * Hyper-V variant - just a stub. 516 + * ixgbevf_hv_update_mc_addr_list_vf - stub 519 517 * @hw: unused 520 518 * @netdev: unused 519 + * 520 + * Hyper-V variant - just a stub. 521 521 */ 522 522 static s32 ixgbevf_hv_update_mc_addr_list_vf(struct ixgbe_hw *hw, 523 523 struct net_device *netdev) ··· 568 564 } 569 565 570 566 /** 571 - * Hyper-V variant - just a stub. 567 + * ixgbevf_hv_update_xcast_mode - stub 572 568 * @hw: unused 573 569 * @xcast_mode: unused 570 + * 571 + * Hyper-V variant - just a stub. 574 572 */ 575 573 static s32 ixgbevf_hv_update_xcast_mode(struct ixgbe_hw *hw, int xcast_mode) 576 574 { ··· 614 608 } 615 609 616 610 /** 617 - * Hyper-V variant - just a stub. 611 + * ixgbevf_hv_set_vfta_vf - * Hyper-V variant - just a stub. 618 612 * @hw: unused 619 613 * @vlan: unused 620 614 * @vind: unused ··· 732 726 } 733 727 734 728 /** 735 - * Hyper-V variant; there is no mailbox communication. 729 + * ixgbevf_hv_check_mac_link_vf - check link 736 730 * @hw: pointer to private hardware struct 737 731 * @speed: pointer to link speed 738 732 * @link_up: true is link is up, false otherwise 739 733 * @autoneg_wait_to_complete: unused 734 + * 735 + * Hyper-V variant; there is no mailbox communication. 740 736 */ 741 737 static s32 ixgbevf_hv_check_mac_link_vf(struct ixgbe_hw *hw, 742 738 ixgbe_link_speed *speed,