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 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 file_operations name## _ops = { \
46 .read = name## _read, \
47 .open = simple_open, \
48 .llseek = generic_file_llseek, \
51 #define DEBUGFS_READONLY_FILE(name, fmt, value...) \
52 DEBUGFS_READONLY_FILE_FN(name, fmt, value) \
53 DEBUGFS_READONLY_FILE_OPS(name)
55 #define DEBUGFS_ADD(name) \
56 debugfs_create_file(#name, 0400, phyd, local, &name## _ops)
58 #define DEBUGFS_ADD_MODE(name, mode) \
59 debugfs_create_file(#name, mode, phyd, local, &name## _ops);
62 DEBUGFS_READONLY_FILE(hw_conf, "%x",
63 local->hw.conf.flags);
64 DEBUGFS_READONLY_FILE(user_power, "%d",
65 local->user_power_level);
66 DEBUGFS_READONLY_FILE(power, "%d",
67 local->hw.conf.power_level);
68 DEBUGFS_READONLY_FILE(total_ps_buffered, "%d",
69 local->total_ps_buffered);
70 DEBUGFS_READONLY_FILE(wep_iv, "%#08x",
71 local->wep_iv & 0xffffff);
72 DEBUGFS_READONLY_FILE(rate_ctrl_alg, "%s",
73 local->rate_ctrl ? local->rate_ctrl->ops->name : "hw/driver");
75 static ssize_t aqm_read(struct file *file,
76 char __user *user_buf,
80 struct ieee80211_local *local = file->private_data;
81 struct fq *fq = &local->fq;
85 spin_lock_bh(&local->fq.lock);
88 len = scnprintf(buf, sizeof(buf),
93 "R fq_overmemory %u\n"
94 "R fq_collisions %u\n"
95 "R fq_memory_usage %u\n"
96 "RW fq_memory_limit %u\n"
110 spin_unlock_bh(&local->fq.lock);
112 return simple_read_from_buffer(user_buf, count, ppos,
116 static ssize_t aqm_write(struct file *file,
117 const char __user *user_buf,
121 struct ieee80211_local *local = file->private_data;
124 if (count >= sizeof(buf))
127 if (copy_from_user(buf, user_buf, count))
130 if (count && buf[count - 1] == '\n')
131 buf[count - 1] = '\0';
135 if (sscanf(buf, "fq_limit %u", &local->fq.limit) == 1)
137 else if (sscanf(buf, "fq_memory_limit %u", &local->fq.memory_limit) == 1)
139 else if (sscanf(buf, "fq_quantum %u", &local->fq.quantum) == 1)
145 static const struct file_operations aqm_ops = {
149 .llseek = default_llseek,
152 static ssize_t airtime_flags_read(struct file *file,
153 char __user *user_buf,
154 size_t count, loff_t *ppos)
156 struct ieee80211_local *local = file->private_data;
157 char buf[128] = {}, *pos, *end;
160 end = pos + sizeof(buf) - 1;
162 if (local->airtime_flags & AIRTIME_USE_TX)
163 pos += scnprintf(pos, end - pos, "AIRTIME_TX\t(%lx)\n",
165 if (local->airtime_flags & AIRTIME_USE_RX)
166 pos += scnprintf(pos, end - pos, "AIRTIME_RX\t(%lx)\n",
169 return simple_read_from_buffer(user_buf, count, ppos, buf,
173 static ssize_t airtime_flags_write(struct file *file,
174 const char __user *user_buf,
175 size_t count, loff_t *ppos)
177 struct ieee80211_local *local = file->private_data;
180 if (count >= sizeof(buf))
183 if (copy_from_user(buf, user_buf, count))
186 if (count && buf[count - 1] == '\n')
187 buf[count - 1] = '\0';
191 if (kstrtou16(buf, 0, &local->airtime_flags))
197 static const struct file_operations airtime_flags_ops = {
198 .write = airtime_flags_write,
199 .read = airtime_flags_read,
201 .llseek = default_llseek,
204 static ssize_t aql_txq_limit_read(struct file *file,
205 char __user *user_buf,
209 struct ieee80211_local *local = file->private_data;
213 len = scnprintf(buf, sizeof(buf),
214 "AC AQL limit low AQL limit high\n"
219 local->airtime[IEEE80211_AC_VO].aql_txq_limit_low,
220 local->airtime[IEEE80211_AC_VO].aql_txq_limit_high,
221 local->airtime[IEEE80211_AC_VI].aql_txq_limit_low,
222 local->airtime[IEEE80211_AC_VI].aql_txq_limit_high,
223 local->airtime[IEEE80211_AC_BE].aql_txq_limit_low,
224 local->airtime[IEEE80211_AC_BE].aql_txq_limit_high,
225 local->airtime[IEEE80211_AC_BK].aql_txq_limit_low,
226 local->airtime[IEEE80211_AC_BK].aql_txq_limit_high);
227 return simple_read_from_buffer(user_buf, count, ppos,
231 static ssize_t aql_txq_limit_write(struct file *file,
232 const char __user *user_buf,
236 struct ieee80211_local *local = file->private_data;
238 u32 ac, q_limit_low, q_limit_high, q_limit_low_old, q_limit_high_old;
239 struct sta_info *sta;
241 if (count >= sizeof(buf))
244 if (copy_from_user(buf, user_buf, count))
247 if (count && buf[count - 1] == '\n')
248 buf[count - 1] = '\0';
252 if (sscanf(buf, "%u %u %u", &ac, &q_limit_low, &q_limit_high) != 3)
255 if (ac >= IEEE80211_NUM_ACS)
258 q_limit_low_old = local->airtime[ac].aql_txq_limit_low;
259 q_limit_high_old = local->airtime[ac].aql_txq_limit_high;
261 local->airtime[ac].aql_txq_limit_low = q_limit_low;
262 local->airtime[ac].aql_txq_limit_high = q_limit_high;
264 mutex_lock(&local->sta_mtx);
265 list_for_each_entry(sta, &local->sta_list, list) {
266 /* If a sta has customized queue limits, keep it */
267 if (sta->airtime[ac].aql_limit_low == q_limit_low_old &&
268 sta->airtime[ac].aql_limit_high == q_limit_high_old) {
269 sta->airtime[ac].aql_limit_low = q_limit_low;
270 sta->airtime[ac].aql_limit_high = q_limit_high;
273 mutex_unlock(&local->sta_mtx);
277 static const struct file_operations aql_txq_limit_ops = {
278 .write = aql_txq_limit_write,
279 .read = aql_txq_limit_read,
281 .llseek = default_llseek,
284 static ssize_t aql_enable_read(struct file *file, char __user *user_buf,
285 size_t count, loff_t *ppos)
290 len = scnprintf(buf, sizeof(buf), "%d\n",
291 !static_key_false(&aql_disable.key));
293 return simple_read_from_buffer(user_buf, count, ppos, buf, len);
296 static ssize_t aql_enable_write(struct file *file, const char __user *user_buf,
297 size_t count, loff_t *ppos)
299 bool aql_disabled = static_key_false(&aql_disable.key);
303 if (count > sizeof(buf))
306 if (copy_from_user(buf, user_buf, count))
309 buf[sizeof(buf) - 1] = '\0';
311 if (len > 0 && buf[len - 1] == '\n')
314 if (buf[0] == '0' && buf[1] == '\0') {
316 static_branch_inc(&aql_disable);
317 } else if (buf[0] == '1' && buf[1] == '\0') {
319 static_branch_dec(&aql_disable);
327 static const struct file_operations aql_enable_ops = {
328 .write = aql_enable_write,
329 .read = aql_enable_read,
331 .llseek = default_llseek,
334 static ssize_t force_tx_status_read(struct file *file,
335 char __user *user_buf,
339 struct ieee80211_local *local = file->private_data;
343 len = scnprintf(buf, sizeof(buf), "%d\n", (int)local->force_tx_status);
345 return simple_read_from_buffer(user_buf, count, ppos,
349 static ssize_t force_tx_status_write(struct file *file,
350 const char __user *user_buf,
354 struct ieee80211_local *local = file->private_data;
357 if (count >= sizeof(buf))
360 if (copy_from_user(buf, user_buf, count))
363 if (count && buf[count - 1] == '\n')
364 buf[count - 1] = '\0';
368 if (buf[0] == '0' && buf[1] == '\0')
369 local->force_tx_status = 0;
370 else if (buf[0] == '1' && buf[1] == '\0')
371 local->force_tx_status = 1;
378 static const struct file_operations force_tx_status_ops = {
379 .write = force_tx_status_write,
380 .read = force_tx_status_read,
382 .llseek = default_llseek,
385 static ssize_t airtime_read(struct file *file,
386 char __user *user_buf,
390 struct ieee80211_local *local = file->private_data;
392 u64 v_t[IEEE80211_NUM_ACS];
393 u64 wt[IEEE80211_NUM_ACS];
396 for (ac = 0; ac < IEEE80211_NUM_ACS; ac++) {
397 spin_lock_bh(&local->airtime[ac].lock);
398 v_t[ac] = local->airtime[ac].v_t;
399 wt[ac] = local->airtime[ac].weight_sum;
400 spin_unlock_bh(&local->airtime[ac].lock);
402 len = scnprintf(buf, sizeof(buf),
404 "Virt-t\t%-10llu %-10llu %-10llu %-10llu\n"
405 "Weight\t%-10llu %-10llu %-10llu %-10llu\n",
415 return simple_read_from_buffer(user_buf, count, ppos,
419 static const struct file_operations airtime_ops = {
420 .read = airtime_read,
422 .llseek = default_llseek,
426 static ssize_t reset_write(struct file *file, const char __user *user_buf,
427 size_t count, loff_t *ppos)
429 struct ieee80211_local *local = file->private_data;
433 wiphy_lock(local->hw.wiphy);
434 __ieee80211_suspend(&local->hw, NULL);
435 ret = __ieee80211_resume(&local->hw);
436 wiphy_unlock(local->hw.wiphy);
439 cfg80211_shutdown_all_interfaces(local->hw.wiphy);
446 static const struct file_operations reset_ops = {
447 .write = reset_write,
449 .llseek = noop_llseek,
453 static const char *hw_flag_names[] = {
454 #define FLAG(F) [IEEE80211_HW_##F] = #F
455 FLAG(HAS_RATE_CONTROL),
456 FLAG(RX_INCLUDES_FCS),
457 FLAG(HOST_BROADCAST_PS_BUFFERING),
460 FLAG(NEED_DTIM_BEFORE_ASSOC),
462 FLAG(AMPDU_AGGREGATION),
464 FLAG(PS_NULLFUNC_STACK),
465 FLAG(SUPPORTS_DYNAMIC_PS),
467 FLAG(WANT_MONITOR_VIF),
469 FLAG(SW_CRYPTO_CONTROL),
470 FLAG(SUPPORT_FAST_XMIT),
471 FLAG(REPORTS_TX_ACK_STATUS),
472 FLAG(CONNECTION_MONITOR),
474 FLAG(SUPPORTS_PER_STA_GTK),
476 FLAG(TX_AMPDU_SETUP_IN_HW),
477 FLAG(SUPPORTS_RC_TABLE),
478 FLAG(P2P_DEV_ADDR_FOR_INTF),
479 FLAG(TIMING_BEACON_ONLY),
480 FLAG(SUPPORTS_HT_CCK_RATES),
481 FLAG(CHANCTX_STA_CSA),
482 FLAG(SUPPORTS_CLONED_SKBS),
483 FLAG(SINGLE_SCAN_ON_ALL_BANDS),
485 FLAG(SUPPORTS_AMSDU_IN_AMPDU),
486 FLAG(BEACON_TX_STATUS),
487 FLAG(NEEDS_UNIQUE_STA_ADDR),
488 FLAG(SUPPORTS_REORDERING_BUFFER),
492 FLAG(REPORTS_LOW_ACK),
493 FLAG(SUPPORTS_TX_FRAG),
494 FLAG(SUPPORTS_TDLS_BUFFER_STA),
495 FLAG(DEAUTH_NEED_MGD_TX_PREP),
496 FLAG(DOESNT_SUPPORT_QOS_NDP),
497 FLAG(BUFF_MMPDU_TXQ),
498 FLAG(SUPPORTS_VHT_EXT_NSS_BW),
500 FLAG(TX_STATUS_NO_AMPDU_LEN),
501 FLAG(SUPPORTS_MULTI_BSSID),
502 FLAG(SUPPORTS_ONLY_HE_MULTI_BSSID),
503 FLAG(AMPDU_KEYBORDER_SUPPORT),
504 FLAG(SUPPORTS_TX_ENCAP_OFFLOAD),
505 FLAG(SUPPORTS_RX_DECAP_OFFLOAD),
506 FLAG(SUPPORTS_CONC_MON_RX_DECAP),
510 static ssize_t hwflags_read(struct file *file, char __user *user_buf,
511 size_t count, loff_t *ppos)
513 struct ieee80211_local *local = file->private_data;
514 size_t bufsz = 30 * NUM_IEEE80211_HW_FLAGS;
515 char *buf = kzalloc(bufsz, GFP_KERNEL);
516 char *pos = buf, *end = buf + bufsz - 1;
523 /* fail compilation if somebody adds or removes
524 * a flag without updating the name array above
526 BUILD_BUG_ON(ARRAY_SIZE(hw_flag_names) != NUM_IEEE80211_HW_FLAGS);
528 for (i = 0; i < NUM_IEEE80211_HW_FLAGS; i++) {
529 if (test_bit(i, local->hw.flags))
530 pos += scnprintf(pos, end - pos, "%s\n",
534 rv = simple_read_from_buffer(user_buf, count, ppos, buf, strlen(buf));
539 static ssize_t misc_read(struct file *file, char __user *user_buf,
540 size_t count, loff_t *ppos)
542 struct ieee80211_local *local = file->private_data;
543 /* Max len of each line is 16 characters, plus 9 for 'pending:\n' */
544 size_t bufsz = IEEE80211_MAX_QUEUES * 16 + 9;
551 buf = kzalloc(bufsz, GFP_KERNEL);
556 end = buf + bufsz - 1;
558 pos += scnprintf(pos, end - pos, "pending:\n");
560 for (i = 0; i < IEEE80211_MAX_QUEUES; i++) {
561 ln = skb_queue_len(&local->pending[i]);
562 pos += scnprintf(pos, end - pos, "[%i] %d\n",
566 rv = simple_read_from_buffer(user_buf, count, ppos, buf, strlen(buf));
571 static ssize_t queues_read(struct file *file, char __user *user_buf,
572 size_t count, loff_t *ppos)
574 struct ieee80211_local *local = file->private_data;
576 char buf[IEEE80211_MAX_QUEUES * 20];
579 spin_lock_irqsave(&local->queue_stop_reason_lock, flags);
580 for (q = 0; q < local->hw.queues; q++)
581 res += sprintf(buf + res, "%02d: %#.8lx/%d\n", q,
582 local->queue_stop_reasons[q],
583 skb_queue_len(&local->pending[q]));
584 spin_unlock_irqrestore(&local->queue_stop_reason_lock, flags);
586 return simple_read_from_buffer(user_buf, count, ppos, buf, res);
589 DEBUGFS_READONLY_FILE_OPS(hwflags);
590 DEBUGFS_READONLY_FILE_OPS(queues);
591 DEBUGFS_READONLY_FILE_OPS(misc);
593 /* statistics stuff */
595 static ssize_t format_devstat_counter(struct ieee80211_local *local,
596 char __user *userbuf,
597 size_t count, loff_t *ppos,
598 int (*printvalue)(struct ieee80211_low_level_stats *stats, char *buf,
601 struct ieee80211_low_level_stats stats;
606 res = drv_get_stats(local, &stats);
610 res = printvalue(&stats, buf, sizeof(buf));
611 return simple_read_from_buffer(userbuf, count, ppos, buf, res);
614 #define DEBUGFS_DEVSTATS_FILE(name) \
615 static int print_devstats_##name(struct ieee80211_low_level_stats *stats,\
616 char *buf, int buflen) \
618 return scnprintf(buf, buflen, "%u\n", stats->name); \
620 static ssize_t stats_ ##name## _read(struct file *file, \
621 char __user *userbuf, \
622 size_t count, loff_t *ppos) \
624 return format_devstat_counter(file->private_data, \
628 print_devstats_##name); \
631 static const struct file_operations stats_ ##name## _ops = { \
632 .read = stats_ ##name## _read, \
633 .open = simple_open, \
634 .llseek = generic_file_llseek, \
637 #define DEBUGFS_STATS_ADD(name) \
638 debugfs_create_u32(#name, 0400, statsd, &local->name);
639 #define DEBUGFS_DEVSTATS_ADD(name) \
640 debugfs_create_file(#name, 0400, statsd, local, &stats_ ##name## _ops);
642 DEBUGFS_DEVSTATS_FILE(dot11ACKFailureCount);
643 DEBUGFS_DEVSTATS_FILE(dot11RTSFailureCount);
644 DEBUGFS_DEVSTATS_FILE(dot11FCSErrorCount);
645 DEBUGFS_DEVSTATS_FILE(dot11RTSSuccessCount);
647 void debugfs_hw_add(struct ieee80211_local *local)
649 struct dentry *phyd = local->hw.wiphy->debugfsdir;
650 struct dentry *statsd;
655 local->debugfs.keys = debugfs_create_dir("keys", phyd);
657 DEBUGFS_ADD(total_ps_buffered);
659 DEBUGFS_ADD(rate_ctrl_alg);
663 DEBUGFS_ADD_MODE(reset, 0200);
665 DEBUGFS_ADD(hwflags);
666 DEBUGFS_ADD(user_power);
668 DEBUGFS_ADD(hw_conf);
669 DEBUGFS_ADD_MODE(force_tx_status, 0600);
670 DEBUGFS_ADD_MODE(aql_enable, 0600);
672 if (local->ops->wake_tx_queue)
673 DEBUGFS_ADD_MODE(aqm, 0600);
675 if (wiphy_ext_feature_isset(local->hw.wiphy,
676 NL80211_EXT_FEATURE_AIRTIME_FAIRNESS)) {
677 DEBUGFS_ADD_MODE(airtime, 0600);
678 DEBUGFS_ADD_MODE(airtime_flags, 0600);
681 DEBUGFS_ADD(aql_txq_limit);
682 debugfs_create_u32("aql_threshold", 0600,
683 phyd, &local->aql_threshold);
685 statsd = debugfs_create_dir("statistics", phyd);
687 /* if the dir failed, don't put all the other things into the root! */
691 #ifdef CONFIG_MAC80211_DEBUG_COUNTERS
692 DEBUGFS_STATS_ADD(dot11TransmittedFragmentCount);
693 DEBUGFS_STATS_ADD(dot11MulticastTransmittedFrameCount);
694 DEBUGFS_STATS_ADD(dot11FailedCount);
695 DEBUGFS_STATS_ADD(dot11RetryCount);
696 DEBUGFS_STATS_ADD(dot11MultipleRetryCount);
697 DEBUGFS_STATS_ADD(dot11FrameDuplicateCount);
698 DEBUGFS_STATS_ADD(dot11ReceivedFragmentCount);
699 DEBUGFS_STATS_ADD(dot11MulticastReceivedFrameCount);
700 DEBUGFS_STATS_ADD(dot11TransmittedFrameCount);
701 DEBUGFS_STATS_ADD(tx_handlers_drop);
702 DEBUGFS_STATS_ADD(tx_handlers_queued);
703 DEBUGFS_STATS_ADD(tx_handlers_drop_wep);
704 DEBUGFS_STATS_ADD(tx_handlers_drop_not_assoc);
705 DEBUGFS_STATS_ADD(tx_handlers_drop_unauth_port);
706 DEBUGFS_STATS_ADD(rx_handlers_drop);
707 DEBUGFS_STATS_ADD(rx_handlers_queued);
708 DEBUGFS_STATS_ADD(rx_handlers_drop_nullfunc);
709 DEBUGFS_STATS_ADD(rx_handlers_drop_defrag);
710 DEBUGFS_STATS_ADD(tx_expand_skb_head);
711 DEBUGFS_STATS_ADD(tx_expand_skb_head_cloned);
712 DEBUGFS_STATS_ADD(rx_expand_skb_head_defrag);
713 DEBUGFS_STATS_ADD(rx_handlers_fragments);
714 DEBUGFS_STATS_ADD(tx_status_drop);
716 DEBUGFS_DEVSTATS_ADD(dot11ACKFailureCount);
717 DEBUGFS_DEVSTATS_ADD(dot11RTSFailureCount);
718 DEBUGFS_DEVSTATS_ADD(dot11FCSErrorCount);
719 DEBUGFS_DEVSTATS_ADD(dot11RTSSuccessCount);