1 /* 2 * mac80211 debugfs for wireless PHYs 3 * 4 * Copyright 2007 Johannes Berg <johannes@sipsolutions.net> 5 * Copyright 2013-2014 Intel Mobile Communications GmbH 6 * Copyright (C) 2018 - 2019 Intel Corporation 7 * 8 * GPLv2 9 * 10 */ 11 12 #include <linux/debugfs.h> 13 #include <linux/rtnetlink.h> 14 #include <linux/vmalloc.h> 15 #include "ieee80211_i.h" 16 #include "driver-ops.h" 17 #include "rate.h" 18 #include "debugfs.h" 19 20 #define DEBUGFS_FORMAT_BUFFER_SIZE 100 21 22 int mac80211_format_buffer(char __user *userbuf, size_t count, 23 loff_t *ppos, char *fmt, ...) 24 { 25 va_list args; 26 char buf[DEBUGFS_FORMAT_BUFFER_SIZE]; 27 int res; 28 29 va_start(args, fmt); 30 res = vscnprintf(buf, sizeof(buf), fmt, args); 31 va_end(args); 32 33 return simple_read_from_buffer(userbuf, count, ppos, buf, res); 34 } 35 36 #define DEBUGFS_READONLY_FILE_FN(name, fmt, value...) \ 37 static ssize_t name## _read(struct file *file, char __user *userbuf, \ 38 size_t count, loff_t *ppos) \ 39 { \ 40 struct ieee80211_local *local = file->private_data; \ 41 \ 42 return mac80211_format_buffer(userbuf, count, ppos, \ 43 fmt "\n", ##value); \ 44 } 45 46 #define DEBUGFS_READONLY_FILE_OPS(name) \ 47 static const struct file_operations name## _ops = { \ 48 .read = name## _read, \ 49 .open = simple_open, \ 50 .llseek = generic_file_llseek, \ 51 }; 52 53 #define DEBUGFS_READONLY_FILE(name, fmt, value...) \ 54 DEBUGFS_READONLY_FILE_FN(name, fmt, value) \ 55 DEBUGFS_READONLY_FILE_OPS(name) 56 57 #define DEBUGFS_ADD(name) \ 58 debugfs_create_file(#name, 0400, phyd, local, &name## _ops); 59 60 #define DEBUGFS_ADD_MODE(name, mode) \ 61 debugfs_create_file(#name, mode, phyd, local, &name## _ops); 62 63 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 force_tx_status_read(struct file *file, 154 char __user *user_buf, 155 size_t count, 156 loff_t *ppos) 157 { 158 struct ieee80211_local *local = file->private_data; 159 char buf[3]; 160 int len = 0; 161 162 len = scnprintf(buf, sizeof(buf), "%d\n", (int)local->force_tx_status); 163 164 return simple_read_from_buffer(user_buf, count, ppos, 165 buf, len); 166 } 167 168 static ssize_t force_tx_status_write(struct file *file, 169 const char __user *user_buf, 170 size_t count, 171 loff_t *ppos) 172 { 173 struct ieee80211_local *local = file->private_data; 174 char buf[3]; 175 size_t len; 176 177 if (count > sizeof(buf)) 178 return -EINVAL; 179 180 if (copy_from_user(buf, user_buf, count)) 181 return -EFAULT; 182 183 buf[sizeof(buf) - 1] = '\0'; 184 len = strlen(buf); 185 if (len > 0 && buf[len - 1] == '\n') 186 buf[len - 1] = 0; 187 188 if (buf[0] == '0' && buf[1] == '\0') 189 local->force_tx_status = 0; 190 else if (buf[0] == '1' && buf[1] == '\0') 191 local->force_tx_status = 1; 192 else 193 return -EINVAL; 194 195 return count; 196 } 197 198 static const struct file_operations force_tx_status_ops = { 199 .write = force_tx_status_write, 200 .read = force_tx_status_read, 201 .open = simple_open, 202 .llseek = default_llseek, 203 }; 204 205 #ifdef CONFIG_PM 206 static ssize_t reset_write(struct file *file, const char __user *user_buf, 207 size_t count, loff_t *ppos) 208 { 209 struct ieee80211_local *local = file->private_data; 210 211 rtnl_lock(); 212 __ieee80211_suspend(&local->hw, NULL); 213 __ieee80211_resume(&local->hw); 214 rtnl_unlock(); 215 216 return count; 217 } 218 219 static const struct file_operations reset_ops = { 220 .write = reset_write, 221 .open = simple_open, 222 .llseek = noop_llseek, 223 }; 224 #endif 225 226 static const char *hw_flag_names[] = { 227 #define FLAG(F) [IEEE80211_HW_##F] = #F 228 FLAG(HAS_RATE_CONTROL), 229 FLAG(RX_INCLUDES_FCS), 230 FLAG(HOST_BROADCAST_PS_BUFFERING), 231 FLAG(SIGNAL_UNSPEC), 232 FLAG(SIGNAL_DBM), 233 FLAG(NEED_DTIM_BEFORE_ASSOC), 234 FLAG(SPECTRUM_MGMT), 235 FLAG(AMPDU_AGGREGATION), 236 FLAG(SUPPORTS_PS), 237 FLAG(PS_NULLFUNC_STACK), 238 FLAG(SUPPORTS_DYNAMIC_PS), 239 FLAG(MFP_CAPABLE), 240 FLAG(WANT_MONITOR_VIF), 241 FLAG(NO_AUTO_VIF), 242 FLAG(SW_CRYPTO_CONTROL), 243 FLAG(SUPPORT_FAST_XMIT), 244 FLAG(REPORTS_TX_ACK_STATUS), 245 FLAG(CONNECTION_MONITOR), 246 FLAG(QUEUE_CONTROL), 247 FLAG(SUPPORTS_PER_STA_GTK), 248 FLAG(AP_LINK_PS), 249 FLAG(TX_AMPDU_SETUP_IN_HW), 250 FLAG(SUPPORTS_RC_TABLE), 251 FLAG(P2P_DEV_ADDR_FOR_INTF), 252 FLAG(TIMING_BEACON_ONLY), 253 FLAG(SUPPORTS_HT_CCK_RATES), 254 FLAG(CHANCTX_STA_CSA), 255 FLAG(SUPPORTS_CLONED_SKBS), 256 FLAG(SINGLE_SCAN_ON_ALL_BANDS), 257 FLAG(TDLS_WIDER_BW), 258 FLAG(SUPPORTS_AMSDU_IN_AMPDU), 259 FLAG(BEACON_TX_STATUS), 260 FLAG(NEEDS_UNIQUE_STA_ADDR), 261 FLAG(SUPPORTS_REORDERING_BUFFER), 262 FLAG(USES_RSS), 263 FLAG(TX_AMSDU), 264 FLAG(TX_FRAG_LIST), 265 FLAG(REPORTS_LOW_ACK), 266 FLAG(SUPPORTS_TX_FRAG), 267 FLAG(SUPPORTS_TDLS_BUFFER_STA), 268 FLAG(DEAUTH_NEED_MGD_TX_PREP), 269 FLAG(DOESNT_SUPPORT_QOS_NDP), 270 FLAG(BUFF_MMPDU_TXQ), 271 FLAG(SUPPORTS_VHT_EXT_NSS_BW), 272 FLAG(STA_MMPDU_TXQ), 273 FLAG(TX_STATUS_NO_AMPDU_LEN), 274 FLAG(SUPPORTS_MULTI_BSSID), 275 FLAG(SUPPORTS_ONLY_HE_MULTI_BSSID), 276 FLAG(EXT_KEY_ID_NATIVE), 277 FLAG(NO_AMPDU_KEYBORDER_SUPPORT), 278 #undef FLAG 279 }; 280 281 static ssize_t hwflags_read(struct file *file, char __user *user_buf, 282 size_t count, loff_t *ppos) 283 { 284 struct ieee80211_local *local = file->private_data; 285 size_t bufsz = 30 * NUM_IEEE80211_HW_FLAGS; 286 char *buf = kzalloc(bufsz, GFP_KERNEL); 287 char *pos = buf, *end = buf + bufsz - 1; 288 ssize_t rv; 289 int i; 290 291 if (!buf) 292 return -ENOMEM; 293 294 /* fail compilation if somebody adds or removes 295 * a flag without updating the name array above 296 */ 297 BUILD_BUG_ON(ARRAY_SIZE(hw_flag_names) != NUM_IEEE80211_HW_FLAGS); 298 299 for (i = 0; i < NUM_IEEE80211_HW_FLAGS; i++) { 300 if (test_bit(i, local->hw.flags)) 301 pos += scnprintf(pos, end - pos, "%s\n", 302 hw_flag_names[i]); 303 } 304 305 rv = simple_read_from_buffer(user_buf, count, ppos, buf, strlen(buf)); 306 kfree(buf); 307 return rv; 308 } 309 310 static ssize_t misc_read(struct file *file, char __user *user_buf, 311 size_t count, loff_t *ppos) 312 { 313 struct ieee80211_local *local = file->private_data; 314 /* Max len of each line is 16 characters, plus 9 for 'pending:\n' */ 315 size_t bufsz = IEEE80211_MAX_QUEUES * 16 + 9; 316 char *buf; 317 char *pos, *end; 318 ssize_t rv; 319 int i; 320 int ln; 321 322 buf = kzalloc(bufsz, GFP_KERNEL); 323 if (!buf) 324 return -ENOMEM; 325 326 pos = buf; 327 end = buf + bufsz - 1; 328 329 pos += scnprintf(pos, end - pos, "pending:\n"); 330 331 for (i = 0; i < IEEE80211_MAX_QUEUES; i++) { 332 ln = skb_queue_len(&local->pending[i]); 333 pos += scnprintf(pos, end - pos, "[%i] %d\n", 334 i, ln); 335 } 336 337 rv = simple_read_from_buffer(user_buf, count, ppos, buf, strlen(buf)); 338 kfree(buf); 339 return rv; 340 } 341 342 static ssize_t queues_read(struct file *file, char __user *user_buf, 343 size_t count, loff_t *ppos) 344 { 345 struct ieee80211_local *local = file->private_data; 346 unsigned long flags; 347 char buf[IEEE80211_MAX_QUEUES * 20]; 348 int q, res = 0; 349 350 spin_lock_irqsave(&local->queue_stop_reason_lock, flags); 351 for (q = 0; q < local->hw.queues; q++) 352 res += sprintf(buf + res, "%02d: %#.8lx/%d\n", q, 353 local->queue_stop_reasons[q], 354 skb_queue_len(&local->pending[q])); 355 spin_unlock_irqrestore(&local->queue_stop_reason_lock, flags); 356 357 return simple_read_from_buffer(user_buf, count, ppos, buf, res); 358 } 359 360 DEBUGFS_READONLY_FILE_OPS(hwflags); 361 DEBUGFS_READONLY_FILE_OPS(queues); 362 DEBUGFS_READONLY_FILE_OPS(misc); 363 364 /* statistics stuff */ 365 366 static ssize_t format_devstat_counter(struct ieee80211_local *local, 367 char __user *userbuf, 368 size_t count, loff_t *ppos, 369 int (*printvalue)(struct ieee80211_low_level_stats *stats, char *buf, 370 int buflen)) 371 { 372 struct ieee80211_low_level_stats stats; 373 char buf[20]; 374 int res; 375 376 rtnl_lock(); 377 res = drv_get_stats(local, &stats); 378 rtnl_unlock(); 379 if (res) 380 return res; 381 res = printvalue(&stats, buf, sizeof(buf)); 382 return simple_read_from_buffer(userbuf, count, ppos, buf, res); 383 } 384 385 #define DEBUGFS_DEVSTATS_FILE(name) \ 386 static int print_devstats_##name(struct ieee80211_low_level_stats *stats,\ 387 char *buf, int buflen) \ 388 { \ 389 return scnprintf(buf, buflen, "%u\n", stats->name); \ 390 } \ 391 static ssize_t stats_ ##name## _read(struct file *file, \ 392 char __user *userbuf, \ 393 size_t count, loff_t *ppos) \ 394 { \ 395 return format_devstat_counter(file->private_data, \ 396 userbuf, \ 397 count, \ 398 ppos, \ 399 print_devstats_##name); \ 400 } \ 401 \ 402 static const struct file_operations stats_ ##name## _ops = { \ 403 .read = stats_ ##name## _read, \ 404 .open = simple_open, \ 405 .llseek = generic_file_llseek, \ 406 }; 407 408 #define DEBUGFS_STATS_ADD(name) \ 409 debugfs_create_u32(#name, 0400, statsd, &local->name); 410 #define DEBUGFS_DEVSTATS_ADD(name) \ 411 debugfs_create_file(#name, 0400, statsd, local, &stats_ ##name## _ops); 412 413 DEBUGFS_DEVSTATS_FILE(dot11ACKFailureCount); 414 DEBUGFS_DEVSTATS_FILE(dot11RTSFailureCount); 415 DEBUGFS_DEVSTATS_FILE(dot11FCSErrorCount); 416 DEBUGFS_DEVSTATS_FILE(dot11RTSSuccessCount); 417 418 void debugfs_hw_add(struct ieee80211_local *local) 419 { 420 struct dentry *phyd = local->hw.wiphy->debugfsdir; 421 struct dentry *statsd; 422 423 if (!phyd) 424 return; 425 426 local->debugfs.keys = debugfs_create_dir("keys", phyd); 427 428 DEBUGFS_ADD(total_ps_buffered); 429 DEBUGFS_ADD(wep_iv); 430 DEBUGFS_ADD(rate_ctrl_alg); 431 DEBUGFS_ADD(queues); 432 DEBUGFS_ADD(misc); 433 #ifdef CONFIG_PM 434 DEBUGFS_ADD_MODE(reset, 0200); 435 #endif 436 DEBUGFS_ADD(hwflags); 437 DEBUGFS_ADD(user_power); 438 DEBUGFS_ADD(power); 439 DEBUGFS_ADD_MODE(force_tx_status, 0600); 440 441 if (local->ops->wake_tx_queue) 442 DEBUGFS_ADD_MODE(aqm, 0600); 443 444 debugfs_create_u16("airtime_flags", 0600, 445 phyd, &local->airtime_flags); 446 447 statsd = debugfs_create_dir("statistics", phyd); 448 449 /* if the dir failed, don't put all the other things into the root! */ 450 if (!statsd) 451 return; 452 453 #ifdef CONFIG_MAC80211_DEBUG_COUNTERS 454 DEBUGFS_STATS_ADD(dot11TransmittedFragmentCount); 455 DEBUGFS_STATS_ADD(dot11MulticastTransmittedFrameCount); 456 DEBUGFS_STATS_ADD(dot11FailedCount); 457 DEBUGFS_STATS_ADD(dot11RetryCount); 458 DEBUGFS_STATS_ADD(dot11MultipleRetryCount); 459 DEBUGFS_STATS_ADD(dot11FrameDuplicateCount); 460 DEBUGFS_STATS_ADD(dot11ReceivedFragmentCount); 461 DEBUGFS_STATS_ADD(dot11MulticastReceivedFrameCount); 462 DEBUGFS_STATS_ADD(dot11TransmittedFrameCount); 463 DEBUGFS_STATS_ADD(tx_handlers_drop); 464 DEBUGFS_STATS_ADD(tx_handlers_queued); 465 DEBUGFS_STATS_ADD(tx_handlers_drop_wep); 466 DEBUGFS_STATS_ADD(tx_handlers_drop_not_assoc); 467 DEBUGFS_STATS_ADD(tx_handlers_drop_unauth_port); 468 DEBUGFS_STATS_ADD(rx_handlers_drop); 469 DEBUGFS_STATS_ADD(rx_handlers_queued); 470 DEBUGFS_STATS_ADD(rx_handlers_drop_nullfunc); 471 DEBUGFS_STATS_ADD(rx_handlers_drop_defrag); 472 DEBUGFS_STATS_ADD(tx_expand_skb_head); 473 DEBUGFS_STATS_ADD(tx_expand_skb_head_cloned); 474 DEBUGFS_STATS_ADD(rx_expand_skb_head_defrag); 475 DEBUGFS_STATS_ADD(rx_handlers_fragments); 476 DEBUGFS_STATS_ADD(tx_status_drop); 477 #endif 478 DEBUGFS_DEVSTATS_ADD(dot11ACKFailureCount); 479 DEBUGFS_DEVSTATS_ADD(dot11RTSFailureCount); 480 DEBUGFS_DEVSTATS_ADD(dot11FCSErrorCount); 481 DEBUGFS_DEVSTATS_ADD(dot11RTSSuccessCount); 482 } 483