linux/net/mac80211/debugfs.c
<<
>>
Prefs
   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 *
   7 * GPLv2
   8 *
   9 */
  10
  11#include <linux/debugfs.h>
  12#include <linux/rtnetlink.h>
  13#include <linux/vmalloc.h>
  14#include "ieee80211_i.h"
  15#include "driver-ops.h"
  16#include "rate.h"
  17#include "debugfs.h"
  18
  19#define DEBUGFS_FORMAT_BUFFER_SIZE 100
  20
  21int mac80211_format_buffer(char __user *userbuf, size_t count,
  22                                  loff_t *ppos, char *fmt, ...)
  23{
  24        va_list args;
  25        char buf[DEBUGFS_FORMAT_BUFFER_SIZE];
  26        int res;
  27
  28        va_start(args, fmt);
  29        res = vscnprintf(buf, sizeof(buf), fmt, args);
  30        va_end(args);
  31
  32        return simple_read_from_buffer(userbuf, count, ppos, buf, res);
  33}
  34
  35#define DEBUGFS_READONLY_FILE_FN(name, fmt, value...)                   \
  36static ssize_t name## _read(struct file *file, char __user *userbuf,    \
  37                            size_t count, loff_t *ppos)                 \
  38{                                                                       \
  39        struct ieee80211_local *local = file->private_data;             \
  40                                                                        \
  41        return mac80211_format_buffer(userbuf, count, ppos,             \
  42                                      fmt "\n", ##value);               \
  43}
  44
  45#define DEBUGFS_READONLY_FILE_OPS(name)                 \
  46static const struct file_operations name## _ops = {                     \
  47        .read = name## _read,                                           \
  48        .open = simple_open,                                            \
  49        .llseek = generic_file_llseek,                                  \
  50};
  51
  52#define DEBUGFS_READONLY_FILE(name, fmt, value...)              \
  53        DEBUGFS_READONLY_FILE_FN(name, fmt, value)              \
  54        DEBUGFS_READONLY_FILE_OPS(name)
  55
  56#define DEBUGFS_ADD(name)                                               \
  57        debugfs_create_file(#name, 0400, phyd, local, &name## _ops);
  58
  59#define DEBUGFS_ADD_MODE(name, mode)                                    \
  60        debugfs_create_file(#name, mode, phyd, local, &name## _ops);
  61
  62
  63DEBUGFS_READONLY_FILE(user_power, "%d",
  64                      local->user_power_level);
  65DEBUGFS_READONLY_FILE(power, "%d",
  66                      local->hw.conf.power_level);
  67DEBUGFS_READONLY_FILE(total_ps_buffered, "%d",
  68                      local->total_ps_buffered);
  69DEBUGFS_READONLY_FILE(wep_iv, "%#08x",
  70                      local->wep_iv & 0xffffff);
  71DEBUGFS_READONLY_FILE(rate_ctrl_alg, "%s",
  72        local->rate_ctrl ? local->rate_ctrl->ops->name : "hw/driver");
  73
  74static ssize_t aqm_read(struct file *file,
  75                        char __user *user_buf,
  76                        size_t count,
  77                        loff_t *ppos)
  78{
  79        struct ieee80211_local *local = file->private_data;
  80        struct fq *fq = &local->fq;
  81        char buf[200];
  82        int len = 0;
  83
  84        spin_lock_bh(&local->fq.lock);
  85        rcu_read_lock();
  86
  87        len = scnprintf(buf, sizeof(buf),
  88                        "access name value\n"
  89                        "R fq_flows_cnt %u\n"
  90                        "R fq_backlog %u\n"
  91                        "R fq_overlimit %u\n"
  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"
  96                        "RW fq_limit %u\n"
  97                        "RW fq_quantum %u\n",
  98                        fq->flows_cnt,
  99                        fq->backlog,
 100                        fq->overmemory,
 101                        fq->overlimit,
 102                        fq->collisions,
 103                        fq->memory_usage,
 104                        fq->memory_limit,
 105                        fq->limit,
 106                        fq->quantum);
 107
 108        rcu_read_unlock();
 109        spin_unlock_bh(&local->fq.lock);
 110
 111        return simple_read_from_buffer(user_buf, count, ppos,
 112                                       buf, len);
 113}
 114
 115static ssize_t aqm_write(struct file *file,
 116                         const char __user *user_buf,
 117                         size_t count,
 118                         loff_t *ppos)
 119{
 120        struct ieee80211_local *local = file->private_data;
 121        char buf[100];
 122        size_t len;
 123
 124        if (count > sizeof(buf))
 125                return -EINVAL;
 126
 127        if (copy_from_user(buf, user_buf, count))
 128                return -EFAULT;
 129
 130        buf[sizeof(buf) - 1] = '\0';
 131        len = strlen(buf);
 132        if (len > 0 && buf[len-1] == '\n')
 133                buf[len-1] = 0;
 134
 135        if (sscanf(buf, "fq_limit %u", &local->fq.limit) == 1)
 136                return count;
 137        else if (sscanf(buf, "fq_memory_limit %u", &local->fq.memory_limit) == 1)
 138                return count;
 139        else if (sscanf(buf, "fq_quantum %u", &local->fq.quantum) == 1)
 140                return count;
 141
 142        return -EINVAL;
 143}
 144
 145static const struct file_operations aqm_ops = {
 146        .write = aqm_write,
 147        .read = aqm_read,
 148        .open = simple_open,
 149        .llseek = default_llseek,
 150};
 151
 152#ifdef CONFIG_PM
 153static ssize_t reset_write(struct file *file, const char __user *user_buf,
 154                           size_t count, loff_t *ppos)
 155{
 156        struct ieee80211_local *local = file->private_data;
 157
 158        rtnl_lock();
 159        __ieee80211_suspend(&local->hw, NULL);
 160        __ieee80211_resume(&local->hw);
 161        rtnl_unlock();
 162
 163        return count;
 164}
 165
 166static const struct file_operations reset_ops = {
 167        .write = reset_write,
 168        .open = simple_open,
 169        .llseek = noop_llseek,
 170};
 171#endif
 172
 173static const char *hw_flag_names[] = {
 174#define FLAG(F) [IEEE80211_HW_##F] = #F
 175        FLAG(HAS_RATE_CONTROL),
 176        FLAG(RX_INCLUDES_FCS),
 177        FLAG(HOST_BROADCAST_PS_BUFFERING),
 178        FLAG(SIGNAL_UNSPEC),
 179        FLAG(SIGNAL_DBM),
 180        FLAG(NEED_DTIM_BEFORE_ASSOC),
 181        FLAG(SPECTRUM_MGMT),
 182        FLAG(AMPDU_AGGREGATION),
 183        FLAG(SUPPORTS_PS),
 184        FLAG(PS_NULLFUNC_STACK),
 185        FLAG(SUPPORTS_DYNAMIC_PS),
 186        FLAG(MFP_CAPABLE),
 187        FLAG(WANT_MONITOR_VIF),
 188        FLAG(NO_AUTO_VIF),
 189        FLAG(SW_CRYPTO_CONTROL),
 190        FLAG(SUPPORT_FAST_XMIT),
 191        FLAG(REPORTS_TX_ACK_STATUS),
 192        FLAG(CONNECTION_MONITOR),
 193        FLAG(QUEUE_CONTROL),
 194        FLAG(SUPPORTS_PER_STA_GTK),
 195        FLAG(AP_LINK_PS),
 196        FLAG(TX_AMPDU_SETUP_IN_HW),
 197        FLAG(SUPPORTS_RC_TABLE),
 198        FLAG(P2P_DEV_ADDR_FOR_INTF),
 199        FLAG(TIMING_BEACON_ONLY),
 200        FLAG(SUPPORTS_HT_CCK_RATES),
 201        FLAG(CHANCTX_STA_CSA),
 202        FLAG(SUPPORTS_CLONED_SKBS),
 203        FLAG(SINGLE_SCAN_ON_ALL_BANDS),
 204        FLAG(TDLS_WIDER_BW),
 205        FLAG(SUPPORTS_AMSDU_IN_AMPDU),
 206        FLAG(BEACON_TX_STATUS),
 207        FLAG(NEEDS_UNIQUE_STA_ADDR),
 208        FLAG(SUPPORTS_REORDERING_BUFFER),
 209        FLAG(USES_RSS),
 210        FLAG(TX_AMSDU),
 211        FLAG(TX_FRAG_LIST),
 212        FLAG(REPORTS_LOW_ACK),
 213        FLAG(SUPPORTS_TX_FRAG),
 214        FLAG(SUPPORTS_TDLS_BUFFER_STA),
 215        FLAG(DEAUTH_NEED_MGD_TX_PREP),
 216        FLAG(DOESNT_SUPPORT_QOS_NDP),
 217#undef FLAG
 218};
 219
 220static ssize_t hwflags_read(struct file *file, char __user *user_buf,
 221                            size_t count, loff_t *ppos)
 222{
 223        struct ieee80211_local *local = file->private_data;
 224        size_t bufsz = 30 * NUM_IEEE80211_HW_FLAGS;
 225        char *buf = kzalloc(bufsz, GFP_KERNEL);
 226        char *pos = buf, *end = buf + bufsz - 1;
 227        ssize_t rv;
 228        int i;
 229
 230        if (!buf)
 231                return -ENOMEM;
 232
 233        /* fail compilation if somebody adds or removes
 234         * a flag without updating the name array above
 235         */
 236        BUILD_BUG_ON(ARRAY_SIZE(hw_flag_names) != NUM_IEEE80211_HW_FLAGS);
 237
 238        for (i = 0; i < NUM_IEEE80211_HW_FLAGS; i++) {
 239                if (test_bit(i, local->hw.flags))
 240                        pos += scnprintf(pos, end - pos, "%s\n",
 241                                         hw_flag_names[i]);
 242        }
 243
 244        rv = simple_read_from_buffer(user_buf, count, ppos, buf, strlen(buf));
 245        kfree(buf);
 246        return rv;
 247}
 248
 249static ssize_t misc_read(struct file *file, char __user *user_buf,
 250                         size_t count, loff_t *ppos)
 251{
 252        struct ieee80211_local *local = file->private_data;
 253        /* Max len of each line is 16 characters, plus 9 for 'pending:\n' */
 254        size_t bufsz = IEEE80211_MAX_QUEUES * 16 + 9;
 255        char *buf;
 256        char *pos, *end;
 257        ssize_t rv;
 258        int i;
 259        int ln;
 260
 261        buf = kzalloc(bufsz, GFP_KERNEL);
 262        if (!buf)
 263                return -ENOMEM;
 264
 265        pos = buf;
 266        end = buf + bufsz - 1;
 267
 268        pos += scnprintf(pos, end - pos, "pending:\n");
 269
 270        for (i = 0; i < IEEE80211_MAX_QUEUES; i++) {
 271                ln = skb_queue_len(&local->pending[i]);
 272                pos += scnprintf(pos, end - pos, "[%i] %d\n",
 273                                 i, ln);
 274        }
 275
 276        rv = simple_read_from_buffer(user_buf, count, ppos, buf, strlen(buf));
 277        kfree(buf);
 278        return rv;
 279}
 280
 281static ssize_t queues_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        unsigned long flags;
 286        char buf[IEEE80211_MAX_QUEUES * 20];
 287        int q, res = 0;
 288
 289        spin_lock_irqsave(&local->queue_stop_reason_lock, flags);
 290        for (q = 0; q < local->hw.queues; q++)
 291                res += sprintf(buf + res, "%02d: %#.8lx/%d\n", q,
 292                                local->queue_stop_reasons[q],
 293                                skb_queue_len(&local->pending[q]));
 294        spin_unlock_irqrestore(&local->queue_stop_reason_lock, flags);
 295
 296        return simple_read_from_buffer(user_buf, count, ppos, buf, res);
 297}
 298
 299DEBUGFS_READONLY_FILE_OPS(hwflags);
 300DEBUGFS_READONLY_FILE_OPS(queues);
 301DEBUGFS_READONLY_FILE_OPS(misc);
 302
 303/* statistics stuff */
 304
 305static ssize_t format_devstat_counter(struct ieee80211_local *local,
 306        char __user *userbuf,
 307        size_t count, loff_t *ppos,
 308        int (*printvalue)(struct ieee80211_low_level_stats *stats, char *buf,
 309                          int buflen))
 310{
 311        struct ieee80211_low_level_stats stats;
 312        char buf[20];
 313        int res;
 314
 315        rtnl_lock();
 316        res = drv_get_stats(local, &stats);
 317        rtnl_unlock();
 318        if (res)
 319                return res;
 320        res = printvalue(&stats, buf, sizeof(buf));
 321        return simple_read_from_buffer(userbuf, count, ppos, buf, res);
 322}
 323
 324#define DEBUGFS_DEVSTATS_FILE(name)                                     \
 325static int print_devstats_##name(struct ieee80211_low_level_stats *stats,\
 326                                 char *buf, int buflen)                 \
 327{                                                                       \
 328        return scnprintf(buf, buflen, "%u\n", stats->name);             \
 329}                                                                       \
 330static ssize_t stats_ ##name## _read(struct file *file,                 \
 331                                     char __user *userbuf,              \
 332                                     size_t count, loff_t *ppos)        \
 333{                                                                       \
 334        return format_devstat_counter(file->private_data,               \
 335                                      userbuf,                          \
 336                                      count,                            \
 337                                      ppos,                             \
 338                                      print_devstats_##name);           \
 339}                                                                       \
 340                                                                        \
 341static const struct file_operations stats_ ##name## _ops = {            \
 342        .read = stats_ ##name## _read,                                  \
 343        .open = simple_open,                                            \
 344        .llseek = generic_file_llseek,                                  \
 345};
 346
 347#define DEBUGFS_STATS_ADD(name)                                 \
 348        debugfs_create_u32(#name, 0400, statsd, &local->name);
 349#define DEBUGFS_DEVSTATS_ADD(name)                                      \
 350        debugfs_create_file(#name, 0400, statsd, local, &stats_ ##name## _ops);
 351
 352DEBUGFS_DEVSTATS_FILE(dot11ACKFailureCount);
 353DEBUGFS_DEVSTATS_FILE(dot11RTSFailureCount);
 354DEBUGFS_DEVSTATS_FILE(dot11FCSErrorCount);
 355DEBUGFS_DEVSTATS_FILE(dot11RTSSuccessCount);
 356
 357void debugfs_hw_add(struct ieee80211_local *local)
 358{
 359        struct dentry *phyd = local->hw.wiphy->debugfsdir;
 360        struct dentry *statsd;
 361
 362        if (!phyd)
 363                return;
 364
 365        local->debugfs.keys = debugfs_create_dir("keys", phyd);
 366
 367        DEBUGFS_ADD(total_ps_buffered);
 368        DEBUGFS_ADD(wep_iv);
 369        DEBUGFS_ADD(rate_ctrl_alg);
 370        DEBUGFS_ADD(queues);
 371        DEBUGFS_ADD(misc);
 372#ifdef CONFIG_PM
 373        DEBUGFS_ADD_MODE(reset, 0200);
 374#endif
 375        DEBUGFS_ADD(hwflags);
 376        DEBUGFS_ADD(user_power);
 377        DEBUGFS_ADD(power);
 378
 379        if (local->ops->wake_tx_queue)
 380                DEBUGFS_ADD_MODE(aqm, 0600);
 381
 382        statsd = debugfs_create_dir("statistics", phyd);
 383
 384        /* if the dir failed, don't put all the other things into the root! */
 385        if (!statsd)
 386                return;
 387
 388#ifdef CONFIG_MAC80211_DEBUG_COUNTERS
 389        DEBUGFS_STATS_ADD(dot11TransmittedFragmentCount);
 390        DEBUGFS_STATS_ADD(dot11MulticastTransmittedFrameCount);
 391        DEBUGFS_STATS_ADD(dot11FailedCount);
 392        DEBUGFS_STATS_ADD(dot11RetryCount);
 393        DEBUGFS_STATS_ADD(dot11MultipleRetryCount);
 394        DEBUGFS_STATS_ADD(dot11FrameDuplicateCount);
 395        DEBUGFS_STATS_ADD(dot11ReceivedFragmentCount);
 396        DEBUGFS_STATS_ADD(dot11MulticastReceivedFrameCount);
 397        DEBUGFS_STATS_ADD(dot11TransmittedFrameCount);
 398        DEBUGFS_STATS_ADD(tx_handlers_drop);
 399        DEBUGFS_STATS_ADD(tx_handlers_queued);
 400        DEBUGFS_STATS_ADD(tx_handlers_drop_wep);
 401        DEBUGFS_STATS_ADD(tx_handlers_drop_not_assoc);
 402        DEBUGFS_STATS_ADD(tx_handlers_drop_unauth_port);
 403        DEBUGFS_STATS_ADD(rx_handlers_drop);
 404        DEBUGFS_STATS_ADD(rx_handlers_queued);
 405        DEBUGFS_STATS_ADD(rx_handlers_drop_nullfunc);
 406        DEBUGFS_STATS_ADD(rx_handlers_drop_defrag);
 407        DEBUGFS_STATS_ADD(tx_expand_skb_head);
 408        DEBUGFS_STATS_ADD(tx_expand_skb_head_cloned);
 409        DEBUGFS_STATS_ADD(rx_expand_skb_head_defrag);
 410        DEBUGFS_STATS_ADD(rx_handlers_fragments);
 411        DEBUGFS_STATS_ADD(tx_status_drop);
 412#endif
 413        DEBUGFS_DEVSTATS_ADD(dot11ACKFailureCount);
 414        DEBUGFS_DEVSTATS_ADD(dot11RTSFailureCount);
 415        DEBUGFS_DEVSTATS_ADD(dot11FCSErrorCount);
 416        DEBUGFS_DEVSTATS_ADD(dot11RTSSuccessCount);
 417}
 418