1 // SPDX-License-Identifier: GPL-2.0-only 2 /* 3 * mac80211 debugfs for wireless PHYs 4 * 5 * Copyright 2007 Johannes Berg <johannes@sipsolutions.net> 6 * Copyright 2013-2014 Intel Mobile Communications GmbH 7 * Copyright (C) 2018 - 2019 Intel Corporation 8 */ 9 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" 15 #include "rate.h" 16 #include "debugfs.h" 17 18 #define DEBUGFS_FORMAT_BUFFER_SIZE 100 19 20 int mac80211_format_buffer(char __user *userbuf, size_t count, 21 loff_t *ppos, char *fmt, ...) 22 { 23 va_list args; 24 char buf[DEBUGFS_FORMAT_BUFFER_SIZE]; 25 int res; 26 27 va_start(args, fmt); 28 res = vscnprintf(buf, sizeof(buf), fmt, args); 29 va_end(args); 30 31 return simple_read_from_buffer(userbuf, count, ppos, buf, res); 32 } 33 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) \ 37 { \ 38 struct ieee80211_local *local = file->private_data; \ 39 \ 40 return mac80211_format_buffer(userbuf, count, ppos, \ 41 fmt "\n", ##value); \ 42 } 43 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, \ 49 }; 50 51 #define DEBUGFS_READONLY_FILE(name, fmt, value...) \ 52 DEBUGFS_READONLY_FILE_FN(name, fmt, value) \ 53 DEBUGFS_READONLY_FILE_OPS(name) 54 55 #define DEBUGFS_ADD(name) \ 56 debugfs_create_file(#name, 0400, phyd, local, &name## _ops) 57 58 #define DEBUGFS_ADD_MODE(name, mode) \ 59 debugfs_create_file(#name, mode, phyd, local, &name## _ops); 60 61 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"); 74 75 static ssize_t aqm_read(struct file *file, 76 char __user *user_buf, 77 size_t count, 78 loff_t *ppos) 79 { 80 struct ieee80211_local *local = file->private_data; 81 struct fq *fq = &local->fq; 82 char buf[200]; 83 int len = 0; 84 85 spin_lock_bh(&local->fq.lock); 86 rcu_read_lock(); 87 88 len = scnprintf(buf, sizeof(buf), 89 "access name value\n" 90 "R fq_flows_cnt %u\n" 91 "R fq_backlog %u\n" 92 "R fq_overlimit %u\n" 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" 97 "RW fq_limit %u\n" 98 "RW fq_quantum %u\n", 99 fq->flows_cnt, 100 fq->backlog, 101 fq->overmemory, 102 fq->overlimit, 103 fq->collisions, 104 fq->memory_usage, 105 fq->memory_limit, 106 fq->limit, 107 fq->quantum); 108 109 rcu_read_unlock(); 110 spin_unlock_bh(&local->fq.lock); 111 112 return simple_read_from_buffer(user_buf, count, ppos, 113 buf, len); 114 } 115 116 static ssize_t aqm_write(struct file *file, 117 const char __user *user_buf, 118 size_t count, 119 loff_t *ppos) 120 { 121 struct ieee80211_local *local = file->private_data; 122 char buf[100]; 123 size_t len; 124 125 if (count > sizeof(buf)) 126 return -EINVAL; 127 128 if (copy_from_user(buf, user_buf, count)) 129 return -EFAULT; 130 131 buf[sizeof(buf) - 1] = '\0'; 132 len = strlen(buf); 133 if (len > 0 && buf[len-1] == '\n') 134 buf[len-1] = 0; 135 136 if (sscanf(buf, "fq_limit %u", &local->fq.limit) == 1) 137 return count; 138 else if (sscanf(buf, "fq_memory_limit %u", &local->fq.memory_limit) == 1) 139 return count; 140 else if (sscanf(buf, "fq_quantum %u", &local->fq.quantum) == 1) 141 return count; 142 143 return -EINVAL; 144 } 145 146 static const struct file_operations aqm_ops = { 147 .write = aqm_write, 148 .read = aqm_read, 149 .open = simple_open, 150 .llseek = default_llseek, 151 }; 152 153 static ssize_t airtime_flags_read(struct file *file, 154 char __user *user_buf, 155 size_t count, loff_t *ppos) 156 { 157 struct ieee80211_local *local = file->private_data; 158 char buf[128] = {}, *pos, *end; 159 160 pos = buf; 161 end = pos + sizeof(buf) - 1; 162 163 if (local->airtime_flags & AIRTIME_USE_TX) 164 pos += scnprintf(pos, end - pos, "AIRTIME_TX\t(%lx)\n", 165 AIRTIME_USE_TX); 166 if (local->airtime_flags & AIRTIME_USE_RX) 167 pos += scnprintf(pos, end - pos, "AIRTIME_RX\t(%lx)\n", 168 AIRTIME_USE_RX); 169 170 return simple_read_from_buffer(user_buf, count, ppos, buf, 171 strlen(buf)); 172 } 173 174 static ssize_t airtime_flags_write(struct file *file, 175 const char __user *user_buf, 176 size_t count, loff_t *ppos) 177 { 178 struct ieee80211_local *local = file->private_data; 179 char buf[16]; 180 size_t len; 181 182 if (count > sizeof(buf)) 183 return -EINVAL; 184 185 if (copy_from_user(buf, user_buf, count)) 186 return -EFAULT; 187 188 buf[sizeof(buf) - 1] = 0; 189 len = strlen(buf); 190 if (len > 0 && buf[len - 1] == '\n') 191 buf[len - 1] = 0; 192 193 if (kstrtou16(buf, 0, &local->airtime_flags)) 194 return -EINVAL; 195 196 return count; 197 } 198 199 static const struct file_operations airtime_flags_ops = { 200 .write = airtime_flags_write, 201 .read = airtime_flags_read, 202 .open = simple_open, 203 .llseek = default_llseek, 204 }; 205 206 static ssize_t aql_txq_limit_read(struct file *file, 207 char __user *user_buf, 208 size_t count, 209 loff_t *ppos) 210 { 211 struct ieee80211_local *local = file->private_data; 212 char buf[400]; 213 int len = 0; 214 215 len = scnprintf(buf, sizeof(buf), 216 "AC AQL limit low AQL limit high\n" 217 "VO %u %u\n" 218 "VI %u %u\n" 219 "BE %u %u\n" 220 "BK %u %u\n", 221 local->aql_txq_limit_low[IEEE80211_AC_VO], 222 local->aql_txq_limit_high[IEEE80211_AC_VO], 223 local->aql_txq_limit_low[IEEE80211_AC_VI], 224 local->aql_txq_limit_high[IEEE80211_AC_VI], 225 local->aql_txq_limit_low[IEEE80211_AC_BE], 226 local->aql_txq_limit_high[IEEE80211_AC_BE], 227 local->aql_txq_limit_low[IEEE80211_AC_BK], 228 local->aql_txq_limit_high[IEEE80211_AC_BK]); 229 return simple_read_from_buffer(user_buf, count, ppos, 230 buf, len); 231 } 232 233 static ssize_t aql_txq_limit_write(struct file *file, 234 const char __user *user_buf, 235 size_t count, 236 loff_t *ppos) 237 { 238 struct ieee80211_local *local = file->private_data; 239 char buf[100]; 240 size_t len; 241 u32 ac, q_limit_low, q_limit_high, q_limit_low_old, q_limit_high_old; 242 struct sta_info *sta; 243 244 if (count > sizeof(buf)) 245 return -EINVAL; 246 247 if (copy_from_user(buf, user_buf, count)) 248 return -EFAULT; 249 250 buf[sizeof(buf) - 1] = 0; 251 len = strlen(buf); 252 if (len > 0 && buf[len - 1] == '\n') 253 buf[len - 1] = 0; 254 255 if (sscanf(buf, "%u %u %u", &ac, &q_limit_low, &q_limit_high) != 3) 256 return -EINVAL; 257 258 if (ac >= IEEE80211_NUM_ACS) 259 return -EINVAL; 260 261 q_limit_low_old = local->aql_txq_limit_low[ac]; 262 q_limit_high_old = local->aql_txq_limit_high[ac]; 263 264 local->aql_txq_limit_low[ac] = q_limit_low; 265 local->aql_txq_limit_high[ac] = q_limit_high; 266 267 mutex_lock(&local->sta_mtx); 268 list_for_each_entry(sta, &local->sta_list, list) { 269 /* If a sta has customized queue limits, keep it */ 270 if (sta->airtime[ac].aql_limit_low == q_limit_low_old && 271 sta->airtime[ac].aql_limit_high == q_limit_high_old) { 272 sta->airtime[ac].aql_limit_low = q_limit_low; 273 sta->airtime[ac].aql_limit_high = q_limit_high; 274 } 275 } 276 mutex_unlock(&local->sta_mtx); 277 return count; 278 } 279 280 static const struct file_operations aql_txq_limit_ops = { 281 .write = aql_txq_limit_write, 282 .read = aql_txq_limit_read, 283 .open = simple_open, 284 .llseek = default_llseek, 285 }; 286 287 static ssize_t force_tx_status_read(struct file *file, 288 char __user *user_buf, 289 size_t count, 290 loff_t *ppos) 291 { 292 struct ieee80211_local *local = file->private_data; 293 char buf[3]; 294 int len = 0; 295 296 len = scnprintf(buf, sizeof(buf), "%d\n", (int)local->force_tx_status); 297 298 return simple_read_from_buffer(user_buf, count, ppos, 299 buf, len); 300 } 301 302 static ssize_t force_tx_status_write(struct file *file, 303 const char __user *user_buf, 304 size_t count, 305 loff_t *ppos) 306 { 307 struct ieee80211_local *local = file->private_data; 308 char buf[3]; 309 size_t len; 310 311 if (count > sizeof(buf)) 312 return -EINVAL; 313 314 if (copy_from_user(buf, user_buf, count)) 315 return -EFAULT; 316 317 buf[sizeof(buf) - 1] = '\0'; 318 len = strlen(buf); 319 if (len > 0 && buf[len - 1] == '\n') 320 buf[len - 1] = 0; 321 322 if (buf[0] == '0' && buf[1] == '\0') 323 local->force_tx_status = 0; 324 else if (buf[0] == '1' && buf[1] == '\0') 325 local->force_tx_status = 1; 326 else 327 return -EINVAL; 328 329 return count; 330 } 331 332 static const struct file_operations force_tx_status_ops = { 333 .write = force_tx_status_write, 334 .read = force_tx_status_read, 335 .open = simple_open, 336 .llseek = default_llseek, 337 }; 338 339 #ifdef CONFIG_PM 340 static ssize_t reset_write(struct file *file, const char __user *user_buf, 341 size_t count, loff_t *ppos) 342 { 343 struct ieee80211_local *local = file->private_data; 344 345 rtnl_lock(); 346 __ieee80211_suspend(&local->hw, NULL); 347 __ieee80211_resume(&local->hw); 348 rtnl_unlock(); 349 350 return count; 351 } 352 353 static const struct file_operations reset_ops = { 354 .write = reset_write, 355 .open = simple_open, 356 .llseek = noop_llseek, 357 }; 358 #endif 359 360 static const char *hw_flag_names[] = { 361 #define FLAG(F) [IEEE80211_HW_##F] = #F 362 FLAG(HAS_RATE_CONTROL), 363 FLAG(RX_INCLUDES_FCS), 364 FLAG(HOST_BROADCAST_PS_BUFFERING), 365 FLAG(SIGNAL_UNSPEC), 366 FLAG(SIGNAL_DBM), 367 FLAG(NEED_DTIM_BEFORE_ASSOC), 368 FLAG(SPECTRUM_MGMT), 369 FLAG(AMPDU_AGGREGATION), 370 FLAG(SUPPORTS_PS), 371 FLAG(PS_NULLFUNC_STACK), 372 FLAG(SUPPORTS_DYNAMIC_PS), 373 FLAG(MFP_CAPABLE), 374 FLAG(WANT_MONITOR_VIF), 375 FLAG(NO_AUTO_VIF), 376 FLAG(SW_CRYPTO_CONTROL), 377 FLAG(SUPPORT_FAST_XMIT), 378 FLAG(REPORTS_TX_ACK_STATUS), 379 FLAG(CONNECTION_MONITOR), 380 FLAG(QUEUE_CONTROL), 381 FLAG(SUPPORTS_PER_STA_GTK), 382 FLAG(AP_LINK_PS), 383 FLAG(TX_AMPDU_SETUP_IN_HW), 384 FLAG(SUPPORTS_RC_TABLE), 385 FLAG(P2P_DEV_ADDR_FOR_INTF), 386 FLAG(TIMING_BEACON_ONLY), 387 FLAG(SUPPORTS_HT_CCK_RATES), 388 FLAG(CHANCTX_STA_CSA), 389 FLAG(SUPPORTS_CLONED_SKBS), 390 FLAG(SINGLE_SCAN_ON_ALL_BANDS), 391 FLAG(TDLS_WIDER_BW), 392 FLAG(SUPPORTS_AMSDU_IN_AMPDU), 393 FLAG(BEACON_TX_STATUS), 394 FLAG(NEEDS_UNIQUE_STA_ADDR), 395 FLAG(SUPPORTS_REORDERING_BUFFER), 396 FLAG(USES_RSS), 397 FLAG(TX_AMSDU), 398 FLAG(TX_FRAG_LIST), 399 FLAG(REPORTS_LOW_ACK), 400 FLAG(SUPPORTS_TX_FRAG), 401 FLAG(SUPPORTS_TDLS_BUFFER_STA), 402 FLAG(DEAUTH_NEED_MGD_TX_PREP), 403 FLAG(DOESNT_SUPPORT_QOS_NDP), 404 FLAG(BUFF_MMPDU_TXQ), 405 FLAG(SUPPORTS_VHT_EXT_NSS_BW), 406 FLAG(STA_MMPDU_TXQ), 407 FLAG(TX_STATUS_NO_AMPDU_LEN), 408 FLAG(SUPPORTS_MULTI_BSSID), 409 FLAG(SUPPORTS_ONLY_HE_MULTI_BSSID), 410 FLAG(AMPDU_KEYBORDER_SUPPORT), 411 FLAG(SUPPORTS_TX_ENCAP_OFFLOAD), 412 #undef FLAG 413 }; 414 415 static ssize_t hwflags_read(struct file *file, char __user *user_buf, 416 size_t count, loff_t *ppos) 417 { 418 struct ieee80211_local *local = file->private_data; 419 size_t bufsz = 30 * NUM_IEEE80211_HW_FLAGS; 420 char *buf = kzalloc(bufsz, GFP_KERNEL); 421 char *pos = buf, *end = buf + bufsz - 1; 422 ssize_t rv; 423 int i; 424 425 if (!buf) 426 return -ENOMEM; 427 428 /* fail compilation if somebody adds or removes 429 * a flag without updating the name array above 430 */ 431 BUILD_BUG_ON(ARRAY_SIZE(hw_flag_names) != NUM_IEEE80211_HW_FLAGS); 432 433 for (i = 0; i < NUM_IEEE80211_HW_FLAGS; i++) { 434 if (test_bit(i, local->hw.flags)) 435 pos += scnprintf(pos, end - pos, "%s\n", 436 hw_flag_names[i]); 437 } 438 439 rv = simple_read_from_buffer(user_buf, count, ppos, buf, strlen(buf)); 440 kfree(buf); 441 return rv; 442 } 443 444 static ssize_t misc_read(struct file *file, char __user *user_buf, 445 size_t count, loff_t *ppos) 446 { 447 struct ieee80211_local *local = file->private_data; 448 /* Max len of each line is 16 characters, plus 9 for 'pending:\n' */ 449 size_t bufsz = IEEE80211_MAX_QUEUES * 16 + 9; 450 char *buf; 451 char *pos, *end; 452 ssize_t rv; 453 int i; 454 int ln; 455 456 buf = kzalloc(bufsz, GFP_KERNEL); 457 if (!buf) 458 return -ENOMEM; 459 460 pos = buf; 461 end = buf + bufsz - 1; 462 463 pos += scnprintf(pos, end - pos, "pending:\n"); 464 465 for (i = 0; i < IEEE80211_MAX_QUEUES; i++) { 466 ln = skb_queue_len(&local->pending[i]); 467 pos += scnprintf(pos, end - pos, "[%i] %d\n", 468 i, ln); 469 } 470 471 rv = simple_read_from_buffer(user_buf, count, ppos, buf, strlen(buf)); 472 kfree(buf); 473 return rv; 474 } 475 476 static ssize_t queues_read(struct file *file, char __user *user_buf, 477 size_t count, loff_t *ppos) 478 { 479 struct ieee80211_local *local = file->private_data; 480 unsigned long flags; 481 char buf[IEEE80211_MAX_QUEUES * 20]; 482 int q, res = 0; 483 484 spin_lock_irqsave(&local->queue_stop_reason_lock, flags); 485 for (q = 0; q < local->hw.queues; q++) 486 res += sprintf(buf + res, "%02d: %#.8lx/%d\n", q, 487 local->queue_stop_reasons[q], 488 skb_queue_len(&local->pending[q])); 489 spin_unlock_irqrestore(&local->queue_stop_reason_lock, flags); 490 491 return simple_read_from_buffer(user_buf, count, ppos, buf, res); 492 } 493 494 DEBUGFS_READONLY_FILE_OPS(hwflags); 495 DEBUGFS_READONLY_FILE_OPS(queues); 496 DEBUGFS_READONLY_FILE_OPS(misc); 497 498 /* statistics stuff */ 499 500 static ssize_t format_devstat_counter(struct ieee80211_local *local, 501 char __user *userbuf, 502 size_t count, loff_t *ppos, 503 int (*printvalue)(struct ieee80211_low_level_stats *stats, char *buf, 504 int buflen)) 505 { 506 struct ieee80211_low_level_stats stats; 507 char buf[20]; 508 int res; 509 510 rtnl_lock(); 511 res = drv_get_stats(local, &stats); 512 rtnl_unlock(); 513 if (res) 514 return res; 515 res = printvalue(&stats, buf, sizeof(buf)); 516 return simple_read_from_buffer(userbuf, count, ppos, buf, res); 517 } 518 519 #define DEBUGFS_DEVSTATS_FILE(name) \ 520 static int print_devstats_##name(struct ieee80211_low_level_stats *stats,\ 521 char *buf, int buflen) \ 522 { \ 523 return scnprintf(buf, buflen, "%u\n", stats->name); \ 524 } \ 525 static ssize_t stats_ ##name## _read(struct file *file, \ 526 char __user *userbuf, \ 527 size_t count, loff_t *ppos) \ 528 { \ 529 return format_devstat_counter(file->private_data, \ 530 userbuf, \ 531 count, \ 532 ppos, \ 533 print_devstats_##name); \ 534 } \ 535 \ 536 static const struct file_operations stats_ ##name## _ops = { \ 537 .read = stats_ ##name## _read, \ 538 .open = simple_open, \ 539 .llseek = generic_file_llseek, \ 540 }; 541 542 #define DEBUGFS_STATS_ADD(name) \ 543 debugfs_create_u32(#name, 0400, statsd, &local->name); 544 #define DEBUGFS_DEVSTATS_ADD(name) \ 545 debugfs_create_file(#name, 0400, statsd, local, &stats_ ##name## _ops); 546 547 DEBUGFS_DEVSTATS_FILE(dot11ACKFailureCount); 548 DEBUGFS_DEVSTATS_FILE(dot11RTSFailureCount); 549 DEBUGFS_DEVSTATS_FILE(dot11FCSErrorCount); 550 DEBUGFS_DEVSTATS_FILE(dot11RTSSuccessCount); 551 552 void debugfs_hw_add(struct ieee80211_local *local) 553 { 554 struct dentry *phyd = local->hw.wiphy->debugfsdir; 555 struct dentry *statsd; 556 557 if (!phyd) 558 return; 559 560 local->debugfs.keys = debugfs_create_dir("keys", phyd); 561 562 DEBUGFS_ADD(total_ps_buffered); 563 DEBUGFS_ADD(wep_iv); 564 DEBUGFS_ADD(rate_ctrl_alg); 565 DEBUGFS_ADD(queues); 566 DEBUGFS_ADD(misc); 567 #ifdef CONFIG_PM 568 DEBUGFS_ADD_MODE(reset, 0200); 569 #endif 570 DEBUGFS_ADD(hwflags); 571 DEBUGFS_ADD(user_power); 572 DEBUGFS_ADD(power); 573 DEBUGFS_ADD(hw_conf); 574 DEBUGFS_ADD_MODE(force_tx_status, 0600); 575 576 if (local->ops->wake_tx_queue) 577 DEBUGFS_ADD_MODE(aqm, 0600); 578 579 DEBUGFS_ADD_MODE(airtime_flags, 0600); 580 581 DEBUGFS_ADD(aql_txq_limit); 582 debugfs_create_u32("aql_threshold", 0600, 583 phyd, &local->aql_threshold); 584 585 statsd = debugfs_create_dir("statistics", phyd); 586 587 /* if the dir failed, don't put all the other things into the root! */ 588 if (!statsd) 589 return; 590 591 #ifdef CONFIG_MAC80211_DEBUG_COUNTERS 592 DEBUGFS_STATS_ADD(dot11TransmittedFragmentCount); 593 DEBUGFS_STATS_ADD(dot11MulticastTransmittedFrameCount); 594 DEBUGFS_STATS_ADD(dot11FailedCount); 595 DEBUGFS_STATS_ADD(dot11RetryCount); 596 DEBUGFS_STATS_ADD(dot11MultipleRetryCount); 597 DEBUGFS_STATS_ADD(dot11FrameDuplicateCount); 598 DEBUGFS_STATS_ADD(dot11ReceivedFragmentCount); 599 DEBUGFS_STATS_ADD(dot11MulticastReceivedFrameCount); 600 DEBUGFS_STATS_ADD(dot11TransmittedFrameCount); 601 DEBUGFS_STATS_ADD(tx_handlers_drop); 602 DEBUGFS_STATS_ADD(tx_handlers_queued); 603 DEBUGFS_STATS_ADD(tx_handlers_drop_wep); 604 DEBUGFS_STATS_ADD(tx_handlers_drop_not_assoc); 605 DEBUGFS_STATS_ADD(tx_handlers_drop_unauth_port); 606 DEBUGFS_STATS_ADD(rx_handlers_drop); 607 DEBUGFS_STATS_ADD(rx_handlers_queued); 608 DEBUGFS_STATS_ADD(rx_handlers_drop_nullfunc); 609 DEBUGFS_STATS_ADD(rx_handlers_drop_defrag); 610 DEBUGFS_STATS_ADD(tx_expand_skb_head); 611 DEBUGFS_STATS_ADD(tx_expand_skb_head_cloned); 612 DEBUGFS_STATS_ADD(rx_expand_skb_head_defrag); 613 DEBUGFS_STATS_ADD(rx_handlers_fragments); 614 DEBUGFS_STATS_ADD(tx_status_drop); 615 #endif 616 DEBUGFS_DEVSTATS_ADD(dot11ACKFailureCount); 617 DEBUGFS_DEVSTATS_ADD(dot11RTSFailureCount); 618 DEBUGFS_DEVSTATS_ADD(dot11FCSErrorCount); 619 DEBUGFS_DEVSTATS_ADD(dot11RTSSuccessCount); 620 } 621