From nobody Fri Sep 25 13:17:00 2026 Received: from mail-wr1-f52.google.com (mail-wr1-f52.google.com [209.85.221.52]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 859D13D3336 for ; Fri, 11 Sep 2026 22:55:05 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.221.52 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1789167307; cv=none; b=nUbRbtDXfs+/vgHCm7wMO0G7GVOeL2ipc1IJDEptJ/sX38c4wXL+FU5BlQJUS5+yzPSnZRu8C6kQH999OG8w5Y44A0iUwVF7mc0nQXme8bs1JVDc7/PaNgj1YdJhOcsJOIbjJCllvYwb3qJZVC1lzTN+5eCCEH4MmfPmIjXPEcg= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1789167307; c=relaxed/simple; bh=ygmd3j6naMUaRn4wqyNNGRB13xqTwwz24n2v15rlARI=; h=From:To:Cc:Subject:Date:Message-Id:MIME-Version; b=M8a67eJzq6woORN3etQVRAy7q7X9/9C0sGGODAWjLRr5FgjnuLsxSJemgEhoLW+2gl/FU9XbwojD4ovwVl8XCR587rE/zpqdtzIeDpdwM6lXhuUgoS4F0PZu9rAYY2FuES77zGqlqCk/5plzN6yK0hRH5QyThlIa5fD9MIDZj3w= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=MBRsWiCm; arc=none smtp.client-ip=209.85.221.52 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="MBRsWiCm" Received: by mail-wr1-f52.google.com with SMTP id ffacd0b85a97d-482dd6ee390so1270558f8f.3 for ; Fri, 11 Sep 2026 15:55:05 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20251104; t=1789167304; x=1789772104; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:from:to:cc:subject:date:message-id:reply-to:content-type; bh=/9BcpZ28ZB9TTbclwwCoyiL9EEzb27cEjQfU6Vw/HG0=; b=MBRsWiCmi0fEj7OSTp4/UNjzV4KHQaG2fULn4mueB+4HBo1napOnWGNttx0e1FzMUU pf0C/A+lS42pNVAk0OOSUCkF3JOshtCDNaRAfcfJdHxlYbLTWs8tUuDKOGNW+/pbh1i+ AgSP3L1bPWMdOq2t9iLdHPnmo699qmu5s5FJTUjsqS2tW3WGcnLhpBntssyaAJDCrBwx +n25l8b/ZU4CKg0j6MOzTgxW0+MtzKJiyz1PBsXmocfvKrPE2BrEgS0g/4d8iWDIlLii VvaLiCwOa/mTw5vhfmAy5RNfffJ9RR6BZ+xk2OTGBYKjrtAdS/Kqv+WpCXIdeqEbZn/4 4DNA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1789167304; x=1789772104; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:x-gm-gg:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to:content-type; bh=/9BcpZ28ZB9TTbclwwCoyiL9EEzb27cEjQfU6Vw/HG0=; b=oGED6Zbw7rqPG2ws0RaoDEOtV18U9iJ340NKG+dIU/oHN2ljT0lCLJ0rs2Fei06ccn EOeRvO8VlRLaLN8I1EMyocde9MTLWspVrObowE6iUPEa4XogxLlTEIqbCYUXgw4JdRov NvXy95tKD3Fpz9IHzAYoBLAYvC2SigcUUG6yGMFgeih5LN9x2ocK9au3AsMp1/1QkiOJ hTtOYzZEC6U/JNo03qNswBOio6Jbg1FSlZ5qCM4G7tvEUeGLOJN3TjbB8UDsPy9NaKau FqBpYTngAVuBZQ7OP/2MywWJnTk/R5y/qba6z7k7k8rdooGs++6nw+D/HXFW+jTGFumy CJEQ== X-Forwarded-Encrypted: i=1; AKwUvBwBMzmn+H0otsWjTBG/MZnkCccatA6i3V2Y21XzAIsdgTtrn/xZ5PxmkaUCFDW+2BjLlMNPAycgOfdkeZ0=@vger.kernel.org X-Gm-Message-State: AFuF++nXnCUXK3nMwOVsCIILGY+v2hEfbq3J8yMPjMcG6B6K1FjtVy6n U2/5ujnNAR2khSnRW4wlrM3YSvPdNa0oo/4okygyTmjZyl1f5Xgm99Ow X-Gm-Gg: AYBFou3jeSE3T2isvApP9d7Olmwd/eASSDSqrQFxNBU3SNRlQOSBWOt87Kzzv1R9cG0 dwC2WbynDtMtYQo/gW/SZSQcBTsITLOtu9nZR/j1V161HZvv+noBpZ9c+PHRPY4kahqGxfLeqr4 6uUX2sbYJmsnexGHlL446Ej5UUt/ewmL2OOlGvWUnPFk8+HKiNLvaaQ7wgNPdZYXNJubX6Dg+BO 6E8Wl2vlFWUelU2PTgHlul9PUOxZ/kOcMt1RI95SGkJ/lNQtd7m2mLLHUXX810TXyKxy6MTaUo6 deYPUW2VXOwbfgiF3rhZl7F/neGmbKfI5JpD4ReS6QXJHaTjq/Ok9Qjx/GRDFkALUjY+FiJD1Rn N8cdO6JGfHFSXNbr9Cc94N1emEmClgcfFRBLii5fkQAlp6EjLx57pYyk3+ly6KdwLqlycA12NEW nP5vOqzFz4N6YdJnzp6vJR3jeLFMp6drSnlheEE0VXE61PNgzLOlUivbzhUXABD4qs3AmATJDe1 pQ4a93Q0un8b0i0gKc/kXzuNkz2WpntXBO25KLyXg6pFhQ9CBJ6e2f8vsHOsDchxMf5DNlHQXR3 /AL5e/E1ELFGK8/YlHhiu6XOckPg5LedEp6z X-Received: by 2002:a05:6000:288e:b0:485:8c16:a33f with SMTP id ffacd0b85a97d-486eb350ca0mr7180318f8f.52.1789167303720; Fri, 11 Sep 2026 15:55:03 -0700 (PDT) Received: from localhost.localdomain (dynamic-095-114-033-154.95.114.pool.telefonica.de. [95.114.33.154]) by smtp.gmail.com with ESMTPSA id ffacd0b85a97d-486eb35c071sm9075331f8f.33.2026.09.11.15.55.01 (version=TLS1_3 cipher=TLS_CHACHA20_POLY1305_SHA256 bits=256/256); Fri, 11 Sep 2026 15:55:03 -0700 (PDT) From: Karl Mehltretter To: Johannes Berg Cc: Karl Mehltretter , John Crispin , =?utf-8?q?Toke_H=C3=B8iland-J=C3=B8rgensen?= , Miri Korenblit , linux-wireless@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [PATCH] wifi: mac80211: Fix beacon, TXQ and RX OMI kernel-doc references Date: Sat, 12 Sep 2026 00:53:42 +0200 Message-Id: <20260911225342.11342-1-kmehltretter@gmail.com> X-Mailer: git-send-email 2.39.5 (Apple Git-154) Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" 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 sav= ing") Fixes: b4809e9484da ("mac80211: Add airtime accounting and scheduling to TX= Qs") Assisted-by: LLM Signed-off-by: Karl Mehltretter --- 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..e8d35f431a1bcb0779fac9aebd6= a6f7f4ba9ac2d 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_lin= k_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); --=20 2.39.5 (Apple Git-154)