1 // SPDX-License-Identifier: GPL-2.0-only
3 * mac80211 debugfs for wireless PHYs
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);