2 * This is the linux wireless configuration interface.
4 * Copyright 2006-2009 Johannes Berg <johannes@sipsolutions.net>
8 #include <linux/module.h>
10 #include <linux/list.h>
11 #include <linux/nl80211.h>
12 #include <linux/debugfs.h>
13 #include <linux/notifier.h>
14 #include <linux/device.h>
15 #include <linux/etherdevice.h>
16 #include <linux/rtnetlink.h>
17 #include <net/genetlink.h>
18 #include <net/cfg80211.h>
23 #include "wext-compat.h"
25 /* name for sysfs, %d is appended */
26 #define PHY_NAME "phy"
28 MODULE_AUTHOR("Johannes Berg");
29 MODULE_LICENSE("GPL");
30 MODULE_DESCRIPTION("wireless configuration support");
32 /* RCU might be appropriate here since we usually
33 * only read the list, and that can happen quite
34 * often because we need to do it for each command */
35 LIST_HEAD(cfg80211_rdev_list);
36 int cfg80211_rdev_list_generation;
39 * This is used to protect the cfg80211_rdev_list
41 DEFINE_MUTEX(cfg80211_mutex);
44 static struct dentry *ieee80211_debugfs_dir;
46 /* requires cfg80211_mutex to be held! */
47 struct cfg80211_registered_device *cfg80211_rdev_by_wiphy_idx(int wiphy_idx)
49 struct cfg80211_registered_device *result = NULL, *rdev;
51 if (!wiphy_idx_valid(wiphy_idx))
54 assert_cfg80211_lock();
56 list_for_each_entry(rdev, &cfg80211_rdev_list, list) {
57 if (rdev->wiphy_idx == wiphy_idx) {
66 int get_wiphy_idx(struct wiphy *wiphy)
68 struct cfg80211_registered_device *rdev;
70 return WIPHY_IDX_STALE;
71 rdev = wiphy_to_dev(wiphy);
72 return rdev->wiphy_idx;
75 /* requires cfg80211_rdev_mutex to be held! */
76 struct wiphy *wiphy_idx_to_wiphy(int wiphy_idx)
78 struct cfg80211_registered_device *rdev;
80 if (!wiphy_idx_valid(wiphy_idx))
83 assert_cfg80211_lock();
85 rdev = cfg80211_rdev_by_wiphy_idx(wiphy_idx);
91 /* requires cfg80211_mutex to be held! */
92 struct cfg80211_registered_device *
93 __cfg80211_rdev_from_info(struct genl_info *info)
96 struct cfg80211_registered_device *bywiphyidx = NULL, *byifidx = NULL;
97 struct net_device *dev;
100 assert_cfg80211_lock();
102 if (info->attrs[NL80211_ATTR_WIPHY]) {
103 bywiphyidx = cfg80211_rdev_by_wiphy_idx(
104 nla_get_u32(info->attrs[NL80211_ATTR_WIPHY]));
108 if (info->attrs[NL80211_ATTR_IFINDEX]) {
109 ifindex = nla_get_u32(info->attrs[NL80211_ATTR_IFINDEX]);
110 dev = dev_get_by_index(genl_info_net(info), ifindex);
112 if (dev->ieee80211_ptr)
114 wiphy_to_dev(dev->ieee80211_ptr->wiphy);
120 if (bywiphyidx && byifidx) {
121 if (bywiphyidx != byifidx)
122 return ERR_PTR(-EINVAL);
124 return bywiphyidx; /* == byifidx */
135 struct cfg80211_registered_device *
136 cfg80211_get_dev_from_info(struct genl_info *info)
138 struct cfg80211_registered_device *rdev;
140 mutex_lock(&cfg80211_mutex);
141 rdev = __cfg80211_rdev_from_info(info);
143 /* if it is not an error we grab the lock on
144 * it to assure it won't be going away while
145 * we operate on it */
147 mutex_lock(&rdev->mtx);
149 mutex_unlock(&cfg80211_mutex);
154 struct cfg80211_registered_device *
155 cfg80211_get_dev_from_ifindex(struct net *net, int ifindex)
157 struct cfg80211_registered_device *rdev = ERR_PTR(-ENODEV);
158 struct net_device *dev;
160 mutex_lock(&cfg80211_mutex);
161 dev = dev_get_by_index(net, ifindex);
164 if (dev->ieee80211_ptr) {
165 rdev = wiphy_to_dev(dev->ieee80211_ptr->wiphy);
166 mutex_lock(&rdev->mtx);
168 rdev = ERR_PTR(-ENODEV);
171 mutex_unlock(&cfg80211_mutex);
175 /* requires cfg80211_mutex to be held */
176 int cfg80211_dev_rename(struct cfg80211_registered_device *rdev,
179 struct cfg80211_registered_device *rdev2;
180 int wiphy_idx, taken = -1, result, digits;
182 assert_cfg80211_lock();
184 /* prohibit calling the thing phy%d when %d is not its number */
185 sscanf(newname, PHY_NAME "%d%n", &wiphy_idx, &taken);
186 if (taken == strlen(newname) && wiphy_idx != rdev->wiphy_idx) {
187 /* count number of places needed to print wiphy_idx */
189 while (wiphy_idx /= 10)
192 * deny the name if it is phy<idx> where <idx> is printed
193 * without leading zeroes. taken == strlen(newname) here
195 if (taken == strlen(PHY_NAME) + digits)
200 /* Ignore nop renames */
201 if (strcmp(newname, dev_name(&rdev->wiphy.dev)) == 0)
204 /* Ensure another device does not already have this name. */
205 list_for_each_entry(rdev2, &cfg80211_rdev_list, list)
206 if (strcmp(newname, dev_name(&rdev2->wiphy.dev)) == 0)
209 result = device_rename(&rdev->wiphy.dev, newname);
213 if (rdev->wiphy.debugfsdir &&
214 !debugfs_rename(rdev->wiphy.debugfsdir->d_parent,
215 rdev->wiphy.debugfsdir,
216 rdev->wiphy.debugfsdir->d_parent,
218 printk(KERN_ERR "cfg80211: failed to rename debugfs dir to %s!\n",
221 nl80211_notify_dev_rename(rdev);
226 int cfg80211_switch_netns(struct cfg80211_registered_device *rdev,
229 struct wireless_dev *wdev;
232 if (!rdev->wiphy.netnsok)
235 list_for_each_entry(wdev, &rdev->netdev_list, list) {
236 wdev->netdev->features &= ~NETIF_F_NETNS_LOCAL;
237 err = dev_change_net_namespace(wdev->netdev, net, "wlan%d");
240 wdev->netdev->features |= NETIF_F_NETNS_LOCAL;
244 /* failed -- clean up to old netns */
245 net = wiphy_net(&rdev->wiphy);
247 list_for_each_entry_continue_reverse(wdev, &rdev->netdev_list,
249 wdev->netdev->features &= ~NETIF_F_NETNS_LOCAL;
250 err = dev_change_net_namespace(wdev->netdev, net,
253 wdev->netdev->features |= NETIF_F_NETNS_LOCAL;
257 wiphy_net_set(&rdev->wiphy, net);
262 static void cfg80211_rfkill_poll(struct rfkill *rfkill, void *data)
264 struct cfg80211_registered_device *rdev = data;
266 rdev->ops->rfkill_poll(&rdev->wiphy);
269 static int cfg80211_rfkill_set_block(void *data, bool blocked)
271 struct cfg80211_registered_device *rdev = data;
272 struct wireless_dev *wdev;
278 mutex_lock(&rdev->devlist_mtx);
280 list_for_each_entry(wdev, &rdev->netdev_list, list)
281 dev_close(wdev->netdev);
283 mutex_unlock(&rdev->devlist_mtx);
289 static void cfg80211_rfkill_sync_work(struct work_struct *work)
291 struct cfg80211_registered_device *rdev;
293 rdev = container_of(work, struct cfg80211_registered_device, rfkill_sync);
294 cfg80211_rfkill_set_block(rdev, rfkill_blocked(rdev->rfkill));
297 static void cfg80211_event_work(struct work_struct *work)
299 struct cfg80211_registered_device *rdev;
301 rdev = container_of(work, struct cfg80211_registered_device,
305 cfg80211_lock_rdev(rdev);
307 cfg80211_process_rdev_events(rdev);
308 cfg80211_unlock_rdev(rdev);
312 /* exported functions */
314 struct wiphy *wiphy_new(const struct cfg80211_ops *ops, int sizeof_priv)
316 static int wiphy_counter;
318 struct cfg80211_registered_device *rdev;
321 WARN_ON(ops->add_key && (!ops->del_key || !ops->set_default_key));
322 WARN_ON(ops->auth && (!ops->assoc || !ops->deauth || !ops->disassoc));
323 WARN_ON(ops->connect && !ops->disconnect);
324 WARN_ON(ops->join_ibss && !ops->leave_ibss);
325 WARN_ON(ops->add_virtual_intf && !ops->del_virtual_intf);
326 WARN_ON(ops->add_station && !ops->del_station);
327 WARN_ON(ops->add_mpath && !ops->del_mpath);
329 alloc_size = sizeof(*rdev) + sizeof_priv;
331 rdev = kzalloc(alloc_size, GFP_KERNEL);
337 mutex_lock(&cfg80211_mutex);
339 rdev->wiphy_idx = wiphy_counter++;
341 if (unlikely(!wiphy_idx_valid(rdev->wiphy_idx))) {
343 mutex_unlock(&cfg80211_mutex);
349 mutex_unlock(&cfg80211_mutex);
351 /* give it a proper name */
352 dev_set_name(&rdev->wiphy.dev, PHY_NAME "%d", rdev->wiphy_idx);
354 mutex_init(&rdev->mtx);
355 mutex_init(&rdev->devlist_mtx);
356 INIT_LIST_HEAD(&rdev->netdev_list);
357 spin_lock_init(&rdev->bss_lock);
358 INIT_LIST_HEAD(&rdev->bss_list);
359 INIT_WORK(&rdev->scan_done_wk, __cfg80211_scan_done);
361 device_initialize(&rdev->wiphy.dev);
362 rdev->wiphy.dev.class = &ieee80211_class;
363 rdev->wiphy.dev.platform_data = rdev;
365 rdev->wiphy.ps_default = CONFIG_CFG80211_DEFAULT_PS_VALUE;
367 wiphy_net_set(&rdev->wiphy, &init_net);
369 rdev->rfkill_ops.set_block = cfg80211_rfkill_set_block;
370 rdev->rfkill = rfkill_alloc(dev_name(&rdev->wiphy.dev),
371 &rdev->wiphy.dev, RFKILL_TYPE_WLAN,
372 &rdev->rfkill_ops, rdev);
379 INIT_WORK(&rdev->rfkill_sync, cfg80211_rfkill_sync_work);
380 INIT_WORK(&rdev->conn_work, cfg80211_conn_work);
381 INIT_WORK(&rdev->event_work, cfg80211_event_work);
383 init_waitqueue_head(&rdev->dev_wait);
386 * Initialize wiphy parameters to IEEE 802.11 MIB default values.
387 * Fragmentation and RTS threshold are disabled by default with the
390 rdev->wiphy.retry_short = 7;
391 rdev->wiphy.retry_long = 4;
392 rdev->wiphy.frag_threshold = (u32) -1;
393 rdev->wiphy.rts_threshold = (u32) -1;
397 EXPORT_SYMBOL(wiphy_new);
399 int wiphy_register(struct wiphy *wiphy)
401 struct cfg80211_registered_device *rdev = wiphy_to_dev(wiphy);
403 enum ieee80211_band band;
404 struct ieee80211_supported_band *sband;
405 bool have_band = false;
407 u16 ifmodes = wiphy->interface_modes;
409 /* sanity check ifmodes */
411 ifmodes &= ((1 << __NL80211_IFTYPE_AFTER_LAST) - 1) & ~1;
412 if (WARN_ON(ifmodes != wiphy->interface_modes))
413 wiphy->interface_modes = ifmodes;
415 /* sanity check supported bands/channels */
416 for (band = 0; band < IEEE80211_NUM_BANDS; band++) {
417 sband = wiphy->bands[band];
423 if (WARN_ON(!sband->n_channels || !sband->n_bitrates))
427 * Since we use a u32 for rate bitmaps in
428 * ieee80211_get_response_rate, we cannot
429 * have more than 32 legacy rates.
431 if (WARN_ON(sband->n_bitrates > 32))
434 for (i = 0; i < sband->n_channels; i++) {
435 sband->channels[i].orig_flags =
436 sband->channels[i].flags;
437 sband->channels[i].orig_mag =
438 sband->channels[i].max_antenna_gain;
439 sband->channels[i].orig_mpwr =
440 sband->channels[i].max_power;
441 sband->channels[i].band = band;
452 /* check and set up bitrates */
453 ieee80211_set_bitrate_flags(wiphy);
455 res = device_add(&rdev->wiphy.dev);
459 res = rfkill_register(rdev->rfkill);
463 mutex_lock(&cfg80211_mutex);
465 /* set up regulatory info */
466 wiphy_update_regulatory(wiphy, NL80211_REGDOM_SET_BY_CORE);
468 list_add(&rdev->list, &cfg80211_rdev_list);
469 cfg80211_rdev_list_generation++;
471 mutex_unlock(&cfg80211_mutex);
474 rdev->wiphy.debugfsdir =
475 debugfs_create_dir(wiphy_name(&rdev->wiphy),
476 ieee80211_debugfs_dir);
477 if (IS_ERR(rdev->wiphy.debugfsdir))
478 rdev->wiphy.debugfsdir = NULL;
480 if (wiphy->custom_regulatory) {
481 struct regulatory_request request;
483 request.wiphy_idx = get_wiphy_idx(wiphy);
484 request.initiator = NL80211_REGDOM_SET_BY_DRIVER;
485 request.alpha2[0] = '9';
486 request.alpha2[1] = '9';
488 nl80211_send_reg_change_event(&request);
491 cfg80211_debugfs_rdev_add(rdev);
496 device_del(&rdev->wiphy.dev);
499 EXPORT_SYMBOL(wiphy_register);
501 void wiphy_rfkill_start_polling(struct wiphy *wiphy)
503 struct cfg80211_registered_device *rdev = wiphy_to_dev(wiphy);
505 if (!rdev->ops->rfkill_poll)
507 rdev->rfkill_ops.poll = cfg80211_rfkill_poll;
508 rfkill_resume_polling(rdev->rfkill);
510 EXPORT_SYMBOL(wiphy_rfkill_start_polling);
512 void wiphy_rfkill_stop_polling(struct wiphy *wiphy)
514 struct cfg80211_registered_device *rdev = wiphy_to_dev(wiphy);
516 rfkill_pause_polling(rdev->rfkill);
518 EXPORT_SYMBOL(wiphy_rfkill_stop_polling);
520 void wiphy_unregister(struct wiphy *wiphy)
522 struct cfg80211_registered_device *rdev = wiphy_to_dev(wiphy);
524 rfkill_unregister(rdev->rfkill);
526 /* protect the device list */
527 mutex_lock(&cfg80211_mutex);
529 wait_event(rdev->dev_wait, ({
531 mutex_lock(&rdev->devlist_mtx);
532 __count = rdev->opencount;
533 mutex_unlock(&rdev->devlist_mtx);
536 mutex_lock(&rdev->devlist_mtx);
537 BUG_ON(!list_empty(&rdev->netdev_list));
538 mutex_unlock(&rdev->devlist_mtx);
541 * First remove the hardware from everywhere, this makes
542 * it impossible to find from userspace.
544 cfg80211_debugfs_rdev_del(rdev);
545 list_del(&rdev->list);
548 * Try to grab rdev->mtx. If a command is still in progress,
549 * hopefully the driver will refuse it since it's tearing
550 * down the device already. We wait for this command to complete
551 * before unlinking the item from the list.
552 * Note: as codified by the BUG_ON above we cannot get here if
553 * a virtual interface is still present. Hence, we can only get
554 * to lock contention here if userspace issues a command that
555 * identified the hardware by wiphy index.
557 cfg80211_lock_rdev(rdev);
559 cfg80211_unlock_rdev(rdev);
561 /* If this device got a regulatory hint tell core its
562 * free to listen now to a new shiny device regulatory hint */
563 reg_device_remove(wiphy);
565 cfg80211_rdev_list_generation++;
566 device_del(&rdev->wiphy.dev);
567 debugfs_remove(rdev->wiphy.debugfsdir);
569 mutex_unlock(&cfg80211_mutex);
571 flush_work(&rdev->scan_done_wk);
572 cancel_work_sync(&rdev->conn_work);
573 flush_work(&rdev->event_work);
575 EXPORT_SYMBOL(wiphy_unregister);
577 void cfg80211_dev_free(struct cfg80211_registered_device *rdev)
579 struct cfg80211_internal_bss *scan, *tmp;
580 rfkill_destroy(rdev->rfkill);
581 mutex_destroy(&rdev->mtx);
582 mutex_destroy(&rdev->devlist_mtx);
583 list_for_each_entry_safe(scan, tmp, &rdev->bss_list, list)
584 cfg80211_put_bss(&scan->pub);
588 void wiphy_free(struct wiphy *wiphy)
590 put_device(&wiphy->dev);
592 EXPORT_SYMBOL(wiphy_free);
594 void wiphy_rfkill_set_hw_state(struct wiphy *wiphy, bool blocked)
596 struct cfg80211_registered_device *rdev = wiphy_to_dev(wiphy);
598 if (rfkill_set_hw_state(rdev->rfkill, blocked))
599 schedule_work(&rdev->rfkill_sync);
601 EXPORT_SYMBOL(wiphy_rfkill_set_hw_state);
603 static void wdev_cleanup_work(struct work_struct *work)
605 struct wireless_dev *wdev;
606 struct cfg80211_registered_device *rdev;
608 wdev = container_of(work, struct wireless_dev, cleanup_work);
609 rdev = wiphy_to_dev(wdev->wiphy);
611 cfg80211_lock_rdev(rdev);
613 if (WARN_ON(rdev->scan_req && rdev->scan_req->dev == wdev->netdev)) {
614 rdev->scan_req->aborted = true;
615 ___cfg80211_scan_done(rdev, true);
618 cfg80211_unlock_rdev(rdev);
620 mutex_lock(&rdev->devlist_mtx);
622 mutex_unlock(&rdev->devlist_mtx);
623 wake_up(&rdev->dev_wait);
625 dev_put(wdev->netdev);
628 static int cfg80211_netdev_notifier_call(struct notifier_block * nb,
632 struct net_device *dev = ndev;
633 struct wireless_dev *wdev = dev->ieee80211_ptr;
634 struct cfg80211_registered_device *rdev;
639 rdev = wiphy_to_dev(wdev->wiphy);
641 WARN_ON(wdev->iftype == NL80211_IFTYPE_UNSPECIFIED);
644 case NETDEV_REGISTER:
646 * NB: cannot take rdev->mtx here because this may be
647 * called within code protected by it when interfaces
648 * are added with nl80211.
650 mutex_init(&wdev->mtx);
651 INIT_WORK(&wdev->cleanup_work, wdev_cleanup_work);
652 INIT_LIST_HEAD(&wdev->event_list);
653 spin_lock_init(&wdev->event_lock);
654 mutex_lock(&rdev->devlist_mtx);
655 list_add(&wdev->list, &rdev->netdev_list);
656 rdev->devlist_generation++;
657 /* can only change netns with wiphy */
658 dev->features |= NETIF_F_NETNS_LOCAL;
660 if (sysfs_create_link(&dev->dev.kobj, &rdev->wiphy.dev.kobj,
662 printk(KERN_ERR "wireless: failed to add phy80211 "
663 "symlink to netdev!\n");
666 wdev->sme_state = CFG80211_SME_IDLE;
667 mutex_unlock(&rdev->devlist_mtx);
668 #ifdef CONFIG_WIRELESS_EXT
669 if (!dev->wireless_handlers)
670 dev->wireless_handlers = &cfg80211_wext_handler;
671 wdev->wext.default_key = -1;
672 wdev->wext.default_mgmt_key = -1;
673 wdev->wext.connect.auth_type = NL80211_AUTHTYPE_AUTOMATIC;
674 wdev->wext.ps = wdev->wiphy->ps_default;
675 wdev->wext.ps_timeout = 100;
676 if (rdev->ops->set_power_mgmt)
677 if (rdev->ops->set_power_mgmt(wdev->wiphy, dev,
679 wdev->wext.ps_timeout)) {
680 /* assume this means it's off */
681 wdev->wext.ps = false;
685 case NETDEV_GOING_DOWN:
686 switch (wdev->iftype) {
687 case NL80211_IFTYPE_ADHOC:
688 cfg80211_leave_ibss(rdev, dev, true);
690 case NL80211_IFTYPE_STATION:
692 #ifdef CONFIG_WIRELESS_EXT
693 kfree(wdev->wext.ie);
694 wdev->wext.ie = NULL;
695 wdev->wext.ie_len = 0;
696 wdev->wext.connect.auth_type = NL80211_AUTHTYPE_AUTOMATIC;
698 __cfg80211_disconnect(rdev, dev,
699 WLAN_REASON_DEAUTH_LEAVING, true);
700 cfg80211_mlme_down(rdev, dev);
709 schedule_work(&wdev->cleanup_work);
713 * If we have a really quick DOWN/UP succession we may
714 * have this work still pending ... cancel it and see
715 * if it was pending, in which case we need to account
716 * for some of the work it would have done.
718 if (cancel_work_sync(&wdev->cleanup_work)) {
719 mutex_lock(&rdev->devlist_mtx);
721 mutex_unlock(&rdev->devlist_mtx);
724 #ifdef CONFIG_WIRELESS_EXT
725 cfg80211_lock_rdev(rdev);
726 mutex_lock(&rdev->devlist_mtx);
728 switch (wdev->iftype) {
729 case NL80211_IFTYPE_ADHOC:
730 cfg80211_ibss_wext_join(rdev, wdev);
732 case NL80211_IFTYPE_STATION:
733 cfg80211_mgd_wext_connect(rdev, wdev);
740 mutex_unlock(&rdev->devlist_mtx);
741 cfg80211_unlock_rdev(rdev);
744 case NETDEV_UNREGISTER:
746 * NB: cannot take rdev->mtx here because this may be
747 * called within code protected by it when interfaces
748 * are removed with nl80211.
750 mutex_lock(&rdev->devlist_mtx);
752 * It is possible to get NETDEV_UNREGISTER
753 * multiple times. To detect that, check
754 * that the interface is still on the list
755 * of registered interfaces, and only then
756 * remove and clean it up.
758 if (!list_empty(&wdev->list)) {
759 sysfs_remove_link(&dev->dev.kobj, "phy80211");
760 list_del_init(&wdev->list);
761 rdev->devlist_generation++;
762 #ifdef CONFIG_WIRELESS_EXT
763 kfree(wdev->wext.keys);
766 mutex_unlock(&rdev->devlist_mtx);
769 if (!(wdev->wiphy->interface_modes & BIT(wdev->iftype)))
770 return notifier_from_errno(-EOPNOTSUPP);
771 if (rfkill_blocked(rdev->rfkill))
772 return notifier_from_errno(-ERFKILL);
779 static struct notifier_block cfg80211_netdev_notifier = {
780 .notifier_call = cfg80211_netdev_notifier_call,
783 static void __net_exit cfg80211_pernet_exit(struct net *net)
785 struct cfg80211_registered_device *rdev;
788 mutex_lock(&cfg80211_mutex);
789 list_for_each_entry(rdev, &cfg80211_rdev_list, list) {
790 if (net_eq(wiphy_net(&rdev->wiphy), net))
791 WARN_ON(cfg80211_switch_netns(rdev, &init_net));
793 mutex_unlock(&cfg80211_mutex);
797 static struct pernet_operations cfg80211_pernet_ops = {
798 .exit = cfg80211_pernet_exit,
801 static int __init cfg80211_init(void)
805 err = register_pernet_device(&cfg80211_pernet_ops);
807 goto out_fail_pernet;
809 err = wiphy_sysfs_init();
813 err = register_netdevice_notifier(&cfg80211_netdev_notifier);
815 goto out_fail_notifier;
817 err = nl80211_init();
819 goto out_fail_nl80211;
821 ieee80211_debugfs_dir = debugfs_create_dir("ieee80211", NULL);
823 err = regulatory_init();
830 debugfs_remove(ieee80211_debugfs_dir);
832 unregister_netdevice_notifier(&cfg80211_netdev_notifier);
836 unregister_pernet_device(&cfg80211_pernet_ops);
840 subsys_initcall(cfg80211_init);
842 static void cfg80211_exit(void)
844 debugfs_remove(ieee80211_debugfs_dir);
846 unregister_netdevice_notifier(&cfg80211_netdev_notifier);
849 unregister_pernet_device(&cfg80211_pernet_ops);
851 module_exit(cfg80211_exit);