1 // SPDX-License-Identifier: GPL-2.0-only
3 * mac80211 debugfs for wireless PHYs
5 * Copyright 2007 Johannes Berg <johannes@sipsolutions.net>
6 * Copyright 2013-2014 Intel Mobile Communications GmbH
7 * Copyright (C) 2018 - 2019, 2021-2024 Intel Corporation
10 #include <linux/debugfs.h>
11 #include <linux/rtnetlink.h>
12 #include <linux/vmalloc.h>
13 #include "ieee80211_i.h"
14 #include "driver-ops.h"
18 #define DEBUGFS_FORMAT_BUFFER_SIZE 100
20 int mac80211_format_buffer(char __user
*userbuf
, size_t count
,
21 loff_t
*ppos
, char *fmt
, ...)
24 char buf
[DEBUGFS_FORMAT_BUFFER_SIZE
];
28 res
= vscnprintf(buf
, sizeof(buf
), fmt
, args
);
31 return simple_read_from_buffer(userbuf
, count
, ppos
, buf
, res
);
34 #define DEBUGFS_READONLY_FILE_FN(name, fmt, value...) \
35 static ssize_t name## _read(struct file *file, char __user *userbuf, \
36 size_t count, loff_t *ppos) \
38 struct ieee80211_local *local = file->private_data; \
40 return mac80211_format_buffer(userbuf, count, ppos, \
44 #define DEBUGFS_READONLY_FILE_OPS(name) \
45 static const struct debugfs_short_fops name## _ops = { \
46 .read = name## _read, \
47 .llseek = generic_file_llseek, \
50 #define DEBUGFS_READONLY_FILE(name, fmt, value...) \
51 DEBUGFS_READONLY_FILE_FN(name, fmt, value) \
52 DEBUGFS_READONLY_FILE_OPS(name)
54 #define DEBUGFS_ADD(name) \
55 debugfs_create_file(#name, 0400, phyd, local, &name## _ops)
57 #define DEBUGFS_ADD_MODE(name, mode) \
58 debugfs_create_file(#name, mode, phyd, local, &name## _ops);
61 DEBUGFS_READONLY_FILE(hw_conf
, "%x",
62 local
->hw
.conf
.flags
);
63 DEBUGFS_READONLY_FILE(user_power
, "%d",
64 local
->user_power_level
);
65 DEBUGFS_READONLY_FILE(power
, "%d",
66 local
->hw
.conf
.power_level
);
67 DEBUGFS_READONLY_FILE(total_ps_buffered
, "%d",
68 local
->total_ps_buffered
);
69 DEBUGFS_READONLY_FILE(wep_iv
, "%#08x",
70 local
->wep_iv
& 0xffffff);
71 DEBUGFS_READONLY_FILE(rate_ctrl_alg
, "%s",
72 local
->rate_ctrl
? local
->rate_ctrl
->ops
->name
: "hw/driver");
74 static ssize_t
aqm_read(struct file
*file
,
75 char __user
*user_buf
,
79 struct ieee80211_local
*local
= file
->private_data
;
80 struct fq
*fq
= &local
->fq
;
84 spin_lock_bh(&local
->fq
.lock
);
87 len
= scnprintf(buf
, sizeof(buf
),
92 "R fq_overmemory %u\n"
93 "R fq_collisions %u\n"
94 "R fq_memory_usage %u\n"
95 "RW fq_memory_limit %u\n"
109 spin_unlock_bh(&local
->fq
.lock
);
111 return simple_read_from_buffer(user_buf
, count
, ppos
,
115 static ssize_t
aqm_write(struct file
*file
,
116 const char __user
*user_buf
,
120 struct ieee80211_local
*local
= file
->private_data
;
123 if (count
>= sizeof(buf
))
126 if (copy_from_user(buf
, user_buf
, count
))
129 if (count
&& buf
[count
- 1] == '\n')
130 buf
[count
- 1] = '\0';
134 if (sscanf(buf
, "fq_limit %u", &local
->fq
.limit
) == 1)
136 else if (sscanf(buf
, "fq_memory_limit %u", &local
->fq
.memory_limit
) == 1)
138 else if (sscanf(buf
, "fq_quantum %u", &local
->fq
.quantum
) == 1)
144 static const struct debugfs_short_fops aqm_ops
= {
147 .llseek
= default_llseek
,
150 static ssize_t
airtime_flags_read(struct file
*file
,
151 char __user
*user_buf
,
152 size_t count
, loff_t
*ppos
)
154 struct ieee80211_local
*local
= file
->private_data
;
155 char buf
[128] = {}, *pos
, *end
;
158 end
= pos
+ sizeof(buf
) - 1;
160 if (local
->airtime_flags
& AIRTIME_USE_TX
)
161 pos
+= scnprintf(pos
, end
- pos
, "AIRTIME_TX\t(%lx)\n",
163 if (local
->airtime_flags
& AIRTIME_USE_RX
)
164 pos
+= scnprintf(pos
, end
- pos
, "AIRTIME_RX\t(%lx)\n",
167 return simple_read_from_buffer(user_buf
, count
, ppos
, buf
,
171 static ssize_t
airtime_flags_write(struct file
*file
,
172 const char __user
*user_buf
,
173 size_t count
, loff_t
*ppos
)
175 struct ieee80211_local
*local
= file
->private_data
;
178 if (count
>= sizeof(buf
))
181 if (copy_from_user(buf
, user_buf
, count
))
184 if (count
&& buf
[count
- 1] == '\n')
185 buf
[count
- 1] = '\0';
189 if (kstrtou16(buf
, 0, &local
->airtime_flags
))
195 static const struct debugfs_short_fops airtime_flags_ops
= {
196 .write
= airtime_flags_write
,
197 .read
= airtime_flags_read
,
198 .llseek
= default_llseek
,
201 static ssize_t
aql_pending_read(struct file
*file
,
202 char __user
*user_buf
,
203 size_t count
, loff_t
*ppos
)
205 struct ieee80211_local
*local
= file
->private_data
;
209 len
= scnprintf(buf
, sizeof(buf
),
216 atomic_read(&local
->aql_ac_pending_airtime
[IEEE80211_AC_VO
]),
217 atomic_read(&local
->aql_ac_pending_airtime
[IEEE80211_AC_VI
]),
218 atomic_read(&local
->aql_ac_pending_airtime
[IEEE80211_AC_BE
]),
219 atomic_read(&local
->aql_ac_pending_airtime
[IEEE80211_AC_BK
]),
220 atomic_read(&local
->aql_total_pending_airtime
));
221 return simple_read_from_buffer(user_buf
, count
, ppos
,
225 static const struct debugfs_short_fops aql_pending_ops
= {
226 .read
= aql_pending_read
,
227 .llseek
= default_llseek
,
230 static ssize_t
aql_txq_limit_read(struct file
*file
,
231 char __user
*user_buf
,
235 struct ieee80211_local
*local
= file
->private_data
;
239 len
= scnprintf(buf
, sizeof(buf
),
240 "AC AQL limit low AQL limit high\n"
245 local
->aql_txq_limit_low
[IEEE80211_AC_VO
],
246 local
->aql_txq_limit_high
[IEEE80211_AC_VO
],
247 local
->aql_txq_limit_low
[IEEE80211_AC_VI
],
248 local
->aql_txq_limit_high
[IEEE80211_AC_VI
],
249 local
->aql_txq_limit_low
[IEEE80211_AC_BE
],
250 local
->aql_txq_limit_high
[IEEE80211_AC_BE
],
251 local
->aql_txq_limit_low
[IEEE80211_AC_BK
],
252 local
->aql_txq_limit_high
[IEEE80211_AC_BK
]);
253 return simple_read_from_buffer(user_buf
, count
, ppos
,
257 static ssize_t
aql_txq_limit_write(struct file
*file
,
258 const char __user
*user_buf
,
262 struct ieee80211_local
*local
= file
->private_data
;
264 u32 ac
, q_limit_low
, q_limit_high
, q_limit_low_old
, q_limit_high_old
;
265 struct sta_info
*sta
;
267 if (count
>= sizeof(buf
))
270 if (copy_from_user(buf
, user_buf
, count
))
273 if (count
&& buf
[count
- 1] == '\n')
274 buf
[count
- 1] = '\0';
278 if (sscanf(buf
, "%u %u %u", &ac
, &q_limit_low
, &q_limit_high
) != 3)
281 if (ac
>= IEEE80211_NUM_ACS
)
284 q_limit_low_old
= local
->aql_txq_limit_low
[ac
];
285 q_limit_high_old
= local
->aql_txq_limit_high
[ac
];
287 wiphy_lock(local
->hw
.wiphy
);
288 local
->aql_txq_limit_low
[ac
] = q_limit_low
;
289 local
->aql_txq_limit_high
[ac
] = q_limit_high
;
291 list_for_each_entry(sta
, &local
->sta_list
, list
) {
292 /* If a sta has customized queue limits, keep it */
293 if (sta
->airtime
[ac
].aql_limit_low
== q_limit_low_old
&&
294 sta
->airtime
[ac
].aql_limit_high
== q_limit_high_old
) {
295 sta
->airtime
[ac
].aql_limit_low
= q_limit_low
;
296 sta
->airtime
[ac
].aql_limit_high
= q_limit_high
;
299 wiphy_unlock(local
->hw
.wiphy
);
304 static const struct debugfs_short_fops aql_txq_limit_ops
= {
305 .write
= aql_txq_limit_write
,
306 .read
= aql_txq_limit_read
,
307 .llseek
= default_llseek
,
310 static ssize_t
aql_enable_read(struct file
*file
, char __user
*user_buf
,
311 size_t count
, loff_t
*ppos
)
316 len
= scnprintf(buf
, sizeof(buf
), "%d\n",
317 !static_key_false(&aql_disable
.key
));
319 return simple_read_from_buffer(user_buf
, count
, ppos
, buf
, len
);
322 static ssize_t
aql_enable_write(struct file
*file
, const char __user
*user_buf
,
323 size_t count
, loff_t
*ppos
)
325 bool aql_disabled
= static_key_false(&aql_disable
.key
);
329 if (count
> sizeof(buf
))
332 if (copy_from_user(buf
, user_buf
, count
))
335 buf
[sizeof(buf
) - 1] = '\0';
337 if (len
> 0 && buf
[len
- 1] == '\n')
340 if (buf
[0] == '0' && buf
[1] == '\0') {
342 static_branch_inc(&aql_disable
);
343 } else if (buf
[0] == '1' && buf
[1] == '\0') {
345 static_branch_dec(&aql_disable
);
353 static const struct debugfs_short_fops aql_enable_ops
= {
354 .write
= aql_enable_write
,
355 .read
= aql_enable_read
,
356 .llseek
= default_llseek
,
359 static ssize_t
force_tx_status_read(struct file
*file
,
360 char __user
*user_buf
,
364 struct ieee80211_local
*local
= file
->private_data
;
368 len
= scnprintf(buf
, sizeof(buf
), "%d\n", (int)local
->force_tx_status
);
370 return simple_read_from_buffer(user_buf
, count
, ppos
,
374 static ssize_t
force_tx_status_write(struct file
*file
,
375 const char __user
*user_buf
,
379 struct ieee80211_local
*local
= file
->private_data
;
382 if (count
>= sizeof(buf
))
385 if (copy_from_user(buf
, user_buf
, count
))
388 if (count
&& buf
[count
- 1] == '\n')
389 buf
[count
- 1] = '\0';
393 if (buf
[0] == '0' && buf
[1] == '\0')
394 local
->force_tx_status
= 0;
395 else if (buf
[0] == '1' && buf
[1] == '\0')
396 local
->force_tx_status
= 1;
403 static const struct debugfs_short_fops force_tx_status_ops
= {
404 .write
= force_tx_status_write
,
405 .read
= force_tx_status_read
,
406 .llseek
= default_llseek
,
410 static ssize_t
reset_write(struct file
*file
, const char __user
*user_buf
,
411 size_t count
, loff_t
*ppos
)
413 struct ieee80211_local
*local
= file
->private_data
;
417 wiphy_lock(local
->hw
.wiphy
);
418 __ieee80211_suspend(&local
->hw
, NULL
);
419 ret
= __ieee80211_resume(&local
->hw
);
420 wiphy_unlock(local
->hw
.wiphy
);
423 cfg80211_shutdown_all_interfaces(local
->hw
.wiphy
);
430 static const struct debugfs_short_fops reset_ops
= {
431 .write
= reset_write
,
432 .llseek
= noop_llseek
,
436 static const char *hw_flag_names
[] = {
437 #define FLAG(F) [IEEE80211_HW_##F] = #F
438 FLAG(HAS_RATE_CONTROL
),
439 FLAG(RX_INCLUDES_FCS
),
440 FLAG(HOST_BROADCAST_PS_BUFFERING
),
443 FLAG(NEED_DTIM_BEFORE_ASSOC
),
445 FLAG(AMPDU_AGGREGATION
),
447 FLAG(PS_NULLFUNC_STACK
),
448 FLAG(SUPPORTS_DYNAMIC_PS
),
450 FLAG(WANT_MONITOR_VIF
),
451 FLAG(NO_VIRTUAL_MONITOR
),
453 FLAG(SW_CRYPTO_CONTROL
),
454 FLAG(SUPPORT_FAST_XMIT
),
455 FLAG(REPORTS_TX_ACK_STATUS
),
456 FLAG(CONNECTION_MONITOR
),
458 FLAG(SUPPORTS_PER_STA_GTK
),
460 FLAG(TX_AMPDU_SETUP_IN_HW
),
461 FLAG(SUPPORTS_RC_TABLE
),
462 FLAG(P2P_DEV_ADDR_FOR_INTF
),
463 FLAG(TIMING_BEACON_ONLY
),
464 FLAG(SUPPORTS_HT_CCK_RATES
),
465 FLAG(CHANCTX_STA_CSA
),
466 FLAG(SUPPORTS_CLONED_SKBS
),
467 FLAG(SINGLE_SCAN_ON_ALL_BANDS
),
469 FLAG(SUPPORTS_AMSDU_IN_AMPDU
),
470 FLAG(BEACON_TX_STATUS
),
471 FLAG(NEEDS_UNIQUE_STA_ADDR
),
472 FLAG(SUPPORTS_REORDERING_BUFFER
),
476 FLAG(REPORTS_LOW_ACK
),
477 FLAG(SUPPORTS_TX_FRAG
),
478 FLAG(SUPPORTS_TDLS_BUFFER_STA
),
479 FLAG(DOESNT_SUPPORT_QOS_NDP
),
480 FLAG(BUFF_MMPDU_TXQ
),
481 FLAG(SUPPORTS_VHT_EXT_NSS_BW
),
483 FLAG(TX_STATUS_NO_AMPDU_LEN
),
484 FLAG(SUPPORTS_MULTI_BSSID
),
485 FLAG(SUPPORTS_ONLY_HE_MULTI_BSSID
),
486 FLAG(AMPDU_KEYBORDER_SUPPORT
),
487 FLAG(SUPPORTS_TX_ENCAP_OFFLOAD
),
488 FLAG(SUPPORTS_RX_DECAP_OFFLOAD
),
489 FLAG(SUPPORTS_CONC_MON_RX_DECAP
),
490 FLAG(DETECTS_COLOR_COLLISION
),
491 FLAG(MLO_MCAST_MULTI_LINK_TX
),
492 FLAG(DISALLOW_PUNCTURING
),
493 FLAG(DISALLOW_PUNCTURING_5GHZ
),
494 FLAG(HANDLES_QUIET_CSA
),
498 static ssize_t
hwflags_read(struct file
*file
, char __user
*user_buf
,
499 size_t count
, loff_t
*ppos
)
501 struct ieee80211_local
*local
= file
->private_data
;
502 size_t bufsz
= 30 * NUM_IEEE80211_HW_FLAGS
;
503 char *buf
= kzalloc(bufsz
, GFP_KERNEL
);
504 char *pos
= buf
, *end
= buf
+ bufsz
- 1;
511 /* fail compilation if somebody adds or removes
512 * a flag without updating the name array above
514 BUILD_BUG_ON(ARRAY_SIZE(hw_flag_names
) != NUM_IEEE80211_HW_FLAGS
);
516 for (i
= 0; i
< NUM_IEEE80211_HW_FLAGS
; i
++) {
517 if (test_bit(i
, local
->hw
.flags
))
518 pos
+= scnprintf(pos
, end
- pos
, "%s\n",
522 rv
= simple_read_from_buffer(user_buf
, count
, ppos
, buf
, strlen(buf
));
527 static ssize_t
misc_read(struct file
*file
, char __user
*user_buf
,
528 size_t count
, loff_t
*ppos
)
530 struct ieee80211_local
*local
= file
->private_data
;
531 /* Max len of each line is 16 characters, plus 9 for 'pending:\n' */
532 size_t bufsz
= IEEE80211_MAX_QUEUES
* 16 + 9;
539 buf
= kzalloc(bufsz
, GFP_KERNEL
);
544 end
= buf
+ bufsz
- 1;
546 pos
+= scnprintf(pos
, end
- pos
, "pending:\n");
548 for (i
= 0; i
< IEEE80211_MAX_QUEUES
; i
++) {
549 ln
= skb_queue_len(&local
->pending
[i
]);
550 pos
+= scnprintf(pos
, end
- pos
, "[%i] %d\n",
554 rv
= simple_read_from_buffer(user_buf
, count
, ppos
, buf
, strlen(buf
));
559 static ssize_t
queues_read(struct file
*file
, char __user
*user_buf
,
560 size_t count
, loff_t
*ppos
)
562 struct ieee80211_local
*local
= file
->private_data
;
564 char buf
[IEEE80211_MAX_QUEUES
* 20];
567 spin_lock_irqsave(&local
->queue_stop_reason_lock
, flags
);
568 for (q
= 0; q
< local
->hw
.queues
; q
++)
569 res
+= sprintf(buf
+ res
, "%02d: %#.8lx/%d\n", q
,
570 local
->queue_stop_reasons
[q
],
571 skb_queue_len(&local
->pending
[q
]));
572 spin_unlock_irqrestore(&local
->queue_stop_reason_lock
, flags
);
574 return simple_read_from_buffer(user_buf
, count
, ppos
, buf
, res
);
577 DEBUGFS_READONLY_FILE_OPS(hwflags
);
578 DEBUGFS_READONLY_FILE_OPS(queues
);
579 DEBUGFS_READONLY_FILE_OPS(misc
);
581 /* statistics stuff */
583 static ssize_t
format_devstat_counter(struct ieee80211_local
*local
,
584 char __user
*userbuf
,
585 size_t count
, loff_t
*ppos
,
586 int (*printvalue
)(struct ieee80211_low_level_stats
*stats
, char *buf
,
589 struct ieee80211_low_level_stats stats
;
593 wiphy_lock(local
->hw
.wiphy
);
594 res
= drv_get_stats(local
, &stats
);
595 wiphy_unlock(local
->hw
.wiphy
);
598 res
= printvalue(&stats
, buf
, sizeof(buf
));
599 return simple_read_from_buffer(userbuf
, count
, ppos
, buf
, res
);
602 #define DEBUGFS_DEVSTATS_FILE(name) \
603 static int print_devstats_##name(struct ieee80211_low_level_stats *stats,\
604 char *buf, int buflen) \
606 return scnprintf(buf, buflen, "%u\n", stats->name); \
608 static ssize_t stats_ ##name## _read(struct file *file, \
609 char __user *userbuf, \
610 size_t count, loff_t *ppos) \
612 return format_devstat_counter(file->private_data, \
616 print_devstats_##name); \
619 static const struct debugfs_short_fops stats_ ##name## _ops = { \
620 .read = stats_ ##name## _read, \
621 .llseek = generic_file_llseek, \
624 #ifdef CONFIG_MAC80211_DEBUG_COUNTERS
625 #define DEBUGFS_STATS_ADD(name) \
626 debugfs_create_u32(#name, 0400, statsd, &local->name);
628 #define DEBUGFS_DEVSTATS_ADD(name) \
629 debugfs_create_file(#name, 0400, statsd, local, &stats_ ##name## _ops);
631 DEBUGFS_DEVSTATS_FILE(dot11ACKFailureCount
);
632 DEBUGFS_DEVSTATS_FILE(dot11RTSFailureCount
);
633 DEBUGFS_DEVSTATS_FILE(dot11FCSErrorCount
);
634 DEBUGFS_DEVSTATS_FILE(dot11RTSSuccessCount
);
636 void debugfs_hw_add(struct ieee80211_local
*local
)
638 struct dentry
*phyd
= local
->hw
.wiphy
->debugfsdir
;
639 struct dentry
*statsd
;
644 local
->debugfs
.keys
= debugfs_create_dir("keys", phyd
);
646 DEBUGFS_ADD(total_ps_buffered
);
648 DEBUGFS_ADD(rate_ctrl_alg
);
652 DEBUGFS_ADD_MODE(reset
, 0200);
654 DEBUGFS_ADD(hwflags
);
655 DEBUGFS_ADD(user_power
);
657 DEBUGFS_ADD(hw_conf
);
658 DEBUGFS_ADD_MODE(force_tx_status
, 0600);
659 DEBUGFS_ADD_MODE(aql_enable
, 0600);
660 DEBUGFS_ADD(aql_pending
);
661 DEBUGFS_ADD_MODE(aqm
, 0600);
663 DEBUGFS_ADD_MODE(airtime_flags
, 0600);
665 DEBUGFS_ADD(aql_txq_limit
);
666 debugfs_create_u32("aql_threshold", 0600,
667 phyd
, &local
->aql_threshold
);
669 statsd
= debugfs_create_dir("statistics", phyd
);
671 #ifdef CONFIG_MAC80211_DEBUG_COUNTERS
672 DEBUGFS_STATS_ADD(dot11TransmittedFragmentCount
);
673 DEBUGFS_STATS_ADD(dot11MulticastTransmittedFrameCount
);
674 DEBUGFS_STATS_ADD(dot11FailedCount
);
675 DEBUGFS_STATS_ADD(dot11RetryCount
);
676 DEBUGFS_STATS_ADD(dot11MultipleRetryCount
);
677 DEBUGFS_STATS_ADD(dot11FrameDuplicateCount
);
678 DEBUGFS_STATS_ADD(dot11ReceivedFragmentCount
);
679 DEBUGFS_STATS_ADD(dot11MulticastReceivedFrameCount
);
680 DEBUGFS_STATS_ADD(dot11TransmittedFrameCount
);
681 DEBUGFS_STATS_ADD(tx_handlers_drop
);
682 DEBUGFS_STATS_ADD(tx_handlers_queued
);
683 DEBUGFS_STATS_ADD(tx_handlers_drop_wep
);
684 DEBUGFS_STATS_ADD(tx_handlers_drop_not_assoc
);
685 DEBUGFS_STATS_ADD(tx_handlers_drop_unauth_port
);
686 DEBUGFS_STATS_ADD(rx_handlers_drop
);
687 DEBUGFS_STATS_ADD(rx_handlers_queued
);
688 DEBUGFS_STATS_ADD(rx_handlers_drop_nullfunc
);
689 DEBUGFS_STATS_ADD(rx_handlers_drop_defrag
);
690 DEBUGFS_STATS_ADD(tx_expand_skb_head
);
691 DEBUGFS_STATS_ADD(tx_expand_skb_head_cloned
);
692 DEBUGFS_STATS_ADD(rx_expand_skb_head_defrag
);
693 DEBUGFS_STATS_ADD(rx_handlers_fragments
);
694 DEBUGFS_STATS_ADD(tx_status_drop
);
696 DEBUGFS_DEVSTATS_ADD(dot11ACKFailureCount
);
697 DEBUGFS_DEVSTATS_ADD(dot11RTSFailureCount
);
698 DEBUGFS_DEVSTATS_ADD(dot11FCSErrorCount
);
699 DEBUGFS_DEVSTATS_ADD(dot11RTSSuccessCount
);