| From ef15d375e1c6356df9f6c238ce8d0f7f84768898 Mon Sep 17 00:00:00 2001 |
| From: Sasha Levin <sashal@kernel.org> |
| Date: Sun, 16 Nov 2025 18:03:03 -0800 |
| Subject: wifi: ath9k: debug.h: fix kernel-doc bad lines and struct |
| ath_tx_stats |
| MIME-Version: 1.0 |
| Content-Type: text/plain; charset=UTF-8 |
| Content-Transfer-Encoding: 8bit |
| |
| From: Randy Dunlap <rdunlap@infradead.org> |
| |
| [ Upstream commit c6131765a2c0052b2c5a2310ff92191ff33aec8b ] |
| |
| Repair "bad line" warnings by starting each line with " *". |
| Add or correct kernel-doc entries for missing struct members in |
| struct ath_tx_stats. |
| |
| Warning: ../drivers/net/wireless/ath/ath9k/debug.h:144 bad line: |
| may have had errors. |
| Warning: ../drivers/net/wireless/ath/ath9k/debug.h:146 bad line: |
| may have had errors. |
| Warning: ../drivers/net/wireless/ath/ath9k/debug.h:156 bad line: |
| Valid only for: |
| Warning: ../drivers/net/wireless/ath/ath9k/debug.h:157 bad line: |
| - non-aggregate condition. |
| Warning: ../drivers/net/wireless/ath/ath9k/debug.h:158 bad line: |
| - first packet of aggregate. |
| Warning: drivers/net/wireless/ath/ath9k/debug.h:191 struct member |
| 'xretries' not described in 'ath_tx_stats' |
| Warning: drivers/net/wireless/ath/ath9k/debug.h:191 struct member |
| 'data_underrun' not described in 'ath_tx_stats' |
| Warning: drivers/net/wireless/ath/ath9k/debug.h:191 struct member |
| 'delim_underrun' not described in 'ath_tx_stats' |
| |
| Fixes: 99c15bf575b1 ("ath9k: Report total tx/rx bytes and packets in debugfs.") |
| Fixes: fec247c0d5bf ("ath9k: Add debug counters for TX") |
| Fixes: 5a6f78afdabe ("ath9k: show excessive-retry MPDUs in debugfs") |
| Signed-off-by: Randy Dunlap <rdunlap@infradead.org> |
| Acked-by: Toke Høiland-Jørgensen <toke@toke.dk> |
| Link: https://patch.msgid.link/20251117020304.448687-1-rdunlap@infradead.org |
| Signed-off-by: Jeff Johnson <jeff.johnson@oss.qualcomm.com> |
| Signed-off-by: Sasha Levin <sashal@kernel.org> |
| --- |
| drivers/net/wireless/ath/ath9k/debug.h | 15 ++++++++------- |
| 1 file changed, 8 insertions(+), 7 deletions(-) |
| |
| diff --git a/drivers/net/wireless/ath/ath9k/debug.h b/drivers/net/wireless/ath/ath9k/debug.h |
| index cb3e75969875a..804e2a0a0c20f 100644 |
| --- a/drivers/net/wireless/ath/ath9k/debug.h |
| +++ b/drivers/net/wireless/ath/ath9k/debug.h |
| @@ -142,11 +142,12 @@ struct ath_interrupt_stats { |
| /** |
| * struct ath_tx_stats - Statistics about TX |
| * @tx_pkts_all: No. of total frames transmitted, including ones that |
| - may have had errors. |
| + * may have had errors. |
| * @tx_bytes_all: No. of total bytes transmitted, including ones that |
| - may have had errors. |
| + * may have had errors. |
| * @queued: Total MPDUs (non-aggr) queued |
| * @completed: Total MPDUs (non-aggr) completed |
| + * @xretries: Total MPDUs with xretries |
| * @a_aggr: Total no. of aggregates queued |
| * @a_queued_hw: Total AMPDUs queued to hardware |
| * @a_completed: Total AMPDUs completed |
| @@ -154,14 +155,14 @@ struct ath_interrupt_stats { |
| * @a_xretries: No. of AMPDUs dropped due to xretries |
| * @txerr_filtered: No. of frames with TXERR_FILT flag set. |
| * @fifo_underrun: FIFO underrun occurrences |
| - Valid only for: |
| - - non-aggregate condition. |
| - - first packet of aggregate. |
| + * Valid only for: |
| + * - non-aggregate condition. |
| + * - first packet of aggregate. |
| * @xtxop: No. of frames filtered because of TXOP limit |
| * @timer_exp: Transmit timer expiry |
| * @desc_cfg_err: Descriptor configuration errors |
| - * @data_urn: TX data underrun errors |
| - * @delim_urn: TX delimiter underrun errors |
| + * @data_underrun: TX data underrun errors |
| + * @delim_underrun: TX delimiter underrun errors |
| * @puttxbuf: Number of times hardware was given txbuf to write. |
| * @txstart: Number of times hardware was told to start tx. |
| * @txprocdesc: Number of times tx descriptor was processed |
| -- |
| 2.51.0 |
| |
