[PATCH] wifi: mac80211: Fix beacon, TXQ and RX OMI kernel-doc references
From: Karl Mehltretter
Date: Fri Sep 11 2026 - 19:00:53 EST
Several mac80211 kernel-doc comments misspell the functions they
describe. Refer to ieee80211_beacon_cntdwn_is_complete() for countdown
completion, ieee80211_next_txq() in the transmit queue scheduling
documentation, and ieee80211_prepare_rx_omi_bw() in the receive
bandwidth finalization documentation.
These corrections make the references match the existing APIs.
Fixes: 8552a434b6a0 ("mac80211: rename csa counters to countdown counters")
Fixes: da7f40c05c16 ("wifi: mac80211: add some support for RX OMI power saving")
Fixes: b4809e9484da ("mac80211: Add airtime accounting and scheduling to TXQs")
Assisted-by: LLM
Signed-off-by: Karl Mehltretter <kmehltretter@xxxxxxxxx>
---
include/net/mac80211.h | 6 +++---
1 file changed, 3 insertions(+), 3 deletions(-)
diff --git a/include/net/mac80211.h b/include/net/mac80211.h
index 9d1fac6e808298e068bd819897cc7cabee3fc2b8..e8d35f431a1bcb0779fac9aebd6a6f7f4ba9ac2d 100644
--- a/include/net/mac80211.h
+++ b/include/net/mac80211.h
@@ -4594,7 +4594,7 @@ struct ieee80211_prep_tx_info {
* decremented, and when they reach 1 the driver must call
* ieee80211_csa_finish(). Drivers which use ieee80211_beacon_get()
* get the csa counter decremented by mac80211, but must check if it is
- * 1 using ieee80211_beacon_counter_is_complete() after the beacon has been
+ * 1 using ieee80211_beacon_cntdwn_is_complete() after the beacon has been
* transmitted and then call ieee80211_csa_finish().
* If the CSA count starts as zero or 1, this function will not be called,
* since there won't be any time to beacon before the switch anyway.
@@ -7874,7 +7874,7 @@ ieee80211_return_txq(struct ieee80211_hw *hw, struct ieee80211_txq *txq,
* This function is used to check whether given txq is allowed to transmit by
* the airtime scheduler, and can be used by drivers to access the airtime
* fairness accounting without using the scheduling order enforced by
- * next_txq().
+ * ieee80211_next_txq().
*
* Returns %true if the airtime scheduler thinks the TXQ should be allowed to
* transmit, and %false if it should be throttled. This function can also have
@@ -8195,7 +8195,7 @@ bool ieee80211_prepare_rx_omi_bw(struct ieee80211_link_sta *link_sta,
* ieee80211_finalize_rx_omi_bw - finalize BW RX OMI update
* @link_sta: the link STA the OMI was sent to
*
- * See ieee80211_client_prepare_rx_omi_bw(). Context is the same here
+ * See ieee80211_prepare_rx_omi_bw(). Context is the same here
* as well.
*/
void ieee80211_finalize_rx_omi_bw(struct ieee80211_link_sta *link_sta);
--
2.39.5 (Apple Git-154)