Set 2: Rid W=1 warnings in Wireless
Subsystems (12)
cover Set 2: Rid W=1 warnings in Wireless
This set is part of a larger effort attempting to clean-up W=1 kernel builds, which are currently overwhelmingly riddled with niggly little warnings.
There are quite a few W=1 warnings in the Wireless. My plan is to work through all of them over the next few weeks. Hopefully it won't be too long before drivers/net/wireless builds clean with W=1 enabled.
This set brings the total number of (arm, arm64, x86, mips and ppc *combined* i.e. some duplicated) warnings down from 4983 (since the last set) to 2066.
Lee Jones (32):
wireless: marvell: mwifiex: sdio: Move 'static const struct's into
their own header file
wireless: rsi: rsi_91x_mac80211: Add description for function param
'sta'
wireless: intel: iwlwifi: mvm: ops: Remove unused static struct
'iwl_mvm_debug_names'
wireless: broadcom: brcm80211: brcmsmac: ampdu: Remove a bunch of
unused variables
wireless: broadcom: brcm80211: brcmfmac: p2p: Fix a bunch of function
docs
wireless: rsi: rsi_91x_mgmt: Add descriptions for
rsi_set_vap_capabilities()'s parameters
wireless: intel: iwlwifi: dvm: rx: Demote a couple of nonconformant
kernel-doc headers
wireless: intel: iwlwifi: mvm: utils: Fix some doc-rot
wireless: broadcom: brcm80211: brcmsmac: main: Remove a bunch of
unused variables
wireless: rsi: rsi_91x_ps: Source file headers do not make good
kernel-doc candidates
wireless: intel: iwlwifi: dvm: scan: Demote a few nonconformant
kernel-doc headers
wireless: brcm80211: brcmfmac: firmware: Demote seemingly
unintentional kernel-doc header
wireless: intel: iwlwifi: dvm: rxon: Demote non-conformant kernel-doc
headers
wireless: rsi: rsi_91x_coex: File headers are not suitable for
kernel-doc
wireless: intel: iwlegacy: 4965-mac: Convert function headers to
standard comment blocks
wireless: brcm80211: btcoex: Update 'brcmf_btcoex_state' and demote
others
wireless: broadcom: b43: phy_ht: Remove 9 year old TODO
wireless: intel: iwlwifi: mvm: tx: Demote misuse of kernel-doc headers
wireless: intel: iwlwifi: dvm: devices: Fix function documentation
formatting issues
wireless: rsi: rsi_91x_debugfs: Source file headers are not suitable
for kernel-doc
wireless: intel: iwlwifi: iwl-drv: Provide descriptions debugfs
dentries
wireless: intel: iwlegacy: 4965-rs: Demote non kernel-doc headers to
standard comment blocks
wireless: intel: iwlegacy: 4965-calib: Demote seemingly accidental
kernel-doc header
wireless: brcmfmac: fwsignal: Remove unused variable
'brcmf_fws_prio2fifo'
wireless: ath: wil6210: wmi: Fix formatting and demote non-conforming
function headers
wireless: ath: wil6210: interrupt: Demote comment header which is
clearly not kernel-doc
wireless: ath: wil6210: txrx: Demote obvious abuse of kernel-doc
wireless: ath: wil6210: txrx_edma: Demote comments which are clearly
not kernel-doc
wireless: realtek: rtl8192c: phy_common: Remove unused variable
'bbvalue'
wireless: ath: wil6210: pmc: Demote a few nonconformant kernel-doc
function headers
wireless: ath: wil6210: wil_platform: Demote kernel-doc header to
standard comment block
wireless: mediatek: mt76x0: Move tables used only by init.c to their
own header file
drivers/net/wireless/ath/wil6210/interrupt.c | 2 +- drivers/net/wireless/ath/wil6210/pmc.c | 8 +- drivers/net/wireless/ath/wil6210/txrx.c | 20 +- drivers/net/wireless/ath/wil6210/txrx_edma.c | 6 +- .../net/wireless/ath/wil6210/wil_platform.c | 2 +- drivers/net/wireless/ath/wil6210/wmi.c | 28 +- drivers/net/wireless/broadcom/b43/phy_ht.c | 3 - .../broadcom/brcm80211/brcmfmac/btcoex.c | 12 +- .../broadcom/brcm80211/brcmfmac/firmware.c | 2 +- .../broadcom/brcm80211/brcmfmac/fwsignal.c | 14 - .../broadcom/brcm80211/brcmfmac/p2p.c | 22 +- .../broadcom/brcm80211/brcmsmac/ampdu.c | 28 +- .../broadcom/brcm80211/brcmsmac/main.c | 38 +- .../net/wireless/intel/iwlegacy/4965-calib.c | 2 +- .../net/wireless/intel/iwlegacy/4965-mac.c | 55 +-- drivers/net/wireless/intel/iwlegacy/4965-rs.c | 10 +- .../net/wireless/intel/iwlwifi/dvm/devices.c | 8 +- drivers/net/wireless/intel/iwlwifi/dvm/rx.c | 4 +- drivers/net/wireless/intel/iwlwifi/dvm/rxon.c | 6 +- drivers/net/wireless/intel/iwlwifi/dvm/scan.c | 8 +- drivers/net/wireless/intel/iwlwifi/iwl-drv.c | 5 +- drivers/net/wireless/intel/iwlwifi/mvm/ops.c | 9 - drivers/net/wireless/intel/iwlwifi/mvm/tx.c | 4 +- .../net/wireless/intel/iwlwifi/mvm/utils.c | 7 +- .../wireless/marvell/mwifiex/sdio-tables.h | 451 ++++++++++++++++++ drivers/net/wireless/marvell/mwifiex/sdio.c | 1 + drivers/net/wireless/marvell/mwifiex/sdio.h | 427 ----------------- .../net/wireless/mediatek/mt76/mt76x0/init.c | 1 + .../wireless/mediatek/mt76/mt76x0/initvals.h | 145 ------ .../mediatek/mt76/mt76x0/initvals_init.h | 159 ++++++ .../realtek/rtlwifi/rtl8192c/phy_common.c | 3 +- drivers/net/wireless/rsi/rsi_91x_coex.c | 2 +- drivers/net/wireless/rsi/rsi_91x_debugfs.c | 2 +- drivers/net/wireless/rsi/rsi_91x_mac80211.c | 1 + drivers/net/wireless/rsi/rsi_91x_mgmt.c | 3 + drivers/net/wireless/rsi/rsi_91x_ps.c | 2 +- 36 files changed, 738 insertions(+), 762 deletions(-) create mode 100644 drivers/net/wireless/marvell/mwifiex/sdio-tables.h create mode 100644 drivers/net/wireless/mediatek/mt76/mt76x0/initvals_init.h
Signature · 1 line
2.25.1
PATCH 1/32 wireless: marvell: mwifiex: sdio: Move 'static const struct's into their own header file
Only include these tables in the 1 source file they are used.
Fixes hundreds of W=1 warnings!
Fixes the following W=1 kernel build warning(s):
In file included from drivers/net/wireless/marvell/mwifiex/main.h:59,
from drivers/net/wireless/marvell/mwifiex/main.c:22:
drivers/net/wireless/marvell/mwifiex/sdio.h:705:41: warning: ‘mwifiex_sdio_sd8801’ defined but not used [-Wunused-const-variable=] 705 | static const struct mwifiex_sdio_device mwifiex_sdio_sd8801 = {
| ^~~~~~~~~~~~~~~~~~~
NB: There were 100's of these - snipped for brevity.
--- .../wireless/marvell/mwifiex/sdio-tables.h | 451 ++++++++++++++++++ drivers/net/wireless/marvell/mwifiex/sdio.c | 1 + drivers/net/wireless/marvell/mwifiex/sdio.h | 427 ----------------- 3 files changed, 452 insertions(+), 427 deletions(-) create mode 100644 drivers/net/wireless/marvell/mwifiex/sdio-tables.h
drivers/net/wireless/marvell/mwifiex/sdio-tables.h new file +451 -0
@@ -0,0 +1,451 @@ +/* +* NXP Wireless LAN device driver: SDIO specific definitions +* +* Copyright 2011-2020 NXP +* +* This software file (the "File") is distributed by NXP +* under the terms of the GNU General Public License Version 2, June 1991 +* (the "License"). You may use, redistribute and/or modify this File in +* accordance with the terms and conditions of the License, a copy of which +* is available by writing to the Free Software Foundation, Inc., +* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA or on the +* worldwide web at http://www.gnu.org/licenses/old-licenses/gpl-2.0.txt. +* +* THE FILE IS DISTRIBUTED AS-IS, WITHOUT WARRANTY OF ANY KIND, AND THE +* IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE +* ARE EXPRESSLY DISCLAIMED. The License provides additional details about +* this warranty disclaimer. +*/ + +#ifndef _MWIFIEX_SDIO_TABLES_H +#define _MWIFIEX_SDIO_TABLES_H + +#include "sdio.h" + +static const struct mwifiex_sdio_card_reg mwifiex_reg_sd87xx = { + .start_rd_port =1 , + .start_wr_port =1 , + .base_0_reg =0x0040 , + .base_1_reg =0x0041 , + .poll_reg =0x30 , + .host_int_enable =UP_LD_HOST_INT_MASK |DN_LD_HOST_INT_MASK , + .host_int_rsr_reg =0x1 , + .host_int_mask_reg =0x02 , + .host_int_status_reg =0x03 , + .status_reg_0 =0x60 , + .status_reg_1 =0x61 , + .sdio_int_mask =0x3f , + .data_port_mask =0x0000fffe , + .io_port_0_reg =0x78 , + .io_port_1_reg =0x79 , + .io_port_2_reg =0x7A , + .max_mp_regs =64 , + .rd_bitmap_l =0x04 , + .rd_bitmap_u =0x05 , + .wr_bitmap_l =0x06 , + .wr_bitmap_u =0x07 , + .rd_len_p0_l =0x08 , + .rd_len_p0_u =0x09 , + .card_misc_cfg_reg =0x6c , + .func1_dump_reg_start =0x0 , + .func1_dump_reg_end =0x9 , + .func1_scratch_reg =0x60 , + .func1_spec_reg_num =5 , + .func1_spec_reg_table = {0x28 ,0x30 ,0x34 ,0x38 ,0x3c }, +}; + +static const struct mwifiex_sdio_card_reg mwifiex_reg_sd8897 = { + .start_rd_port =0 , + .start_wr_port =0 , + .base_0_reg =0x60 , + .base_1_reg =0x61 , + .poll_reg =0x50 , + .host_int_enable =UP_LD_HOST_INT_MASK |DN_LD_HOST_INT_MASK | +CMD_PORT_UPLD_INT_MASK |CMD_PORT_DNLD_INT_MASK , + .host_int_rsr_reg =0x1 , + .host_int_status_reg =0x03 , + .host_int_mask_reg =0x02 , + .status_reg_0 =0xc0 , + .status_reg_1 =0xc1 , + .sdio_int_mask =0xff , + .data_port_mask =0xffffffff , + .io_port_0_reg =0xD8 , + .io_port_1_reg =0xD9 , + .io_port_2_reg =0xDA , + .max_mp_regs =184 , + .rd_bitmap_l =0x04 , + .rd_bitmap_u =0x05 , + .rd_bitmap_1l =0x06 , + .rd_bitmap_1u =0x07 , + .wr_bitmap_l =0x08 , + .wr_bitmap_u =0x09 , + .wr_bitmap_1l =0x0a , + .wr_bitmap_1u =0x0b , + .rd_len_p0_l =0x0c , + .rd_len_p0_u =0x0d , + .card_misc_cfg_reg =0xcc , + .card_cfg_2_1_reg =0xcd , + .cmd_rd_len_0 =0xb4 , + .cmd_rd_len_1 =0xb5 , + .cmd_rd_len_2 =0xb6 , + .cmd_rd_len_3 =0xb7 , + .cmd_cfg_0 =0xb8 , + .cmd_cfg_1 =0xb9 , + .cmd_cfg_2 =0xba , + .cmd_cfg_3 =0xbb , + .fw_dump_host_ready =0xee , + .fw_dump_ctrl =0xe2 , + .fw_dump_start =0xe3 , + .fw_dump_end =0xea , + .func1_dump_reg_start =0x0 , + .func1_dump_reg_end =0xb , + .func1_scratch_reg =0xc0 , + .func1_spec_reg_num =8 , + .func1_spec_reg_table = {0x4C ,0x50 ,0x54 ,0x55 ,0x58 , +0x59 ,0x5c ,0x5d }, +}; + +static const struct mwifiex_sdio_card_reg mwifiex_reg_sd8977 = { + .start_rd_port =0 , + .start_wr_port =0 , + .base_0_reg =0xF8 , + .base_1_reg =0xF9 , + .poll_reg =0x5C , + .host_int_enable =UP_LD_HOST_INT_MASK |DN_LD_HOST_INT_MASK | +CMD_PORT_UPLD_INT_MASK |CMD_PORT_DNLD_INT_MASK , + .host_int_rsr_reg =0x4 , + .host_int_status_reg =0x0C , + .host_int_mask_reg =0x08 , + .status_reg_0 =0xE8 , + .status_reg_1 =0xE9 , + .sdio_int_mask =0xff , + .data_port_mask =0xffffffff , + .io_port_0_reg =0xE4 , + .io_port_1_reg =0xE5 , + .io_port_2_reg =0xE6 , + .max_mp_regs =196 , + .rd_bitmap_l =0x10 , + .rd_bitmap_u =0x11 , + .rd_bitmap_1l =0x12 , + .rd_bitmap_1u =0x13 , + .wr_bitmap_l =0x14 , + .wr_bitmap_u =0x15 , + .wr_bitmap_1l =0x16 , + .wr_bitmap_1u =0x17 , + .rd_len_p0_l =0x18 , + .rd_len_p0_u =0x19 , + .card_misc_cfg_reg =0xd8 , + .card_cfg_2_1_reg =0xd9 , + .cmd_rd_len_0 =0xc0 , + .cmd_rd_len_1 =0xc1 , + .cmd_rd_len_2 =0xc2 , + .cmd_rd_len_3 =0xc3 , + .cmd_cfg_0 =0xc4 , + .cmd_cfg_1 =0xc5 , + .cmd_cfg_2 =0xc6 , + .cmd_cfg_3 =0xc7 , + .fw_dump_host_ready =0xcc , + .fw_dump_ctrl =0xf0 , + .fw_dump_start =0xf1 , + .fw_dump_end =0xf8 , + .func1_dump_reg_start =0x10 , + .func1_dump_reg_end =0x17 , + .func1_scratch_reg =0xe8 , + .func1_spec_reg_num =13 , + .func1_spec_reg_table = {0x08 ,0x58 ,0x5C ,0x5D , +0x60 ,0x61 ,0x62 ,0x64 , +0x65 ,0x66 ,0x68 ,0x69 , +0x6a }, +}; + +static const struct mwifiex_sdio_card_reg mwifiex_reg_sd8997 = { + .start_rd_port =0 , + .start_wr_port =0 , + .base_0_reg =0xF8 , + .base_1_reg =0xF9 , + .poll_reg =0x5C , + .host_int_enable =UP_LD_HOST_INT_MASK |DN_LD_HOST_INT_MASK | +CMD_PORT_UPLD_INT_MASK |CMD_PORT_DNLD_INT_MASK , + .host_int_rsr_reg =0x4 , + .host_int_status_reg =0x0C , + .host_int_mask_reg =0x08 , + .status_reg_0 =0xE8 , + .status_reg_1 =0xE9 , + .sdio_int_mask =0xff , + .data_port_mask =0xffffffff , + .io_port_0_reg =0xE4 , + .io_port_1_reg =0xE5 , + .io_port_2_reg =0xE6 , + .max_mp_regs =196 , + .rd_bitmap_l =0x10 , + .rd_bitmap_u =0x11 , + .rd_bitmap_1l =0x12 , + .rd_bitmap_1u =0x13 , + .wr_bitmap_l =0x14 , + .wr_bitmap_u =0x15 , + .wr_bitmap_1l =0x16 , + .wr_bitmap_1u =0x17 , + .rd_len_p0_l =0x18 , + .rd_len_p0_u =0x19 , + .card_misc_cfg_reg =0xd8 , + .card_cfg_2_1_reg =0xd9 , + .cmd_rd_len_0 =0xc0 , + .cmd_rd_len_1 =0xc1 , + .cmd_rd_len_2 =0xc2 , + .cmd_rd_len_3 =0xc3 , + .cmd_cfg_0 =0xc4 , + .cmd_cfg_1 =0xc5 , + .cmd_cfg_2 =0xc6 , + .cmd_cfg_3 =0xc7 , + .fw_dump_host_ready =0xcc , + .fw_dump_ctrl =0xf0 , + .fw_dump_start =0xf1 , + .fw_dump_end =0xf8 , + .func1_dump_reg_start =0x10 , + .func1_dump_reg_end =0x17 , + .func1_scratch_reg =0xe8 , + .func1_spec_reg_num =13 , + .func1_spec_reg_table = {0x08 ,0x58 ,0x5C ,0x5D , +0x60 ,0x61 ,0x62 ,0x64 , +0x65 ,0x66 ,0x68 ,0x69 , +0x6a }, +}; + +static const struct mwifiex_sdio_card_reg mwifiex_reg_sd8887 = { + .start_rd_port =0 , + .start_wr_port =0 , + .base_0_reg =0x6C , + .base_1_reg =0x6D , + .poll_reg =0x5C , + .host_int_enable =UP_LD_HOST_INT_MASK |DN_LD_HOST_INT_MASK | +CMD_PORT_UPLD_INT_MASK |CMD_PORT_DNLD_INT_MASK , + .host_int_rsr_reg =0x4 , + .host_int_status_reg =0x0C , + .host_int_mask_reg =0x08 , + .status_reg_0 =0x90 , + .status_reg_1 =0x91 , + .sdio_int_mask =0xff , + .data_port_mask =0xffffffff , + .io_port_0_reg =0xE4 , + .io_port_1_reg =0xE5 , + .io_port_2_reg =0xE6 , + .max_mp_regs =196 , + .rd_bitmap_l =0x10 , + .rd_bitmap_u =0x11 , + .rd_bitmap_1l =0x12 , + .rd_bitmap_1u =0x13 , + .wr_bitmap_l =0x14 , + .wr_bitmap_u =0x15 , + .wr_bitmap_1l =0x16 , + .wr_bitmap_1u =0x17 , + .rd_len_p0_l =0x18 , + .rd_len_p0_u =0x19 , + .card_misc_cfg_reg =0xd8 , + .card_cfg_2_1_reg =0xd9 , + .cmd_rd_len_0 =0xc0 , + .cmd_rd_len_1 =0xc1 , + .cmd_rd_len_2 =0xc2 , + .cmd_rd_len_3 =0xc3 , + .cmd_cfg_0 =0xc4 , + .cmd_cfg_1 =0xc5 , + .cmd_cfg_2 =0xc6 , + .cmd_cfg_3 =0xc7 , + .func1_dump_reg_start =0x10 , + .func1_dump_reg_end =0x17 , + .func1_scratch_reg =0x90 , + .func1_spec_reg_num =13 , + .func1_spec_reg_table = {0x08 ,0x58 ,0x5C ,0x5D ,0x60 , +0x61 ,0x62 ,0x64 ,0x65 ,0x66 , +0x68 ,0x69 ,0x6a }, +}; + +static const struct mwifiex_sdio_card_reg mwifiex_reg_sd8987 = { + .start_rd_port =0 , + .start_wr_port =0 , + .base_0_reg =0xF8 , + .base_1_reg =0xF9 , + .poll_reg =0x5C , + .host_int_enable =UP_LD_HOST_INT_MASK |DN_LD_HOST_INT_MASK | +CMD_PORT_UPLD_INT_MASK |CMD_PORT_DNLD_INT_MASK , + .host_int_rsr_reg =0x4 , + .host_int_status_reg =0x0C , + .host_int_mask_reg =0x08 , + .status_reg_0 =0xE8 , + .status_reg_1 =0xE9 , + .sdio_int_mask =0xff , + .data_port_mask =0xffffffff , + .io_port_0_reg =0xE4 , + .io_port_1_reg =0xE5 , + .io_port_2_reg =0xE6 , + .max_mp_regs =196 , + .rd_bitmap_l =0x10 , + .rd_bitmap_u =0x11 , + .rd_bitmap_1l =0x12 , + .rd_bitmap_1u =0x13 , + .wr_bitmap_l =0x14 , + .wr_bitmap_u =0x15 , + .wr_bitmap_1l =0x16 , + .wr_bitmap_1u =0x17 , + .rd_len_p0_l =0x18 , + .rd_len_p0_u =0x19 , + .card_misc_cfg_reg =0xd8 , + .card_cfg_2_1_reg =0xd9 , + .cmd_rd_len_0 =0xc0 , + .cmd_rd_len_1 =0xc1 , + .cmd_rd_len_2 =0xc2 , + .cmd_rd_len_3 =0xc3 , + .cmd_cfg_0 =0xc4 , + .cmd_cfg_1 =0xc5 , + .cmd_cfg_2 =0xc6 , + .cmd_cfg_3 =0xc7 , + .fw_dump_host_ready =0xcc , + .fw_dump_ctrl =0xf9 , + .fw_dump_start =0xf1 , + .fw_dump_end =0xf8 , + .func1_dump_reg_start =0x10 , + .func1_dump_reg_end =0x17 , + .func1_scratch_reg =0xE8 , + .func1_spec_reg_num =13 , + .func1_spec_reg_table = {0x08 ,0x58 ,0x5C ,0x5D ,0x60 , +0x61 ,0x62 ,0x64 ,0x65 ,0x66 , +0x68 ,0x69 ,0x6a }, +}; + +static const struct mwifiex_sdio_device mwifiex_sdio_sd8786 = { + .firmware =SD8786_DEFAULT_FW_NAME , + .reg = &mwifiex_reg_sd87xx, + .max_ports =16 , + .mp_agg_pkt_limit =8 , + .tx_buf_size =MWIFIEX_TX_DATA_BUF_SIZE_2K , + .mp_tx_agg_buf_size =MWIFIEX_MP_AGGR_BUF_SIZE_16K , + .mp_rx_agg_buf_size =MWIFIEX_MP_AGGR_BUF_SIZE_16K , + .supports_sdio_new_mode = false, + .has_control_mask = true, + .can_dump_fw = false, + .can_auto_tdls = false, + .can_ext_scan = false, +}; + +static const struct mwifiex_sdio_device mwifiex_sdio_sd8787 = { + .firmware =SD8787_DEFAULT_FW_NAME , + .reg = &mwifiex_reg_sd87xx, + .max_ports =16 , + .mp_agg_pkt_limit =8 , + .tx_buf_size =MWIFIEX_TX_DATA_BUF_SIZE_2K , + .mp_tx_agg_buf_size =MWIFIEX_MP_AGGR_BUF_SIZE_16K , + .mp_rx_agg_buf_size =MWIFIEX_MP_AGGR_BUF_SIZE_16K , + .supports_sdio_new_mode = false, + .has_control_mask = true, + .can_dump_fw = false, + .can_auto_tdls = false, + .can_ext_scan = true, +}; + +static const struct mwifiex_sdio_device mwifiex_sdio_sd8797 = { + .firmware =SD8797_DEFAULT_FW_NAME , + .reg = &mwifiex_reg_sd87xx, + .max_ports =16 , + .mp_agg_pkt_limit =8 , + .tx_buf_size =MWIFIEX_TX_DATA_BUF_SIZE_2K , + .mp_tx_agg_buf_size =MWIFIEX_MP_AGGR_BUF_SIZE_16K , + .mp_rx_agg_buf_size =MWIFIEX_MP_AGGR_BUF_SIZE_16K , + .supports_sdio_new_mode = false, + .has_control_mask = true, + .can_dump_fw = false, + .can_auto_tdls = false, + .can_ext_scan = true, +}; + +static const struct mwifiex_sdio_device mwifiex_sdio_sd8897 = { + .firmware =SD8897_DEFAULT_FW_NAME , + .reg = &mwifiex_reg_sd8897, + .max_ports =32 , + .mp_agg_pkt_limit =16 , + .tx_buf_size =MWIFIEX_TX_DATA_BUF_SIZE_4K , + .mp_tx_agg_buf_size =MWIFIEX_MP_AGGR_BUF_SIZE_MAX , + .mp_rx_agg_buf_size =MWIFIEX_MP_AGGR_BUF_SIZE_MAX , + .supports_sdio_new_mode = true, + .has_control_mask = false, + .can_dump_fw = true, + .can_auto_tdls = false, + .can_ext_scan = true, +}; + +static const struct mwifiex_sdio_device mwifiex_sdio_sd8977 = { + .firmware =SD8977_DEFAULT_FW_NAME , + .reg = &mwifiex_reg_sd8977, + .max_ports =32 , + .mp_agg_pkt_limit =16 , + .tx_buf_size =MWIFIEX_TX_DATA_BUF_SIZE_4K , + .mp_tx_agg_buf_size =MWIFIEX_MP_AGGR_BUF_SIZE_MAX , + .mp_rx_agg_buf_size =MWIFIEX_MP_AGGR_BUF_SIZE_MAX , + .supports_sdio_new_mode = true, + .has_control_mask = false, + .can_dump_fw = true, + .fw_dump_enh = true, + .can_auto_tdls = false, + .can_ext_scan = true, +}; + +static const struct mwifiex_sdio_device mwifiex_sdio_sd8997 = { + .firmware =SD8997_DEFAULT_FW_NAME , + .reg = &mwifiex_reg_sd8997, + .max_ports =32 , + .mp_agg_pkt_limit =16 , + .tx_buf_size =MWIFIEX_TX_DATA_BUF_SIZE_4K , + .mp_tx_agg_buf_size =MWIFIEX_MP_AGGR_BUF_SIZE_MAX , + .mp_rx_agg_buf_size =MWIFIEX_MP_AGGR_BUF_SIZE_MAX , + .supports_sdio_new_mode = true, + .has_control_mask = false, + .can_dump_fw = true, + .fw_dump_enh = true, + .can_auto_tdls = false, + .can_ext_scan = true, +}; + +static const struct mwifiex_sdio_device mwifiex_sdio_sd8887 = { + .firmware =SD8887_DEFAULT_FW_NAME , + .reg = &mwifiex_reg_sd8887, + .max_ports =32 , + .mp_agg_pkt_limit =16 , + .tx_buf_size =MWIFIEX_TX_DATA_BUF_SIZE_2K , + .mp_tx_agg_buf_size =MWIFIEX_MP_AGGR_BUF_SIZE_32K , + .mp_rx_agg_buf_size =MWIFIEX_MP_AGGR_BUF_SIZE_32K , + .supports_sdio_new_mode = true, + .has_control_mask = false, + .can_dump_fw = false, + .can_auto_tdls = true, + .can_ext_scan = true, +}; + +static const struct mwifiex_sdio_device mwifiex_sdio_sd8987 = { + .firmware =SD8987_DEFAULT_FW_NAME , + .reg = &mwifiex_reg_sd8987, + .max_ports =32 , + .mp_agg_pkt_limit =16 , + .tx_buf_size =MWIFIEX_TX_DATA_BUF_SIZE_2K , + .mp_tx_agg_buf_size =MWIFIEX_MP_AGGR_BUF_SIZE_MAX , + .mp_rx_agg_buf_size =MWIFIEX_MP_AGGR_BUF_SIZE_MAX , + .supports_sdio_new_mode = true, + .has_control_mask = false, + .can_dump_fw = true, + .fw_dump_enh = true, + .can_auto_tdls = true, + .can_ext_scan = true, +}; + +static const struct mwifiex_sdio_device mwifiex_sdio_sd8801 = { + .firmware =SD8801_DEFAULT_FW_NAME , + .reg = &mwifiex_reg_sd87xx, + .max_ports =16 , + .mp_agg_pkt_limit =8 , + .supports_sdio_new_mode = false, + .has_control_mask = true, + .tx_buf_size =MWIFIEX_TX_DATA_BUF_SIZE_2K , + .mp_tx_agg_buf_size =MWIFIEX_MP_AGGR_BUF_SIZE_16K , + .mp_rx_agg_buf_size =MWIFIEX_MP_AGGR_BUF_SIZE_16K , + .can_dump_fw = false, + .can_auto_tdls = false, + .can_ext_scan = true, +}; +#endif /* _MWIFIEX_SDIO_TABLES_H */
drivers/net/wireless/marvell/mwifiex/sdio.c +1 -0
@@ -27,6 +27,7 @@#include "wmm.h" #include "11n.h" #include "sdio.h" +#include "sdio-tables.h" #define SDIO_VERSION "1.0"
drivers/net/wireless/marvell/mwifiex/sdio.h +0 -427
433 lines not on this page · raw message
Signature · 1 line
2.25.1
Re: [PATCH 01/32] wireless: marvell: mwifiex: sdio: Move 'static const struct's into their own header file
Quoted 14 lines · Lee Jones
Only include these tables in the 1 source file they are used.
Fixes hundreds of W=1 warnings!
Fixes the following W=1 kernel build warning(s):
In file included from
drivers/net/wireless/marvell/mwifiex/main.h:59,
fromdrivers/net/wireless/marvell/mwifiex/main.c:22:
drivers/net/wireless/marvell/mwifiex/sdio.h:705:41: warning: ‘mwifiex_sdio_sd8801’ defined but not used [-Wunused-const-variable=] 705 | static const structmwifiex_sdio_devicemwifiex_sdio_sd8801= {
| ^~~~~~~~~~~~~~~~~~~NB: There were 100's of these - snipped for brevity.
Quoted 9 lines
Cc Amitkumar Karwar <[email protected]>Cc Ganapathi Bhat <[email protected]>Cc Xinming Hu <[email protected]>Cc Kalle Valo <[email protected]>Cc "David S. Miller" <[email protected]>Cc Jakub Kicinski <[email protected]>Signed-off-by Lee Jones <[email protected]>
I don't think static const variables should be in a .h file. Wouldn't sdio.c be the right place for these? At least from a quick look I got that impression.
Patch set to Changes Requested.
Signature · 3 lines
https://patchwork.kernel.org/patch/11728301/ https://wireless.wiki.kernel.org/en/developers/documentation/submittingpatches
Re: [PATCH 01/32] wireless: marvell: mwifiex: sdio: Move 'static const struct's into their own header file
Quoted 26 lines · Kalle Valo
Quoted 14 lines · Lee Jones
Only include these tables in the 1 source file they are used.
Fixes hundreds of W=1 warnings!
Fixes the following W=1 kernel build warning(s):
In file included from
drivers/net/wireless/marvell/mwifiex/main.h:59,
fromdrivers/net/wireless/marvell/mwifiex/main.c:22:
drivers/net/wireless/marvell/mwifiex/sdio.h:705:41: warning: ‘mwifiex_sdio_sd8801’ defined but not used [-Wunused-const-variable=] 705 | static const structmwifiex_sdio_devicemwifiex_sdio_sd8801= {
| ^~~~~~~~~~~~~~~~~~~NB: There were 100's of these - snipped for brevity.
Quoted 9 lines
Cc Amitkumar Karwar <[email protected]>Cc Ganapathi Bhat <[email protected]>Cc Xinming Hu <[email protected]>Cc Kalle Valo <[email protected]>Cc "David S. Miller" <[email protected]>Cc Jakub Kicinski <[email protected]>Signed-off-by Lee Jones <[email protected]>
Quoted 3 lines
I don't think static const variables should be in a .h file. Wouldn't
sdio.cbe the right place for these? At least from a quick look I got that impression.
That's a bone of contention. I personally do not like to see C-files overwhelmed by a sea of structs/tables and tend to ferry them off into *-tables.h header files instead.
As the gate-keeper, what you say goes. So if you insist we move these 450 lines of tables into the source file which references them, I will of course do as you ask.
Quoted 1 line
Patch set to Changes Requested.
Signature · 4 lines
Lee Jones [李琼斯] Senior Technical Lead - Developer Services Linaro.org │ Open source software for Arm SoCs Follow Linaro: Facebook | Twitter | Blog
PATCH 2/32 wireless: rsi: rsi_91x_mac80211: Add description for function param 'sta'
In reply to Lee JonesFixes the following W=1 kernel build warning(s):
drivers/net/wireless/rsi/rsi_91x_mac80211.c:1021: warning: Function parameter or member 'sta' not described in 'rsi_mac80211_set_key'
--- drivers/net/wireless/rsi/rsi_91x_mac80211.c | 1 + 1 file changed, 1 insertion(+)
drivers/net/wireless/rsi/rsi_91x_mac80211.c +1 -0
@@ -1009,6 +1009,7 @@ static int rsi_hal_key_config(struct ieee80211_hw *hw,* @hw: Pointer to the ieee80211_hw structure. * @cmd: enum set_key_cmd. * @vif: Pointer to the ieee80211_vif structure. +* @sta: Pointer to the ieee80211_sta structure. * @key: Pointer to the ieee80211_key_conf structure. * * Return: status: 0 on success, negative error code on failure.
Signature · 1 line
2.25.1
Re: [02/32] rsi: Add description for function param 'sta'
Quoted 4 lines · Lee Jones
Fixes the following W=1 kernel build warning(s):
drivers/net/wireless/rsi/rsi_91x_mac80211.c:1021: warning: Function parameter or member 'sta' not described in 'rsi_mac80211_set_key'
Quoted 8 lines
Cc Amitkumar Karwar <[email protected]>Cc Siva Rebbagondla <[email protected]>Cc Kalle Valo <[email protected]>Cc "David S. Miller" <[email protected]>Cc Jakub Kicinski <[email protected]>Signed-off-by Lee Jones <[email protected]>
9 patches applied to wireless-drivers-next.git, thanks.
501c0980b752 rsi: Add description for function param 'sta' d7f95d9204ca brcmsmac: ampdu: Remove a bunch of unused variables 5763605890fe brcmfmac: p2p: Fix a bunch of function docsa451ff855218 rsi: Add descriptions for rsi_set_vap_capabilities()'s parameters dceb807b2f28 brcmsmac: main: Remove a bunch of unused variables 246fe9f15036 rsi: Source file headers do not make good kernel-doc candidates 866cf939f252 brcmfmac: firmware: Demote seemingly unintentional kernel-doc header 7a03124c1df5 rsi: File headers are not suitable for kernel-doc 35b7fbfc51d6 iwlegacy: 4965-mac: Convert function headers to standard comment blocks
Signature · 3 lines
https://patchwork.kernel.org/patch/11728371/ https://wireless.wiki.kernel.org/en/developers/documentation/submittingpatches
PATCH 3/32 wireless: intel: iwlwifi: mvm: ops: Remove unused static struct 'iwl_mvm_debug_names'
In reply to Lee JonesLooks as if it's never been used.
Fixes the following W=1 kernel build warning(s):
drivers/net/wireless/intel/iwlwifi/mvm/ops.c:466:36: warning: ‘iwl_mvm_debug_names’ defined but not used [-Wunused-const-variable=]
--- drivers/net/wireless/intel/iwlwifi/mvm/ops.c | 9 --------- 1 file changed, 9 deletions(-)
drivers/net/wireless/intel/iwlwifi/mvm/ops.c +0 -9
@@ -460,15 +460,6 @@ static const struct iwl_hcmd_names iwl_mvm_data_path_names[] = { HCMD_NAME(RX_QUEUES_NOTIFICATION), }; -/* Please keep this array *SORTED* by hex value. -* Access is done through binary search -*/ -static const struct iwl_hcmd_names iwl_mvm_debug_names[] = { -HCMD_NAME (DBGC_SUSPEND_RESUME ), -HCMD_NAME (BUFFER_ALLOCATION ), -HCMD_NAME (MFU_ASSERT_DUMP_NTF ), -}; -/* Please keep this array *SORTED* by hex value. * Access is done through binary search */
Signature · 1 line
2.25.1
PATCH 4/32 wireless: broadcom: brcm80211: brcmsmac: ampdu: Remove a bunch of unused variables
In reply to Lee JonesFixes the following W=1 kernel build warning(s):
from drivers/net/wireless/broadcom/brcm80211/brcmsmac/ampdu.c:18:
drivers/net/wireless/broadcom/brcm80211/brcmsmac/ampdu.c: In function ‘brcms_c_ampdu_finalize’:
drivers/net/wireless/broadcom/brcm80211/brcmsmac/ampdu.c:648:25: warning: variable ‘sgi’ set but not used [-Wunused-but-set-variable] drivers/net/wireless/broadcom/brcm80211/brcmsmac/ampdu.c: In function ‘brcms_c_ampdu_dotxstatus_complete’:
drivers/net/wireless/broadcom/brcm80211/brcmsmac/ampdu.c:856:18: warning: variable ‘rr_retry_limit’ set but not used [-Wunused-but-set-variable] drivers/net/wireless/broadcom/brcm80211/brcmsmac/ampdu.c:855:5: warning: variable ‘antselid’ set but not used [-Wunused-but-set-variable] drivers/net/wireless/broadcom/brcm80211/brcmsmac/ampdu.c:853:41: warning: variable ‘tx_error’ set but not used [-Wunused-but-set-variable] drivers/net/wireless/broadcom/brcm80211/brcmsmac/ampdu.c:853:7: warning: variable ‘update_rate’ set but not used [-Wunused-but-set-variable] drivers/net/wireless/broadcom/brcm80211/brcmsmac/ampdu.c: In function ‘brcms_c_ampdu_dotxstatus’:
drivers/net/wireless/broadcom/brcm80211/brcmsmac/ampdu.c:1037:28: warning: variable ‘tx_info’ set but not used [-Wunused-but-set-variable] drivers/net/wireless/broadcom/brcm80211/brcmsmac/ampdu.c:1035:28: warning: variable ‘ini’ set but not used [-Wunused-but-set-variable]
--- .../broadcom/brcm80211/brcmsmac/ampdu.c | 28 ++++++------------- 1 file changed, 8 insertions(+), 20 deletions(-)
drivers/net/wireless/broadcom/brcm80211/brcmsmac/ampdu.c +8 -20
@@ -645,7 +645,7 @@ void brcms_c_ampdu_finalize(struct brcms_ampdu_session *session)u16 mimo_ctlchbw =PHY_TXC1_BW_20MHZ ;u32 rspec =0 , rspec_fallback =0 ;u32 rts_rspec =0 , rts_rspec_fallback =0 ; -u8 plcp0, plcp3, is40, sgi, mcs; +u8 plcp0, is40, mcs;u16 mch;u8 preamble_type =BRCMS_GF_PREAMBLE ;u8 fbr_preamble_type =BRCMS_GF_PREAMBLE ;
@@ -704,15 +704,12 @@ void brcms_c_ampdu_finalize(struct brcms_ampdu_session *session) txh->MacTxControlLow =cpu_to_le16 (mcl); fbr = txrate[1 ].count >0 ; -if (!fbr) { +if (!fbr) plcp0 = plcp[0 ]; - plcp3 = plcp[3 ]; - }else { +else plcp0 = txh->FragPLCPFallback[0 ]; - plcp3 = txh->FragPLCPFallback[3 ]; - } + is40 = (plcp0 &MIMO_PLCP_40MHZ ) ?1 :0 ; - sgi =plcp3_issgi (plcp3) ?1 :0 ; mcs = plcp0 & ~MIMO_PLCP_40MHZ ;if (is40) {
@@ -850,10 +847,9 @@ brcms_c_ampdu_dotxstatus_complete(struct ampdu_info *ampdu, struct scb *scb,bool ba_recd = false, ack_recd = false;u8 suc_mpdu =0 , tot_mpdu =0 ;uint supr_status; -bool update_rate = true, retry = true, tx_error = false; +bool update_rate = true, retry = true;u16 mimoantsel =0 ; -u8 antselid =0 ; -u8 retry_limit, rr_retry_limit; +u8 retry_limit;struct ieee80211_tx_info *tx_info =IEEE80211_SKB_CB (p);#ifdef DEBUG
@@ -866,7 +862,6 @@ brcms_c_ampdu_dotxstatus_complete(struct ampdu_info *ampdu, struct scb *scb, ini = &scb_ampdu->ini[tid]; retry_limit = ampdu->retry_limit_tid[tid]; - rr_retry_limit = ampdu->rr_retry_limit_tid[tid];memset (bitmap,0 ,sizeof (bitmap)); queue = txs->frameid &TXFID_QUEUE_MASK ; supr_status = txs->status &TX_STATUS_SUPR_MASK ;
@@ -923,8 +918,7 @@ brcms_c_ampdu_dotxstatus_complete(struct ampdu_info *ampdu, struct scb *scb,* if there were underflows, but pre-loading * is not active, notify rate adaptation. */ -if (brcms_c_ffpld_check_txfunfl (wlc, queue) >0 ) - tx_error = true; +brcms_c_ffpld_check_txfunfl (wlc, queue); } }else if (txs->phyerr) { update_rate = false;
@@ -1023,7 +1017,7 @@ brcms_c_ampdu_dotxstatus_complete(struct ampdu_info *ampdu, struct scb *scb, }/* update rate state */ - antselid =brcms_c_antsel_antsel2id (wlc->asi, mimoantsel); +brcms_c_antsel_antsel2id (wlc->asi, mimoantsel); }void
@@ -1032,11 +1026,7 @@ brcms_c_ampdu_dotxstatus(struct ampdu_info *ampdu, struct scb *scb, {struct scb_ampdu *scb_ampdu;struct brcms_c_info *wlc = ampdu->wlc; -struct scb_ampdu_tid_ini *ini;u32 s1 =0 , s2 =0 ; -struct ieee80211_tx_info *tx_info; - - tx_info =IEEE80211_SKB_CB (p);/* BMAC_NOTE: For the split driver, second level txstatus comes later * So if the ACK was received then wait for the second level else just
@@ -1061,7 +1051,6 @@ brcms_c_ampdu_dotxstatus(struct ampdu_info *ampdu, struct scb *scb,if (scb) { scb_ampdu = &scb->scb_ampdu; - ini = &scb_ampdu->ini[p->priority];brcms_c_ampdu_dotxstatus_complete (ampdu, scb, p, txs, s1, s2); }else {/* loop through all pkts and free */
@@ -1069,7 +1058,6 @@ brcms_c_ampdu_dotxstatus(struct ampdu_info *ampdu, struct scb *scb,struct d11txh *txh;u16 mcl;while (p) { - tx_info =IEEE80211_SKB_CB (p); txh = (struct d11txh *) p->data;trace_brcms_txdesc (&wlc->hw->d11core->dev, txh,sizeof (*txh));
Signature · 1 line
2.25.1
PATCH 5/32 wireless: broadcom: brcm80211: brcmfmac: p2p: Fix a bunch of function docs
In reply to Lee JonesSome formatting issues, some missing and some extra descriptions.
Fixes the following W=1 kernel build warning(s):
drivers/net/wireless/broadcom/brcm80211/brcmfmac/p2p.c:162: warning: Function parameter or member 'oui' not described in 'brcmf_p2p_pub_act_frame' drivers/net/wireless/broadcom/brcm80211/brcmfmac/p2p.c:162: warning: Function parameter or member 'elts' not described in 'brcmf_p2p_pub_act_frame' drivers/net/wireless/broadcom/brcm80211/brcmfmac/p2p.c:181: warning: Function parameter or member 'oui' not described in 'brcmf_p2p_action_frame' drivers/net/wireless/broadcom/brcm80211/brcmfmac/p2p.c:181: warning: Function parameter or member 'elts' not described in 'brcmf_p2p_action_frame' drivers/net/wireless/broadcom/brcm80211/brcmfmac/p2p.c:196: warning: Function parameter or member 'query_data' not described in 'brcmf_p2psd_gas_pub_act_frame' drivers/net/wireless/broadcom/brcm80211/brcmfmac/p2p.c:210: warning: Function parameter or member 'extra_listen' not described in 'brcmf_config_af_params' drivers/net/wireless/broadcom/brcm80211/brcmfmac/p2p.c:776: warning: Function parameter or member 'ifp' not described in 'brcmf_p2p_run_escan' drivers/net/wireless/broadcom/brcm80211/brcmfmac/p2p.c:776: warning: Excess function parameter 'ndev' description in 'brcmf_p2p_run_escan' drivers/net/wireless/broadcom/brcm80211/brcmfmac/p2p.c:776: warning: Excess function parameter 'action' description in 'brcmf_p2p_run_escan' drivers/net/wireless/broadcom/brcm80211/brcmfmac/p2p.c:977: warning: Function parameter or member 'wdev' not described in 'brcmf_p2p_remain_on_channel' drivers/net/wireless/broadcom/brcm80211/brcmfmac/p2p.c:977: warning: Function parameter or member 'cookie' not described in 'brcmf_p2p_remain_on_channel' drivers/net/wireless/broadcom/brcm80211/brcmfmac/p2p.c:1063: warning: Function parameter or member 'channel' not described in 'brcmf_p2p_act_frm_search' drivers/net/wireless/broadcom/brcm80211/brcmfmac/p2p.c:1337: warning: Function parameter or member 'mac' not described in 'brcmf_p2p_gon_req_collision' drivers/net/wireless/broadcom/brcm80211/brcmfmac/p2p.c:2046: warning: Function parameter or member 'cfg' not described in 'brcmf_p2p_ifchange' drivers/net/wireless/broadcom/brcm80211/brcmfmac/p2p.c:2046: warning: Function parameter or member 'if_type' not described in 'brcmf_p2p_ifchange' drivers/net/wireless/broadcom/brcm80211/brcmfmac/p2p.c:2046: warning: Excess function parameter 'mac' description in 'brcmf_p2p_ifchange'
--- .../broadcom/brcm80211/brcmfmac/p2p.c | 22 ++++++++++--------- 1 file changed, 12 insertions(+), 10 deletions(-)
drivers/net/wireless/broadcom/brcm80211/brcmfmac/p2p.c +12 -10
@@ -145,11 +145,11 @@ struct brcmf_p2p_scan_le {* * @category: P2P_PUB_AF_CATEGORY * @action: P2P_PUB_AF_ACTION -* @oui[3]: P2P_OUI +* @oui: P2P_OUI * @oui_type: OUI type - P2P_VER * @subtype: OUI subtype - P2P_TYPE_* * @dialog_token: nonzero, identifies req/rsp transaction -* @elts[1]: Variable length information elements. +* @elts: Variable length information elements. */ struct brcmf_p2p_pub_act_frame {u8 category;
@@ -165,11 +165,11 @@ struct brcmf_p2p_pub_act_frame {* struct brcmf_p2p_action_frame - WiFi P2P Action Frame * * @category: P2P_AF_CATEGORY -* @OUI[3]: OUI - P2P_OUI +* @oui: OUI - P2P_OUI * @type: OUI Type - P2P_VER * @subtype: OUI Subtype - P2P_AF_* * @dialog_token: nonzero, identifies req/resp tranaction -* @elts[1]: Variable length information elements. +* @elts: Variable length information elements. */ struct brcmf_p2p_action_frame {u8 category;
@@ -186,7 +186,7 @@ struct brcmf_p2p_action_frame {* @category: 0x04 Public Action Frame * @action: 0x6c Advertisement Protocol * @dialog_token: nonzero, identifies req/rsp transaction -* @query_data[1]: Query Data. SD gas ireq SD gas iresp +* @query_data: Query Data. SD gas ireq SD gas iresp */ struct brcmf_p2psd_gas_pub_act_frame {u8 category;
@@ -201,7 +201,7 @@ struct brcmf_p2psd_gas_pub_act_frame {* @mpc_onoff: To make sure to send successfully action frame, we have to * turn off mpc 0: off, 1: on, (-1): do nothing * @search_channel: 1: search peer's channel to send af -* extra_listen: keep the dwell time to get af response frame. +* @extra_listen: keep the dwell time to get af response frame. */ struct brcmf_config_af_params {s32 mpc_onoff;
@@ -763,9 +763,8 @@ static s32 brcmf_p2p_escan(struct brcmf_p2p_info *p2p, u32 num_chans,* brcmf_p2p_run_escan() - escan callback for peer-to-peer. * * @cfg: driver private data for cfg80211 interface. -* @ndev: net device for which scan is requested. +* @ifp: interface control. * @request: scan request from cfg80211. -* @action: scan action. * * Determines the P2P discovery state based to scan request parameters and * validates the channels in the request.
@@ -967,9 +966,10 @@ brcmf_p2p_discover_listen(struct brcmf_p2p_info *p2p, u16 channel, u32 duration)* brcmf_p2p_remain_on_channel() - put device on channel and stay there. * * @wiphy: wiphy device. +* @wiphy: wireless device. * @channel: channel to stay on. * @duration: time in ms to remain on channel. -* +* @cookie: cookie. */ int brcmf_p2p_remain_on_channel(struct wiphy *wiphy, struct wireless_dev *wdev, struct ieee80211_channel *channel,
@@ -1054,7 +1054,7 @@ void brcmf_p2p_cancel_remain_on_channel(struct brcmf_if *ifp)* brcmf_p2p_act_frm_search() - search function for action frame. * * @p2p: p2p device. -* channel: channel on which action frame is to be trasmitted. +* @channel: channel on which action frame is to be trasmitted. * * search function to reach at common channel to send action frame. When * channel is 0 then all social channels will be used to send af
@@ -1329,6 +1329,7 @@ brcmf_p2p_stop_wait_next_action_frame(struct brcmf_cfg80211_info *cfg)* brcmf_p2p_gon_req_collision() - Check if go negotiaton collission * * @p2p: p2p device info struct. +* @mac: MAC address. * * return true if recevied action frame is to be dropped. */
@@ -2039,6 +2040,7 @@ static void brcmf_p2p_get_current_chanspec(struct brcmf_p2p_info *p2p,* Change a P2P Role. * Parameters: * @mac: MAC address of the BSS to change a role +* @if_type: interface type. * Returns 0 if success. */ int brcmf_p2p_ifchange(struct brcmf_cfg80211_info *cfg,
Signature · 1 line
2.25.1
PATCH 6/32 wireless: rsi: rsi_91x_mgmt: Add descriptions for rsi_set_vap_capabilities()'s parameters
In reply to Lee JonesFixes the following W=1 kernel build warning(s):
drivers/net/wireless/rsi/rsi_91x_mgmt.c:713: warning: Function parameter or member 'mac_addr' not described in 'rsi_set_vap_capabilities' drivers/net/wireless/rsi/rsi_91x_mgmt.c:713: warning: Function parameter or member 'vap_id' not described in 'rsi_set_vap_capabilities' drivers/net/wireless/rsi/rsi_91x_mgmt.c:713: warning: Function parameter or member 'vap_status' not described in 'rsi_set_vap_capabilities'
--- drivers/net/wireless/rsi/rsi_91x_mgmt.c | 3 +++ 1 file changed, 3 insertions(+)
drivers/net/wireless/rsi/rsi_91x_mgmt.c +3 -0
@@ -702,6 +702,9 @@ static int rsi_program_bb_rf(struct rsi_common *common)* rsi_set_vap_capabilities() - This function send vap capability to firmware. * @common: Pointer to the driver private structure. * @mode: Operating mode of device. +* @mac_addr: MAC address +* @vap_id: Rate information - offset and mask +* @vap_status: VAP status - ADD, DELETE or UPDATE * * Return: 0 on success, corresponding negative error code on failure. */
Signature · 1 line
2.25.1
PATCH 7/32 wireless: intel: iwlwifi: dvm: rx: Demote a couple of nonconformant kernel-doc headers
In reply to Lee JonesFixes the following W=1 kernel build warning(s):
drivers/net/wireless/intel/iwlwifi/dvm/rx.c:145: warning: Function parameter or member 'priv' not described in 'iwlagn_good_plcp_health' drivers/net/wireless/intel/iwlwifi/dvm/rx.c:145: warning: Function parameter or member 'cur_ofdm' not described in 'iwlagn_good_plcp_health' drivers/net/wireless/intel/iwlwifi/dvm/rx.c:145: warning: Function parameter or member 'cur_ofdm_ht' not described in 'iwlagn_good_plcp_health' drivers/net/wireless/intel/iwlwifi/dvm/rx.c:145: warning: Function parameter or member 'msecs' not described in 'iwlagn_good_plcp_health' drivers/net/wireless/intel/iwlwifi/dvm/rx.c:939: warning: Function parameter or member 'priv' not described in 'iwl_setup_rx_handlers'
--- drivers/net/wireless/intel/iwlwifi/dvm/rx.c | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-)
drivers/net/wireless/intel/iwlwifi/dvm/rx.c +2 -2
@@ -132,7 +132,7 @@ static void iwlagn_rx_beacon_notif(struct iwl_priv *priv, priv->ibss_manager =le32_to_cpu (beacon->ibss_mgr_status); } -/** +/* * iwl_good_plcp_health - checks for plcp error. * * When the plcp error is exceeding the thresholds, reset the radio
@@ -929,7 +929,7 @@ static void iwlagn_rx_noa_notification(struct iwl_priv *priv,kfree_rcu (old_data, rcu_head); } -/** +/* * iwl_setup_rx_handlers - Initialize Rx handler callbacks * * Setup the RX handlers for each of the reply types sent from the uCode
Signature · 1 line
2.25.1
PATCH 8/32 wireless: intel: iwlwifi: mvm: utils: Fix some doc-rot
In reply to Lee JonesFix misnamed, and missing descriptions likely due to doc-rot.
Fixes the following W=1 kernel build warning(s):
drivers/net/wireless/intel/iwlwifi/mvm/utils.c:669: warning: Function parameter or member 'mvm' not described in 'iwl_mvm_send_lq_cmd' drivers/net/wireless/intel/iwlwifi/mvm/utils.c:669: warning: Function parameter or member 'lq' not described in 'iwl_mvm_send_lq_cmd' drivers/net/wireless/intel/iwlwifi/mvm/utils.c:669: warning: Excess function parameter 'sync' description in 'iwl_mvm_send_lq_cmd' drivers/net/wireless/intel/iwlwifi/mvm/utils.c:695: warning: Function parameter or member 'mvm' not described in 'iwl_mvm_update_smps' drivers/net/wireless/intel/iwlwifi/mvm/utils.c:695: warning: Function parameter or member 'vif' not described in 'iwl_mvm_update_smps' drivers/net/wireless/intel/iwlwifi/mvm/utils.c:695: warning: Function parameter or member 'smps_request' not described in 'iwl_mvm_update_smps' drivers/net/wireless/intel/iwlwifi/mvm/utils.c:695: warning: Excess function parameter 'smps_requests' description in 'iwl_mvm_update_smps'
--- drivers/net/wireless/intel/iwlwifi/mvm/utils.c | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-)
drivers/net/wireless/intel/iwlwifi/mvm/utils.c +5 -2
@@ -658,7 +658,8 @@ int iwl_mvm_reconfig_scd(struct iwl_mvm *mvm, int queue, int fifo, int sta_id,/** * iwl_mvm_send_lq_cmd() - Send link quality command -* @sync: This command can be sent synchronously. +* @mvm: Driver data. +* @lq: Link quality command to send. * * The link quality command is sent as the last step of station creation. * This is the special case in which init is set and we call a callback in
@@ -683,8 +684,10 @@ int iwl_mvm_send_lq_cmd(struct iwl_mvm *mvm, struct iwl_lq_cmd *lq)/** * iwl_mvm_update_smps - Get a request to change the SMPS mode +* @mvm: Driver data. +* @vif: Pointer to the ieee80211_vif structure * @req_type: The part of the driver who call for a change. -* @smps_requests: The request to change the SMPS mode. +* @smps_request: The request to change the SMPS mode. * * Get a requst to change the SMPS mode, * and change it according to all other requests in the driver.
Signature · 1 line
2.25.1
PATCH 9/32 wireless: broadcom: brcm80211: brcmsmac: main: Remove a bunch of unused variables
In reply to Lee JonesFixes the following W=1 kernel build warning(s):
from drivers/net/wireless/broadcom/brcm80211/brcmsmac/main.c:27:
drivers/net/wireless/broadcom/brcm80211/brcmsmac/main.c: In function ‘brcms_c_dotxstatus’:
drivers/net/wireless/broadcom/brcm80211/brcmsmac/main.c:845:6: warning: variable ‘mcl’ set but not used [-Wunused-but-set-variable] drivers/net/wireless/broadcom/brcm80211/brcmsmac/main.c: In function ‘brcms_b_phy_reset’:
drivers/net/wireless/broadcom/brcm80211/brcmsmac/main.c:1779:7: warning: variable ‘phy_in_reset’ set but not used [-Wunused-but-set-variable] drivers/net/wireless/broadcom/brcm80211/brcmsmac/main.c: In function ‘brcms_ucode_download’:
drivers/net/wireless/broadcom/brcm80211/brcmsmac/main.c:2273:23: warning: variable ‘wlc’ set but not used [-Wunused-but-set-variable] drivers/net/wireless/broadcom/brcm80211/brcmsmac/main.c: In function ‘brcms_b_coreinit’:
drivers/net/wireless/broadcom/brcm80211/brcmsmac/main.c:3176:6: warning: variable ‘sflags’ set but not used [-Wunused-but-set-variable] drivers/net/wireless/broadcom/brcm80211/brcmsmac/main.c: In function ‘brcms_c_set_chanspec’:
drivers/net/wireless/broadcom/brcm80211/brcmsmac/main.c:3902:7: warning: variable ‘switchband’ set but not used [-Wunused-but-set-variable] drivers/net/wireless/broadcom/brcm80211/brcmsmac/main.c: In function ‘brcms_c_down’:
drivers/net/wireless/broadcom/brcm80211/brcmsmac/main.c:5182:7: warning: variable ‘dev_gone’ set but not used [-Wunused-but-set-variable] drivers/net/wireless/broadcom/brcm80211/brcmsmac/main.c: In function ‘brcms_c_ofdm_rateset_war’:
drivers/net/wireless/broadcom/brcm80211/brcmsmac/main.c:5393:5: warning: variable ‘r’ set but not used [-Wunused-but-set-variable] drivers/net/wireless/broadcom/brcm80211/brcmsmac/main.c: In function ‘mac80211_wlc_set_nrate’:
drivers/net/wireless/broadcom/brcm80211/brcmsmac/main.c:5876:6: warning: variable ‘bcmerror’ set but not used [-Wunused-but-set-variable] drivers/net/wireless/broadcom/brcm80211/brcmsmac/main.c: In function ‘brcms_c_d11hdrs_mac80211’:
drivers/net/wireless/broadcom/brcm80211/brcmsmac/main.c:6213:7: warning: variable ‘short_preamble’ set but not used [-Wunused-but-set-variable]
--- .../broadcom/brcm80211/brcmsmac/main.c | 38 ++----------------- 1 file changed, 3 insertions(+), 35 deletions(-)
drivers/net/wireless/broadcom/brcm80211/brcmsmac/main.c +3 -35
@@ -842,7 +842,6 @@ brcms_c_dotxstatus(struct brcms_c_info *wlc, struct tx_status *txs)uint supr_status;bool lastframe;struct ieee80211_hdr *h; -u16 mcl;struct ieee80211_tx_info *tx_info;struct ieee80211_tx_rate *txrate;int i;
@@ -879,7 +878,6 @@ brcms_c_dotxstatus(struct brcms_c_info *wlc, struct tx_status *txs) } txh = (struct d11txh *) (p->data); - mcl =le16_to_cpu (txh->MacTxControlLow);if (txs->phyerr) brcms_dbg_tx(wlc->hw->d11core, "phyerr 0x%x, rate 0x%x\n",
@@ -1776,7 +1774,6 @@ void brcms_b_phy_reset(struct brcms_hardware *wlc_hw) {struct brcms_phy_pub *pih = wlc_hw->band->pi;u32 phy_bw_clkbits; -bool phy_in_reset = false;brcms_dbg_info (wlc_hw->d11core,"wl%d: reset phy\n" , wlc_hw->unit);
@@ -1799,7 +1796,6 @@ void brcms_b_phy_reset(struct brcms_hardware *wlc_hw)/* reset the PHY */ brcms_b_core_ioctl (wlc_hw, (SICF_PRST |SICF_PCLKE ), (SICF_PRST |SICF_PCLKE )); - phy_in_reset = true; }else { brcms_b_core_ioctl(wlc_hw, (SICF_PRST | SICF_PCLKE | SICF_BWMASK),
@@ -2270,11 +2266,8 @@ static void brcms_ucode_write(struct brcms_hardware *wlc_hw,static void brcms_ucode_download (struct brcms_hardware *wlc_hw) { -struct brcms_c_info *wlc;struct brcms_ucode *ucode = &wlc_hw->wlc->wl->ucode; - wlc = wlc_hw->wlc; -if (wlc_hw->ucode_loaded)return ;
@@ -3173,7 +3166,6 @@ static void brcms_b_coreinit(struct brcms_c_info *wlc) {struct brcms_hardware *wlc_hw = wlc->hw;struct bcma_device *core = wlc_hw->d11core; -u32 sflags;u32 bcnint_us;uint i =0 ;bool fifosz_fixup = false;
@@ -3206,7 +3198,7 @@ static void brcms_b_coreinit(struct brcms_c_info *wlc)brcms_c_gpio_init (wlc); - sflags =bcma_aread32 (core,BCMA_IOST ); +bcma_aread32 (core,BCMA_IOST );if (D11REV_IS (wlc_hw->corerev,17 ) ||D11REV_IS (wlc_hw->corerev,23 )) {if (BRCMS_ISNPHY (wlc_hw->band))
@@ -3899,7 +3891,6 @@ static void brcms_c_setband(struct brcms_c_info *wlc,static void brcms_c_set_chanspec (struct brcms_c_info *wlc,u16 chanspec) {uint bandunit; -bool switchband = false;u16 old_chanspec = wlc->chanspec;if (!brcms_c_valid_chanspec_db (wlc->cmi, chanspec)) {
@@ -3912,7 +3903,6 @@ static void brcms_c_set_chanspec(struct brcms_c_info *wlc, u16 chanspec)if (wlc->pub->_nbands >1 ) { bandunit =chspec_bandunit (chanspec);if (wlc->band->bandunit != bandunit || wlc->bandinit_pending) { - switchband = true;if (wlc->bandlocked) { brcms_err(wlc->hw->d11core, "wl%d: %s: chspec %d band is locked!\n",
@@ -5179,7 +5169,6 @@ uint brcms_c_down(struct brcms_c_info *wlc)uint callbacks =0 ;int i; -bool dev_gone = false;brcms_dbg_info (wlc->hw->d11core,"wl%d\n" , wlc->pub->unit);
@@ -5197,7 +5186,7 @@ uint brcms_c_down(struct brcms_c_info *wlc) callbacks +=brcms_b_bmac_down_prep (wlc->hw); - dev_gone =brcms_deviceremoved (wlc); +brcms_deviceremoved (wlc);/* Call any registered down handlers */ for (i =0 ; i <BRCMS_MAXMODULES ; i++) {
@@ -5390,15 +5379,7 @@ brcms_c_set_internal_rateset(struct brcms_c_info *wlc,static void brcms_c_ofdm_rateset_war (struct brcms_c_info *wlc) { -u8 r; -bool war = false; - -if (wlc->pub->associated) - r = wlc->bsscfg->current_bss->rateset.rates[0 ]; -else - r = wlc->default_bss->rateset.rates[0 ]; - -wlc_phy_ofdm_rateset_war (wlc->band->pi, war); +wlc_phy_ofdm_rateset_war (wlc->band->pi, false); }int brcms_c_set_channel (struct brcms_c_info *wlc,u16 channel)
@@ -5873,7 +5854,6 @@ mac80211_wlc_set_nrate(struct brcms_c_info *wlc, struct brcms_band *cur_band,bool issgi = ((int_val &NRATE_SGI_MASK ) >>NRATE_SGI_SHIFT );bool override_mcs_only = ((int_val &NRATE_OVERRIDE_MCS_ONLY ) ==NRATE_OVERRIDE_MCS_ONLY ); -int bcmerror =0 ;if (!ismcs)return (u32 ) rate;
@@ -5884,7 +5864,6 @@ mac80211_wlc_set_nrate(struct brcms_c_info *wlc, struct brcms_band *cur_band,if (stf >PHY_TXC1_MODE_SDM ) {brcms_err (core,"wl%d: %s: Invalid stf\n" , wlc->pub->unit, __func__); - bcmerror = -EINVAL ; goto done; }
@@ -5895,7 +5874,6 @@ mac80211_wlc_set_nrate(struct brcms_c_info *wlc, struct brcms_band *cur_band, && (stf != PHY_TXC1_MODE_CDD))) {brcms_err (core,"wl%d: %s: Invalid mcs 32\n" , wlc->pub->unit, __func__); - bcmerror = -EINVAL ; goto done; }/* mcs > 7 must use stf SDM */
@@ -5917,7 +5895,6 @@ mac80211_wlc_set_nrate(struct brcms_c_info *wlc, struct brcms_band *cur_band, && (stf == PHY_TXC1_MODE_STBC))) {brcms_err (core,"wl%d: %s: Invalid STBC\n" , wlc->pub->unit, __func__); - bcmerror = -EINVAL ; goto done; } }
@@ -5925,7 +5902,6 @@ mac80211_wlc_set_nrate(struct brcms_c_info *wlc, struct brcms_band *cur_band,if ((stf !=PHY_TXC1_MODE_CDD ) && (stf !=PHY_TXC1_MODE_SISO )) {brcms_err (core,"wl%d: %s: Invalid OFDM\n" , wlc->pub->unit, __func__); - bcmerror = -EINVAL ; goto done; } }else if (is_cck_rate (rate)) {
@@ -5933,20 +5909,17 @@ mac80211_wlc_set_nrate(struct brcms_c_info *wlc, struct brcms_band *cur_band, || (stf != PHY_TXC1_MODE_SISO)) {brcms_err (core,"wl%d: %s: Invalid CCK\n" , wlc->pub->unit, __func__); - bcmerror = -EINVAL ; goto done; } }else {brcms_err (core,"wl%d: %s: Unknown rate type\n" , wlc->pub->unit, __func__); - bcmerror = -EINVAL ; goto done; }/* make sure multiple antennae are available for non-siso rates */ if ((stf !=PHY_TXC1_MODE_SISO ) && (wlc->stf->txstreams ==1 )) {brcms_err (core,"wl%d: %s: SISO antenna but !SISO " "request\n" , wlc->pub->unit, __func__); - bcmerror = -EINVAL ; goto done; }
@@ -6210,7 +6183,6 @@ brcms_c_d11hdrs_mac80211(struct brcms_c_info *wlc, struct ieee80211_hw *hw,bool use_rts = false;bool use_cts = false;bool use_rifs = false; -bool short_preamble[2 ] = { false, false };u8 preamble_type[2 ] = {BRCMS_LONG_PREAMBLE ,BRCMS_LONG_PREAMBLE };u8 rts_preamble_type[2 ] = {BRCMS_LONG_PREAMBLE ,BRCMS_LONG_PREAMBLE };u8 *rts_plcp, rts_plcp_fallback[D11_PHY_HDR_LEN ];
@@ -6296,10 +6268,6 @@ brcms_c_d11hdrs_mac80211(struct brcms_c_info *wlc, struct ieee80211_hw *hw, rspec[k] = hw->wiphy->bands[tx_info->band]-> bitrates[txrate[k]->idx].hw_value; - short_preamble[k] = - txrate[k]-> - flags &IEEE80211_TX_RC_USE_SHORT_PREAMBLE ? - true : false; }else { rspec[k] =BRCM_RATE_1M ; }
Signature · 1 line
2.25.1
PATCH 10/32 wireless: rsi: rsi_91x_ps: Source file headers do not make good kernel-doc candidates
In reply to Lee JonesFixes the following W=1 kernel build warning(s):
drivers/net/wireless/rsi/rsi_91x_ps.c:26: warning: Function parameter or member 'state' not described in 'str_psstate'
--- drivers/net/wireless/rsi/rsi_91x_ps.c | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-)
drivers/net/wireless/rsi/rsi_91x_ps.c +1 -1
@@ -1,4 +1,4 @@ -/** +/* * Copyright (c) 2014 Redpine Signals Inc. * * Permission to use, copy, modify, and/or distribute this software for any
Signature · 1 line
2.25.1
PATCH 11/32 wireless: intel: iwlwifi: dvm: scan: Demote a few nonconformant kernel-doc headers
In reply to Lee Jones2 of which do not attempt to document their parameters, 1 does a poor job.
Fixes the following W=1 kernel build warning(s):
drivers/net/wireless/intel/iwlwifi/dvm/scan.c:193: warning: Function parameter or member 'priv' not described in 'iwl_scan_cancel' drivers/net/wireless/intel/iwlwifi/dvm/scan.c:205: warning: Function parameter or member 'priv' not described in 'iwl_scan_cancel_timeout' drivers/net/wireless/intel/iwlwifi/dvm/scan.c:570: warning: Function parameter or member 'frame' not described in 'iwl_fill_probe_req' drivers/net/wireless/intel/iwlwifi/dvm/scan.c:570: warning: Function parameter or member 'ta' not described in 'iwl_fill_probe_req' drivers/net/wireless/intel/iwlwifi/dvm/scan.c:570: warning: Function parameter or member 'ies' not described in 'iwl_fill_probe_req' drivers/net/wireless/intel/iwlwifi/dvm/scan.c:570: warning: Function parameter or member 'ie_len' not described in 'iwl_fill_probe_req' drivers/net/wireless/intel/iwlwifi/dvm/scan.c:570: warning: Function parameter or member 'ssid' not described in 'iwl_fill_probe_req' drivers/net/wireless/intel/iwlwifi/dvm/scan.c:570: warning: Function parameter or member 'ssid_len' not described in 'iwl_fill_probe_req' drivers/net/wireless/intel/iwlwifi/dvm/scan.c:570: warning: Function parameter or member 'left' not described in 'iwl_fill_probe_req'
--- drivers/net/wireless/intel/iwlwifi/dvm/scan.c | 8 +++----- 1 file changed, 3 insertions(+), 5 deletions(-)
drivers/net/wireless/intel/iwlwifi/dvm/scan.c +3 -5
@@ -186,7 +186,7 @@ static void iwl_do_scan_abort(struct iwl_priv *priv)IWL_DEBUG_SCAN (priv,"Successfully send scan abort\n" ); } -/** +/* * iwl_scan_cancel - Cancel any currently executing HW scan */ int iwl_scan_cancel (struct iwl_priv *priv)
@@ -196,10 +196,9 @@ int iwl_scan_cancel(struct iwl_priv *priv)return 0 ; } -/** +/* * iwl_scan_cancel_timeout - Cancel any currently executing HW scan * @ms: amount of time to wait (in milliseconds) for scan to abort -* */ void iwl_scan_cancel_timeout (struct iwl_priv *priv,unsigned long ms) {
@@ -560,10 +559,9 @@ static int iwl_get_channels_for_scan(struct iwl_priv *priv,return added; } -/** +/* * iwl_fill_probe_req - fill in all required fields and IE for probe request */ -static u16 iwl_fill_probe_req (struct ieee80211_mgmt *frame,const u8 *ta,const u8 *ies,int ie_len,const u8 *ssid,u8 ssid_len,int left)
Signature · 1 line
2.25.1
PATCH 12/32 wireless: brcm80211: brcmfmac: firmware: Demote seemingly unintentional kernel-doc header
In reply to Lee JonesThe function parameter is not documented and either are any of the other functions in this source file.
Fixes the following W=1 kernel build warning(s):
drivers/net/wireless/broadcom/brcm80211/brcmfmac/firmware.c:69: warning: Function parameter or member 'c' not described in 'is_nvram_char'
--- drivers/net/wireless/broadcom/brcm80211/brcmfmac/firmware.c | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-)
drivers/net/wireless/broadcom/brcm80211/brcmfmac/firmware.c +1 -1
@@ -59,7 +59,7 @@ struct nvram_parser {bool boardrev_found; }; -/** +/* * is_nvram_char() - check if char is a valid one for NVRAM entry * * It accepts all printable ASCII chars except for '#' which opens a comment.
Signature · 1 line
2.25.1
PATCH 13/32 wireless: intel: iwlwifi: dvm: rxon: Demote non-conformant kernel-doc headers
In reply to Lee JonesFixes the following W=1 kernel build warning(s):
drivers/net/wireless/intel/iwlwifi/dvm/rxon.c:695: warning: bad line:
drivers/net/wireless/intel/iwlwifi/dvm/rxon.c:701: warning: Function parameter or member 'priv' not described in 'iwl_set_rxon_channel' drivers/net/wireless/intel/iwlwifi/dvm/rxon.c:701: warning: Function parameter or member 'ctx' not described in 'iwl_set_rxon_channel' drivers/net/wireless/intel/iwlwifi/dvm/rxon.c:839: warning: Function parameter or member 'ctx' not described in 'iwl_full_rxon_required' drivers/net/wireless/intel/iwlwifi/dvm/rxon.c:1029: warning: Function parameter or member 'priv' not described in 'iwlagn_commit_rxon' drivers/net/wireless/intel/iwlwifi/dvm/rxon.c:1029: warning: Function parameter or member 'ctx' not described in 'iwlagn_commit_rxon'
--- drivers/net/wireless/intel/iwlwifi/dvm/rxon.c | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-)
drivers/net/wireless/intel/iwlwifi/dvm/rxon.c +3 -3
@@ -689,7 +689,7 @@ void iwl_set_rxon_ht(struct iwl_priv *priv, struct iwl_ht_config *ht_conf)_iwl_set_rxon_ht (priv, ht_conf, ctx); } -/** +/* * iwl_set_rxon_channel - Set the band and channel values in staging RXON * @ch: requested channel as a pointer to struct ieee80211_channel
@@ -826,7 +826,7 @@ static int iwl_check_rxon_cmd(struct iwl_priv *priv,return errors ? -EINVAL :0 ; } -/** +/* * iwl_full_rxon_required - check if full RXON (vs RXON_ASSOC) cmd is needed * @priv: staging_rxon is compared to active_rxon *
@@ -1007,7 +1007,7 @@ static void iwl_calc_basic_rates(struct iwl_priv *priv, ctx->staging.ofdm_basic_rates = ofdm; } -/** +/* * iwlagn_commit_rxon - commit staging_rxon to hardware * * The RXON command in staging_rxon is committed to the hardware and
Signature · 1 line
2.25.1
PATCH 14/32 wireless: rsi: rsi_91x_coex: File headers are not suitable for kernel-doc
In reply to Lee JonesFixes the following W=1 kernel build warning(s):
drivers/net/wireless/rsi/rsi_91x_coex.c:24: warning: Function parameter or member 'coex_cb' not described in 'rsi_coex_determine_coex_q'
--- drivers/net/wireless/rsi/rsi_91x_coex.c | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-)
drivers/net/wireless/rsi/rsi_91x_coex.c +1 -1
@@ -1,4 +1,4 @@ -/** +/* * Copyright (c) 2018 Redpine Signals Inc. * * Permission to use, copy, modify, and/or distribute this software for any
Signature · 1 line
2.25.1
PATCH 15/32 wireless: intel: iwlegacy: 4965-mac: Convert function headers to standard comment blocks
In reply to Lee JonesThese are clearly not suitable for kernel-doc.
Fixes the following W=1 kernel build warning(s):
drivers/net/wireless/intel/iwlegacy/4965-mac.c:234: warning: Function parameter or member 'il' not described in 'il4965_dma_addr2rbd_ptr' drivers/net/wireless/intel/iwlegacy/4965-mac.c:234: warning: Function parameter or member 'dma_addr' not described in 'il4965_dma_addr2rbd_ptr' drivers/net/wireless/intel/iwlegacy/4965-mac.c:251: warning: Function parameter or member 'il' not described in 'il4965_rx_queue_restock' drivers/net/wireless/intel/iwlegacy/4965-mac.c:301: warning: Function parameter or member 'il' not described in 'il4965_rx_allocate' drivers/net/wireless/intel/iwlegacy/4965-mac.c:301: warning: Function parameter or member 'priority' not described in 'il4965_rx_allocate' drivers/net/wireless/intel/iwlegacy/4965-mac.c:1138: warning: Function parameter or member 'il' not described in 'il4965_set_rxon_chain' drivers/net/wireless/intel/iwlegacy/4965-mac.c:1943: warning: Function parameter or member 'il' not described in 'il4965_hw_txq_ctx_free' drivers/net/wireless/intel/iwlegacy/4965-mac.c:1971: warning: Function parameter or member 'il' not described in 'il4965_txq_ctx_alloc' drivers/net/wireless/intel/iwlegacy/4965-mac.c:2068: warning: Function parameter or member 'il' not described in 'il4965_txq_ctx_stop' drivers/net/wireless/intel/iwlegacy/4965-mac.c:2109: warning: Function parameter or member 'il' not described in 'il4965_tx_queue_stop_scheduler' drivers/net/wireless/intel/iwlegacy/4965-mac.c:2109: warning: Function parameter or member 'txq_id' not described in 'il4965_tx_queue_stop_scheduler' drivers/net/wireless/intel/iwlegacy/4965-mac.c:2122: warning: Function parameter or member 'il' not described in 'il4965_tx_queue_set_q2ratid' drivers/net/wireless/intel/iwlegacy/4965-mac.c:2122: warning: Function parameter or member 'ra_tid' not described in 'il4965_tx_queue_set_q2ratid' drivers/net/wireless/intel/iwlegacy/4965-mac.c:2122: warning: Function parameter or member 'txq_id' not described in 'il4965_tx_queue_set_q2ratid' drivers/net/wireless/intel/iwlegacy/4965-mac.c:2153: warning: Function parameter or member 'il' not described in 'il4965_txq_agg_enable' drivers/net/wireless/intel/iwlegacy/4965-mac.c:2153: warning: Function parameter or member 'txq_id' not described in 'il4965_txq_agg_enable' drivers/net/wireless/intel/iwlegacy/4965-mac.c:2153: warning: Function parameter or member 'tx_fifo' not described in 'il4965_txq_agg_enable' drivers/net/wireless/intel/iwlegacy/4965-mac.c:2153: warning: Function parameter or member 'sta_id' not described in 'il4965_txq_agg_enable' drivers/net/wireless/intel/iwlegacy/4965-mac.c:2153: warning: Function parameter or member 'tid' not described in 'il4965_txq_agg_enable' drivers/net/wireless/intel/iwlegacy/4965-mac.c:2153: warning: Function parameter or member 'ssn_idx' not described in 'il4965_txq_agg_enable' drivers/net/wireless/intel/iwlegacy/4965-mac.c:2285: warning: Function parameter or member 'il' not described in 'il4965_txq_agg_disable' drivers/net/wireless/intel/iwlegacy/4965-mac.c:2285: warning: Function parameter or member 'txq_id' not described in 'il4965_txq_agg_disable' drivers/net/wireless/intel/iwlegacy/4965-mac.c:2285: warning: Function parameter or member 'ssn_idx' not described in 'il4965_txq_agg_disable' drivers/net/wireless/intel/iwlegacy/4965-mac.c:2285: warning: Function parameter or member 'tx_fifo' not described in 'il4965_txq_agg_disable' drivers/net/wireless/intel/iwlegacy/4965-mac.c:2500: warning: Function parameter or member 'il' not described in 'il4965_tx_status_reply_compressed_ba' drivers/net/wireless/intel/iwlegacy/4965-mac.c:2500: warning: Function parameter or member 'agg' not described in 'il4965_tx_status_reply_compressed_ba' drivers/net/wireless/intel/iwlegacy/4965-mac.c:2500: warning: Function parameter or member 'ba_resp' not described in 'il4965_tx_status_reply_compressed_ba' drivers/net/wireless/intel/iwlegacy/4965-mac.c:2651: warning: Function parameter or member 'il' not described in 'il4965_tx_status_reply_tx' drivers/net/wireless/intel/iwlegacy/4965-mac.c:2651: warning: Function parameter or member 'agg' not described in 'il4965_tx_status_reply_tx' drivers/net/wireless/intel/iwlegacy/4965-mac.c:2651: warning: Function parameter or member 'tx_resp' not described in 'il4965_tx_status_reply_tx' drivers/net/wireless/intel/iwlegacy/4965-mac.c:2651: warning: Function parameter or member 'txq_id' not described in 'il4965_tx_status_reply_tx' drivers/net/wireless/intel/iwlegacy/4965-mac.c:2651: warning: Function parameter or member 'start_idx' not described in 'il4965_tx_status_reply_tx' drivers/net/wireless/intel/iwlegacy/4965-mac.c:2761: warning: Function parameter or member 'il' not described in 'il4965_hdl_tx' drivers/net/wireless/intel/iwlegacy/4965-mac.c:2761: warning: Function parameter or member 'rxb' not described in 'il4965_hdl_tx' drivers/net/wireless/intel/iwlegacy/4965-mac.c:2882: warning: Function parameter or member 'il' not described in 'il4965_hwrate_to_tx_control' drivers/net/wireless/intel/iwlegacy/4965-mac.c:2882: warning: Function parameter or member 'rate_n_flags' not described in 'il4965_hwrate_to_tx_control' drivers/net/wireless/intel/iwlegacy/4965-mac.c:2882: warning: Function parameter or member 'info' not described in 'il4965_hwrate_to_tx_control' drivers/net/wireless/intel/iwlegacy/4965-mac.c:2908: warning: Function parameter or member 'il' not described in 'il4965_hdl_compressed_ba' drivers/net/wireless/intel/iwlegacy/4965-mac.c:2908: warning: Function parameter or member 'rxb' not described in 'il4965_hdl_compressed_ba' drivers/net/wireless/intel/iwlegacy/4965-mac.c:3514: warning: Function parameter or member 'il' not described in 'il4965_alloc_bcast_station' drivers/net/wireless/intel/iwlegacy/4965-mac.c:3554: warning: Function parameter or member 'il' not described in 'il4965_update_bcast_station' drivers/net/wireless/intel/iwlegacy/4965-mac.c:3587: warning: Function parameter or member 'il' not described in 'il4965_sta_tx_modify_enable_tid' drivers/net/wireless/intel/iwlegacy/4965-mac.c:3587: warning: Function parameter or member 'sta_id' not described in 'il4965_sta_tx_modify_enable_tid' drivers/net/wireless/intel/iwlegacy/4965-mac.c:3587: warning: Function parameter or member 'tid' not described in 'il4965_sta_tx_modify_enable_tid' drivers/net/wireless/intel/iwlegacy/4965-mac.c:3916: warning: Function parameter or member 'il' not described in 'il4965_hw_txq_free_tfd' drivers/net/wireless/intel/iwlegacy/4965-mac.c:3916: warning: Function parameter or member 'txq' not described in 'il4965_hw_txq_free_tfd' drivers/net/wireless/intel/iwlegacy/4965-mac.c:4059: warning: Function parameter or member 't' not described in 'il4965_bg_stats_periodic' drivers/net/wireless/intel/iwlegacy/4965-mac.c:4169: warning: Function parameter or member 'il' not described in 'il4965_setup_handlers' drivers/net/wireless/intel/iwlegacy/4965-mac.c:4211: warning: Function parameter or member 'il' not described in 'il4965_rx_handle' drivers/net/wireless/intel/iwlegacy/4965-mac.c:4767: warning: Function parameter or member 'ucode_raw' not described in 'il4965_ucode_callback' drivers/net/wireless/intel/iwlegacy/4965-mac.c:4767: warning: Function parameter or member 'context' not described in 'il4965_ucode_callback' drivers/net/wireless/intel/iwlegacy/4965-mac.c:5269: warning: Function parameter or member 'il' not described in 'il4965_alive_start'
--- .../net/wireless/intel/iwlegacy/4965-mac.c | 55 +++++++++---------- 1 file changed, 25 insertions(+), 30 deletions(-)
drivers/net/wireless/intel/iwlegacy/4965-mac.c +25 -30
@@ -226,7 +226,7 @@ il4965_hw_nic_init(struct il_priv *il)return 0 ; } -/** +/* * il4965_dma_addr2rbd_ptr - convert a DMA address to a uCode read buffer ptr */ static inline __le32
@@ -235,7 +235,7 @@ il4965_dma_addr2rbd_ptr(struct il_priv *il, dma_addr_t dma_addr)return cpu_to_le32 ((u32) (dma_addr >>8 )); } -/** +/* * il4965_rx_queue_restock - refill RX queue from pre-allocated pool * * If there are slots in the RX queue that need to be restocked,
@@ -288,7 +288,7 @@ il4965_rx_queue_restock(struct il_priv *il) } } -/** +/* * il4965_rx_replenish - Move all used packet from rx_used to rx_free * * When moving to rx_free an SKB is allocated for the slot.
@@ -1127,7 +1127,7 @@ il4965_count_chain_bitmap(u32 chain_bitmap)return res; } -/** +/* * il4965_set_rxon_chain - Set up Rx chain usage in "staging" RXON image * * Selects how many and which Rx receivers/antennas/chains to use.
@@ -1933,7 +1933,7 @@ il4965_free_dma_ptr(struct il_priv *il, struct il_dma_ptr *ptr)memset (ptr,0 ,sizeof (*ptr)); } -/** +/* * il4965_hw_txq_ctx_free - Free TXQ Context * * Destroy all TX DMA queues and structures
@@ -1959,12 +1959,9 @@ il4965_hw_txq_ctx_free(struct il_priv *il)il_free_txq_mem (il); } -/** +/* * il4965_txq_ctx_alloc - allocate TX queue context * Allocate all Tx DMA structures and initialize them -* -* @param il -* @return error code */ int il4965_txq_ctx_alloc (struct il_priv *il)
@@ -2060,7 +2057,7 @@ il4965_txq_ctx_unmap(struct il_priv *il)il_tx_queue_unmap (il, txq_id); } -/** +/* * il4965_txq_ctx_stop - Stop all Tx DMA channels */ void
@@ -2101,7 +2098,7 @@ il4965_txq_ctx_activate_free(struct il_priv *il)return -1 ; } -/** +/* * il4965_tx_queue_stop_scheduler - Stop queue, but keep configuration */ static void
@@ -2114,7 +2111,7 @@ il4965_tx_queue_stop_scheduler(struct il_priv *il, u16 txq_id) (1 << IL49_SCD_QUEUE_STTS_REG_POS_SCD_ACT_EN)); } -/** +/* * il4965_tx_queue_set_q2ratid - Map unique receiver/tid combination to a queue */ static int
@@ -2141,7 +2138,7 @@ il4965_tx_queue_set_q2ratid(struct il_priv *il, u16 ra_tid, u16 txq_id)return 0 ; } -/** +/* * il4965_tx_queue_agg_enable - Set up & enable aggregation for selected queue * * NOTE: txq_id must be greater than IL49_FIRST_AMPDU_QUEUE,
@@ -2276,7 +2273,7 @@ il4965_tx_agg_start(struct il_priv *il, struct ieee80211_vif *vif,return ret; } -/** +/* * txq_id must be greater than IL49_FIRST_AMPDU_QUEUE * il->lock must be held by the caller */
@@ -2488,7 +2485,7 @@ il4965_tx_queue_reclaim(struct il_priv *il, int txq_id, int idx)return nfreed; } -/** +/* * il4965_tx_status_reply_compressed_ba - Update tx status from block-ack * * Go through block-ack's bitmap of ACK'd frames, update driver's record of
@@ -2641,7 +2638,7 @@ il4965_tx_status_to_mac80211(u32 status) } } -/** +/* * il4965_tx_status_reply_tx - Handle Tx response for frames in aggregation queue */ static int
@@ -2753,7 +2750,7 @@ il4965_tx_status_reply_tx(struct il_priv *il, struct il_ht_agg *agg,return 0 ; } -/** +/* * il4965_hdl_tx - Handle standard (non-aggregation) Tx response */ static void
@@ -2873,7 +2870,7 @@ il4965_hdl_tx(struct il_priv *il, struct il_rx_buf *rxb)spin_unlock_irqrestore (&il->sta_lock, flags); } -/** +/* * translate ucode response to mac80211 tx status control values */ void
@@ -2897,7 +2894,7 @@ il4965_hwrate_to_tx_control(struct il_priv *il, u32 rate_n_flags, r->idx =il4965_hwrate_to_mac80211_idx (rate_n_flags, info->band); } -/** +/* * il4965_hdl_compressed_ba - Handler for N_COMPRESSED_BA * * Handles block-acknowledge notification from device, which reports success
@@ -3502,7 +3499,7 @@ il4965_set_dynamic_key(struct il_priv *il, struct ieee80211_key_conf *keyconf,return ret; } -/** +/* * il4965_alloc_bcast_station - add broadcast station into driver's station table. * * This adds the broadcast station into the driver's station table
@@ -3543,7 +3540,7 @@ il4965_alloc_bcast_station(struct il_priv *il)return 0 ; } -/** +/* * il4965_update_bcast_station - update broadcast station's LQ command * * Only used by iwl4965. Placed here to have all bcast station management
@@ -3579,7 +3576,7 @@ il4965_update_bcast_stations(struct il_priv *il)return il4965_update_bcast_station (il); } -/** +/* * il4965_sta_tx_modify_enable_tid - Enable Tx for this TID in station table */ int
@@ -3903,10 +3900,8 @@ il4965_tfd_get_num_tbs(struct il_tfd *tfd)return tfd->num_tbs &0x1f ; } -/** +/* * il4965_hw_txq_free_tfd - Free all chunks referenced by TFD [txq->q.read_ptr] -* @il - driver ilate data -* @txq - tx queue * * Does NOT advance any TFD circular buffer read/write idxes * Does NOT free the TFD itself (which is within circular buffer)
@@ -4044,7 +4039,7 @@ il4965_hdl_alive(struct il_priv *il, struct il_rx_buf *rxb)IL_WARN ("uCode did not respond OK.\n" ); } -/** +/* * il4965_bg_stats_periodic - Timer callback to queue stats * * This callback is provided in order to send a stats request.
@@ -4155,7 +4150,7 @@ il4965_hdl_card_state(struct il_priv *il, struct il_rx_buf *rxb)wake_up (&il->wait_command_queue); } -/** +/* * il4965_setup_handlers - Initialize Rx handler callbacks * * Setup the RX handlers for each of the reply types sent from the uCode
@@ -4199,7 +4194,7 @@ il4965_setup_handlers(struct il_priv *il) il->handlers[C_TX ] = il4965_hdl_tx; } -/** +/* * il4965_rx_handle - Main entry function for receiving responses from uCode * * Uses the il->handlers callback function array to invoke
@@ -4756,7 +4751,7 @@ il4965_load_firmware(struct il_priv *il, const struct firmware *ucode_raw,return 0 ; } -/** +/* * il4965_ucode_callback - callback when firmware was loaded * * If loaded successfully, copies the firmware into buffers
@@ -5259,7 +5254,7 @@ il4965_alive_notify(struct il_priv *il)return 0 ; } -/** +/* * il4965_alive_start - called after N_ALIVE notification received * from protocol/runtime uCode (initialization uCode's * Alive gets handled by il_init_alive_start()).
Signature · 1 line
2.25.1
PATCH 16/32 wireless: brcm80211: btcoex: Update 'brcmf_btcoex_state' and demote others
In reply to Lee JonesThe function headers are either very weakly documented or not at all.
Fixes the following W=1 kernel build warning(s):
drivers/net/wireless/broadcom/brcm80211/brcmfmac/btcoex.c:94: warning: Function parameter or member 'reg50' not described in 'brcmf_btcoex_info' drivers/net/wireless/broadcom/brcm80211/brcmfmac/btcoex.c:94: warning: Function parameter or member 'saved_regs_part2' not described in 'brcmf_btcoex_info' drivers/net/wireless/broadcom/brcm80211/brcmfmac/btcoex.c:233: warning: Function parameter or member 'btci' not described in 'btcmf_btcoex_save_part1' drivers/net/wireless/broadcom/brcm80211/brcmfmac/btcoex.c:253: warning: Function parameter or member 'btci' not described in 'brcmf_btcoex_restore_part1' drivers/net/wireless/broadcom/brcm80211/brcmfmac/btcoex.c:273: warning: Function parameter or member 't' not described in 'brcmf_btcoex_timerfunc' drivers/net/wireless/broadcom/brcm80211/brcmfmac/btcoex.c:453: warning: Function parameter or member 'vif' not described in 'brcmf_btcoex_set_mode' drivers/net/wireless/broadcom/brcm80211/brcmfmac/btcoex.c:453: warning: Function parameter or member 'duration' not described in 'brcmf_btcoex_set_mode' drivers/net/wireless/broadcom/brcm80211/brcmfmac/btcoex.c:453: warning: Excess function parameter 'cfg' description in 'brcmf_btcoex_set_mode'
--- .../wireless/broadcom/brcm80211/brcmfmac/btcoex.c | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-)
drivers/net/wireless/broadcom/brcm80211/brcmfmac/btcoex.c +6 -6
@@ -65,11 +65,12 @@ enum brcmf_btcoex_state {* @reg68: saved value of btc_params 68 * @saved_regs_part1: flag indicating regs 66,41,68 * have been saved +* @reg50: saved value of btc_params 50 * @reg51: saved value of btc_params 51 * @reg64: saved value of btc_params 64 * @reg65: saved value of btc_params 65 * @reg71: saved value of btc_params 71 -* @saved_regs_part1: flag indicating regs 50,51,64,65,71 +* @saved_regs_part2: flag indicating regs 50,51,64,65,71 * have been saved */ struct brcmf_btcoex_info {
@@ -226,7 +227,7 @@ static bool brcmf_btcoex_is_sco_active(struct brcmf_if *ifp)return res; } -/** +/* * btcmf_btcoex_save_part1() - save first step parameters. */ static void btcmf_btcoex_save_part1 (struct brcmf_btcoex_info *btci)
@@ -246,7 +247,7 @@ static void btcmf_btcoex_save_part1(struct brcmf_btcoex_info *btci) } } -/** +/* * brcmf_btcoex_restore_part1() - restore first step parameters. */ static void brcmf_btcoex_restore_part1 (struct brcmf_btcoex_info *btci)
@@ -266,7 +267,7 @@ static void brcmf_btcoex_restore_part1(struct brcmf_btcoex_info *btci) } } -/** +/* * brcmf_btcoex_timerfunc() - BT coex timer callback */ static void brcmf_btcoex_timerfunc (struct timer_list *t)
@@ -441,9 +442,8 @@ static void brcmf_btcoex_dhcp_end(struct brcmf_btcoex_info *btci) } } -/** +/* * brcmf_btcoex_set_mode - set BT coex mode -* @cfg: driver private cfg80211 data * @mode: Wifi-Bluetooth coexistence mode * * return: 0 on success
Signature · 1 line
2.25.1
Re: [16/32] brcmfmac: btcoex: Update 'brcmf_btcoex_state' and demote others
Quoted 13 lines · Lee Jones
The function headers are either very weakly documented or not at all.
Fixes the following W=1 kernel build warning(s):
drivers/net/wireless/broadcom/brcm80211/brcmfmac/btcoex.c:94: warning: Function parameter or member 'reg50' not described in 'brcmf_btcoex_info'drivers/net/wireless/broadcom/brcm80211/brcmfmac/btcoex.c:94: warning: Function parameter or member 'saved_regs_part2' not described in 'brcmf_btcoex_info'drivers/net/wireless/broadcom/brcm80211/brcmfmac/btcoex.c:233: warning: Function parameter or member 'btci' not described in 'btcmf_btcoex_save_part1'drivers/net/wireless/broadcom/brcm80211/brcmfmac/btcoex.c:253: warning: Function parameter or member 'btci' not described in 'brcmf_btcoex_restore_part1'drivers/net/wireless/broadcom/brcm80211/brcmfmac/btcoex.c:273: warning: Function parameter or member 't' not described in 'brcmf_btcoex_timerfunc'drivers/net/wireless/broadcom/brcm80211/brcmfmac/btcoex.c:453: warning: Function parameter or member 'vif' not described in 'brcmf_btcoex_set_mode'drivers/net/wireless/broadcom/brcm80211/brcmfmac/btcoex.c:453: warning: Function parameter or member 'duration' not described in 'brcmf_btcoex_set_mode'drivers/net/wireless/broadcom/brcm80211/brcmfmac/btcoex.c:453: warning: Excess function parameter 'cfg' description in 'brcmf_btcoex_set_mode'
Quoted 13 lines
Cc Arend van Spriel <[email protected]>Cc Franky Lin <[email protected]>Cc Hante Meuleman <[email protected]>Cc Chi-Hsien Lin <[email protected]>Cc Wright Feng <[email protected]>Cc Kalle Valo <[email protected]>Cc "David S. Miller" <[email protected]>Cc Jakub Kicinski <[email protected]>Signed-off-by Lee Jones <[email protected]>
7 patches applied to wireless-drivers-next.git, thanks.
9d16c3859012 brcmfmac: btcoex: Update 'brcmf_btcoex_state' and demote others 03a7c2ea609b b43: phy_ht: Remove 9 year old TODO5316050efdde rsi: Source file headers are not suitable for kernel-doc 3ecf6a3d6f62 iwlegacy: 4965-rs: Demote non kernel-doc headers to standard comment blocks fa5768d59c53 iwlegacy: 4965-calib: Demote seemingly accidental kernel-doc header a940977aaf2a brcmfmac: fwsignal: Remove unused variable 'brcmf_fws_prio2fifo' e9cf68ff4eff rtlwifi: rtl8192c: phy_common: Remove unused variable 'bbvalue'
Signature · 3 lines
https://patchwork.kernel.org/patch/11728347/ https://wireless.wiki.kernel.org/en/developers/documentation/submittingpatches
PATCH 17/32 wireless: broadcom: b43: phy_ht: Remove 9 year old TODO
In reply to Lee JonesFixes the following W=1 kernel build warning(s):
drivers/net/wireless/broadcom/b43/phy_ht.c: In function ?b43_phy_ht_op_init?:
drivers/net/wireless/broadcom/b43/phy_ht.c:904:3: warning: suggest braces around empty body in an ?if? statement [-Wempty-body]
--- drivers/net/wireless/broadcom/b43/phy_ht.c | 3 --- 1 file changed, 3 deletions(-)
drivers/net/wireless/broadcom/b43/phy_ht.c +0 -3
@@ -900,9 +900,6 @@ static int b43_phy_ht_op_init(struct b43_wldev *dev)b43_phy_write (dev,0x70 ,0x50 );b43_phy_write (dev,0x1ff ,0x30 ); -if (0 )/* TODO: condition */ - ;/* TODO: PHY op on reg 0x217 */ -if (b43_current_band (dev->wl) ==NL80211_BAND_5GHZ )b43_phy_ht_classifier (dev,B43_PHY_HT_CLASS_CTL_CCK_EN ,0 );else
Signature · 1 line
2.25.1
PATCH 18/32 wireless: intel: iwlwifi: mvm: tx: Demote misuse of kernel-doc headers
In reply to Lee JonesFixes the following W=1 kernel build warning(s):
drivers/net/wireless/intel/iwlwifi/mvm/tx.c:1379: warning: Function parameter or member 'rate_n_flags' not described in 'iwl_mvm_hwrate_to_tx_status' drivers/net/wireless/intel/iwlwifi/mvm/tx.c:1379: warning: Function parameter or member 'info' not described in 'iwl_mvm_hwrate_to_tx_status' drivers/net/wireless/intel/iwlwifi/mvm/tx.c:1431: warning: Function parameter or member 'mvm' not described in 'iwl_mvm_get_scd_ssn'
--- drivers/net/wireless/intel/iwlwifi/mvm/tx.c | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-)
drivers/net/wireless/intel/iwlwifi/mvm/tx.c +2 -2
@@ -1371,7 +1371,7 @@ void iwl_mvm_hwrate_to_tx_rate(u32 rate_n_flags, } } -/** +/* * translate ucode response to mac80211 tx status control values */ static void iwl_mvm_hwrate_to_tx_status(u32 rate_n_flags,
@@ -1413,7 +1413,7 @@ static void iwl_mvm_tx_status_check_trigger(struct iwl_mvm *mvm, } } -/** +/* * iwl_mvm_get_scd_ssn - returns the SSN of the SCD * @tx_resp: the Tx response from the fw (agg or non-agg) *
Signature · 1 line
2.25.1
PATCH 19/32 wireless: intel: iwlwifi: dvm: devices: Fix function documentation formatting issues
In reply to Lee JonesKerneldoc expects attributes/parameters to be in '@*.: ' format and gets confused if the variable does not follow the type/attribute definitions.
Fixes the following W=1 kernel build warning(s):
drivers/net/wireless/intel/iwlwifi/dvm/devices.c:66: warning: Function parameter or member 'priv' not described in 'iwl_beacon_time_mask_low' drivers/net/wireless/intel/iwlwifi/dvm/devices.c:66: warning: Function parameter or member 'tsf_bits' not described in 'iwl_beacon_time_mask_low' drivers/net/wireless/intel/iwlwifi/dvm/devices.c:77: warning: Function parameter or member 'priv' not described in 'iwl_beacon_time_mask_high' drivers/net/wireless/intel/iwlwifi/dvm/devices.c:77: warning: Function parameter or member 'tsf_bits' not described in 'iwl_beacon_time_mask_high'
--- drivers/net/wireless/intel/iwlwifi/dvm/devices.c | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-)
drivers/net/wireless/intel/iwlwifi/dvm/devices.c +4 -4
@@ -58,8 +58,8 @@ static void iwl1000_nic_config(struct iwl_priv *priv)/** * iwl_beacon_time_mask_low - mask of lower 32 bit of beacon time -* @priv -- pointer to iwl_priv data structure -* @tsf_bits -- number of bits need to shift for masking) +* @priv: pointer to iwl_priv data structure +* @tsf_bits: number of bits need to shift for masking) */ static inline u32 iwl_beacon_time_mask_low (struct iwl_priv *priv,u16 tsf_bits)
@@ -69,8 +69,8 @@ static inline u32 iwl_beacon_time_mask_low(struct iwl_priv *priv,/** * iwl_beacon_time_mask_high - mask of higher 32 bit of beacon time -* @priv -- pointer to iwl_priv data structure -* @tsf_bits -- number of bits need to shift for masking) +* @priv: pointer to iwl_priv data structure +* @tsf_bits: number of bits need to shift for masking) */ static inline u32 iwl_beacon_time_mask_high (struct iwl_priv *priv,u16 tsf_bits)
Signature · 1 line
2.25.1
PATCH 20/32 wireless: rsi: rsi_91x_debugfs: Source file headers are not suitable for kernel-doc
In reply to Lee JonesFixes the following W=1 kernel build warning(s):
drivers/net/wireless/rsi/rsi_91x_debugfs.c:21: warning: Incorrect use of kernel-doc format: * rsi_sdio_stats_read() - This function returns the sdio status of the driver. drivers/net/wireless/rsi/rsi_91x_debugfs.c:28: warning: Function parameter or member 'seq' not described in 'rsi_sdio_stats_read' drivers/net/wireless/rsi/rsi_91x_debugfs.c:28: warning: Function parameter or member 'data' not described in 'rsi_sdio_stats_read'
--- drivers/net/wireless/rsi/rsi_91x_debugfs.c | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-)
drivers/net/wireless/rsi/rsi_91x_debugfs.c +1 -1
@@ -1,4 +1,4 @@ -/** +/* * Copyright (c) 2014 Redpine Signals Inc. * * Permission to use, copy, modify, and/or distribute this software for any
Signature · 1 line
2.25.1
PATCH 21/32 wireless: intel: iwlwifi: iwl-drv: Provide descriptions debugfs dentries
In reply to Lee JonesAlso demote a non-conforming kernel-doc function header.
Fixes the following W=1 kernel build warning(s):
drivers/net/wireless/intel/iwlwifi/iwl-drv.c:124: warning: Function parameter or member 'dbgfs_drv' not described in 'iwl_drv' drivers/net/wireless/intel/iwlwifi/iwl-drv.c:124: warning: Function parameter or member 'dbgfs_trans' not described in 'iwl_drv' drivers/net/wireless/intel/iwlwifi/iwl-drv.c:124: warning: Function parameter or member 'dbgfs_op_mode' not described in 'iwl_drv' drivers/net/wireless/intel/iwlwifi/iwl-drv.c:1329: warning: Function parameter or member 'ucode_raw' not described in 'iwl_req_fw_callback' drivers/net/wireless/intel/iwlwifi/iwl-drv.c:1329: warning: Function parameter or member 'context' not described in 'iwl_req_fw_callback'
--- drivers/net/wireless/intel/iwlwifi/iwl-drv.c | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-)
drivers/net/wireless/intel/iwlwifi/iwl-drv.c +4 -1
@@ -102,6 +102,9 @@ static struct dentry *iwl_dbgfs_root;* @fw_index: firmware revision to try loading * @firmware_name: composite filename of ucode file to load * @request_firmware_complete: the firmware has been obtained from user space +* @dbgfs_drv: debugfs root directory entry +* @dbgfs_trans: debugfs transport directory entry +* @dbgfs_op_mode: debugfs op_mode directory entry */ struct iwl_drv {struct list_head list;
@@ -1319,7 +1322,7 @@ static void _iwl_op_mode_stop(struct iwl_drv *drv) } } -/** +/* * iwl_req_fw_callback - callback when firmware was loaded * * If loaded successfully, copies the firmware into buffers
Signature · 1 line
2.25.1
PATCH 22/32 wireless: intel: iwlegacy: 4965-rs: Demote non kernel-doc headers to standard comment blocks
In reply to Lee JonesFixes the following W=1 kernel build warning(s):
drivers/net/wireless/intel/iwlegacy/4965-rs.c:156: warning: cannot understand function prototype: 's32 expected_tpt_legacy[RATE_COUNT] = ' drivers/net/wireless/intel/iwlegacy/4965-rs.c:406: warning: Function parameter or member 'tbl' not described in 'il4965_rs_collect_tx_data' drivers/net/wireless/intel/iwlegacy/4965-rs.c:406: warning: Function parameter or member 'scale_idx' not described in 'il4965_rs_collect_tx_data' drivers/net/wireless/intel/iwlegacy/4965-rs.c:406: warning: Function parameter or member 'attempts' not described in 'il4965_rs_collect_tx_data' drivers/net/wireless/intel/iwlegacy/4965-rs.c:406: warning: Function parameter or member 'successes' not described in 'il4965_rs_collect_tx_data' drivers/net/wireless/intel/iwlegacy/4965-rs.c:629: warning: Function parameter or member 'il' not described in 'il4965_rs_use_green' drivers/net/wireless/intel/iwlegacy/4965-rs.c:629: warning: Function parameter or member 'sta' not described in 'il4965_rs_use_green' drivers/net/wireless/intel/iwlegacy/4965-rs.c:645: warning: Function parameter or member 'lq_sta' not described in 'il4965_rs_get_supported_rates' drivers/net/wireless/intel/iwlegacy/4965-rs.c:645: warning: Function parameter or member 'hdr' not described in 'il4965_rs_get_supported_rates' drivers/net/wireless/intel/iwlegacy/4965-rs.c:645: warning: Function parameter or member 'rate_type' not described in 'il4965_rs_get_supported_rates' drivers/net/wireless/intel/iwlegacy/4965-rs.c:2130: warning: duplicate section name 'NOTE' drivers/net/wireless/intel/iwlegacy/4965-rs.c:2134: warning: Function parameter or member 'il' not described in 'il4965_rs_initialize_lq' drivers/net/wireless/intel/iwlegacy/4965-rs.c:2134: warning: Function parameter or member 'conf' not described in 'il4965_rs_initialize_lq' drivers/net/wireless/intel/iwlegacy/4965-rs.c:2134: warning: Function parameter or member 'sta' not described in 'il4965_rs_initialize_lq' drivers/net/wireless/intel/iwlegacy/4965-rs.c:2134: warning: Function parameter or member 'lq_sta' not described in 'il4965_rs_initialize_lq'
--- drivers/net/wireless/intel/iwlegacy/4965-rs.c | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-)
drivers/net/wireless/intel/iwlegacy/4965-rs.c +5 -5
@@ -142,7 +142,7 @@ il4965_rs_dbgfs_set_mcs(struct il_lq_sta *lq_sta, u32 * rate_n_flags, int idx) }#endif -/** +/* * The following tables contain the expected throughput metrics for all rates * * 1, 2, 5.5, 11, 6, 9, 12, 18, 24, 36, 48, 54, 60 MBits
@@ -393,7 +393,7 @@ il4965_get_expected_tpt(struct il_scale_tbl_info *tbl, int rs_idx)return 0 ; } -/** +/* * il4965_rs_collect_tx_data - Update the success/failure sliding win * * We keep a sliding win of the last 62 packets transmitted
@@ -620,7 +620,7 @@ il4965_rs_toggle_antenna(u32 valid_ant, u32 *rate_n_flags,return 1 ; } -/** +/* * Green-field mode is valid if the station supports it and * there are no non-GF stations present in the BSS. */
@@ -631,7 +631,7 @@ il4965_rs_use_green(struct il_priv *il, struct ieee80211_sta *sta) !il->ht.non_gf_sta_present; } -/** +/* * il4965_rs_get_supported_rates - get the available rates * * if management frame or broadcast frame only return
@@ -2114,7 +2114,7 @@ il4965_rs_rate_scale_perform(struct il_priv *il, struct sk_buff *skb, lq_sta->last_txrate_idx = i; } -/** +/* * il4965_rs_initialize_lq - Initialize a station's hardware rate table * * The uCode's station table contains a table of fallback rates
Signature · 1 line
2.25.1
PATCH 23/32 wireless: intel: iwlegacy: 4965-calib: Demote seemingly accidental kernel-doc header
In reply to Lee JonesNo parameters were documented and it's the only one in the file.
Fixes the following W=1 kernel build warning(s):
drivers/net/wireless/intel/iwlegacy/4965-calib.c:608: warning: Function parameter or member 'il' not described in 'il4965_find_disconn_antenna' drivers/net/wireless/intel/iwlegacy/4965-calib.c:608: warning: Function parameter or member 'average_sig' not described in 'il4965_find_disconn_antenna' drivers/net/wireless/intel/iwlegacy/4965-calib.c:608: warning: Function parameter or member 'data' not described in 'il4965_find_disconn_antenna'
--- drivers/net/wireless/intel/iwlegacy/4965-calib.c | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-)
drivers/net/wireless/intel/iwlegacy/4965-calib.c +1 -1
@@ -598,7 +598,7 @@ il4965_find_first_chain(u8 mask)return CHAIN_C ; } -/** +/* * Run disconnected antenna algorithm to find out which antennas are * disconnected. */
Signature · 1 line
2.25.1
PATCH 24/32 wireless: brcmfmac: fwsignal: Remove unused variable 'brcmf_fws_prio2fifo'
In reply to Lee JonesFixes the following W=1 kernel build warning(s):
drivers/net/wireless/broadcom/brcm80211/brcmfmac/fwsignal.c:504:18: warning: ‘brcmf_fws_prio2fifo’ defined but not used [-Wunused-const-variable=]
--- .../broadcom/brcm80211/brcmfmac/fwsignal.c | 14 -------------- 1 file changed, 14 deletions(-)
drivers/net/wireless/broadcom/brcm80211/brcmfmac/fwsignal.c +0 -14
@@ -498,20 +498,6 @@ struct brcmf_fws_info {bool avoid_queueing; }; -/* -* brcmf_fws_prio2fifo - mapping from 802.1d priority to firmware fifo index. -*/ -static const int brcmf_fws_prio2fifo[] = { -BRCMF_FWS_FIFO_AC_BE , -BRCMF_FWS_FIFO_AC_BK , -BRCMF_FWS_FIFO_AC_BK , -BRCMF_FWS_FIFO_AC_BE , -BRCMF_FWS_FIFO_AC_VI , -BRCMF_FWS_FIFO_AC_VI , -BRCMF_FWS_FIFO_AC_VO , -BRCMF_FWS_FIFO_AC_VO -}; -#define BRCMF_FWS_TLV_DEF (name, id, len) \ case BRCMF_FWS_TYPE_ ## name: \ return len;
Signature · 1 line
2.25.1
PATCH 25/32 wireless: ath: wil6210: wmi: Fix formatting and demote non-conforming function headers
In reply to Lee JonesFixes the following W=1 kernel build warning(s):
drivers/net/wireless/ath/wil6210/wmi.c:52: warning: Incorrect use of kernel-doc format: * Addressing - theory of operations drivers/net/wireless/ath/wil6210/wmi.c:70: warning: Incorrect use of kernel-doc format: * @sparrow_fw_mapping provides memory remapping table for sparrow drivers/net/wireless/ath/wil6210/wmi.c:80: warning: cannot understand function prototype: 'const struct fw_map sparrow_fw_mapping[] = '
drivers/net/wireless/ath/wil6210/wmi.c:107: warning: Cannot understand * @sparrow_d0_mac_rgf_ext - mac_rgf_ext section for Sparrow D0 drivers/net/wireless/ath/wil6210/wmi.c:115: warning: Cannot understand * @talyn_fw_mapping provides memory remapping table for Talyn drivers/net/wireless/ath/wil6210/wmi.c:158: warning: Cannot understand * @talyn_mb_fw_mapping provides memory remapping table for Talyn-MB
drivers/net/wireless/ath/wil6210/wmi.c:236: warning: Function parameter or member 'x' not described in 'wmi_addr_remap' drivers/net/wireless/ath/wil6210/wmi.c:255: warning: Function parameter or member 'section' not described in 'wil_find_fw_mapping' drivers/net/wireless/ath/wil6210/wmi.c:278: warning: Function parameter or member 'wil' not described in 'wmi_buffer_block' drivers/net/wireless/ath/wil6210/wmi.c:278: warning: Function parameter or member 'ptr_' not described in 'wmi_buffer_block' drivers/net/wireless/ath/wil6210/wmi.c:278: warning: Function parameter or member 'size' not described in 'wmi_buffer_block' drivers/net/wireless/ath/wil6210/wmi.c:307: warning: Function parameter or member 'wil' not described in 'wmi_addr' drivers/net/wireless/ath/wil6210/wmi.c:307: warning: Function parameter or member 'ptr' not described in 'wmi_addr' drivers/net/wireless/ath/wil6210/wmi.c:1589: warning: Function parameter or member 'wil' not described in 'wil_find_cid_ringid_sta' drivers/net/wireless/ath/wil6210/wmi.c:1589: warning: Function parameter or member 'vif' not described in 'wil_find_cid_ringid_sta' drivers/net/wireless/ath/wil6210/wmi.c:1589: warning: Function parameter or member 'cid' not described in 'wil_find_cid_ringid_sta' drivers/net/wireless/ath/wil6210/wmi.c:1589: warning: Function parameter or member 'ringid' not described in 'wil_find_cid_ringid_sta' drivers/net/wireless/ath/wil6210/wmi.c:1876: warning: Function parameter or member 'vif' not described in 'wmi_evt_ignore' drivers/net/wireless/ath/wil6210/wmi.c:1876: warning: Function parameter or member 'id' not described in 'wmi_evt_ignore' drivers/net/wireless/ath/wil6210/wmi.c:1876: warning: Function parameter or member 'd' not described in 'wmi_evt_ignore' drivers/net/wireless/ath/wil6210/wmi.c:1876: warning: Function parameter or member 'len' not described in 'wmi_evt_ignore' drivers/net/wireless/ath/wil6210/wmi.c:2588: warning: Function parameter or member 'wil' not described in 'wmi_rxon'
--- drivers/net/wireless/ath/wil6210/wmi.c | 28 ++++++++++++++------------ 1 file changed, 15 insertions(+), 13 deletions(-)
drivers/net/wireless/ath/wil6210/wmi.c +15 -13
@@ -31,7 +31,7 @@ MODULE_PARM_DESC(led_id,#define WIL_WAIT_FOR_SUSPEND_RESUME_COMP 200#define WIL_WMI_PCP_STOP_TO_MS 5000 -/** +/* * WMI event receiving - theory of operations * * When firmware about to report WMI event, it fills memory area
@@ -48,7 +48,7 @@ MODULE_PARM_DESC(led_id,* won't be completed because of blocked IRQ thread. */ -/** +/* * Addressing - theory of operations * * There are several buses present on the WIL6210 card.
@@ -66,7 +66,7 @@ MODULE_PARM_DESC(led_id,* AHB address must be used. */ -/** +/* * @sparrow_fw_mapping provides memory remapping table for sparrow * * array size should be in sync with the declaration in the wil6210.h
@@ -103,7 +103,7 @@ const struct fw_map sparrow_fw_mapping[] = { {0x800000, 0x804000, 0x940000, "uc_data", false, false}, }; -/** +/* * @sparrow_d0_mac_rgf_ext - mac_rgf_ext section for Sparrow D0 * it is a bit larger to support extra features */
@@ -111,7 +111,7 @@ const struct fw_map sparrow_d0_mac_rgf_ext = { 0x88c000, 0x88c500, 0x88c000, "mac_rgf_ext", true, true }; -/** +/* * @talyn_fw_mapping provides memory remapping table for Talyn * * array size should be in sync with the declaration in the wil6210.h
@@ -154,7 +154,7 @@ const struct fw_map talyn_fw_mapping[] = { {0x800000, 0x808000, 0xa78000, "uc_data", false, false}, }; -/** +/* * @talyn_mb_fw_mapping provides memory remapping table for Talyn-MB * * array size should be in sync with the declaration in the wil6210.h
@@ -229,7 +229,7 @@ u8 led_polarity = LED_POLARITY_LOW_ACTIVE;/** * return AHB address for given firmware internal (linker) address -* @x - internal address +* @x: internal address * If address have no valid AHB mapping, return 0 */ static u32 wmi_addr_remap (u32 x)
@@ -247,7 +247,7 @@ static u32 wmi_addr_remap(u32 x)/** * find fw_mapping entry by section name -* @section - section name +* @section: section name * * Return pointer to section or NULL if not found */
@@ -265,8 +265,9 @@ struct fw_map *wil_find_fw_mapping(const char *section)/** * Check address validity for WMI buffer; remap if needed -* @ptr - internal (linker) fw/ucode address -* @size - if non zero, validate the block does not +* @wil: driver data +* @ptr: internal (linker) fw/ucode address +* @size: if non zero, validate the block does not * exceed the device memory (bar) * * Valid buffer should be DWORD aligned
@@ -300,7 +301,7 @@ void __iomem *wmi_buffer(struct wil6210_priv *wil, __le32 ptr_)return wmi_buffer_block (wil, ptr_,0 ); } -/** +/* * Check address validity */ void __iomem *wmi_addr (struct wil6210_priv *wil,u32 ptr)
@@ -1577,7 +1578,7 @@ wmi_evt_link_stats(struct wil6210_vif *vif, int id, void *d, int len) evt->payload, payload_size); } -/** +/* * find cid and ringid for the station vif * * return error, if other interfaces are used or ring was not found
@@ -1868,7 +1869,7 @@ wmi_evt_link_monitor(struct wil6210_vif *vif, int id, void *d, int len)cfg80211_cqm_rssi_notify (ndev, event_type, evt->rssi_level,GFP_KERNEL ); } -/** +/* * Some events are ignored for purpose; and need not be interpreted as * "unhandled events" */
@@ -2578,6 +2579,7 @@ int wmi_update_ft_ies(struct wil6210_vif *vif, u16 ie_len, const void *ie)/** * wmi_rxon - turn radio on/off +* @wil: driver data * @on: turn on if true, off otherwise * * Only switch radio. Channel should be set separately.
Signature · 1 line
2.25.1
Re: [PATCH 25/32] wireless: ath: wil6210: wmi: Fix formatting and demote non-conforming function headers
Quoted 70 lines · Lee Jones
Fixes the following W=1 kernel build warning(s):
drivers/net/wireless/ath/wil6210/wmi.c:52: warning: Incorrect use of
kernel-doc format: * Addressing - theory of operations
drivers/net/wireless/ath/wil6210/wmi.c:70: warning: Incorrect use of
kernel-doc format: * @sparrow_fw_mapping provides memory remapping table for sparrow
drivers/net/wireless/ath/wil6210/wmi.c:80: warning: cannot understand
function prototype: 'const structfw_mapsparrow_fw_mapping[] = '
drivers/net/wireless/ath/wil6210/wmi.c:107: warning: Cannot
understand * @sparrow_d0_mac_rgf_ext -mac_rgf_extsection for Sparrow D0
drivers/net/wireless/ath/wil6210/wmi.c:115: warning: Cannot
understand * @talyn_fw_mapping provides memory remapping table for Talyn
drivers/net/wireless/ath/wil6210/wmi.c:158: warning: Cannot
understand * @talyn_mb_fw_mapping provides memory remapping table for Talyn-MB
drivers/net/wireless/ath/wil6210/wmi.c:236: warning: Function
parameter or member 'x' not described in 'wmi_addr_remap'
drivers/net/wireless/ath/wil6210/wmi.c:255: warning: Function
parameter or member 'section' not described in 'wil_find_fw_mapping'
drivers/net/wireless/ath/wil6210/wmi.c:278: warning: Function
parameter or member 'wil' not described in 'wmi_buffer_block'
drivers/net/wireless/ath/wil6210/wmi.c:278: warning: Function
parameter or member 'ptr_' not described in 'wmi_buffer_block'
drivers/net/wireless/ath/wil6210/wmi.c:278: warning: Function
parameter or member 'size' not described in 'wmi_buffer_block'
drivers/net/wireless/ath/wil6210/wmi.c:307: warning: Function
parameter or member 'wil' not described in 'wmi_addr'
drivers/net/wireless/ath/wil6210/wmi.c:307: warning: Function
parameter or member 'ptr' not described in 'wmi_addr'
drivers/net/wireless/ath/wil6210/wmi.c:1589: warning: Function
parameter or member 'wil' not described in 'wil_find_cid_ringid_sta'
drivers/net/wireless/ath/wil6210/wmi.c:1589: warning: Function
parameter or member 'vif' not described in 'wil_find_cid_ringid_sta'
drivers/net/wireless/ath/wil6210/wmi.c:1589: warning: Function
parameter or member 'cid' not described in 'wil_find_cid_ringid_sta'
drivers/net/wireless/ath/wil6210/wmi.c:1589: warning: Function
parameter or member 'ringid' not described in 'wil_find_cid_ringid_sta'
drivers/net/wireless/ath/wil6210/wmi.c:1876: warning: Function
parameter or member 'vif' not described in 'wmi_evt_ignore'
drivers/net/wireless/ath/wil6210/wmi.c:1876: warning: Function
parameter or member 'id' not described in 'wmi_evt_ignore'
drivers/net/wireless/ath/wil6210/wmi.c:1876: warning: Function
parameter or member 'd' not described in 'wmi_evt_ignore'
drivers/net/wireless/ath/wil6210/wmi.c:1876: warning: Function
parameter or member 'len' not described in 'wmi_evt_ignore'
drivers/net/wireless/ath/wil6210/wmi.c:2588: warning: Function
parameter or member 'wil' not described in 'wmi_rxon'Cc Maya Erez <[email protected]>Cc Kalle Valo <[email protected]>Cc "David S. Miller" <[email protected]>Cc Jakub Kicinski <[email protected]>Signed-off-by Lee Jones <[email protected]>--- drivers/net/wireless/ath/wil6210/wmi.c | 28 ++++++++++++++------------ 1 file changed, 15 insertions(+), 13 deletions(-)drivers/net/wireless/ath/wil6210/wmi.c +0
-0
drivers/net/wireless/ath/wil6210/wmi.c MODULE_PARM_DESC(led_id, · line 37
Quoted 8 lines
drivers/net/wireless/ath/wil6210/wmi.c +1
-1@@ -31,7 +31,7 @@ MODULE_PARM_DESC(led_id,#define WIL_WAIT_FOR_SUSPEND_RESUME_COMP 200#define WIL_WMI_PCP_STOP_TO_MS 5000 -/** +/* * WMI event receiving - theory of operations * * When firmware about to report WMI event, it fills memory area
The correct format for such documentation blocks is:
/**
* DOC: Theory of Operation
This comment is also applicable for the rest of such documentation blocks changed in this patch.
drivers/net/wireless/ath/wil6210/wmi.c MODULE_PARM_DESC(led_id, · line 72
Quoted 9 lines
drivers/net/wireless/ath/wil6210/wmi.c +1
-1@@ -66,7 +66,7 @@ MODULE_PARM_DESC(led_id,* AHB address must be used. */ -/** +/* * @sparrow_fw_mapping provides memory remapping table for sparrow * * array size should be in sync with the declaration in the wil6210.h
For files in net/ and drivers/net/ the preferred style for long (multi-line) comments is a different and the text should be in the same line as /*, as follows:
/* sparrow_fw_mapping provides memory remapping table for sparrow
I would also remove the @ from @sparrow_fw_mapping.
This comment is also applicable for the rest of such documentation blocks changed in this patch.
Re: [PATCH 25/32] wireless: ath: wil6210: wmi: Fix formatting and demote non-conforming function headers
Quoted 84 lines · On Wed, 26 Aug 2020, [email protected] wrote:
Quoted 70 lines · Lee Jones
Fixes the following W=1 kernel build warning(s):
drivers/net/wireless/ath/wil6210/wmi.c:52: warning: Incorrect use of
kernel-doc format: * Addressing - theory of operations
drivers/net/wireless/ath/wil6210/wmi.c:70: warning: Incorrect use of
kernel-doc format: * @sparrow_fw_mapping provides memory remapping table for sparrow
drivers/net/wireless/ath/wil6210/wmi.c:80: warning: cannot understand
function prototype: 'const structfw_mapsparrow_fw_mapping[] = '
drivers/net/wireless/ath/wil6210/wmi.c:107: warning: Cannot
understand * @sparrow_d0_mac_rgf_ext -mac_rgf_extsection for Sparrow D0
drivers/net/wireless/ath/wil6210/wmi.c:115: warning: Cannot
understand * @talyn_fw_mapping provides memory remapping table for Talyn
drivers/net/wireless/ath/wil6210/wmi.c:158: warning: Cannot
understand * @talyn_mb_fw_mapping provides memory remapping table for Talyn-MB
drivers/net/wireless/ath/wil6210/wmi.c:236: warning: Function
parameter or member 'x' not described in 'wmi_addr_remap'
drivers/net/wireless/ath/wil6210/wmi.c:255: warning: Function
parameter or member 'section' not described in 'wil_find_fw_mapping'
drivers/net/wireless/ath/wil6210/wmi.c:278: warning: Function
parameter or member 'wil' not described in 'wmi_buffer_block'
drivers/net/wireless/ath/wil6210/wmi.c:278: warning: Function
parameter or member 'ptr_' not described in 'wmi_buffer_block'
drivers/net/wireless/ath/wil6210/wmi.c:278: warning: Function
parameter or member 'size' not described in 'wmi_buffer_block'
drivers/net/wireless/ath/wil6210/wmi.c:307: warning: Function
parameter or member 'wil' not described in 'wmi_addr'
drivers/net/wireless/ath/wil6210/wmi.c:307: warning: Function
parameter or member 'ptr' not described in 'wmi_addr'
drivers/net/wireless/ath/wil6210/wmi.c:1589: warning: Function
parameter or member 'wil' not described in 'wil_find_cid_ringid_sta'
drivers/net/wireless/ath/wil6210/wmi.c:1589: warning: Function
parameter or member 'vif' not described in 'wil_find_cid_ringid_sta'
drivers/net/wireless/ath/wil6210/wmi.c:1589: warning: Function
parameter or member 'cid' not described in 'wil_find_cid_ringid_sta'
drivers/net/wireless/ath/wil6210/wmi.c:1589: warning: Function
parameter or member 'ringid' not described in 'wil_find_cid_ringid_sta'
drivers/net/wireless/ath/wil6210/wmi.c:1876: warning: Function
parameter or member 'vif' not described in 'wmi_evt_ignore'
drivers/net/wireless/ath/wil6210/wmi.c:1876: warning: Function
parameter or member 'id' not described in 'wmi_evt_ignore'
drivers/net/wireless/ath/wil6210/wmi.c:1876: warning: Function
parameter or member 'd' not described in 'wmi_evt_ignore'
drivers/net/wireless/ath/wil6210/wmi.c:1876: warning: Function
parameter or member 'len' not described in 'wmi_evt_ignore'
drivers/net/wireless/ath/wil6210/wmi.c:2588: warning: Function
parameter or member 'wil' not described in 'wmi_rxon'Cc Maya Erez <[email protected]>Cc Kalle Valo <[email protected]>Cc "David S. Miller" <[email protected]>Cc Jakub Kicinski <[email protected]>Signed-off-by Lee Jones <[email protected]>--- drivers/net/wireless/ath/wil6210/wmi.c | 28 ++++++++++++++------------ 1 file changed, 15 insertions(+), 13 deletions(-)drivers/net/wireless/ath/wil6210/wmi.c +0
-0drivers/net/wireless/ath/wil6210/wmi.c MODULE_PARM_DESC(led_id, · line 37
Quoted 8 lines
drivers/net/wireless/ath/wil6210/wmi.c +1
-1@@ -31,7 +31,7 @@ MODULE_PARM_DESC(led_id,#define WIL_WAIT_FOR_SUSPEND_RESUME_COMP 200#define WIL_WMI_PCP_STOP_TO_MS 5000 -/** +/* * WMI event receiving - theory of operations * * When firmware about to report WMI event, it fills memory area The correct format for such documentation blocks is:
/**
* DOC: Theory of Operation
Quoted 2 lines
This comment is also applicable for the rest of such documentation blocks changed in this patch.
Ah yes, good point. Will fix.
Quoted 4 lines
Quoted 4 lines
drivers/net/wireless/ath/wil6210/wmi.c +0
-0@@ -66,7 +66,7 @@ MODULE_PARM_DESC(led_id,* AHB address must be used. */
Quoted 12 lines
drivers/net/wireless/ath/wil6210/wmi.c MODULE_PARM_DESC(led_id, · line 72
Quoted 5 lines
drivers/net/wireless/ath/wil6210/wmi.c +1
-1-/** +/* * @sparrow_fw_mapping provides memory remapping table for sparrow * * array size should be in sync with the declaration in the wil6210.h For files in
net/anddrivers/net/the preferred style for long (multi-line) comments is a different and
the text should be in the same line as /*, as follows:
/*sparrow_fw_mappingprovides memory remapping table for sparrow I would also remove the @ from @sparrow_fw_mapping.
This comment is also applicable for the rest of such documentation blocks changed in this patch.
Sounds fair. Will also fix.
Thank you.
Signature · 4 lines
Lee Jones [李琼斯] Senior Technical Lead - Developer Services Linaro.org │ Open source software for Arm SoCs Follow Linaro: Facebook | Twitter | Blog
Re: [PATCH 25/32] wireless: ath: wil6210: wmi: Fix formatting and demote non-conforming function headers
In reply to Lee JonesQuoted 25 lines · Lee Jones
Fixes the following W=1 kernel build warning(s):
drivers/net/wireless/ath/wil6210/wmi.c:52: warning: Incorrect use of kernel-doc format: * Addressing - theory of operationsdrivers/net/wireless/ath/wil6210/wmi.c:70: warning: Incorrect use of kernel-doc format: * @sparrow_fw_mapping provides memory remapping table for sparrowdrivers/net/wireless/ath/wil6210/wmi.c:80: warning: cannot understand function prototype: 'const structfw_mapsparrow_fw_mapping[] = 'drivers/net/wireless/ath/wil6210/wmi.c:107: warning: Cannot understand * @sparrow_d0_mac_rgf_ext - mac_rgf_ext section for Sparrow D0 drivers/net/wireless/ath/wil6210/wmi.c:115: warning: Cannot understand * @talyn_fw_mapping provides memory remapping table for Talyn drivers/net/wireless/ath/wil6210/wmi.c:158: warning: Cannot understand * @talyn_mb_fw_mapping provides memory remapping table for Talyn-MB
drivers/net/wireless/ath/wil6210/wmi.c:236: warning: Function parameter or member 'x' not described in 'wmi_addr_remap'drivers/net/wireless/ath/wil6210/wmi.c:255: warning: Function parameter or member 'section' not described in 'wil_find_fw_mapping'drivers/net/wireless/ath/wil6210/wmi.c:278: warning: Function parameter or member 'wil' not described in 'wmi_buffer_block'drivers/net/wireless/ath/wil6210/wmi.c:278: warning: Function parameter or member 'ptr_' not described in 'wmi_buffer_block'drivers/net/wireless/ath/wil6210/wmi.c:278: warning: Function parameter or member 'size' not described in 'wmi_buffer_block'drivers/net/wireless/ath/wil6210/wmi.c:307: warning: Function parameter or member 'wil' not described in 'wmi_addr'drivers/net/wireless/ath/wil6210/wmi.c:307: warning: Function parameter or member 'ptr' not described in 'wmi_addr'drivers/net/wireless/ath/wil6210/wmi.c:1589: warning: Function parameter or member 'wil' not described in 'wil_find_cid_ringid_sta'drivers/net/wireless/ath/wil6210/wmi.c:1589: warning: Function parameter or member 'vif' not described in 'wil_find_cid_ringid_sta'drivers/net/wireless/ath/wil6210/wmi.c:1589: warning: Function parameter or member 'cid' not described in 'wil_find_cid_ringid_sta'drivers/net/wireless/ath/wil6210/wmi.c:1589: warning: Function parameter or member 'ringid' not described in 'wil_find_cid_ringid_sta'drivers/net/wireless/ath/wil6210/wmi.c:1876: warning: Function parameter or member 'vif' not described in 'wmi_evt_ignore'drivers/net/wireless/ath/wil6210/wmi.c:1876: warning: Function parameter or member 'id' not described in 'wmi_evt_ignore'drivers/net/wireless/ath/wil6210/wmi.c:1876: warning: Function parameter or member 'd' not described in 'wmi_evt_ignore'drivers/net/wireless/ath/wil6210/wmi.c:1876: warning: Function parameter or member 'len' not described in 'wmi_evt_ignore'drivers/net/wireless/ath/wil6210/wmi.c:2588: warning: Function parameter or member 'wil' not described in 'wmi_rxon'
Quoted 8 lines
Cc Maya Erez <[email protected]>Cc Kalle Valo <[email protected]>Cc "David S. Miller" <[email protected]>Cc Jakub Kicinski <[email protected]>Signed-off-by Lee Jones <[email protected]>
So what's the plan, should I drop the six patches for wil6210 in this patchset?
Signature · 3 lines
https://patchwork.kernel.org/patch/11728319/ https://wireless.wiki.kernel.org/en/developers/documentation/submittingpatches
A message that is not in the archive (sent off-list or not yet received): [email protected]
Re: [PATCH 25/32] wireless: ath: wil6210: wmi: Fix formatting and demote non-conforming function headers
Quoted 36 lines · Kalle Valo
Quoted 25 lines · Lee Jones
Fixes the following W=1 kernel build warning(s):
drivers/net/wireless/ath/wil6210/wmi.c:52: warning: Incorrect use of kernel-doc format: * Addressing - theory of operationsdrivers/net/wireless/ath/wil6210/wmi.c:70: warning: Incorrect use of kernel-doc format: * @sparrow_fw_mapping provides memory remapping table for sparrowdrivers/net/wireless/ath/wil6210/wmi.c:80: warning: cannot understand function prototype: 'const structfw_mapsparrow_fw_mapping[] = 'drivers/net/wireless/ath/wil6210/wmi.c:107: warning: Cannot understand * @sparrow_d0_mac_rgf_ext - mac_rgf_ext section for Sparrow D0 drivers/net/wireless/ath/wil6210/wmi.c:115: warning: Cannot understand * @talyn_fw_mapping provides memory remapping table for Talyn drivers/net/wireless/ath/wil6210/wmi.c:158: warning: Cannot understand * @talyn_mb_fw_mapping provides memory remapping table for Talyn-MB
drivers/net/wireless/ath/wil6210/wmi.c:236: warning: Function parameter or member 'x' not described in 'wmi_addr_remap'drivers/net/wireless/ath/wil6210/wmi.c:255: warning: Function parameter or member 'section' not described in 'wil_find_fw_mapping'drivers/net/wireless/ath/wil6210/wmi.c:278: warning: Function parameter or member 'wil' not described in 'wmi_buffer_block'drivers/net/wireless/ath/wil6210/wmi.c:278: warning: Function parameter or member 'ptr_' not described in 'wmi_buffer_block'drivers/net/wireless/ath/wil6210/wmi.c:278: warning: Function parameter or member 'size' not described in 'wmi_buffer_block'drivers/net/wireless/ath/wil6210/wmi.c:307: warning: Function parameter or member 'wil' not described in 'wmi_addr'drivers/net/wireless/ath/wil6210/wmi.c:307: warning: Function parameter or member 'ptr' not described in 'wmi_addr'drivers/net/wireless/ath/wil6210/wmi.c:1589: warning: Function parameter or member 'wil' not described in 'wil_find_cid_ringid_sta'drivers/net/wireless/ath/wil6210/wmi.c:1589: warning: Function parameter or member 'vif' not described in 'wil_find_cid_ringid_sta'drivers/net/wireless/ath/wil6210/wmi.c:1589: warning: Function parameter or member 'cid' not described in 'wil_find_cid_ringid_sta'drivers/net/wireless/ath/wil6210/wmi.c:1589: warning: Function parameter or member 'ringid' not described in 'wil_find_cid_ringid_sta'drivers/net/wireless/ath/wil6210/wmi.c:1876: warning: Function parameter or member 'vif' not described in 'wmi_evt_ignore'drivers/net/wireless/ath/wil6210/wmi.c:1876: warning: Function parameter or member 'id' not described in 'wmi_evt_ignore'drivers/net/wireless/ath/wil6210/wmi.c:1876: warning: Function parameter or member 'd' not described in 'wmi_evt_ignore'drivers/net/wireless/ath/wil6210/wmi.c:1876: warning: Function parameter or member 'len' not described in 'wmi_evt_ignore'drivers/net/wireless/ath/wil6210/wmi.c:2588: warning: Function parameter or member 'wil' not described in 'wmi_rxon'Quoted 8 lines
Cc Maya Erez <[email protected]>Cc Kalle Valo <[email protected]>Cc "David S. Miller" <[email protected]>Cc Jakub Kicinski <[email protected]>Signed-off-by Lee Jones <[email protected]>
Quoted 1 line
So what's the plan, should I drop the six patches for wil6210 in this patchset?
I'll fix them and submit the v2s in reply-to the v1s.
Signature · 4 lines
Lee Jones [李琼斯] Senior Technical Lead - Developer Services Linaro.org │ Open source software for Arm SoCs Follow Linaro: Facebook | Twitter | Blog
PATCH v2 25/32 wireless: ath: wil6210: wmi: Fix formatting and demote non-conforming function headers
In reply to Lee JonesFixes the following W=1 kernel build warning(s):
drivers/net/wireless/ath/wil6210/wmi.c:52: warning: Incorrect use of kernel-doc format: * Addressing - theory of operations drivers/net/wireless/ath/wil6210/wmi.c:70: warning: Incorrect use of kernel-doc format: * @sparrow_fw_mapping provides memory remapping table for sparrow drivers/net/wireless/ath/wil6210/wmi.c:80: warning: cannot understand function prototype: 'const struct fw_map sparrow_fw_mapping[] = '
drivers/net/wireless/ath/wil6210/wmi.c:107: warning: Cannot understand * @sparrow_d0_mac_rgf_ext - mac_rgf_ext section for Sparrow D0 drivers/net/wireless/ath/wil6210/wmi.c:115: warning: Cannot understand * @talyn_fw_mapping provides memory remapping table for Talyn drivers/net/wireless/ath/wil6210/wmi.c:158: warning: Cannot understand * @talyn_mb_fw_mapping provides memory remapping table for Talyn-MB
drivers/net/wireless/ath/wil6210/wmi.c:236: warning: Function parameter or member 'x' not described in 'wmi_addr_remap' drivers/net/wireless/ath/wil6210/wmi.c:255: warning: Function parameter or member 'section' not described in 'wil_find_fw_mapping' drivers/net/wireless/ath/wil6210/wmi.c:278: warning: Function parameter or member 'wil' not described in 'wmi_buffer_block' drivers/net/wireless/ath/wil6210/wmi.c:278: warning: Function parameter or member 'ptr_' not described in 'wmi_buffer_block' drivers/net/wireless/ath/wil6210/wmi.c:278: warning: Function parameter or member 'size' not described in 'wmi_buffer_block' drivers/net/wireless/ath/wil6210/wmi.c:307: warning: Function parameter or member 'wil' not described in 'wmi_addr' drivers/net/wireless/ath/wil6210/wmi.c:307: warning: Function parameter or member 'ptr' not described in 'wmi_addr' drivers/net/wireless/ath/wil6210/wmi.c:1589: warning: Function parameter or member 'wil' not described in 'wil_find_cid_ringid_sta' drivers/net/wireless/ath/wil6210/wmi.c:1589: warning: Function parameter or member 'vif' not described in 'wil_find_cid_ringid_sta' drivers/net/wireless/ath/wil6210/wmi.c:1589: warning: Function parameter or member 'cid' not described in 'wil_find_cid_ringid_sta' drivers/net/wireless/ath/wil6210/wmi.c:1589: warning: Function parameter or member 'ringid' not described in 'wil_find_cid_ringid_sta' drivers/net/wireless/ath/wil6210/wmi.c:1876: warning: Function parameter or member 'vif' not described in 'wmi_evt_ignore' drivers/net/wireless/ath/wil6210/wmi.c:1876: warning: Function parameter or member 'id' not described in 'wmi_evt_ignore' drivers/net/wireless/ath/wil6210/wmi.c:1876: warning: Function parameter or member 'd' not described in 'wmi_evt_ignore' drivers/net/wireless/ath/wil6210/wmi.c:1876: warning: Function parameter or member 'len' not described in 'wmi_evt_ignore' drivers/net/wireless/ath/wil6210/wmi.c:2588: warning: Function parameter or member 'wil' not described in 'wmi_rxon'
--- drivers/net/wireless/ath/wil6210/wmi.c | 36 +++++++++++--------------- 1 file changed, 15 insertions(+), 21 deletions(-)
drivers/net/wireless/ath/wil6210/wmi.c +15 -21
@@ -32,7 +32,7 @@ MODULE_PARM_DESC(led_id,#define WIL_WMI_PCP_STOP_TO_MS 5000/** -* WMI event receiving - theory of operations +* DOC: WMI event receiving - theory of operations * * When firmware about to report WMI event, it fills memory area * in the mailbox and raises misc. IRQ. Thread interrupt handler invoked for
@@ -49,7 +49,7 @@ MODULE_PARM_DESC(led_id,*/ /** -* Addressing - theory of operations +* DOC: Addressing - theory of operations * * There are several buses present on the WIL6210 card. * Same memory areas are visible at different address on
@@ -66,8 +66,7 @@ MODULE_PARM_DESC(led_id,* AHB address must be used. */ -/** -* @sparrow_fw_mapping provides memory remapping table for sparrow +/* sparrow_fw_mapping provides memory remapping table for sparrow * * array size should be in sync with the declaration in the wil6210.h *
@@ -103,16 +102,14 @@ const struct fw_map sparrow_fw_mapping[] = { {0x800000, 0x804000, 0x940000, "uc_data", false, false}, }; -/** -* @sparrow_d0_mac_rgf_ext - mac_rgf_ext section for Sparrow D0 +/* sparrow_d0_mac_rgf_ext - mac_rgf_ext section for Sparrow D0 * it is a bit larger to support extra features */ const struct fw_map sparrow_d0_mac_rgf_ext = {0x88c000 ,0x88c500 ,0x88c000 ,"mac_rgf_ext" , true, true }; -/** -* @talyn_fw_mapping provides memory remapping table for Talyn +/* talyn_fw_mapping provides memory remapping table for Talyn * * array size should be in sync with the declaration in the wil6210.h *
@@ -154,8 +151,7 @@ const struct fw_map talyn_fw_mapping[] = { {0x800000, 0x808000, 0xa78000, "uc_data", false, false}, }; -/** -* @talyn_mb_fw_mapping provides memory remapping table for Talyn-MB +/* talyn_mb_fw_mapping provides memory remapping table for Talyn-MB * * array size should be in sync with the declaration in the wil6210.h *
@@ -229,7 +225,7 @@ u8 led_polarity = LED_POLARITY_LOW_ACTIVE;/** * return AHB address for given firmware internal (linker) address -* @x - internal address +* @x: internal address * If address have no valid AHB mapping, return 0 */ static u32 wmi_addr_remap (u32 x)
@@ -247,7 +243,7 @@ static u32 wmi_addr_remap(u32 x)/** * find fw_mapping entry by section name -* @section - section name +* @section: section name * * Return pointer to section or NULL if not found */
@@ -265,8 +261,9 @@ struct fw_map *wil_find_fw_mapping(const char *section)/** * Check address validity for WMI buffer; remap if needed -* @ptr - internal (linker) fw/ucode address -* @size - if non zero, validate the block does not +* @wil: driver data +* @ptr: internal (linker) fw/ucode address +* @size: if non zero, validate the block does not * exceed the device memory (bar) * * Valid buffer should be DWORD aligned
@@ -300,9 +297,7 @@ void __iomem *wmi_buffer(struct wil6210_priv *wil, __le32 ptr_)return wmi_buffer_block (wil, ptr_,0 ); } -/** -* Check address validity -*/ +/* Check address validity */ void __iomem *wmi_addr (struct wil6210_priv *wil,u32 ptr) {u32 off;
@@ -1577,8 +1572,7 @@ wmi_evt_link_stats(struct wil6210_vif *vif, int id, void *d, int len) evt->payload, payload_size); } -/** -* find cid and ringid for the station vif +/* find cid and ringid for the station vif * * return error, if other interfaces are used or ring was not found */
@@ -1868,8 +1862,7 @@ wmi_evt_link_monitor(struct wil6210_vif *vif, int id, void *d, int len)cfg80211_cqm_rssi_notify (ndev, event_type, evt->rssi_level,GFP_KERNEL ); } -/** -* Some events are ignored for purpose; and need not be interpreted as +/* Some events are ignored for purpose; and need not be interpreted as * "unhandled events" */ static void wmi_evt_ignore (struct wil6210_vif *vif,int id,void *d,int len)
@@ -2578,6 +2571,7 @@ int wmi_update_ft_ies(struct wil6210_vif *vif, u16 ie_len, const void *ie)/** * wmi_rxon - turn radio on/off +* @wil: driver data * @on: turn on if true, off otherwise * * Only switch radio. Channel should be set separately.
Signature · 1 line
2.25.1
Re: [PATCH v2 25/32] wireless: ath: wil6210: wmi: Fix formatting and demote non-conforming function headers
Quoted 25 lines · Lee Jones
Fixes the following W=1 kernel build warning(s):
drivers/net/wireless/ath/wil6210/wmi.c:52: warning: Incorrect use of kernel-doc format: * Addressing - theory of operationsdrivers/net/wireless/ath/wil6210/wmi.c:70: warning: Incorrect use of kernel-doc format: * @sparrow_fw_mapping provides memory remapping table for sparrowdrivers/net/wireless/ath/wil6210/wmi.c:80: warning: cannot understand function prototype: 'const structfw_mapsparrow_fw_mapping[] = 'drivers/net/wireless/ath/wil6210/wmi.c:107: warning: Cannot understand * @sparrow_d0_mac_rgf_ext - mac_rgf_ext section for Sparrow D0 drivers/net/wireless/ath/wil6210/wmi.c:115: warning: Cannot understand * @talyn_fw_mapping provides memory remapping table for Talyn drivers/net/wireless/ath/wil6210/wmi.c:158: warning: Cannot understand * @talyn_mb_fw_mapping provides memory remapping table for Talyn-MB
drivers/net/wireless/ath/wil6210/wmi.c:236: warning: Function parameter or member 'x' not described in 'wmi_addr_remap'drivers/net/wireless/ath/wil6210/wmi.c:255: warning: Function parameter or member 'section' not described in 'wil_find_fw_mapping'drivers/net/wireless/ath/wil6210/wmi.c:278: warning: Function parameter or member 'wil' not described in 'wmi_buffer_block'drivers/net/wireless/ath/wil6210/wmi.c:278: warning: Function parameter or member 'ptr_' not described in 'wmi_buffer_block'drivers/net/wireless/ath/wil6210/wmi.c:278: warning: Function parameter or member 'size' not described in 'wmi_buffer_block'drivers/net/wireless/ath/wil6210/wmi.c:307: warning: Function parameter or member 'wil' not described in 'wmi_addr'drivers/net/wireless/ath/wil6210/wmi.c:307: warning: Function parameter or member 'ptr' not described in 'wmi_addr'drivers/net/wireless/ath/wil6210/wmi.c:1589: warning: Function parameter or member 'wil' not described in 'wil_find_cid_ringid_sta'drivers/net/wireless/ath/wil6210/wmi.c:1589: warning: Function parameter or member 'vif' not described in 'wil_find_cid_ringid_sta'drivers/net/wireless/ath/wil6210/wmi.c:1589: warning: Function parameter or member 'cid' not described in 'wil_find_cid_ringid_sta'drivers/net/wireless/ath/wil6210/wmi.c:1589: warning: Function parameter or member 'ringid' not described in 'wil_find_cid_ringid_sta'drivers/net/wireless/ath/wil6210/wmi.c:1876: warning: Function parameter or member 'vif' not described in 'wmi_evt_ignore'drivers/net/wireless/ath/wil6210/wmi.c:1876: warning: Function parameter or member 'id' not described in 'wmi_evt_ignore'drivers/net/wireless/ath/wil6210/wmi.c:1876: warning: Function parameter or member 'd' not described in 'wmi_evt_ignore'drivers/net/wireless/ath/wil6210/wmi.c:1876: warning: Function parameter or member 'len' not described in 'wmi_evt_ignore'drivers/net/wireless/ath/wil6210/wmi.c:2588: warning: Function parameter or member 'wil' not described in 'wmi_rxon'
Quoted 9 lines
Cc Maya Erez <[email protected]>Cc Kalle Valo <[email protected]>Cc "David S. Miller" <[email protected]>Cc Jakub Kicinski <[email protected]>Signed-off-by Lee Jones <[email protected]>Signed-off-by Kalle Valo <[email protected]>
6 patches applied to ath-next branch of ath.git, thanks.
6b9739c8b8b8 wil6210: wmi: Fix formatting and demote non-conforming function headers 299ff6c6baa2 wil6210: interrupt: Demote comment header which is clearly not kernel-doc e6636d649474 wil6210: txrx: Demote obvious abuse of kernel-doc e2d651b99379 wil6210: txrx_edma: Demote comments which are clearly not kernel-doc c7b1a9b358e1 wil6210: pmc: Demote a few nonconformant kernel-doc function headers ea2e3df7c4f2 wil6210: wil_platform: Demote kernel-doc header to standard comment block
Signature · 3 lines
https://patchwork.kernel.org/patch/11740165/ https://wireless.wiki.kernel.org/en/developers/documentation/submittingpatches
PATCH 26/32 wireless: ath: wil6210: interrupt: Demote comment header which is clearly not kernel-doc
In reply to Lee JonesFixes the following W=1 kernel build warning(s):
drivers/net/wireless/ath/wil6210/interrupt.c:652: warning: Function parameter or member 'irq' not described in 'wil6210_thread_irq' drivers/net/wireless/ath/wil6210/interrupt.c:652: warning: Function parameter or member 'cookie' not described in 'wil6210_thread_irq'
--- drivers/net/wireless/ath/wil6210/interrupt.c | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-)
drivers/net/wireless/ath/wil6210/interrupt.c +1 -1
@@ -645,7 +645,7 @@ static irqreturn_t wil6210_irq_misc_thread(int irq, void *cookie)return IRQ_HANDLED ; } -/** +/* * thread IRQ handler */ static irqreturn_t wil6210_thread_irq (int irq,void *cookie)
Signature · 1 line
2.25.1
PATCH v2 26/32 wireless: ath: wil6210: interrupt: Demote comment header which is clearly not kernel-doc
Fixes the following W=1 kernel build warning(s):
drivers/net/wireless/ath/wil6210/interrupt.c:652: warning: Function parameter or member 'irq' not described in 'wil6210_thread_irq' drivers/net/wireless/ath/wil6210/interrupt.c:652: warning: Function parameter or member 'cookie' not described in 'wil6210_thread_irq'
--- drivers/net/wireless/ath/wil6210/interrupt.c | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-)
drivers/net/wireless/ath/wil6210/interrupt.c +1 -3
@@ -645,9 +645,7 @@ static irqreturn_t wil6210_irq_misc_thread(int irq, void *cookie)return IRQ_HANDLED ; } -/** -* thread IRQ handler -*/ +/* thread IRQ handler */ static irqreturn_t wil6210_thread_irq (int irq,void *cookie) {struct wil6210_priv *wil = cookie;
Signature · 1 line
2.25.1
PATCH 27/32 wireless: ath: wil6210: txrx: Demote obvious abuse of kernel-doc
In reply to Lee JonesNone of these headers provide any parameter documentation.
Fixes the following W=1 kernel build warning(s):
drivers/net/wireless/ath/wil6210/txrx.c:259: warning: Function parameter or member 'wil' not described in 'wil_vring_alloc_skb' drivers/net/wireless/ath/wil6210/txrx.c:259: warning: Function parameter or member 'vring' not described in 'wil_vring_alloc_skb' drivers/net/wireless/ath/wil6210/txrx.c:259: warning: Function parameter or member 'i' not described in 'wil_vring_alloc_skb' drivers/net/wireless/ath/wil6210/txrx.c:259: warning: Function parameter or member 'headroom' not described in 'wil_vring_alloc_skb' drivers/net/wireless/ath/wil6210/txrx.c:309: warning: Function parameter or member 'wil' not described in 'wil_rx_add_radiotap_header' drivers/net/wireless/ath/wil6210/txrx.c:309: warning: Function parameter or member 'skb' not described in 'wil_rx_add_radiotap_header' drivers/net/wireless/ath/wil6210/txrx.c:444: warning: Function parameter or member 'wil' not described in 'wil_vring_reap_rx' drivers/net/wireless/ath/wil6210/txrx.c:444: warning: Function parameter or member 'vring' not described in 'wil_vring_reap_rx' drivers/net/wireless/ath/wil6210/txrx.c:610: warning: Function parameter or member 'wil' not described in 'wil_rx_refill' drivers/net/wireless/ath/wil6210/txrx.c:610: warning: Function parameter or member 'count' not described in 'wil_rx_refill' drivers/net/wireless/ath/wil6210/txrx.c:1011: warning: Function parameter or member 'wil' not described in 'wil_rx_handle' drivers/net/wireless/ath/wil6210/txrx.c:1011: warning: Function parameter or member 'quota' not described in 'wil_rx_handle' drivers/net/wireless/ath/wil6210/txrx.c:1643: warning: Function parameter or member 'd' not described in 'wil_tx_desc_offload_setup_tso' drivers/net/wireless/ath/wil6210/txrx.c:1643: warning: Function parameter or member 'skb' not described in 'wil_tx_desc_offload_setup_tso' drivers/net/wireless/ath/wil6210/txrx.c:1643: warning: Function parameter or member 'tso_desc_type' not described in 'wil_tx_desc_offload_setup_tso' drivers/net/wireless/ath/wil6210/txrx.c:1643: warning: Function parameter or member 'is_ipv4' not described in 'wil_tx_desc_offload_setup_tso' drivers/net/wireless/ath/wil6210/txrx.c:1643: warning: Function parameter or member 'tcp_hdr_len' not described in 'wil_tx_desc_offload_setup_tso' drivers/net/wireless/ath/wil6210/txrx.c:1643: warning: Function parameter or member 'skb_net_hdr_len' not described in 'wil_tx_desc_offload_setup_tso' drivers/net/wireless/ath/wil6210/txrx.c:1674: warning: Function parameter or member 'd' not described in 'wil_tx_desc_offload_setup' drivers/net/wireless/ath/wil6210/txrx.c:1674: warning: Function parameter or member 'skb' not described in 'wil_tx_desc_offload_setup' drivers/net/wireless/ath/wil6210/txrx.c:2240: warning: Function parameter or member 'wil' not described in '__wil_update_net_queues' drivers/net/wireless/ath/wil6210/txrx.c:2240: warning: Function parameter or member 'vif' not described in '__wil_update_net_queues' drivers/net/wireless/ath/wil6210/txrx.c:2240: warning: Function parameter or member 'ring' not described in '__wil_update_net_queues' drivers/net/wireless/ath/wil6210/txrx.c:2240: warning: Function parameter or member 'check_stop' not described in '__wil_update_net_queues' drivers/net/wireless/ath/wil6210/txrx.c:2430: warning: Function parameter or member 'vif' not described in 'wil_tx_complete' drivers/net/wireless/ath/wil6210/txrx.c:2430: warning: Function parameter or member 'ringid' not described in 'wil_tx_complete'
--- drivers/net/wireless/ath/wil6210/txrx.c | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-)
drivers/net/wireless/ath/wil6210/txrx.c +10 -10
@@ -249,7 +249,7 @@ static void wil_vring_free(struct wil6210_priv *wil, struct wil_ring *vring) vring->ctx =NULL ; } -/** +/* * Allocate one skb for Rx VRING * * Safe to call from IRQ
@@ -295,7 +295,7 @@ static int wil_vring_alloc_skb(struct wil6210_priv *wil, struct wil_ring *vring,return 0 ; } -/** +/* * Adds radiotap header * * Any error indicated as "Bad FCS"
@@ -432,7 +432,7 @@ static int wil_rx_get_cid_by_skb(struct wil6210_priv *wil, struct sk_buff *skb)return cid; } -/** +/* * reap 1 frame from @swhead * * Rx descriptor copied to skb->cb
@@ -597,7 +597,7 @@ static struct sk_buff *wil_vring_reap_rx(struct wil6210_priv *wil,return skb; } -/** +/* * allocate and fill up to @count buffers in rx ring * buffers posted at @swtail * Note: we have a single RX queue for servicing all VIFs, but we
@@ -1002,7 +1002,7 @@ void wil_netif_rx_any(struct sk_buff *skb, struct net_device *ndev)wil_netif_rx (skb, ndev, cid, stats, true); } -/** +/* * Proceed all completed skb's from Rx VRING * * Safe to call from NAPI poll, i.e. softirq with interrupts enabled
@@ -1629,7 +1629,7 @@ void wil_tx_desc_set_nr_frags(struct vring_tx_desc *d, int nr_frags) d->mac.d[2 ] |= (nr_frags <<MAC_CFG_DESC_TX_2_NUM_OF_DESCRIPTORS_POS ); } -/** +/* * Sets the descriptor @d up for csum and/or TSO offloading. The corresponding * @skb is used to obtain the protocol and headers length. * @tso_desc_type is a descriptor type for TSO: 0 - a header, 1 - first data,
@@ -1660,7 +1660,7 @@ static void wil_tx_desc_offload_setup_tso(struct vring_tx_desc *d, d->dma.d0 |=BIT (DMA_CFG_DESC_TX_0_PSEUDO_HEADER_CALC_EN_POS ); } -/** +/* * Sets the descriptor @d up for csum. The corresponding * @skb is used to obtain the protocol and headers length. * Returns the protocol: 0 - not TCP, 1 - TCPv4, 2 - TCPv6.
@@ -2216,7 +2216,7 @@ static int wil_tx_ring(struct wil6210_priv *wil, struct wil6210_vif *vif,return rc; } -/** +/* * Check status of tx vrings and stop/wake net queues if needed * It will start/stop net queues of a specific VIF net_device. *
@@ -2419,7 +2419,7 @@ void wil_tx_latency_calc(struct wil6210_priv *wil, struct sk_buff *skb, sta->stats.tx_latency_max_us = skb_time_us; } -/** +/* * Clean up transmitted skb's from the Tx VRING * * Return number of descriptors cleared
@@ -2460,7 +2460,7 @@ int wil_tx_complete(struct wil6210_vif *vif, int ringid)while (!wil_ring_is_empty (vring)) {int new_swtail;struct wil_ctx *ctx = &vring->ctx[vring->swtail]; -/** +/* * For the fragmented skb, HW will set DU bit only for the * last fragment. look for it. * In TSO the first DU will include hdr desc
Signature · 1 line
2.25.1
PATCH v2 27/32 wireless: ath: wil6210: txrx: Demote obvious abuse of kernel-doc
None of these headers provide any parameter documentation.
Fixes the following W=1 kernel build warning(s):
drivers/net/wireless/ath/wil6210/txrx.c:259: warning: Function parameter or member 'wil' not described in 'wil_vring_alloc_skb' drivers/net/wireless/ath/wil6210/txrx.c:259: warning: Function parameter or member 'vring' not described in 'wil_vring_alloc_skb' drivers/net/wireless/ath/wil6210/txrx.c:259: warning: Function parameter or member 'i' not described in 'wil_vring_alloc_skb' drivers/net/wireless/ath/wil6210/txrx.c:259: warning: Function parameter or member 'headroom' not described in 'wil_vring_alloc_skb' drivers/net/wireless/ath/wil6210/txrx.c:309: warning: Function parameter or member 'wil' not described in 'wil_rx_add_radiotap_header' drivers/net/wireless/ath/wil6210/txrx.c:309: warning: Function parameter or member 'skb' not described in 'wil_rx_add_radiotap_header' drivers/net/wireless/ath/wil6210/txrx.c:444: warning: Function parameter or member 'wil' not described in 'wil_vring_reap_rx' drivers/net/wireless/ath/wil6210/txrx.c:444: warning: Function parameter or member 'vring' not described in 'wil_vring_reap_rx' drivers/net/wireless/ath/wil6210/txrx.c:610: warning: Function parameter or member 'wil' not described in 'wil_rx_refill' drivers/net/wireless/ath/wil6210/txrx.c:610: warning: Function parameter or member 'count' not described in 'wil_rx_refill' drivers/net/wireless/ath/wil6210/txrx.c:1011: warning: Function parameter or member 'wil' not described in 'wil_rx_handle' drivers/net/wireless/ath/wil6210/txrx.c:1011: warning: Function parameter or member 'quota' not described in 'wil_rx_handle' drivers/net/wireless/ath/wil6210/txrx.c:1643: warning: Function parameter or member 'd' not described in 'wil_tx_desc_offload_setup_tso' drivers/net/wireless/ath/wil6210/txrx.c:1643: warning: Function parameter or member 'skb' not described in 'wil_tx_desc_offload_setup_tso' drivers/net/wireless/ath/wil6210/txrx.c:1643: warning: Function parameter or member 'tso_desc_type' not described in 'wil_tx_desc_offload_setup_tso' drivers/net/wireless/ath/wil6210/txrx.c:1643: warning: Function parameter or member 'is_ipv4' not described in 'wil_tx_desc_offload_setup_tso' drivers/net/wireless/ath/wil6210/txrx.c:1643: warning: Function parameter or member 'tcp_hdr_len' not described in 'wil_tx_desc_offload_setup_tso' drivers/net/wireless/ath/wil6210/txrx.c:1643: warning: Function parameter or member 'skb_net_hdr_len' not described in 'wil_tx_desc_offload_setup_tso' drivers/net/wireless/ath/wil6210/txrx.c:1674: warning: Function parameter or member 'd' not described in 'wil_tx_desc_offload_setup' drivers/net/wireless/ath/wil6210/txrx.c:1674: warning: Function parameter or member 'skb' not described in 'wil_tx_desc_offload_setup' drivers/net/wireless/ath/wil6210/txrx.c:2240: warning: Function parameter or member 'wil' not described in '__wil_update_net_queues' drivers/net/wireless/ath/wil6210/txrx.c:2240: warning: Function parameter or member 'vif' not described in '__wil_update_net_queues' drivers/net/wireless/ath/wil6210/txrx.c:2240: warning: Function parameter or member 'ring' not described in '__wil_update_net_queues' drivers/net/wireless/ath/wil6210/txrx.c:2240: warning: Function parameter or member 'check_stop' not described in '__wil_update_net_queues' drivers/net/wireless/ath/wil6210/txrx.c:2430: warning: Function parameter or member 'vif' not described in 'wil_tx_complete' drivers/net/wireless/ath/wil6210/txrx.c:2430: warning: Function parameter or member 'ringid' not described in 'wil_tx_complete'
--- drivers/net/wireless/ath/wil6210/txrx.c | 30 +++++++++---------------- 1 file changed, 10 insertions(+), 20 deletions(-)
drivers/net/wireless/ath/wil6210/txrx.c +10 -20
@@ -249,8 +249,7 @@ static void wil_vring_free(struct wil6210_priv *wil, struct wil_ring *vring) vring->ctx =NULL ; } -/** -* Allocate one skb for Rx VRING +/* Allocate one skb for Rx VRING * * Safe to call from IRQ */
@@ -295,8 +294,7 @@ static int wil_vring_alloc_skb(struct wil6210_priv *wil, struct wil_ring *vring,return 0 ; } -/** -* Adds radiotap header +/* Adds radiotap header * * Any error indicated as "Bad FCS" *
@@ -432,8 +430,7 @@ static int wil_rx_get_cid_by_skb(struct wil6210_priv *wil, struct sk_buff *skb)return cid; } -/** -* reap 1 frame from @swhead +/* reap 1 frame from @swhead * * Rx descriptor copied to skb->cb *
@@ -597,8 +594,7 @@ static struct sk_buff *wil_vring_reap_rx(struct wil6210_priv *wil,return skb; } -/** -* allocate and fill up to @count buffers in rx ring +/* allocate and fill up to @count buffers in rx ring * buffers posted at @swtail * Note: we have a single RX queue for servicing all VIFs, but we * allocate skbs with headroom according to main interface only. This
@@ -1002,8 +998,7 @@ void wil_netif_rx_any(struct sk_buff *skb, struct net_device *ndev)wil_netif_rx (skb, ndev, cid, stats, true); } -/** -* Proceed all completed skb's from Rx VRING +/* Proceed all completed skb's from Rx VRING * * Safe to call from NAPI poll, i.e. softirq with interrupts enabled */
@@ -1629,8 +1624,7 @@ void wil_tx_desc_set_nr_frags(struct vring_tx_desc *d, int nr_frags) d->mac.d[2 ] |= (nr_frags <<MAC_CFG_DESC_TX_2_NUM_OF_DESCRIPTORS_POS ); } -/** -* Sets the descriptor @d up for csum and/or TSO offloading. The corresponding +/* Sets the descriptor @d up for csum and/or TSO offloading. The corresponding * @skb is used to obtain the protocol and headers length. * @tso_desc_type is a descriptor type for TSO: 0 - a header, 1 - first data, * 2 - middle, 3 - last descriptor.
@@ -1660,8 +1654,7 @@ static void wil_tx_desc_offload_setup_tso(struct vring_tx_desc *d, d->dma.d0 |=BIT (DMA_CFG_DESC_TX_0_PSEUDO_HEADER_CALC_EN_POS ); } -/** -* Sets the descriptor @d up for csum. The corresponding +/* Sets the descriptor @d up for csum. The corresponding * @skb is used to obtain the protocol and headers length. * Returns the protocol: 0 - not TCP, 1 - TCPv4, 2 - TCPv6. * Note, if d==NULL, the function only returns the protocol result.
@@ -2216,8 +2209,7 @@ static int wil_tx_ring(struct wil6210_priv *wil, struct wil6210_vif *vif,return rc; } -/** -* Check status of tx vrings and stop/wake net queues if needed +/* Check status of tx vrings and stop/wake net queues if needed * It will start/stop net queues of a specific VIF net_device. * * This function does one of two checks:
@@ -2419,8 +2411,7 @@ void wil_tx_latency_calc(struct wil6210_priv *wil, struct sk_buff *skb, sta->stats.tx_latency_max_us = skb_time_us; } -/** -* Clean up transmitted skb's from the Tx VRING +/* Clean up transmitted skb's from the Tx VRING * * Return number of descriptors cleared *
@@ -2460,8 +2451,7 @@ int wil_tx_complete(struct wil6210_vif *vif, int ringid)while (!wil_ring_is_empty (vring)) {int new_swtail;struct wil_ctx *ctx = &vring->ctx[vring->swtail]; -/** -* For the fragmented skb, HW will set DU bit only for the +/* For the fragmented skb, HW will set DU bit only for the * last fragment. look for it. * In TSO the first DU will include hdr desc */
Signature · 1 line
2.25.1
PATCH 28/32 wireless: ath: wil6210: txrx_edma: Demote comments which are clearly not kernel-doc
In reply to Lee JonesFixes the following W=1 kernel build warning(s):
drivers/net/wireless/ath/wil6210/txrx_edma.c:155: warning: Function parameter or member 'wil' not described in 'wil_ring_alloc_skb_edma' drivers/net/wireless/ath/wil6210/txrx_edma.c:155: warning: Function parameter or member 'ring' not described in 'wil_ring_alloc_skb_edma' drivers/net/wireless/ath/wil6210/txrx_edma.c:155: warning: Function parameter or member 'i' not described in 'wil_ring_alloc_skb_edma' drivers/net/wireless/ath/wil6210/txrx_edma.c:1161: warning: Function parameter or member 'wil' not described in 'wil_tx_sring_handler' drivers/net/wireless/ath/wil6210/txrx_edma.c:1161: warning: Function parameter or member 'sring' not described in 'wil_tx_sring_handler' drivers/net/wireless/ath/wil6210/txrx_edma.c:1328: warning: Function parameter or member 'd' not described in 'wil_tx_desc_offload_setup_tso_edma' drivers/net/wireless/ath/wil6210/txrx_edma.c:1328: warning: Function parameter or member 'tso_desc_type' not described in 'wil_tx_desc_offload_setup_tso_edma' drivers/net/wireless/ath/wil6210/txrx_edma.c:1328: warning: Function parameter or member 'is_ipv4' not described in 'wil_tx_desc_offload_setup_tso_edma' drivers/net/wireless/ath/wil6210/txrx_edma.c:1328: warning: Function parameter or member 'tcp_hdr_len' not described in 'wil_tx_desc_offload_setup_tso_edma' drivers/net/wireless/ath/wil6210/txrx_edma.c:1328: warning: Function parameter or member 'skb_net_hdr_len' not described in 'wil_tx_desc_offload_setup_tso_edma' drivers/net/wireless/ath/wil6210/txrx_edma.c:1328: warning: Function parameter or member 'mss' not described in 'wil_tx_desc_offload_setup_tso_edma'
--- drivers/net/wireless/ath/wil6210/txrx_edma.c | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-)
drivers/net/wireless/ath/wil6210/txrx_edma.c +3 -3
@@ -147,7 +147,7 @@ static int wil_tx_init_edma(struct wil6210_priv *wil)return rc; } -/** +/* * Allocate one skb for Rx descriptor RING */ static int wil_ring_alloc_skb_edma(struct wil6210_priv *wil,
@@ -1152,7 +1152,7 @@ wil_get_next_tx_status_msg(struct wil_status_ring *sring, u8 *dr_bit, *msg = *_msg; } -/** +/* * Clean up transmitted skb's from the Tx descriptor RING. * Return number of descriptors cleared. */
@@ -1314,7 +1314,7 @@ int wil_tx_sring_handler(struct wil6210_priv *wil,return desc_cnt; } -/** +/* * Sets the descriptor @d up for csum and/or TSO offloading. The corresponding * @skb is used to obtain the protocol and headers length. * @tso_desc_type is a descriptor type for TSO: 0 - a header, 1 - first data,
Signature · 1 line
2.25.1
PATCH v2 28/32 wireless: ath: wil6210: txrx_edma: Demote comments which are clearly not kernel-doc
Fixes the following W=1 kernel build warning(s):
drivers/net/wireless/ath/wil6210/txrx_edma.c:155: warning: Function parameter or member 'wil' not described in 'wil_ring_alloc_skb_edma' drivers/net/wireless/ath/wil6210/txrx_edma.c:155: warning: Function parameter or member 'ring' not described in 'wil_ring_alloc_skb_edma' drivers/net/wireless/ath/wil6210/txrx_edma.c:155: warning: Function parameter or member 'i' not described in 'wil_ring_alloc_skb_edma' drivers/net/wireless/ath/wil6210/txrx_edma.c:1161: warning: Function parameter or member 'wil' not described in 'wil_tx_sring_handler' drivers/net/wireless/ath/wil6210/txrx_edma.c:1161: warning: Function parameter or member 'sring' not described in 'wil_tx_sring_handler' drivers/net/wireless/ath/wil6210/txrx_edma.c:1328: warning: Function parameter or member 'd' not described in 'wil_tx_desc_offload_setup_tso_edma' drivers/net/wireless/ath/wil6210/txrx_edma.c:1328: warning: Function parameter or member 'tso_desc_type' not described in 'wil_tx_desc_offload_setup_tso_edma' drivers/net/wireless/ath/wil6210/txrx_edma.c:1328: warning: Function parameter or member 'is_ipv4' not described in 'wil_tx_desc_offload_setup_tso_edma' drivers/net/wireless/ath/wil6210/txrx_edma.c:1328: warning: Function parameter or member 'tcp_hdr_len' not described in 'wil_tx_desc_offload_setup_tso_edma' drivers/net/wireless/ath/wil6210/txrx_edma.c:1328: warning: Function parameter or member 'skb_net_hdr_len' not described in 'wil_tx_desc_offload_setup_tso_edma' drivers/net/wireless/ath/wil6210/txrx_edma.c:1328: warning: Function parameter or member 'mss' not described in 'wil_tx_desc_offload_setup_tso_edma'
--- drivers/net/wireless/ath/wil6210/txrx_edma.c | 10 +++------- 1 file changed, 3 insertions(+), 7 deletions(-)
drivers/net/wireless/ath/wil6210/txrx_edma.c +3 -7
@@ -147,9 +147,7 @@ static int wil_tx_init_edma(struct wil6210_priv *wil)return rc; } -/** -* Allocate one skb for Rx descriptor RING -*/ +/* Allocate one skb for Rx descriptor RING */ static int wil_ring_alloc_skb_edma (struct wil6210_priv *wil,struct wil_ring *ring,u32 i) {
@@ -1152,8 +1150,7 @@ wil_get_next_tx_status_msg(struct wil_status_ring *sring, u8 *dr_bit, *msg = *_msg; } -/** -* Clean up transmitted skb's from the Tx descriptor RING. +/* Clean up transmitted skb's from the Tx descriptor RING. * Return number of descriptors cleared. */ int wil_tx_sring_handler(struct wil6210_priv *wil,
@@ -1314,8 +1311,7 @@ int wil_tx_sring_handler(struct wil6210_priv *wil,return desc_cnt; } -/** -* Sets the descriptor @d up for csum and/or TSO offloading. The corresponding +/* Sets the descriptor @d up for csum and/or TSO offloading. The corresponding * @skb is used to obtain the protocol and headers length. * @tso_desc_type is a descriptor type for TSO: 0 - a header, 1 - first data, * 2 - middle, 3 - last descriptor.
Signature · 1 line
2.25.1
PATCH 29/32 wireless: realtek: rtl8192c: phy_common: Remove unused variable 'bbvalue'
In reply to Lee JonesFixes the following W=1 kernel build warning(s):
drivers/net/wireless/realtek/rtlwifi/rtl8192c/phy_common.c: In function ‘_rtl92c_phy_iq_calibrate’:
drivers/net/wireless/realtek/rtlwifi/rtl8192c/phy_common.c:1223:6: warning: variable ‘bbvalue’ set but not used [-Wunused-but-set-variable]
--- drivers/net/wireless/realtek/rtlwifi/rtl8192c/phy_common.c | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-)
drivers/net/wireless/realtek/rtlwifi/rtl8192c/phy_common.c +1 -2
@@ -1220,10 +1220,9 @@ static void _rtl92c_phy_iq_calibrate(struct ieee80211_hw *hw, 0x522, 0x550, 0x551, 0x040 };const u32 retrycount =2 ; -u32 bbvalue;if (t ==0 ) { - bbvalue =rtl_get_bbreg (hw,0x800 ,MASKDWORD ); +rtl_get_bbreg (hw,0x800 ,MASKDWORD );_rtl92c_phy_save_adda_registers (hw, adda_reg, rtlphy->adda_backup,16 );
Signature · 1 line
2.25.1
PATCH 30/32 wireless: ath: wil6210: pmc: Demote a few nonconformant kernel-doc function headers
In reply to Lee JonesFixes the following W=1 kernel build warning(s):
drivers/net/wireless/ath/wil6210/pmc.c:43: warning: Function parameter or member 'wil' not described in 'wil_pmc_alloc' drivers/net/wireless/ath/wil6210/pmc.c:43: warning: Function parameter or member 'num_descriptors' not described in 'wil_pmc_alloc' drivers/net/wireless/ath/wil6210/pmc.c:43: warning: Function parameter or member 'descriptor_size' not described in 'wil_pmc_alloc' drivers/net/wireless/ath/wil6210/pmc.c:229: warning: Function parameter or member 'wil' not described in 'wil_pmc_free' drivers/net/wireless/ath/wil6210/pmc.c:229: warning: Function parameter or member 'send_pmc_cmd' not described in 'wil_pmc_free' drivers/net/wireless/ath/wil6210/pmc.c:307: warning: Function parameter or member 'wil' not described in 'wil_pmc_last_cmd_status' drivers/net/wireless/ath/wil6210/pmc.c:320: warning: Function parameter or member 'filp' not described in 'wil_pmc_read' drivers/net/wireless/ath/wil6210/pmc.c:320: warning: Function parameter or member 'buf' not described in 'wil_pmc_read' drivers/net/wireless/ath/wil6210/pmc.c:320: warning: Function parameter or member 'count' not described in 'wil_pmc_read' drivers/net/wireless/ath/wil6210/pmc.c:320: warning: Function parameter or member 'f_pos' not described in 'wil_pmc_read'
--- drivers/net/wireless/ath/wil6210/pmc.c | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-)
drivers/net/wireless/ath/wil6210/pmc.c +4 -4
@@ -29,7 +29,7 @@ void wil_pmc_init(struct wil6210_priv *wil)mutex_init (&wil->pmc.lock); } -/** +/* * Allocate the physical ring (p-ring) and the required * number of descriptors of required size. * Initialize the descriptors as required by pmc dma.
@@ -221,7 +221,7 @@ void wil_pmc_alloc(struct wil6210_priv *wil,mutex_unlock (&pmc->lock); } -/** +/* * Traverse the p-ring and release all buffers. * At the end release the p-ring memory */
@@ -299,7 +299,7 @@ void wil_pmc_free(struct wil6210_priv *wil, int send_pmc_cmd)mutex_unlock (&pmc->lock); } -/** +/* * Status of the last operation requested via debugfs: alloc/free/read. * 0 - success or negative errno */
@@ -311,7 +311,7 @@ int wil_pmc_last_cmd_status(struct wil6210_priv *wil)return wil->pmc.last_cmd_status; } -/** +/* * Read from required position up to the end of current descriptor, * depends on descriptor size configured during alloc request. */
Signature · 1 line
2.25.1
PATCH v2 30/32 wireless: ath: wil6210: pmc: Demote a few nonconformant kernel-doc function headers
Fixes the following W=1 kernel build warning(s):
drivers/net/wireless/ath/wil6210/pmc.c:43: warning: Function parameter or member 'wil' not described in 'wil_pmc_alloc' drivers/net/wireless/ath/wil6210/pmc.c:43: warning: Function parameter or member 'num_descriptors' not described in 'wil_pmc_alloc' drivers/net/wireless/ath/wil6210/pmc.c:43: warning: Function parameter or member 'descriptor_size' not described in 'wil_pmc_alloc' drivers/net/wireless/ath/wil6210/pmc.c:229: warning: Function parameter or member 'wil' not described in 'wil_pmc_free' drivers/net/wireless/ath/wil6210/pmc.c:229: warning: Function parameter or member 'send_pmc_cmd' not described in 'wil_pmc_free' drivers/net/wireless/ath/wil6210/pmc.c:307: warning: Function parameter or member 'wil' not described in 'wil_pmc_last_cmd_status' drivers/net/wireless/ath/wil6210/pmc.c:320: warning: Function parameter or member 'filp' not described in 'wil_pmc_read' drivers/net/wireless/ath/wil6210/pmc.c:320: warning: Function parameter or member 'buf' not described in 'wil_pmc_read' drivers/net/wireless/ath/wil6210/pmc.c:320: warning: Function parameter or member 'count' not described in 'wil_pmc_read' drivers/net/wireless/ath/wil6210/pmc.c:320: warning: Function parameter or member 'f_pos' not described in 'wil_pmc_read'
--- drivers/net/wireless/ath/wil6210/pmc.c | 12 ++++-------- 1 file changed, 4 insertions(+), 8 deletions(-)
drivers/net/wireless/ath/wil6210/pmc.c +4 -8
@@ -29,8 +29,7 @@ void wil_pmc_init(struct wil6210_priv *wil)mutex_init (&wil->pmc.lock); } -/** -* Allocate the physical ring (p-ring) and the required +/* Allocate the physical ring (p-ring) and the required * number of descriptors of required size. * Initialize the descriptors as required by pmc dma. * The descriptors' buffers dwords are initialized to hold
@@ -221,8 +220,7 @@ void wil_pmc_alloc(struct wil6210_priv *wil,mutex_unlock (&pmc->lock); } -/** -* Traverse the p-ring and release all buffers. +/* Traverse the p-ring and release all buffers. * At the end release the p-ring memory */ void wil_pmc_free (struct wil6210_priv *wil,int send_pmc_cmd)
@@ -299,8 +297,7 @@ void wil_pmc_free(struct wil6210_priv *wil, int send_pmc_cmd)mutex_unlock (&pmc->lock); } -/** -* Status of the last operation requested via debugfs: alloc/free/read. +/* Status of the last operation requested via debugfs: alloc/free/read. * 0 - success or negative errno */ int wil_pmc_last_cmd_status (struct wil6210_priv *wil)
@@ -311,8 +308,7 @@ int wil_pmc_last_cmd_status(struct wil6210_priv *wil)return wil->pmc.last_cmd_status; } -/** -* Read from required position up to the end of current descriptor, +/* Read from required position up to the end of current descriptor, * depends on descriptor size configured during alloc request. */ ssize_t wil_pmc_read(struct file *filp, char __user *buf, size_t count,
Signature · 1 line
2.25.1
PATCH 31/32 wireless: ath: wil6210: wil_platform: Demote kernel-doc header to standard comment block
In reply to Lee JonesThere has been no attempt to document any of the function parameters here.
Fixes the following W=1 kernel build warning(s):
drivers/net/wireless/ath/wil6210/wil_platform.c:27: warning: Function parameter or member 'dev' not described in 'wil_platform_init' drivers/net/wireless/ath/wil6210/wil_platform.c:27: warning: Function parameter or member 'ops' not described in 'wil_platform_init' drivers/net/wireless/ath/wil6210/wil_platform.c:27: warning: Function parameter or member 'rops' not described in 'wil_platform_init' drivers/net/wireless/ath/wil6210/wil_platform.c:27: warning: Function parameter or member 'wil_handle' not described in 'wil_platform_init'
--- drivers/net/wireless/ath/wil6210/wil_platform.c | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-)
drivers/net/wireless/ath/wil6210/wil_platform.c +1 -1
@@ -15,7 +15,7 @@ void wil_platform_modexit(void) { } -/** +/* * wil_platform_init() - wil6210 platform module init * * The function must be called before all other functions in this module.
Signature · 1 line
2.25.1
PATCH v2 31/32 wireless: ath: wil6210: wil_platform: Demote kernel-doc header to standard comment block
There has been no attempt to document any of the function parameters here.
Fixes the following W=1 kernel build warning(s):
drivers/net/wireless/ath/wil6210/wil_platform.c:27: warning: Function parameter or member 'dev' not described in 'wil_platform_init' drivers/net/wireless/ath/wil6210/wil_platform.c:27: warning: Function parameter or member 'ops' not described in 'wil_platform_init' drivers/net/wireless/ath/wil6210/wil_platform.c:27: warning: Function parameter or member 'rops' not described in 'wil_platform_init' drivers/net/wireless/ath/wil6210/wil_platform.c:27: warning: Function parameter or member 'wil_handle' not described in 'wil_platform_init'
--- drivers/net/wireless/ath/wil6210/wil_platform.c | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-)
drivers/net/wireless/ath/wil6210/wil_platform.c +1 -2
@@ -15,8 +15,7 @@ void wil_platform_modexit(void) { } -/** -* wil_platform_init() - wil6210 platform module init +/* wil_platform_init() - wil6210 platform module init * * The function must be called before all other functions in this module. * It returns a handle which is used with the rest of the API
Signature · 1 line
2.25.1
PATCH 32/32 wireless: mediatek: mt76x0: Move tables used only by init.c to their own header file
In reply to Lee JonesTaking the same approach as initvals_phy.h.
Fixes the following W=1 kernel build warning(s):
drivers/net/wireless/mediatek/mt76/mt76x0/initvals.h:218:35: warning: ‘mt76x0_dcoc_tab’ defined but not used [-Wunused-const-variable=] 218 | static const struct mt76_reg_pair mt76x0_dcoc_tab[] = {
| ^~~~~~~~~~~~~~~
drivers/net/wireless/mediatek/mt76/mt76x0/initvals.h:86:35: warning: ‘mt76x0_bbp_init_tab’ defined but not used [-Wunused-const-variable=] 86 | static const struct mt76_reg_pair mt76x0_bbp_init_tab[] = {
| ^~~~~~~~~~~~~~~~~~~
drivers/net/wireless/mediatek/mt76/mt76x0/initvals.h:48:35: warning: ‘mt76x0_mac_reg_table’ defined but not used [-Wunused-const-variable=] 48 | static const struct mt76_reg_pair mt76x0_mac_reg_table[] = {
| ^~~~~~~~~~~~~~~~~~~~
drivers/net/wireless/mediatek/mt76/mt76x0/initvals.h:14:35: warning: ‘common_mac_reg_table’ defined but not used [-Wunused-const-variable=] 14 | static const struct mt76_reg_pair common_mac_reg_table[] = {
| ^~~~~~~~~~~~~~~~~~~~
--- .../net/wireless/mediatek/mt76/mt76x0/init.c | 1 + .../wireless/mediatek/mt76/mt76x0/initvals.h | 145 ---------------- .../mediatek/mt76/mt76x0/initvals_init.h | 159 ++++++++++++++++++ 3 files changed, 160 insertions(+), 145 deletions(-) create mode 100644 drivers/net/wireless/mediatek/mt76/mt76x0/initvals_init.h
drivers/net/wireless/mediatek/mt76/mt76x0/init.c +1 -0
@@ -10,6 +10,7 @@#include "eeprom.h" #include "mcu.h" #include "initvals.h" +#include "initvals_init.h" #include "../mt76x02_phy.h" static void
drivers/net/wireless/mediatek/mt76/mt76x0/initvals.h +0 -145
155 lines not on this page · raw message
drivers/net/wireless/mediatek/mt76/mt76x0/initvals_init.h new file +159 -0
159 lines not on this page · raw message
Signature · 7 lines
2.25.1 _______________________________________________ Linux-mediatek mailing list [email protected] http://lists.infradead.org/mailman/listinfo/linux-mediatek
Quoted 4 lines · Lee Jones
This set is part of a larger effort attempting to clean-up W=1 kernel builds, which are currently overwhelmingly riddled with niggly little warnings.
I see that after our discussion about the carl9170 change in this thread following your patch: <https://lkml.org/lkml/2020/8/14/291>
you decided the best way to address our requirements, was to "drop" your patch from the series, instead of just implementing the requested changes. :(
Quoted 4 lines
There are quite a few W=1 warnings in the Wireless. My plan is to work through all of them over the next few weeks. Hopefully it won't be too long before
drivers/net/wirelessbuilds clean with W=1 enabled.
Just a parting note for your consideration:
Since 5.7 [0], it has become rather easy to also compile the linux kernel with clang and the LLVM Utilities.
<https://www.kernel.org/doc/html/latest/kbuild/llvm.html>
I hope this information can help you to see beyond that one-unamed "compiler" bias there... I wish you the best of luck in your endeavors.
Christian
[0] <https://www.phoronix.com/scan.php?page=news_item&px=Linux-5.7-Kbuild-Easier-LLVM>
Quoted 11 lines · Christian Lamparter
Quoted 4 lines · Lee Jones
This set is part of a larger effort attempting to clean-up W=1 kernel builds, which are currently overwhelmingly riddled with niggly little warnings.
I see that after our discussion about the carl9170 change in this thread following your patch: <https://lkml.org/lkml/2020/8/14/291>
you decided the best way to address our requirements, was to "drop" your patch from the series, instead of just implementing the requested changes. :(
No, this is "set 2", not "v2".
The patch you refer to is in the first set.
Looks like I am waiting for your reply [0]:
[0] https://lkml.org/lkml/2020/8/18/334
Quoted 5 lines
Quoted 4 lines
There are quite a few W=1 warnings in the Wireless. My plan is to work through all of them over the next few weeks. Hopefully it won't be too long before
drivers/net/wirelessbuilds clean with W=1 enabled.
Quoted 8 lines
Just a parting note for your consideration:
Since 5.7 [0], it has become rather easy to also compile the linux kernel with clang and the LLVM Utilities.
<https://www.kernel.org/doc/html/latest/kbuild/llvm.html>I hope this information can help you to see beyond that one-unamed "compiler" bias there... I wish you the best of luck in your endeavors.
Never used them.
GCC has always worked well for me. What are their benefits over GCC?
I already build for 5 architectures locally and a great deal more (arch * defconfigs) using remote testing infrastructures. Multiplying them without very good reason sounds like a *potential* waste of already limited computation resources.
Quoted 3 lines
Christian
[0] <https://www.phoronix.com/scan.php?page=news_item&px=Linux-5.7-Kbuild-Easier-LLVM>
Signature · 4 lines
Lee Jones [李琼斯] Senior Technical Lead - Developer Services Linaro.org │ Open source software for Arm SoCs Follow Linaro: Facebook | Twitter | Blog
Quoted 8 lines · Lee Jones
This set is part of a larger effort attempting to clean-up W=1 kernel builds, which are currently overwhelmingly riddled with niggly little warnings.
There are quite a few W=1 warnings in the Wireless. My plan is to work through all of them over the next few weeks. Hopefully it won't be too long before
drivers/net/wirelessbuilds clean with W=1 enabled.
BTW, now the patches are in random order and it's quite annoying to review when there's no logic. Grouping them by the driver would be a lot more pleasent for reviewers.
Signature · 1 line
https://wireless.wiki.kernel.org/en/developers/documentation/submittingpatches
Quoted 6 lines · Kalle Valo
Quoted 4 lines · Lee Jones
This set is part of a larger effort attempting to clean-up W=1 kernel builds, which are currently overwhelmingly riddled with niggly little warnings.
Quoted 8 lines
Quoted 4 lines
There are quite a few W=1 warnings in the Wireless. My plan is to work through all of them over the next few weeks. Hopefully it won't be too long before
drivers/net/wirelessbuilds clean with W=1 enabled.BTW, now the patches are in random order and it's quite annoying to review when there's no logic. Grouping them by the driver would be a lot more pleasent for reviewers.
My script makes a best effort attempt to group changes by file. It takes the first warning presented by the compiler then greps the output for all issues pertaining to that file. I then split the patch by issue (i.e. different patches for; kernel-doc, unused variables, bracketing etc).
One issue you might be seeing is the potential for one fixed issue to cause another i.e. when one unused variable is removed which was the only user of another, leading to a subsequent fix of the newly unused variable.
Other than that, I'm not sure why they would end up out of order.
Signature · 4 lines
Lee Jones [李琼斯] Senior Technical Lead - Developer Services Linaro.org │ Open source software for Arm SoCs Follow Linaro: Facebook | Twitter | Blog