net/mac80211/main.c

   1 /*
   2  * Copyright 2002-2005, Instant802 Networks, Inc.
   3  * Copyright 2005-2006, Devicescape Software, Inc.
   4  * Copyright 2006-2007  Jiri Benc <jbenc@suse.cz>
   5  *
   6  * This program is free software; you can redistribute it and/or modify
   7  * it under the terms of the GNU General Public License version 2 as
   8  * published by the Free Software Foundation.
   9  */
  10
  11 #include <net/mac80211.h>
  12 #include <linux/module.h>
  13 #include <linux/init.h>
  14 #include <linux/netdevice.h>
  15 #include <linux/types.h>
  16 #include <linux/slab.h>
  17 #include <linux/skbuff.h>
  18 #include <linux/etherdevice.h>
  19 #include <linux/if_arp.h>
  20 #include <linux/rtnetlink.h>
  21 #include <linux/bitmap.h>
  22 #include <linux/pm_qos.h>
  23 #include <linux/inetdevice.h>
  24 #include <net/net_namespace.h>
  25 #include <net/cfg80211.h>
  26 #include <net/addrconf.h>
  27
  28 #include "ieee80211_i.h"
  29 #include "driver-ops.h"
  30 #include "rate.h"
  31 #include "mesh.h"
  32 #include "wep.h"
  33 #include "led.h"
  34 #include "cfg.h"
  35 #include "debugfs.h"
  36
  37 void ieee80211_configure_filter(struct ieee80211_local *local)
  38 {
  39         u64 mc;
  40         unsigned int changed_flags;
  41         unsigned int new_flags = 0;
  42
  43         if (atomic_read(&local->iff_promiscs))
  44                 new_flags |= FIF_PROMISC_IN_BSS;
  45
  46         if (atomic_read(&local->iff_allmultis))
  47                 new_flags |= FIF_ALLMULTI;
  48
  49         if (local->monitors || test_bit(SCAN_SW_SCANNING, &local->scanning) ||
  50             test_bit(SCAN_ONCHANNEL_SCANNING, &local->scanning))
  51                 new_flags |= FIF_BCN_PRBRESP_PROMISC;
  52
  53         if (local->fif_probe_req || local->probe_req_reg)
  54                 new_flags |= FIF_PROBE_REQ;
  55
  56         if (local->fif_fcsfail)
  57                 new_flags |= FIF_FCSFAIL;
  58
  59         if (local->fif_plcpfail)
  60                 new_flags |= FIF_PLCPFAIL;
  61
  62         if (local->fif_control)
  63                 new_flags |= FIF_CONTROL;
  64
  65         if (local->fif_other_bss)
  66                 new_flags |= FIF_OTHER_BSS;
  67
  68         if (local->fif_pspoll)
  69                 new_flags |= FIF_PSPOLL;
  70
  71         spin_lock_bh(&local->filter_lock);
  72         changed_flags = local->filter_flags ^ new_flags;
  73
  74         mc = drv_prepare_multicast(local, &local->mc_list);
  75         spin_unlock_bh(&local->filter_lock);
  76
  77         /* be a bit nasty */
  78         new_flags |= (1<<31);
  79
  80         drv_configure_filter(local, changed_flags, &new_flags, mc);
  81
  82         WARN_ON(new_flags & (1<<31));
  83
  84         local->filter_flags = new_flags & ~(1<<31);
  85 }
  86
  87 static void ieee80211_reconfig_filter(struct work_struct *work)
  88 {
  89         struct ieee80211_local *local =
  90                 container_of(work, struct ieee80211_local, reconfig_filter);
  91
  92         ieee80211_configure_filter(local);
  93 }
  94
  95 static u32 ieee80211_hw_conf_chan(struct ieee80211_local *local)
  96 {
  97         struct ieee80211_sub_if_data *sdata;
  98         struct cfg80211_chan_def chandef = {};
  99         u32 changed = 0;
 100         int power;
 101         u32 offchannel_flag;
 102
 103         offchannel_flag = local->hw.conf.flags & IEEE80211_CONF_OFFCHANNEL;
 104
 105         if (local->scan_chandef.chan) {
 106                 chandef = local->scan_chandef;
 107         } else if (local->tmp_channel) {
 108                 chandef.chan = local->tmp_channel;
 109                 chandef.width = NL80211_CHAN_WIDTH_20_NOHT;
 110                 chandef.center_freq1 = chandef.chan->center_freq;
 111         } else
 112                 chandef = local->_oper_chandef;
 113
 114         WARN(!cfg80211_chandef_valid(&chandef),
 115              "control:%d MHz width:%d center: %d/%d MHz",
 116              chandef.chan->center_freq, chandef.width,
 117              chandef.center_freq1, chandef.center_freq2);
 118
 119         if (!cfg80211_chandef_identical(&chandef, &local->_oper_chandef))
 120                 local->hw.conf.flags |= IEEE80211_CONF_OFFCHANNEL;
 121         else
 122                 local->hw.conf.flags &= ~IEEE80211_CONF_OFFCHANNEL;
 123
 124         offchannel_flag ^= local->hw.conf.flags & IEEE80211_CONF_OFFCHANNEL;
 125
 126         if (offchannel_flag ||
 127             !cfg80211_chandef_identical(&local->hw.conf.chandef,
 128                                         &local->_oper_chandef)) {
 129                 local->hw.conf.chandef = chandef;
 130                 changed |= IEEE80211_CONF_CHANGE_CHANNEL;
 131         }
 132
 133         if (!conf_is_ht(&local->hw.conf)) {
 134                 /*
 135                  * mac80211.h documents that this is only valid
 136                  * when the channel is set to an HT type, and
 137                  * that otherwise STATIC is used.
 138                  */
 139                 local->hw.conf.smps_mode = IEEE80211_SMPS_STATIC;
 140         } else if (local->hw.conf.smps_mode != local->smps_mode) {
 141                 local->hw.conf.smps_mode = local->smps_mode;
 142                 changed |= IEEE80211_CONF_CHANGE_SMPS;
 143         }
 144
 145         power = ieee80211_chandef_max_power(&chandef);
 146
 147         rcu_read_lock();
 148         list_for_each_entry_rcu(sdata, &local->interfaces, list) {
 149                 if (!rcu_access_pointer(sdata->vif.chanctx_conf))
 150                         continue;
 151                 power = min(power, sdata->vif.bss_conf.txpower);
 152         }
 153         rcu_read_unlock();
 154
 155         if (local->hw.conf.power_level != power) {
 156                 changed |= IEEE80211_CONF_CHANGE_POWER;
 157                 local->hw.conf.power_level = power;
 158         }
 159
 160         return changed;
 161 }
 162
 163 int ieee80211_hw_config(struct ieee80211_local *local, u32 changed)
 164 {
 165         int ret = 0;
 166
 167         might_sleep();
 168
 169         if (!local->use_chanctx)
 170                 changed |= ieee80211_hw_conf_chan(local);
 171         else
 172                 changed &= ~(IEEE80211_CONF_CHANGE_CHANNEL |
 173                              IEEE80211_CONF_CHANGE_POWER);
 174
 175         if (changed && local->open_count) {
 176                 ret = drv_config(local, changed);
 177                 /*
 178                  * Goal:
 179                  * HW reconfiguration should never fail, the driver has told
 180                  * us what it can support so it should live up to that promise.
 181                  *
 182                  * Current status:
 183                  * rfkill is not integrated with mac80211 and a
 184                  * configuration command can thus fail if hardware rfkill
 185                  * is enabled
 186                  *
 187                  * FIXME: integrate rfkill with mac80211 and then add this
 188                  * WARN_ON() back
 189                  *
 190                  */
 191                 /* WARN_ON(ret); */
 192         }
 193
 194         return ret;
 195 }
 196
 197 void ieee80211_bss_info_change_notify(struct ieee80211_sub_if_data *sdata,
 198                                       u32 changed)
 199 {
 200         struct ieee80211_local *local = sdata->local;
 201
 202         if (!changed)
 203                 return;
 204
 205         drv_bss_info_changed(local, sdata, &sdata->vif.bss_conf, changed);
 206 }
 207
 208 u32 ieee80211_reset_erp_info(struct ieee80211_sub_if_data *sdata)
 209 {
 210         sdata->vif.bss_conf.use_cts_prot = false;
 211         sdata->vif.bss_conf.use_short_preamble = false;
 212         sdata->vif.bss_conf.use_short_slot = false;
 213         return BSS_CHANGED_ERP_CTS_PROT |
 214                BSS_CHANGED_ERP_PREAMBLE |
 215                BSS_CHANGED_ERP_SLOT;
 216 }
 217
 218 static void ieee80211_tasklet_handler(unsigned long data)
 219 {
 220         struct ieee80211_local *local = (struct ieee80211_local *) data;
 221         struct sk_buff *skb;
 222
 223         while ((skb = skb_dequeue(&local->skb_queue)) ||
 224                (skb = skb_dequeue(&local->skb_queue_unreliable))) {
 225                 switch (skb->pkt_type) {
 226                 case IEEE80211_RX_MSG:
 227                         /* Clear skb->pkt_type in order to not confuse kernel
 228                          * netstack. */
 229                         skb->pkt_type = 0;
 230                         ieee80211_rx(&local->hw, skb);
 231                         break;
 232                 case IEEE80211_TX_STATUS_MSG:
 233                         skb->pkt_type = 0;
 234                         ieee80211_tx_status(&local->hw, skb);
 235                         break;
 236                 default:
 237                         WARN(1, "mac80211: Packet is of unknown type %d\n",
 238                              skb->pkt_type);
 239                         dev_kfree_skb(skb);
 240                         break;
 241                 }
 242         }
 243 }
 244
 245 static void ieee80211_restart_work(struct work_struct *work)
 246 {
 247         struct ieee80211_local *local =
 248                 container_of(work, struct ieee80211_local, restart_work);
 249
 250         /* wait for scan work complete */
 251         flush_workqueue(local->workqueue);
 252
 253         mutex_lock(&local->mtx);
 254         WARN(test_bit(SCAN_HW_SCANNING, &local->scanning) ||
 255              rcu_dereference_protected(local->sched_scan_sdata,
 256                                        lockdep_is_held(&local->mtx)),
 257                 "%s called with hardware scan in progress\n", __func__);
 258         mutex_unlock(&local->mtx);
 259
 260         rtnl_lock();
 261         ieee80211_scan_cancel(local);
 262         ieee80211_reconfig(local);
 263         rtnl_unlock();
 264 }
 265
 266 void ieee80211_restart_hw(struct ieee80211_hw *hw)
 267 {
 268         struct ieee80211_local *local = hw_to_local(hw);
 269
 270         trace_api_restart_hw(local);
 271
 272         wiphy_info(hw->wiphy,
 273                    "Hardware restart was requested\n");
 274
 275         /* use this reason, ieee80211_reconfig will unblock it */
 276         ieee80211_stop_queues_by_reason(hw, IEEE80211_MAX_QUEUE_MAP,
 277                                         IEEE80211_QUEUE_STOP_REASON_SUSPEND);
 278
 279         /*
 280          * Stop all Rx during the reconfig. We don't want state changes
 281          * or driver callbacks while this is in progress.
 282          */
 283         local->in_reconfig = true;
 284         barrier();
 285
 286         schedule_work(&local->restart_work);
 287 }
 288 EXPORT_SYMBOL(ieee80211_restart_hw);
 289
 290 #ifdef CONFIG_INET
 291 static int ieee80211_ifa_changed(struct notifier_block *nb,
 292                                  unsigned long data, void *arg)
 293 {
 294         struct in_ifaddr *ifa = arg;
 295         struct ieee80211_local *local =
 296                 container_of(nb, struct ieee80211_local,
 297                              ifa_notifier);
 298         struct net_device *ndev = ifa->ifa_dev->dev;
 299         struct wireless_dev *wdev = ndev->ieee80211_ptr;
 300         struct in_device *idev;
 301         struct ieee80211_sub_if_data *sdata;
 302         struct ieee80211_bss_conf *bss_conf;
 303         struct ieee80211_if_managed *ifmgd;
 304         int c = 0;
 305
 306         /* Make sure it's our interface that got changed */
 307         if (!wdev)
 308                 return NOTIFY_DONE;
 309
 310         if (wdev->wiphy != local->hw.wiphy)
 311                 return NOTIFY_DONE;
 312
 313         sdata = IEEE80211_DEV_TO_SUB_IF(ndev);
 314         bss_conf = &sdata->vif.bss_conf;
 315
 316         /* ARP filtering is only supported in managed mode */
 317         if (sdata->vif.type != NL80211_IFTYPE_STATION)
 318                 return NOTIFY_DONE;
 319
 320         idev = __in_dev_get_rtnl(sdata->dev);
 321         if (!idev)
 322                 return NOTIFY_DONE;
 323
 324         ifmgd = &sdata->u.mgd;
 325         sdata_lock(sdata);
 326
 327         /* Copy the addresses to the bss_conf list */
 328         ifa = idev->ifa_list;
 329         while (ifa) {
 330                 if (c < IEEE80211_BSS_ARP_ADDR_LIST_LEN)
 331                         bss_conf->arp_addr_list[c] = ifa->ifa_address;
 332                 ifa = ifa->ifa_next;
 333                 c++;
 334         }
 335
 336         bss_conf->arp_addr_cnt = c;
 337
 338         /* Configure driver only if associated (which also implies it is up) */
 339         if (ifmgd->associated)
 340                 ieee80211_bss_info_change_notify(sdata,
 341                                                  BSS_CHANGED_ARP_FILTER);
 342
 343         sdata_unlock(sdata);
 344
 345         return NOTIFY_DONE;
 346 }
 347 #endif
 348
 349 #if IS_ENABLED(CONFIG_IPV6)
 350 static int ieee80211_ifa6_changed(struct notifier_block *nb,
 351                                   unsigned long data, void *arg)
 352 {
 353         struct inet6_ifaddr *ifa = (struct inet6_ifaddr *)arg;
 354         struct inet6_dev *idev = ifa->idev;
 355         struct net_device *ndev = ifa->idev->dev;
 356         struct ieee80211_local *local =
 357                 container_of(nb, struct ieee80211_local, ifa6_notifier);
 358         struct wireless_dev *wdev = ndev->ieee80211_ptr;
 359         struct ieee80211_sub_if_data *sdata;
 360
 361         /* Make sure it's our interface that got changed */
 362         if (!wdev || wdev->wiphy != local->hw.wiphy)
 363                 return NOTIFY_DONE;
 364
 365         sdata = IEEE80211_DEV_TO_SUB_IF(ndev);
 366
 367         /*
 368          * For now only support station mode. This is mostly because
 369          * doing AP would have to handle AP_VLAN in some way ...
 370          */
 371         if (sdata->vif.type != NL80211_IFTYPE_STATION)
 372                 return NOTIFY_DONE;
 373
 374         drv_ipv6_addr_change(local, sdata, idev);
 375
 376         return NOTIFY_DONE;
 377 }
 378 #endif
 379
 380 /* There isn't a lot of sense in it, but you can transmit anything you like */
 381 static const struct ieee80211_txrx_stypes
 382 ieee80211_default_mgmt_stypes[NUM_NL80211_IFTYPES] = {
 383         [NL80211_IFTYPE_ADHOC] = {
 384                 .tx = 0xffff,
 385                 .rx = BIT(IEEE80211_STYPE_ACTION >> 4) |
 386                         BIT(IEEE80211_STYPE_AUTH >> 4) |
 387                         BIT(IEEE80211_STYPE_DEAUTH >> 4) |
 388                         BIT(IEEE80211_STYPE_PROBE_REQ >> 4),
 389         },
 390         [NL80211_IFTYPE_STATION] = {
 391                 .tx = 0xffff,
 392                 .rx = BIT(IEEE80211_STYPE_ACTION >> 4) |
 393                         BIT(IEEE80211_STYPE_PROBE_REQ >> 4),
 394         },
 395         [NL80211_IFTYPE_AP] = {
 396                 .tx = 0xffff,
 397                 .rx = BIT(IEEE80211_STYPE_ASSOC_REQ >> 4) |
 398                         BIT(IEEE80211_STYPE_REASSOC_REQ >> 4) |
 399                         BIT(IEEE80211_STYPE_PROBE_REQ >> 4) |
 400                         BIT(IEEE80211_STYPE_DISASSOC >> 4) |
 401                         BIT(IEEE80211_STYPE_AUTH >> 4) |
 402                         BIT(IEEE80211_STYPE_DEAUTH >> 4) |
 403                         BIT(IEEE80211_STYPE_ACTION >> 4),
 404         },
 405         [NL80211_IFTYPE_AP_VLAN] = {
 406                 /* copy AP */
 407                 .tx = 0xffff,
 408                 .rx = BIT(IEEE80211_STYPE_ASSOC_REQ >> 4) |
 409                         BIT(IEEE80211_STYPE_REASSOC_REQ >> 4) |
 410                         BIT(IEEE80211_STYPE_PROBE_REQ >> 4) |
 411                         BIT(IEEE80211_STYPE_DISASSOC >> 4) |
 412                         BIT(IEEE80211_STYPE_AUTH >> 4) |
 413                         BIT(IEEE80211_STYPE_DEAUTH >> 4) |
 414                         BIT(IEEE80211_STYPE_ACTION >> 4),
 415         },
 416         [NL80211_IFTYPE_P2P_CLIENT] = {
 417                 .tx = 0xffff,
 418                 .rx = BIT(IEEE80211_STYPE_ACTION >> 4) |
 419                         BIT(IEEE80211_STYPE_PROBE_REQ >> 4),
 420         },
 421         [NL80211_IFTYPE_P2P_GO] = {
 422                 .tx = 0xffff,
 423                 .rx = BIT(IEEE80211_STYPE_ASSOC_REQ >> 4) |
 424                         BIT(IEEE80211_STYPE_REASSOC_REQ >> 4) |
 425                         BIT(IEEE80211_STYPE_PROBE_REQ >> 4) |
 426                         BIT(IEEE80211_STYPE_DISASSOC >> 4) |
 427                         BIT(IEEE80211_STYPE_AUTH >> 4) |
 428                         BIT(IEEE80211_STYPE_DEAUTH >> 4) |
 429                         BIT(IEEE80211_STYPE_ACTION >> 4),
 430         },
 431         [NL80211_IFTYPE_MESH_POINT] = {
 432                 .tx = 0xffff,
 433                 .rx = BIT(IEEE80211_STYPE_ACTION >> 4) |
 434                         BIT(IEEE80211_STYPE_AUTH >> 4) |
 435                         BIT(IEEE80211_STYPE_DEAUTH >> 4),
 436         },
 437         [NL80211_IFTYPE_P2P_DEVICE] = {
 438                 .tx = 0xffff,
 439                 .rx = BIT(IEEE80211_STYPE_ACTION >> 4) |
 440                         BIT(IEEE80211_STYPE_PROBE_REQ >> 4),
 441         },
 442 };
 443
 444 static const struct ieee80211_ht_cap mac80211_ht_capa_mod_mask = {
 445         .ampdu_params_info = IEEE80211_HT_AMPDU_PARM_FACTOR |
 446                              IEEE80211_HT_AMPDU_PARM_DENSITY,
 447
 448         .cap_info = cpu_to_le16(IEEE80211_HT_CAP_SUP_WIDTH_20_40 |
 449                                 IEEE80211_HT_CAP_MAX_AMSDU |
 450                                 IEEE80211_HT_CAP_SGI_20 |
 451                                 IEEE80211_HT_CAP_SGI_40),
 452         .mcs = {
 453                 .rx_mask = { 0xff, 0xff, 0xff, 0xff, 0xff,
 454                              0xff, 0xff, 0xff, 0xff, 0xff, },
 455         },
 456 };
 457
 458 static const struct ieee80211_vht_cap mac80211_vht_capa_mod_mask = {
 459         .vht_cap_info =
 460                 cpu_to_le32(IEEE80211_VHT_CAP_RXLDPC |
 461                             IEEE80211_VHT_CAP_SHORT_GI_80 |
 462                             IEEE80211_VHT_CAP_SHORT_GI_160 |
 463                             IEEE80211_VHT_CAP_RXSTBC_1 |
 464                             IEEE80211_VHT_CAP_RXSTBC_2 |
 465                             IEEE80211_VHT_CAP_RXSTBC_3 |
 466                             IEEE80211_VHT_CAP_RXSTBC_4 |
 467                             IEEE80211_VHT_CAP_TXSTBC |
 468                             IEEE80211_VHT_CAP_SU_BEAMFORMER_CAPABLE |
 469                             IEEE80211_VHT_CAP_SU_BEAMFORMEE_CAPABLE |
 470                             IEEE80211_VHT_CAP_TX_ANTENNA_PATTERN |
 471                             IEEE80211_VHT_CAP_RX_ANTENNA_PATTERN |
 472                             IEEE80211_VHT_CAP_MAX_A_MPDU_LENGTH_EXPONENT_MASK),
 473         .supp_mcs = {
 474                 .rx_mcs_map = cpu_to_le16(~0),
 475                 .tx_mcs_map = cpu_to_le16(~0),
 476         },
 477 };
 478
 479 static const u8 extended_capabilities[] = {
 480         0, 0, 0, 0, 0, 0, 0,
 481         WLAN_EXT_CAPA8_OPMODE_NOTIF,
 482 };
 483
 484 struct ieee80211_hw *ieee80211_alloc_hw(size_t priv_data_len,
 485                                         const struct ieee80211_ops *ops)
 486 {
 487         struct ieee80211_local *local;
 488         int priv_size, i;
 489         struct wiphy *wiphy;
 490         bool use_chanctx;
 491
 492         if (WARN_ON(!ops->tx || !ops->start || !ops->stop || !ops->config ||
 493                     !ops->add_interface || !ops->remove_interface ||
 494                     !ops->configure_filter))
 495                 return NULL;
 496
 497         if (WARN_ON(ops->sta_state && (ops->sta_add || ops->sta_remove)))
 498                 return NULL;
 499
 500         /* check all or no channel context operations exist */
 501         i = !!ops->add_chanctx + !!ops->remove_chanctx +
 502             !!ops->change_chanctx + !!ops->assign_vif_chanctx +
 503             !!ops->unassign_vif_chanctx;
 504         if (WARN_ON(i != 0 && i != 5))
 505                 return NULL;
 506         use_chanctx = i == 5;
 507
 508         /* Ensure 32-byte alignment of our private data and hw private data.
 509          * We use the wiphy priv data for both our ieee80211_local and for
 510          * the driver's private data
 511          *
 512          * In memory it'll be like this:
 513          *
 514          * +-------------------------+
 515          * | struct wiphy           |
 516          * +-------------------------+
 517          * | struct ieee80211_local  |
 518          * +-------------------------+
 519          * | driver's private data   |
 520          * +-------------------------+
 521          *
 522          */
 523         priv_size = ALIGN(sizeof(*local), NETDEV_ALIGN) + priv_data_len;
 524
 525         wiphy = wiphy_new(&mac80211_config_ops, priv_size);
 526
 527         if (!wiphy)
 528                 return NULL;
 529
 530         wiphy->mgmt_stypes = ieee80211_default_mgmt_stypes;
 531
 532         wiphy->privid = mac80211_wiphy_privid;
 533
 534         wiphy->flags |= WIPHY_FLAG_NETNS_OK |
 535                         WIPHY_FLAG_4ADDR_AP |
 536                         WIPHY_FLAG_4ADDR_STATION |
 537                         WIPHY_FLAG_REPORTS_OBSS |
 538                         WIPHY_FLAG_OFFCHAN_TX;
 539
 540         wiphy->extended_capabilities = extended_capabilities;
 541         wiphy->extended_capabilities_mask = extended_capabilities;
 542         wiphy->extended_capabilities_len = ARRAY_SIZE(extended_capabilities);
 543
 544         if (ops->remain_on_channel)
 545                 wiphy->flags |= WIPHY_FLAG_HAS_REMAIN_ON_CHANNEL;
 546
 547         wiphy->features |= NL80211_FEATURE_SK_TX_STATUS |
 548                            NL80211_FEATURE_SAE |
 549                            NL80211_FEATURE_HT_IBSS |
 550                            NL80211_FEATURE_VIF_TXPOWER |
 551                            NL80211_FEATURE_USERSPACE_MPM;
 552
 553         if (!ops->hw_scan)
 554                 wiphy->features |= NL80211_FEATURE_LOW_PRIORITY_SCAN |
 555                                    NL80211_FEATURE_AP_SCAN;
 556
 557
 558         if (!ops->set_key)
 559                 wiphy->flags |= WIPHY_FLAG_IBSS_RSN;
 560
 561         wiphy->bss_priv_size = sizeof(struct ieee80211_bss);
 562
 563         local = wiphy_priv(wiphy);
 564
 565         local->hw.wiphy = wiphy;
 566
 567         local->hw.priv = (char *)local + ALIGN(sizeof(*local), NETDEV_ALIGN);
 568
 569         local->ops = ops;
 570         local->use_chanctx = use_chanctx;
 571
 572         /* set up some defaults */
 573         local->hw.queues = 1;
 574         local->hw.max_rates = 1;
 575         local->hw.max_report_rates = 0;
 576         local->hw.max_rx_aggregation_subframes = IEEE80211_MAX_AMPDU_BUF;
 577         local->hw.max_tx_aggregation_subframes = IEEE80211_MAX_AMPDU_BUF;
 578         local->hw.offchannel_tx_hw_queue = IEEE80211_INVAL_HW_QUEUE;
 579         local->hw.conf.long_frame_max_tx_count = wiphy->retry_long;
 580         local->hw.conf.short_frame_max_tx_count = wiphy->retry_short;
 581         local->hw.radiotap_mcs_details = IEEE80211_RADIOTAP_MCS_HAVE_MCS |
 582                                          IEEE80211_RADIOTAP_MCS_HAVE_GI |
 583                                          IEEE80211_RADIOTAP_MCS_HAVE_BW;
 584         local->hw.radiotap_vht_details = IEEE80211_RADIOTAP_VHT_KNOWN_GI |
 585                                          IEEE80211_RADIOTAP_VHT_KNOWN_BANDWIDTH;
 586         local->hw.uapsd_queues = IEEE80211_DEFAULT_UAPSD_QUEUES;
 587         local->hw.uapsd_max_sp_len = IEEE80211_DEFAULT_MAX_SP_LEN;
 588         local->user_power_level = IEEE80211_UNSET_POWER_LEVEL;
 589         wiphy->ht_capa_mod_mask = &mac80211_ht_capa_mod_mask;
 590         wiphy->vht_capa_mod_mask = &mac80211_vht_capa_mod_mask;
 591
 592         INIT_LIST_HEAD(&local->interfaces);
 593
 594         __hw_addr_init(&local->mc_list);
 595
 596         mutex_init(&local->iflist_mtx);
 597         mutex_init(&local->mtx);
 598
 599         mutex_init(&local->key_mtx);
 600         spin_lock_init(&local->filter_lock);
 601         spin_lock_init(&local->rx_path_lock);
 602         spin_lock_init(&local->queue_stop_reason_lock);
 603
 604         INIT_LIST_HEAD(&local->chanctx_list);
 605         mutex_init(&local->chanctx_mtx);
 606
 607         INIT_DELAYED_WORK(&local->scan_work, ieee80211_scan_work);
 608
 609         INIT_WORK(&local->restart_work, ieee80211_restart_work);
 610
 611         INIT_WORK(&local->radar_detected_work,
 612                   ieee80211_dfs_radar_detected_work);
 613
 614         INIT_WORK(&local->reconfig_filter, ieee80211_reconfig_filter);
 615         local->smps_mode = IEEE80211_SMPS_OFF;
 616
 617         INIT_WORK(&local->dynamic_ps_enable_work,
 618                   ieee80211_dynamic_ps_enable_work);
 619         INIT_WORK(&local->dynamic_ps_disable_work,
 620                   ieee80211_dynamic_ps_disable_work);
 621         setup_timer(&local->dynamic_ps_timer,
 622                     ieee80211_dynamic_ps_timer, (unsigned long) local);
 623
 624         INIT_WORK(&local->sched_scan_stopped_work,
 625                   ieee80211_sched_scan_stopped_work);
 626
 627         spin_lock_init(&local->ack_status_lock);
 628         idr_init(&local->ack_status_frames);
 629
 630         sta_info_init(local);
 631
 632         for (i = 0; i < IEEE80211_MAX_QUEUES; i++) {
 633                 skb_queue_head_init(&local->pending[i]);
 634                 atomic_set(&local->agg_queue_stop[i], 0);
 635         }
 636         tasklet_init(&local->tx_pending_tasklet, ieee80211_tx_pending,
 637                      (unsigned long)local);
 638
 639         tasklet_init(&local->tasklet,
 640                      ieee80211_tasklet_handler,
 641                      (unsigned long) local);
 642
 643         skb_queue_head_init(&local->skb_queue);
 644         skb_queue_head_init(&local->skb_queue_unreliable);
 645
 646         ieee80211_led_names(local);
 647
 648         ieee80211_roc_setup(local);
 649
 650         return &local->hw;
 651 }
 652 EXPORT_SYMBOL(ieee80211_alloc_hw);
 653
 654 int ieee80211_register_hw(struct ieee80211_hw *hw)
 655 {
 656         struct ieee80211_local *local = hw_to_local(hw);
 657         int result, i;
 658         enum ieee80211_band band;
 659         int channels, max_bitrates;
 660         bool supp_ht, supp_vht;
 661         netdev_features_t feature_whitelist;
 662         struct cfg80211_chan_def dflt_chandef = {};
 663         static const u32 cipher_suites[] = {
 664                 /* keep WEP first, it may be removed below */
 665                 WLAN_CIPHER_SUITE_WEP40,
 666                 WLAN_CIPHER_SUITE_WEP104,
 667                 WLAN_CIPHER_SUITE_TKIP,
 668                 WLAN_CIPHER_SUITE_CCMP,
 669
 670                 /* keep last -- depends on hw flags! */
 671                 WLAN_CIPHER_SUITE_AES_CMAC
 672         };
 673
 674         if (hw->flags & IEEE80211_HW_QUEUE_CONTROL &&
 675             (local->hw.offchannel_tx_hw_queue == IEEE80211_INVAL_HW_QUEUE ||
 676              local->hw.offchannel_tx_hw_queue >= local->hw.queues))
 677                 return -EINVAL;
 678
 679 #ifdef CONFIG_PM
 680         if (hw->wiphy->wowlan && (!local->ops->suspend || !local->ops->resume))
 681                 return -EINVAL;
 682 #endif
 683
 684         if (!local->use_chanctx) {
 685                 for (i = 0; i < local->hw.wiphy->n_iface_combinations; i++) {
 686                         const struct ieee80211_iface_combination *comb;
 687
 688                         comb = &local->hw.wiphy->iface_combinations[i];
 689
 690                         if (comb->num_different_channels > 1)
 691                                 return -EINVAL;
 692                 }
 693         } else {
 694                 /*
 695                  * WDS is currently prohibited when channel contexts are used
 696                  * because there's no clear definition of which channel WDS
 697                  * type interfaces use
 698                  */
 699                 if (local->hw.wiphy->interface_modes & BIT(NL80211_IFTYPE_WDS))
 700                         return -EINVAL;
 701
 702                 /* DFS currently not supported with channel context drivers */
 703                 for (i = 0; i < local->hw.wiphy->n_iface_combinations; i++) {
 704                         const struct ieee80211_iface_combination *comb;
 705
 706                         comb = &local->hw.wiphy->iface_combinations[i];
 707
 708                         if (comb->radar_detect_widths)
 709                                 return -EINVAL;
 710                 }
 711         }
 712
 713         /* Only HW csum features are currently compatible with mac80211 */
 714         feature_whitelist = NETIF_F_IP_CSUM | NETIF_F_IPV6_CSUM |
 715                             NETIF_F_HW_CSUM;
 716         if (WARN_ON(hw->netdev_features & ~feature_whitelist))
 717                 return -EINVAL;
 718
 719         if (hw->max_report_rates == 0)
 720                 hw->max_report_rates = hw->max_rates;
 721
 722         local->rx_chains = 1;
 723
 724         /*
 725          * generic code guarantees at least one band,
 726          * set this very early because much code assumes
 727          * that hw.conf.channel is assigned
 728          */
 729         channels = 0;
 730         max_bitrates = 0;
 731         supp_ht = false;
 732         supp_vht = false;
 733         for (band = 0; band < IEEE80211_NUM_BANDS; band++) {
 734                 struct ieee80211_supported_band *sband;
 735
 736                 sband = local->hw.wiphy->bands[band];
 737                 if (!sband)
 738                         continue;
 739
 740                 if (!dflt_chandef.chan) {
 741                         cfg80211_chandef_create(&dflt_chandef,
 742                                                 &sband->channels[0],
 743                                                 NL80211_CHAN_NO_HT);
 744                         /* init channel we're on */
 745                         if (!local->use_chanctx && !local->_oper_chandef.chan) {
 746                                 local->hw.conf.chandef = dflt_chandef;
 747                                 local->_oper_chandef = dflt_chandef;
 748                         }
 749                         local->monitor_chandef = dflt_chandef;
 750                 }
 751
 752                 channels += sband->n_channels;
 753
 754                 if (max_bitrates < sband->n_bitrates)
 755                         max_bitrates = sband->n_bitrates;
 756                 supp_ht = supp_ht || sband->ht_cap.ht_supported;
 757                 supp_vht = supp_vht || sband->vht_cap.vht_supported;
 758
 759                 if (sband->ht_cap.ht_supported)
 760                         local->rx_chains =
 761                                 max(ieee80211_mcs_to_chains(&sband->ht_cap.mcs),
 762                                     local->rx_chains);
 763
 764                 /* TODO: consider VHT for RX chains, hopefully it's the same */
 765         }
 766
 767         local->int_scan_req = kzalloc(sizeof(*local->int_scan_req) +
 768                                       sizeof(void *) * channels, GFP_KERNEL);
 769         if (!local->int_scan_req)
 770                 return -ENOMEM;
 771
 772         for (band = 0; band < IEEE80211_NUM_BANDS; band++) {
 773                 if (!local->hw.wiphy->bands[band])
 774                         continue;
 775                 local->int_scan_req->rates[band] = (u32) -1;
 776         }
 777
 778         /* if low-level driver supports AP, we also support VLAN */
 779         if (local->hw.wiphy->interface_modes & BIT(NL80211_IFTYPE_AP)) {
 780                 hw->wiphy->interface_modes |= BIT(NL80211_IFTYPE_AP_VLAN);
 781                 hw->wiphy->software_iftypes |= BIT(NL80211_IFTYPE_AP_VLAN);
 782         }
 783
 784         /* mac80211 always supports monitor */
 785         hw->wiphy->interface_modes |= BIT(NL80211_IFTYPE_MONITOR);
 786         hw->wiphy->software_iftypes |= BIT(NL80211_IFTYPE_MONITOR);
 787
 788         /* mac80211 doesn't support more than one IBSS interface right now */
 789         for (i = 0; i < hw->wiphy->n_iface_combinations; i++) {
 790                 const struct ieee80211_iface_combination *c;
 791                 int j;
 792
 793                 c = &hw->wiphy->iface_combinations[i];
 794
 795                 for (j = 0; j < c->n_limits; j++)
 796                         if ((c->limits[j].types & BIT(NL80211_IFTYPE_ADHOC)) &&
 797                             c->limits[j].max > 1)
 798                                 return -EINVAL;
 799         }
 800
 801 #ifndef CONFIG_MAC80211_MESH
 802         /* mesh depends on Kconfig, but drivers should set it if they want */
 803         local->hw.wiphy->interface_modes &= ~BIT(NL80211_IFTYPE_MESH_POINT);
 804 #endif
 805
 806         /* if the underlying driver supports mesh, mac80211 will (at least)
 807          * provide routing of mesh authentication frames to userspace */
 808         if (local->hw.wiphy->interface_modes & BIT(NL80211_IFTYPE_MESH_POINT))
 809                 local->hw.wiphy->flags |= WIPHY_FLAG_MESH_AUTH;
 810
 811         /* mac80211 supports control port protocol changing */
 812         local->hw.wiphy->flags |= WIPHY_FLAG_CONTROL_PORT_PROTOCOL;
 813
 814         if (local->hw.flags & IEEE80211_HW_SIGNAL_DBM)
 815                 local->hw.wiphy->signal_type = CFG80211_SIGNAL_TYPE_MBM;
 816         else if (local->hw.flags & IEEE80211_HW_SIGNAL_UNSPEC)
 817                 local->hw.wiphy->signal_type = CFG80211_SIGNAL_TYPE_UNSPEC;
 818
 819         WARN((local->hw.flags & IEEE80211_HW_SUPPORTS_UAPSD)
 820              && (local->hw.flags & IEEE80211_HW_PS_NULLFUNC_STACK),
 821              "U-APSD not supported with HW_PS_NULLFUNC_STACK\n");
 822
 823         /*
 824          * Calculate scan IE length -- we need this to alloc
 825          * memory and to subtract from the driver limit. It
 826          * includes the DS Params, (extended) supported rates, and HT
 827          * information -- SSID is the driver's responsibility.
 828          */
 829         local->scan_ies_len = 4 + max_bitrates /* (ext) supp rates */ +
 830                 3 /* DS Params */;
 831         if (supp_ht)
 832                 local->scan_ies_len += 2 + sizeof(struct ieee80211_ht_cap);
 833
 834         if (supp_vht)
 835                 local->scan_ies_len +=
 836                         2 + sizeof(struct ieee80211_vht_cap);
 837
 838         if (!local->ops->hw_scan) {
 839                 /* For hw_scan, driver needs to set these up. */
 840                 local->hw.wiphy->max_scan_ssids = 4;
 841                 local->hw.wiphy->max_scan_ie_len = IEEE80211_MAX_DATA_LEN;
 842         }
 843
 844         /*
 845          * If the driver supports any scan IEs, then assume the
 846          * limit includes the IEs mac80211 will add, otherwise
 847          * leave it at zero and let the driver sort it out; we
 848          * still pass our IEs to the driver but userspace will
 849          * not be allowed to in that case.
 850          */
 851         if (local->hw.wiphy->max_scan_ie_len)
 852                 local->hw.wiphy->max_scan_ie_len -= local->scan_ies_len;
 853
 854         /* Set up cipher suites unless driver already did */
 855         if (!local->hw.wiphy->cipher_suites) {
 856                 local->hw.wiphy->cipher_suites = cipher_suites;
 857                 local->hw.wiphy->n_cipher_suites = ARRAY_SIZE(cipher_suites);
 858                 if (!(local->hw.flags & IEEE80211_HW_MFP_CAPABLE))
 859                         local->hw.wiphy->n_cipher_suites--;
 860         }
 861         if (IS_ERR(local->wep_tx_tfm) || IS_ERR(local->wep_rx_tfm)) {
 862                 if (local->hw.wiphy->cipher_suites == cipher_suites) {
 863                         local->hw.wiphy->cipher_suites += 2;
 864                         local->hw.wiphy->n_cipher_suites -= 2;
 865                 } else {
 866                         u32 *suites;
 867                         int r, w = 0;
 868
 869                         /* Filter out WEP */
 870
 871                         suites = kmemdup(
 872                                 local->hw.wiphy->cipher_suites,
 873                                 sizeof(u32) * local->hw.wiphy->n_cipher_suites,
 874                                 GFP_KERNEL);
 875                         if (!suites) {
 876                                 result = -ENOMEM;
 877                                 goto fail_wiphy_register;
 878                         }
 879                         for (r = 0; r < local->hw.wiphy->n_cipher_suites; r++) {
 880                                 u32 suite = local->hw.wiphy->cipher_suites[r];
 881                                 if (suite == WLAN_CIPHER_SUITE_WEP40 ||
 882                                     suite == WLAN_CIPHER_SUITE_WEP104)
 883                                         continue;
 884                                 suites[w++] = suite;
 885                         }
 886                         local->hw.wiphy->cipher_suites = suites;
 887                         local->hw.wiphy->n_cipher_suites = w;
 888                         local->wiphy_ciphers_allocated = true;
 889                 }
 890         }
 891
 892         if (!local->ops->remain_on_channel)
 893                 local->hw.wiphy->max_remain_on_channel_duration = 5000;
 894
 895         /* mac80211 based drivers don't support internal TDLS setup */
 896         if (local->hw.wiphy->flags & WIPHY_FLAG_SUPPORTS_TDLS)
 897                 local->hw.wiphy->flags |= WIPHY_FLAG_TDLS_EXTERNAL_SETUP;
 898
 899         result = wiphy_register(local->hw.wiphy);
 900         if (result < 0)
 901                 goto fail_wiphy_register;
 902
 903         /*
 904          * We use the number of queues for feature tests (QoS, HT) internally
 905          * so restrict them appropriately.
 906          */
 907         if (hw->queues > IEEE80211_MAX_QUEUES)
 908                 hw->queues = IEEE80211_MAX_QUEUES;
 909
 910         local->workqueue =
 911                 alloc_ordered_workqueue("%s", 0, wiphy_name(local->hw.wiphy));
 912         if (!local->workqueue) {
 913                 result = -ENOMEM;
 914                 goto fail_workqueue;
 915         }
 916
 917         /*
 918          * The hardware needs headroom for sending the frame,
 919          * and we need some headroom for passing the frame to monitor
 920          * interfaces, but never both at the same time.
 921          */
 922         local->tx_headroom = max_t(unsigned int , local->hw.extra_tx_headroom,
 923                                    IEEE80211_TX_STATUS_HEADROOM);
 924
 925         debugfs_hw_add(local);
 926
 927         /*
 928          * if the driver doesn't specify a max listen interval we
 929          * use 5 which should be a safe default
 930          */
 931         if (local->hw.max_listen_interval == 0)
 932                 local->hw.max_listen_interval = 5;
 933
 934         local->hw.conf.listen_interval = local->hw.max_listen_interval;
 935
 936         local->dynamic_ps_forced_timeout = -1;
 937
 938         result = ieee80211_wep_init(local);
 939         if (result < 0)
 940                 wiphy_debug(local->hw.wiphy, "Failed to initialize wep: %d\n",
 941                             result);
 942
 943         local->hw.conf.flags = IEEE80211_CONF_IDLE;
 944
 945         ieee80211_led_init(local);
 946
 947         rtnl_lock();
 948
 949         result = ieee80211_init_rate_ctrl_alg(local,
 950                                               hw->rate_control_algorithm);
 951         if (result < 0) {
 952                 wiphy_debug(local->hw.wiphy,
 953                             "Failed to initialize rate control algorithm\n");
 954                 goto fail_rate;
 955         }
 956
 957         /* add one default STA interface if supported */
 958         if (local->hw.wiphy->interface_modes & BIT(NL80211_IFTYPE_STATION)) {
 959                 result = ieee80211_if_add(local, "wlan%d", NULL,
 960                                           NL80211_IFTYPE_STATION, NULL);
 961                 if (result)
 962                         wiphy_warn(local->hw.wiphy,
 963                                    "Failed to add default virtual iface\n");
 964         }
 965
 966         rtnl_unlock();
 967
 968         local->network_latency_notifier.notifier_call =
 969                 ieee80211_max_network_latency;
 970         result = pm_qos_add_notifier(PM_QOS_NETWORK_LATENCY,
 971                                      &local->network_latency_notifier);
 972         if (result) {
 973                 rtnl_lock();
 974                 goto fail_pm_qos;
 975         }
 976
 977 #ifdef CONFIG_INET
 978         local->ifa_notifier.notifier_call = ieee80211_ifa_changed;
 979         result = register_inetaddr_notifier(&local->ifa_notifier);
 980         if (result)
 981                 goto fail_ifa;
 982 #endif
 983
 984 #if IS_ENABLED(CONFIG_IPV6)
 985         local->ifa6_notifier.notifier_call = ieee80211_ifa6_changed;
 986         result = register_inet6addr_notifier(&local->ifa6_notifier);
 987         if (result)
 988                 goto fail_ifa6;
 989 #endif
 990
 991         return 0;
 992
 993 #if IS_ENABLED(CONFIG_IPV6)
 994  fail_ifa6:
 995 #ifdef CONFIG_INET
 996         unregister_inetaddr_notifier(&local->ifa_notifier);
 997 #endif
 998 #endif
 999 #if defined(CONFIG_INET) || defined(CONFIG_IPV6)
1000  fail_ifa:
1001         pm_qos_remove_notifier(PM_QOS_NETWORK_LATENCY,
1002                                &local->network_latency_notifier);
1003         rtnl_lock();
1004 #endif
1005  fail_pm_qos:
1006         ieee80211_led_exit(local);
1007         ieee80211_remove_interfaces(local);
1008  fail_rate:
1009         rtnl_unlock();
1010         ieee80211_wep_free(local);
1011         sta_info_stop(local);
1012         destroy_workqueue(local->workqueue);
1013  fail_workqueue:
1014         wiphy_unregister(local->hw.wiphy);
1015  fail_wiphy_register:
1016         if (local->wiphy_ciphers_allocated)
1017                 kfree(local->hw.wiphy->cipher_suites);
1018         kfree(local->int_scan_req);
1019         return result;
1020 }
1021 EXPORT_SYMBOL(ieee80211_register_hw);
1022
1023 void ieee80211_unregister_hw(struct ieee80211_hw *hw)
1024 {
1025         struct ieee80211_local *local = hw_to_local(hw);
1026
1027         tasklet_kill(&local->tx_pending_tasklet);
1028         tasklet_kill(&local->tasklet);
1029
1030         pm_qos_remove_notifier(PM_QOS_NETWORK_LATENCY,
1031                                &local->network_latency_notifier);
1032 #ifdef CONFIG_INET
1033         unregister_inetaddr_notifier(&local->ifa_notifier);
1034 #endif
1035 #if IS_ENABLED(CONFIG_IPV6)
1036         unregister_inet6addr_notifier(&local->ifa6_notifier);
1037 #endif
1038
1039         rtnl_lock();
1040
1041         /*
1042          * At this point, interface list manipulations are fine
1043          * because the driver cannot be handing us frames any
1044          * more and the tasklet is killed.
1045          */
1046         ieee80211_remove_interfaces(local);
1047
1048         rtnl_unlock();
1049
1050         cancel_work_sync(&local->restart_work);
1051         cancel_work_sync(&local->reconfig_filter);
1052         flush_work(&local->sched_scan_stopped_work);
1053
1054         ieee80211_clear_tx_pending(local);
1055         rate_control_deinitialize(local);
1056
1057         if (skb_queue_len(&local->skb_queue) ||
1058             skb_queue_len(&local->skb_queue_unreliable))
1059                 wiphy_warn(local->hw.wiphy, "skb_queue not empty\n");
1060         skb_queue_purge(&local->skb_queue);
1061         skb_queue_purge(&local->skb_queue_unreliable);
1062
1063         destroy_workqueue(local->workqueue);
1064         wiphy_unregister(local->hw.wiphy);
1065         sta_info_stop(local);
1066         ieee80211_wep_free(local);
1067         ieee80211_led_exit(local);
1068         kfree(local->int_scan_req);
1069 }
1070 EXPORT_SYMBOL(ieee80211_unregister_hw);
1071
1072 static int ieee80211_free_ack_frame(int id, void *p, void *data)
1073 {
1074         WARN_ONCE(1, "Have pending ack frames!\n");
1075         kfree_skb(p);
1076         return 0;
1077 }
1078
1079 void ieee80211_free_hw(struct ieee80211_hw *hw)
1080 {
1081         struct ieee80211_local *local = hw_to_local(hw);
1082
1083         mutex_destroy(&local->iflist_mtx);
1084         mutex_destroy(&local->mtx);
1085
1086         if (local->wiphy_ciphers_allocated)
1087                 kfree(local->hw.wiphy->cipher_suites);
1088
1089         idr_for_each(&local->ack_status_frames,
1090                      ieee80211_free_ack_frame, NULL);
1091         idr_destroy(&local->ack_status_frames);
1092
1093         wiphy_free(local->hw.wiphy);
1094 }
1095 EXPORT_SYMBOL(ieee80211_free_hw);
1096
1097 static int __init ieee80211_init(void)
1098 {
1099         struct sk_buff *skb;
1100         int ret;
1101
1102         BUILD_BUG_ON(sizeof(struct ieee80211_tx_info) > sizeof(skb->cb));
1103         BUILD_BUG_ON(offsetof(struct ieee80211_tx_info, driver_data) +
1104                      IEEE80211_TX_INFO_DRIVER_DATA_SIZE > sizeof(skb->cb));
1105
1106         ret = rc80211_minstrel_init();
1107         if (ret)
1108                 return ret;
1109
1110         ret = rc80211_minstrel_ht_init();
1111         if (ret)
1112                 goto err_minstrel;
1113
1114         ret = rc80211_pid_init();
1115         if (ret)
1116                 goto err_pid;
1117
1118         ret = ieee80211_iface_init();
1119         if (ret)
1120                 goto err_netdev;
1121
1122         return 0;
1123  err_netdev:
1124         rc80211_pid_exit();
1125  err_pid:
1126         rc80211_minstrel_ht_exit();
1127  err_minstrel:
1128         rc80211_minstrel_exit();
1129
1130         return ret;
1131 }
1132
1133 static void __exit ieee80211_exit(void)
1134 {
1135         rc80211_pid_exit();
1136         rc80211_minstrel_ht_exit();
1137         rc80211_minstrel_exit();
1138
1139         ieee80211s_stop();
1140
1141         ieee80211_iface_exit();
1142
1143         rcu_barrier();
1144 }
1145
1146
1147 subsys_initcall(ieee80211_init);
1148 module_exit(ieee80211_exit);
1149
1150 MODULE_DESCRIPTION("IEEE 802.11 subsystem");
1151 MODULE_LICENSE("GPL");