mirrors
/
linux-stable
mirror of https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git
1
0
Fork 0
Code Issues Releases Wiki Activity

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>
This commit is contained in:
Jesse Brandeburg 2021-03-18 16:18:52 -07:00 committed by Tony Nguyen
parent 39da2cac42
commit 262de08f64
29 changed files with 61 additions and 53 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
drivers/net/ethernet/intel/fm10k/fm10k_dcbnl.c
View File

@ -105,7 +105,7 @@ static int fm10k_dcbnl_ieee_setpfc(struct net_device *dev, struct ieee_pfc *pfc)
}
/**
* fm10k_dcbnl_ieee_getdcbx - get the DCBX configuration for the device
* fm10k_dcbnl_getdcbx - get the DCBX configuration for the device
* @dev: netdev interface for the device
*
* Returns that we support only IEEE DCB for this interface
@ -116,7 +116,7 @@ static u8 fm10k_dcbnl_getdcbx(struct net_device __always_unused *dev)
}
/**
* fm10k_dcbnl_ieee_setdcbx - get the DCBX configuration for the device
* fm10k_dcbnl_setdcbx - get the DCBX configuration for the device
* @dev: netdev interface for the device
* @mode: new mode for this device
*

2
drivers/net/ethernet/intel/fm10k/fm10k_debugfs.c
View File

@ -185,7 +185,7 @@ void fm10k_dbg_q_vector_init(struct fm10k_q_vector *q_vector)
}
/**
* fm10k_dbg_free_q_vector_dir - setup debugfs for the q_vectors
* fm10k_dbg_q_vector_exit - setup debugfs for the q_vectors
* @q_vector: q_vector to allocate directories for
**/
void fm10k_dbg_q_vector_exit(struct fm10k_q_vector *q_vector)

4
drivers/net/ethernet/intel/fm10k/fm10k_main.c
View File

@ -1774,7 +1774,7 @@ static void fm10k_free_q_vectors(struct fm10k_intfc *interface)
}
/**
* f10k_reset_msix_capability - reset MSI-X capability
* fm10k_reset_msix_capability - reset MSI-X capability
* @interface: board private structure to initialize
*
* Reset the MSI-X capability back to its starting state
@ -1787,7 +1787,7 @@ static void fm10k_reset_msix_capability(struct fm10k_intfc *interface)
}
/**
* f10k_init_msix_capability - configure MSI-X capability
* fm10k_init_msix_capability - configure MSI-X capability
* @interface: board private structure to initialize
*
* Attempt to configure the interrupts using the best available

2
drivers/net/ethernet/intel/fm10k/fm10k_mbx.c
View File

@ -692,7 +692,7 @@ static bool fm10k_mbx_tx_complete(struct fm10k_mbx_info *mbx)
}
/**
* fm10k_mbx_deqeueue_rx - Dequeues the message from the head in the Rx FIFO
* fm10k_mbx_dequeue_rx - Dequeues the message from the head in the Rx FIFO
* @hw: pointer to hardware structure
* @mbx: pointer to mailbox
*

2
drivers/net/ethernet/intel/fm10k/fm10k_pf.c
View File

@ -1417,7 +1417,7 @@ s32 fm10k_iov_msg_lport_state_pf(struct fm10k_hw *hw, u32 **results,
}
/**
* fm10k_update_stats_hw_pf - Updates hardware related statistics of PF
* fm10k_update_hw_stats_pf - Updates hardware related statistics of PF
* @hw: pointer to hardware structure
* @stats: pointer to the stats structure to update
*

6
drivers/net/ethernet/intel/i40e/i40e_common.c
View File

@ -2332,7 +2332,7 @@ i40e_status i40e_aq_set_vsi_vlan_promisc(struct i40e_hw *hw,
}
/**
* i40e_get_vsi_params - get VSI configuration info
* i40e_aq_get_vsi_params - get VSI configuration info
* @hw: pointer to the hw struct
* @vsi_ctx: pointer to a vsi context struct
* @cmd_details: pointer to command details structure or NULL
@ -2586,7 +2586,7 @@ i40e_status i40e_get_link_status(struct i40e_hw *hw, bool *link_up)
}
/**
* i40e_updatelink_status - update status of the HW network link
* i40e_update_link_info - update status of the HW network link
* @hw: pointer to the hw struct
**/
noinline_for_stack i40e_status i40e_update_link_info(struct i40e_hw *hw)
@ -5059,7 +5059,7 @@ u8 i40e_get_phy_address(struct i40e_hw *hw, u8 dev_num)
}
/**
* i40e_blink_phy_led
* i40e_blink_phy_link_led
* @hw: pointer to the HW structure
* @time: time how long led will blinks in secs
* @interval: gap between LED on and off in msecs

4
drivers/net/ethernet/intel/i40e/i40e_dcb.c
View File

@ -234,7 +234,7 @@ static void i40e_parse_ieee_app_tlv(struct i40e_lldp_org_tlv *tlv,
}
/**
* i40e_parse_ieee_etsrec_tlv
* i40e_parse_ieee_tlv
* @tlv: IEEE 802.1Qaz TLV
* @dcbcfg: Local store to update ETS REC data
*
@ -1588,7 +1588,7 @@ void i40e_dcb_hw_rx_ets_bw_config(struct i40e_hw *hw, u8 *bw_share,
}
/**
* i40e_dcb_hw_rx_ets_bw_config
* i40e_dcb_hw_rx_up2tc_config
* @hw: pointer to the hw struct
* @prio_tc: priority to tc assignment indexed by priority
*

2
drivers/net/ethernet/intel/i40e/i40e_dcb_nl.c
View File

@ -392,7 +392,7 @@ static void i40e_dcbnl_set_pg_tc_cfg_tx(struct net_device *netdev, int tc,
}
/**
* i40e_dcbnl_set_pg_tc_cfg_tx - Set CEE PG Tx BW config
* i40e_dcbnl_set_pg_bwg_cfg_tx - Set CEE PG Tx BW config
* @netdev: the corresponding netdev
* @pgid: the corresponding traffic class
* @bw_pct: the BW percentage for the specified traffic class

2
drivers/net/ethernet/intel/i40e/i40e_ddp.c
View File

@ -77,7 +77,7 @@ static bool i40e_ddp_profiles_overlap(struct i40e_profile_info *new,
}
/**
* i40e_ddp_does_profiles_ - checks if DDP overlaps with existing one.
* i40e_ddp_does_profile_overlap - checks if DDP overlaps with existing one.
* @hw: HW data structure
* @pinfo: DDP profile information structure
*

4
drivers/net/ethernet/intel/i40e/i40e_debugfs.c
View File

@ -651,7 +651,7 @@ static void i40e_dbg_dump_vsi_no_seid(struct i40e_pf *pf)
}
/**
* i40e_dbg_dump_stats - handles dump stats write into command datum
* i40e_dbg_dump_eth_stats - handles dump stats write into command datum
* @pf: the i40e_pf created in command write
* @estats: the eth stats structure to be dumped
**/
@ -1638,7 +1638,7 @@ static const struct file_operations i40e_dbg_command_fops = {
static char i40e_dbg_netdev_ops_buf[256] = "";
/**
* i40e_dbg_netdev_ops - read for netdev_ops datum
* i40e_dbg_netdev_ops_read - read for netdev_ops datum
* @filp: the opened file
* @buffer: where to write the data for the user to read
* @count: the size of the user's buffer

2
drivers/net/ethernet/intel/i40e/i40e_ethtool.c
View File

@ -212,7 +212,7 @@ static void __i40e_add_stat_strings(u8 **p, const struct i40e_stats stats[],
}
/**
* 40e_add_stat_strings - copy stat strings into ethtool buffer
* i40e_add_stat_strings - copy stat strings into ethtool buffer
* @p: ethtool supplied buffer
* @stats: stat definitions array
*

2
drivers/net/ethernet/intel/i40e/i40e_lan_hmc.c
View File

@ -511,7 +511,7 @@ configure_lan_hmc_out:
}
/**
* i40e_delete_hmc_object - remove hmc objects
* i40e_delete_lan_hmc_object - remove hmc objects
* @hw: pointer to the HW structure
* @info: pointer to i40e_hmc_delete_obj_info struct
*

6
drivers/net/ethernet/intel/i40e/i40e_main.c
View File

@ -2023,7 +2023,7 @@ static void i40e_undo_add_filter_entries(struct i40e_vsi *vsi,
}
/**
* i40e_next_entry - Get the next non-broadcast filter from a list
* i40e_next_filter - Get the next non-broadcast filter from a list
* @next: pointer to filter in list
*
* Returns the next non-broadcast filter in the list. Required so that we
@ -5191,7 +5191,7 @@ static u8 i40e_pf_get_num_tc(struct i40e_pf *pf)
}
/**
* i40e_pf_get_pf_tc_map - Get bitmap for enabled traffic classes
* i40e_pf_get_tc_map - Get bitmap for enabled traffic classes
* @pf: PF being queried
*
* Return a bitmap for enabled traffic classes for this PF.
@ -9454,7 +9454,7 @@ static void i40e_fdir_flush_and_replay(struct i40e_pf *pf)
}
/**
* i40e_get_current_atr_count - Get the count of total FD ATR filters programmed
* i40e_get_current_atr_cnt - Get the count of total FD ATR filters programmed
* @pf: board private structure
**/
u32 i40e_get_current_atr_cnt(struct i40e_pf *pf)

2
drivers/net/ethernet/intel/i40e/i40e_nvm.c
View File

@ -4,7 +4,7 @@
#include "i40e_prototype.h"
/**
* i40e_init_nvm_ops - Initialize NVM function pointers
* i40e_init_nvm - Initialize NVM function pointers
* @hw: pointer to the HW structure
*
* Setup the function pointers and the NVM info structure. Should be called

2
drivers/net/ethernet/intel/i40e/i40e_ptp.c
View File

@ -216,7 +216,7 @@ static int i40e_ptp_feature_enable(struct ptp_clock_info *ptp,
}
/**
* i40e_ptp_update_latch_events - Read I40E_PRTTSYN_STAT_1 and latch events
* i40e_ptp_get_rx_events - Read I40E_PRTTSYN_STAT_1 and latch events
* @pf: the PF data structure
*
* This function reads I40E_PRTTSYN_STAT_1 and updates the corresponding timers

2
drivers/net/ethernet/intel/i40e/i40e_txrx.c
View File

@ -3345,7 +3345,7 @@ static int i40e_tx_enable_csum(struct sk_buff *skb, u32 *tx_flags,
}
/**
* i40e_create_tx_ctx Build the Tx context descriptor
* i40e_create_tx_ctx - Build the Tx context descriptor
* @tx_ring: ring to create the descriptor on
* @cd_type_cmd_tso_mss: Quad Word 1
* @cd_tunneling: Quad Word 0 - bits 0-31

2
drivers/net/ethernet/intel/i40e/i40e_xsk.c
View File

@ -628,7 +628,7 @@ void i40e_xsk_clean_rx_ring(struct i40e_ring *rx_ring)
}
/**
* i40e_xsk_clean_xdp_ring - Clean the XDP Tx ring on shutdown
* i40e_xsk_clean_tx_ring - Clean the XDP Tx ring on shutdown
* @tx_ring: XDP Tx ring
**/
void i40e_xsk_clean_tx_ring(struct i40e_ring *tx_ring)

2
drivers/net/ethernet/intel/iavf/iavf_main.c
View File

@ -2546,7 +2546,7 @@ validate_bw:
}
/**
* iavf_validate_channel_config - validate queue mapping info
* iavf_validate_ch_config - validate queue mapping info
* @adapter: board private structure
* @mqprio_qopt: queue parameters
*

2
drivers/net/ethernet/intel/iavf/iavf_txrx.c
View File

@ -2098,7 +2098,7 @@ static int iavf_tx_enable_csum(struct sk_buff *skb, u32 *tx_flags,
}
/**
* iavf_create_tx_ctx Build the Tx context descriptor
* iavf_create_tx_ctx - Build the Tx context descriptor
* @tx_ring: ring to create the descriptor on
* @cd_type_cmd_tso_mss: Quad Word 1
* @cd_tunneling: Quad Word 0 - bits 0-31

4
drivers/net/ethernet/intel/iavf/iavf_virtchnl.c
View File

@ -1006,7 +1006,7 @@ iavf_set_adapter_link_speed_from_vpe(struct iavf_adapter *adapter,
}
/**
* iavf_enable_channel
* iavf_enable_channels
* @adapter: adapter structure
*
* Request that the PF enable channels as specified by
@ -1047,7 +1047,7 @@ void iavf_enable_channels(struct iavf_adapter *adapter)
}
/**
* iavf_disable_channel
* iavf_disable_channels
* @adapter: adapter structure
*
* Request that the PF disable channels that are configured

2
drivers/net/ethernet/intel/igb/e1000_mbx.c
View File

@ -441,7 +441,7 @@ out_no_read:
}
/**
* e1000_init_mbx_params_pf - set initial values for pf mailbox
* igb_init_mbx_params_pf - set initial values for pf mailbox
* @hw: pointer to the HW structure
*
* Initializes the hw->mbx struct to correct values for pf mailbox

6
drivers/net/ethernet/intel/igb/igb_main.c
View File

@ -2037,7 +2037,7 @@ static void igb_power_down_link(struct igb_adapter *adapter)
}
/**
* Detect and switch function for Media Auto Sense
* igb_check_swap_media - Detect and switch function for Media Auto Sense
* @adapter: address of the board private structure
**/
static void igb_check_swap_media(struct igb_adapter *adapter)
@ -4020,7 +4020,7 @@ static int igb_sw_init(struct igb_adapter *adapter)
}
/**
* igb_open - Called when a network interface is made active
* __igb_open - Called when a network interface is made active
* @netdev: network interface device structure
* @resuming: indicates whether we are in a resume call
*
@ -4138,7 +4138,7 @@ int igb_open(struct net_device *netdev)
}
/**
* igb_close - Disables a network interface
* __igb_close - Disables a network interface
* @netdev: network interface device structure
* @suspending: indicates we are in a suspend call
*

2
drivers/net/ethernet/intel/ixgbe/ixgbe_82599.c
View File

@ -1351,7 +1351,7 @@ static u32 ixgbe_atr_compute_sig_hash_82599(union ixgbe_atr_hash_dword input,
}
/**
* ixgbe_atr_add_signature_filter_82599 - Adds a signature hash filter
* ixgbe_fdir_add_signature_filter_82599 - Adds a signature hash filter
* @hw: pointer to hardware structure
* @input: unique input dword
* @common: compressed common input dword

15
drivers/net/ethernet/intel/ixgbe/ixgbe_common.c
View File

@ -2707,7 +2707,7 @@ s32 ixgbe_disable_rx_buff_generic(struct ixgbe_hw *hw)
}
/**
* ixgbe_enable_rx_buff - Enables the receive data path
* ixgbe_enable_rx_buff_generic - Enables the receive data path
* @hw: pointer to hardware structure
*
* Enables the receive data path
@ -3029,14 +3029,14 @@ s32 ixgbe_set_vmdq_generic(struct ixgbe_hw *hw, u32 rar, u32 vmdq)
}
/**
* ixgbe_set_vmdq_san_mac_generic - Associate VMDq pool index with a rx address
* @hw: pointer to hardware struct
* @vmdq: VMDq pool index
*
* This function should only be involved in the IOV mode.
* In IOV mode, Default pool is next pool after the number of
* VFs advertized and not 0.
* MPSAR table needs to be updated for SAN_MAC RAR [hw->mac.san_mac_rar_index]
*
* ixgbe_set_vmdq_san_mac - Associate default VMDq pool index with a rx address
* @hw: pointer to hardware struct
* @vmdq: VMDq pool index
**/
s32 ixgbe_set_vmdq_san_mac_generic(struct ixgbe_hw *hw, u32 vmdq)
{
@ -3896,7 +3896,7 @@ static s32 ixgbe_get_ets_data(struct ixgbe_hw *hw, u16 *ets_cfg,
}
/**
* ixgbe_get_thermal_sensor_data - Gathers thermal sensor data
* ixgbe_get_thermal_sensor_data_generic - Gathers thermal sensor data
* @hw: pointer to hardware structure
*
* Returns the thermal sensor data structure
@ -4054,8 +4054,7 @@ void ixgbe_get_orom_version(struct ixgbe_hw *hw,
}
/**
* ixgbe_get_oem_prod_version Etrack ID from EEPROM
*
* ixgbe_get_oem_prod_version - Etrack ID from EEPROM
* @hw: pointer to hardware structure
* @nvm_ver: pointer to output structure
*

4
drivers/net/ethernet/intel/ixgbe/ixgbe_main.c
View File

@ -225,7 +225,7 @@ static s32 ixgbe_get_parent_bus_info(struct ixgbe_adapter *adapter)
}
/**
* ixgbe_check_from_parent - Determine whether PCIe info should come from parent
* ixgbe_pcie_from_parent - Determine whether PCIe info should come from parent
* @hw: hw specific details
*
* This function is used by probe to determine whether a device's PCI-Express
@ -6156,7 +6156,7 @@ void ixgbe_down(struct ixgbe_adapter *adapter)
}
/**
* ixgbe_eee_capable - helper function to determine EEE support on X550
* ixgbe_set_eee_capable - helper function to determine EEE support on X550
* @adapter: board private structure
*/
static void ixgbe_set_eee_capable(struct ixgbe_adapter *adapter)

5
drivers/net/ethernet/intel/ixgbe/ixgbe_phy.c
View File

@ -461,12 +461,13 @@ s32 ixgbe_reset_phy_generic(struct ixgbe_hw *hw)
}
/**
* ixgbe_read_phy_mdi - Reads a value from a specified PHY register without
* the SWFW lock
* ixgbe_read_phy_reg_mdi - read PHY register
* @hw: pointer to hardware structure
* @reg_addr: 32 bit address of PHY register to read
* @device_type: 5 bit device type
* @phy_data: Pointer to read data from PHY register
*
* Reads a value from a specified PHY register without the SWFW lock
**/
s32 ixgbe_read_phy_reg_mdi(struct ixgbe_hw *hw, u32 reg_addr, u32 device_type,
u16 *phy_data)

2
drivers/net/ethernet/intel/ixgbe/ixgbe_x540.c
View File

@ -701,7 +701,7 @@ static s32 ixgbe_get_swfw_sync_semaphore(struct ixgbe_hw *hw)
}
/**
* ixgbe_release_nvm_semaphore - Release hardware semaphore
* ixgbe_release_swfw_sync_semaphore - Release hardware semaphore
* @hw: pointer to hardware structure
*
* This function clears hardware semaphore bits.

2
drivers/net/ethernet/intel/ixgbe/ixgbe_x550.c
View File

@ -1248,7 +1248,7 @@ static s32 ixgbe_get_bus_info_X550em(struct ixgbe_hw *hw)
}
/**
* ixgbe_fw_recovery_mode - Check FW NVM recovery mode
* ixgbe_fw_recovery_mode_X550 - Check FW NVM recovery mode
* @hw: pointer t hardware structure
*
* Returns true if in FW NVM recovery mode.

18
drivers/net/ethernet/intel/ixgbevf/vf.c
View File

@ -121,9 +121,11 @@ static s32 ixgbevf_reset_hw_vf(struct ixgbe_hw *hw)
}
/**
* ixgbevf_hv_reset_hw_vf - reset via Hyper-V
* @hw: pointer to private hardware struct
*
* Hyper-V variant; the VF/PF communication is through the PCI
* config space.
* @hw: pointer to private hardware struct
*/
static s32 ixgbevf_hv_reset_hw_vf(struct ixgbe_hw *hw)
{
@ -513,9 +515,11 @@ static s32 ixgbevf_update_mc_addr_list_vf(struct ixgbe_hw *hw,
}
/**
* Hyper-V variant - just a stub.
* ixgbevf_hv_update_mc_addr_list_vf - stub
* @hw: unused
* @netdev: unused
*
* Hyper-V variant - just a stub.
*/
static s32 ixgbevf_hv_update_mc_addr_list_vf(struct ixgbe_hw *hw,
struct net_device *netdev)
@ -564,9 +568,11 @@ static s32 ixgbevf_update_xcast_mode(struct ixgbe_hw *hw, int xcast_mode)
}
/**
* Hyper-V variant - just a stub.
* ixgbevf_hv_update_xcast_mode - stub
* @hw: unused
* @xcast_mode: unused
*
* Hyper-V variant - just a stub.
*/
static s32 ixgbevf_hv_update_xcast_mode(struct ixgbe_hw *hw, int xcast_mode)
{
@ -608,7 +614,7 @@ mbx_err:
}
/**
* Hyper-V variant - just a stub.
* ixgbevf_hv_set_vfta_vf - * Hyper-V variant - just a stub.
* @hw: unused
* @vlan: unused
* @vind: unused
@ -726,11 +732,13 @@ out:
}
/**
* Hyper-V variant; there is no mailbox communication.
* ixgbevf_hv_check_mac_link_vf - check link
* @hw: pointer to private hardware struct
* @speed: pointer to link speed
* @link_up: true is link is up, false otherwise
* @autoneg_wait_to_complete: unused
*
* Hyper-V variant; there is no mailbox communication.
*/
static s32 ixgbevf_hv_check_mac_link_vf(struct ixgbe_hw *hw,
ixgbe_link_speed *speed,