wifi: iwlwifi: api: fix kernel-doc links

Some of the kernel-doc links are outdated due to other
changes, fix that.

Signed-off-by: Johannes Berg <johannes.berg@intel.com>
Signed-off-by: Gregory Greenman <gregory.greenman@intel.com>
Link: https://lore.kernel.org/r/20230601171633.85e2cf489893.Ie3889ea6f755b80c988543ccca56c67420c51b1f@changeid
Signed-off-by: Johannes Berg <johannes.berg@intel.com>

diff --git a/drivers/net/wireless/intel/iwlwifi/fw/api/commands.h b/drivers/net/wireless/intel/iwlwifi/fw/api/commands.h
index 78d3cca..13cb0d5 100644 (file)
--- a/drivers/net/wireless/intel/iwlwifi/fw/api/commands.h
+++ b/drivers/net/wireless/intel/iwlwifi/fw/api/commands.h
@@ -555,18 +555,22 @@ enum iwl_legacy_cmds {
        WOWLAN_TKIP_PARAM = 0xe3,
 
        /**
-        * @WOWLAN_KEK_KCK_MATERIAL: &struct iwl_wowlan_kek_kck_material_cmd
+        * @WOWLAN_KEK_KCK_MATERIAL: &struct iwl_wowlan_kek_kck_material_cmd_v2,
+        * &struct iwl_wowlan_kek_kck_material_cmd_v3 or
+        * &struct iwl_wowlan_kek_kck_material_cmd_v4
         */
        WOWLAN_KEK_KCK_MATERIAL = 0xe4,
 
        /**
-        * @WOWLAN_GET_STATUSES: response in &struct iwl_wowlan_status
+        * @WOWLAN_GET_STATUSES: response in &struct iwl_wowlan_status_v6,
+        *      &struct iwl_wowlan_status_v7, &struct iwl_wowlan_status_v9 or
+        *      &struct iwl_wowlan_status_v12
         */
        WOWLAN_GET_STATUSES = 0xe5,
 
        /**
-        * @SCAN_OFFLOAD_PROFILES_QUERY_CMD:
-        * No command data, response is &struct iwl_scan_offload_profiles_query
+        * @SCAN_OFFLOAD_PROFILES_QUERY_CMD: No command data, response is
+        *      &struct iwl_scan_offload_profiles_query_v1
         */
        SCAN_OFFLOAD_PROFILES_QUERY_CMD = 0x56,
 };

diff --git a/drivers/net/wireless/intel/iwlwifi/fw/api/datapath.h b/drivers/net/wireless/intel/iwlwifi/fw/api/datapath.h
index 6f59381..751b596 100644 (file)
--- a/drivers/net/wireless/intel/iwlwifi/fw/api/datapath.h
+++ b/drivers/net/wireless/intel/iwlwifi/fw/api/datapath.h
@@ -38,7 +38,9 @@ enum iwl_data_path_subcmd_ids {
        WNM_80211V_TIMING_MEASUREMENT_CONFIG_CMD = 0x4,
 
        /**
-        * @STA_HE_CTXT_CMD: &struct iwl_he_sta_context_cmd
+        * @STA_HE_CTXT_CMD: &struct iwl_he_sta_context_cmd_v1,
+        *      &struct iwl_he_sta_context_cmd_v2 or
+        *      &struct iwl_he_sta_context_cmd_v3
         */
        STA_HE_CTXT_CMD = 0x7,
 
@@ -447,7 +449,7 @@ struct iwl_sad_properties {
  * @phy_id: PHY index
  * @rlc: RLC properties, &struct iwl_rlc_properties
  * @sad: SAD (single antenna diversity) options, &struct iwl_sad_properties
- * @flags: flags, &enum iwl_rlc_flags
+ * @flags: flags (unused)
  * @reserved: reserved
  */
 struct iwl_rlc_config_cmd {

diff --git a/drivers/net/wireless/intel/iwlwifi/fw/api/location.h b/drivers/net/wireless/intel/iwlwifi/fw/api/location.h
index 12af94e..b044990 100644 (file)
--- a/drivers/net/wireless/intel/iwlwifi/fw/api/location.h
+++ b/drivers/net/wireless/intel/iwlwifi/fw/api/location.h
@@ -1,7 +1,7 @@
 /* SPDX-License-Identifier: GPL-2.0 OR BSD-3-Clause */
 /*
  * Copyright (C) 2015-2017 Intel Deutschland GmbH
- * Copyright (C) 2018-2021 Intel Corporation
+ * Copyright (C) 2018-2022 Intel Corporation
  */
 #ifndef __iwl_fw_api_location_h__
 #define __iwl_fw_api_location_h__
@@ -35,8 +35,11 @@ enum iwl_location_subcmd_ids {
         */
        TOF_RANGE_REQ_EXT_CMD = 0x3,
        /**
-        * @TOF_RESPONDER_CONFIG_CMD: FTM responder configuration,
-        *      uses &struct iwl_tof_responder_config_cmd
+        * @TOF_RESPONDER_CONFIG_CMD: FTM responder configuration, one of
+        *      &struct iwl_tof_responder_config_cmd_v6,
+        *      &struct iwl_tof_responder_config_cmd_v7,
+        *      &struct iwl_tof_responder_config_cmd_v8 or
+        *      &struct iwl_tof_responder_config_cmd_v9
         */
        TOF_RESPONDER_CONFIG_CMD = 0x4,
        /**
@@ -69,8 +72,11 @@ enum iwl_location_subcmd_ids {
         */
        TOF_MCSI_DEBUG_NOTIF = 0xFE,
        /**
-        * @TOF_RANGE_RESPONSE_NOTIF: ranging response, using
-        *      &struct iwl_tof_range_rsp_ntfy
+        * @TOF_RANGE_RESPONSE_NOTIF: ranging response, using one of
+        *      &struct iwl_tof_range_rsp_ntfy_v5,
+        *      &struct iwl_tof_range_rsp_ntfy_v6,
+        *      &struct iwl_tof_range_rsp_ntfy_v7 or
+        *      &struct iwl_tof_range_rsp_ntfy_v8
         */
        TOF_RANGE_RESPONSE_NOTIF = 0xFF,
 };

diff --git a/drivers/net/wireless/intel/iwlwifi/fw/api/nvm-reg.h b/drivers/net/wireless/intel/iwlwifi/fw/api/nvm-reg.h
index 635e4dd..28bfabb 100644 (file)
--- a/drivers/net/wireless/intel/iwlwifi/fw/api/nvm-reg.h
+++ b/drivers/net/wireless/intel/iwlwifi/fw/api/nvm-reg.h
@@ -17,7 +17,12 @@ enum iwl_regulatory_and_nvm_subcmd_ids {
        NVM_ACCESS_COMPLETE = 0x0,
 
        /**
-        * @LARI_CONFIG_CHANGE: &struct iwl_lari_config_change_cmd
+        * @LARI_CONFIG_CHANGE: &struct iwl_lari_config_change_cmd_v1,
+        *      &struct iwl_lari_config_change_cmd_v2,
+        *      &struct iwl_lari_config_change_cmd_v3,
+        *      &struct iwl_lari_config_change_cmd_v4,
+        *      &struct iwl_lari_config_change_cmd_v5 or
+        *      &struct iwl_lari_config_change_cmd_v6
         */
        LARI_CONFIG_CHANGE = 0x1,
 
@@ -29,12 +34,12 @@ enum iwl_regulatory_and_nvm_subcmd_ids {
        NVM_GET_INFO = 0x2,
 
        /**
-        * @TAS_CONFIG: &struct iwl_tas_config_cmd
+        * @TAS_CONFIG: &union iwl_tas_config_cmd
         */
        TAS_CONFIG = 0x3,
 
        /**
-        * @SAR_OFFSET_MAPPING_TABLE_CMD: &iwl_sar_offset_mapping_cmd
+        * @SAR_OFFSET_MAPPING_TABLE_CMD: &struct iwl_sar_offset_mapping_cmd
         */
        SAR_OFFSET_MAPPING_TABLE_CMD = 0x4,
 

diff --git a/drivers/net/wireless/intel/iwlwifi/fw/api/offload.h b/drivers/net/wireless/intel/iwlwifi/fw/api/offload.h
index a0123f8..898bf35 100644 (file)
--- a/drivers/net/wireless/intel/iwlwifi/fw/api/offload.h
+++ b/drivers/net/wireless/intel/iwlwifi/fw/api/offload.h
@@ -28,7 +28,8 @@ enum iwl_prot_offload_subcmd_ids {
        D3_END_NOTIFICATION = 0xFE,
 
        /**
-        * @STORED_BEACON_NTF: &struct iwl_stored_beacon_notif
+        * @STORED_BEACON_NTF: &struct iwl_stored_beacon_notif_v2 or
+        *      &struct iwl_stored_beacon_notif_v3
         */
        STORED_BEACON_NTF = 0xFF,
 };

diff --git a/drivers/net/wireless/intel/iwlwifi/fw/api/phy.h b/drivers/net/wireless/intel/iwlwifi/fw/api/phy.h
index b1b9c29..5a3f30e 100644 (file)
--- a/drivers/net/wireless/intel/iwlwifi/fw/api/phy.h
+++ b/drivers/net/wireless/intel/iwlwifi/fw/api/phy.h
@@ -1,6 +1,6 @@
 /* SPDX-License-Identifier: GPL-2.0 OR BSD-3-Clause */
 /*
- * Copyright (C) 2012-2014, 2019-2021 Intel Corporation
+ * Copyright (C) 2012-2014, 2019-2022 Intel Corporation
  * Copyright (C) 2013-2015 Intel Mobile Communications GmbH
  * Copyright (C) 2016-2017 Intel Deutschland GmbH
  */
@@ -29,12 +29,16 @@ enum iwl_phy_ops_subcmd_ids {
        TEMP_REPORTING_THRESHOLDS_CMD = 0x04,
 
        /**
-        * @PER_CHAIN_LIMIT_OFFSET_CMD: &struct iwl_geo_tx_power_profiles_cmd
+        * @PER_CHAIN_LIMIT_OFFSET_CMD: &struct iwl_geo_tx_power_profiles_cmd_v1,
+        * &struct iwl_geo_tx_power_profiles_cmd_v2,
+        * &struct iwl_geo_tx_power_profiles_cmd_v3,
+        * &struct iwl_geo_tx_power_profiles_cmd_v4 or
+        * &struct iwl_geo_tx_power_profiles_cmd_v5
         */
        PER_CHAIN_LIMIT_OFFSET_CMD = 0x05,
 
        /**
-        * @PER_PLATFORM_ANT_GAIN_CMD: &struct iwl_ppag_table_cmd
+        * @PER_PLATFORM_ANT_GAIN_CMD: &union iwl_ppag_table_cmd
         */
        PER_PLATFORM_ANT_GAIN_CMD = 0x07,