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/rtnetlink.h>
16 #include <net/genetlink.h>
17 #include <net/cfg80211.h>
22 #include "wext-compat.h"
24 /* name for sysfs, %d is appended */
25 #define PHY_NAME "phy"
27 MODULE_AUTHOR("Johannes Berg");
28 MODULE_LICENSE("GPL");
29 MODULE_DESCRIPTION("wireless configuration support");
31 /* RCU might be appropriate here since we usually
32 * only read the list, and that can happen quite
33 * often because we need to do it for each command */
34 LIST_HEAD(cfg80211_rdev_list);
35 int cfg80211_rdev_list_generation;
38 * This is used to protect the cfg80211_rdev_list
40 DEFINE_MUTEX(cfg80211_mutex);
43 static struct dentry *ieee80211_debugfs_dir;
45 /* requires cfg80211_mutex to be held! */
46 struct cfg80211_registered_device *cfg80211_rdev_by_wiphy_idx(int wiphy_idx)
48 struct cfg80211_registered_device *result = NULL, *rdev;
50 if (!wiphy_idx_valid(wiphy_idx))
53 assert_cfg80211_lock();
55 list_for_each_entry(rdev, &cfg80211_rdev_list, list) {
56 if (rdev->wiphy_idx == wiphy_idx) {
65 int get_wiphy_idx(struct wiphy *wiphy)
67 struct cfg80211_registered_device *rdev;
69 return WIPHY_IDX_STALE;
70 rdev = wiphy_to_dev(wiphy);
71 return rdev->wiphy_idx;
74 /* requires cfg80211_rdev_mutex to be held! */
75 struct wiphy *wiphy_idx_to_wiphy(int wiphy_idx)
77 struct cfg80211_registered_device *rdev;
79 if (!wiphy_idx_valid(wiphy_idx))
82 assert_cfg80211_lock();
84 rdev = cfg80211_rdev_by_wiphy_idx(wiphy_idx);
90 /* requires cfg80211_mutex to be held! */
91 struct cfg80211_registered_device *
92 __cfg80211_rdev_from_info(struct genl_info *info)
95 struct cfg80211_registered_device *bywiphyidx = NULL, *byifidx = NULL;
96 struct net_device *dev;
99 assert_cfg80211_lock();
101 if (info->attrs[NL80211_ATTR_WIPHY]) {
102 bywiphyidx = cfg80211_rdev_by_wiphy_idx(
103 nla_get_u32(info->attrs[NL80211_ATTR_WIPHY]));
107 if (info->attrs[NL80211_ATTR_IFINDEX]) {
108 ifindex = nla_get_u32(info->attrs[NL80211_ATTR_IFINDEX]);
109 dev = dev_get_by_index(genl_info_net(info), ifindex);
111 if (dev->ieee80211_ptr)
113 wiphy_to_dev(dev->ieee80211_ptr->wiphy);
119 if (bywiphyidx && byifidx) {
120 if (bywiphyidx != byifidx)
121 return ERR_PTR(-EINVAL);
123 return bywiphyidx; /* == byifidx */
134 struct cfg80211_registered_device *
135 cfg80211_get_dev_from_info(struct genl_info *info)
137 struct cfg80211_registered_device *rdev;
139 mutex_lock(&cfg80211_mutex);
140 rdev = __cfg80211_rdev_from_info(info);
142 /* if it is not an error we grab the lock on
143 * it to assure it won't be going away while
144 * we operate on it */
146 mutex_lock(&rdev->mtx);
148 mutex_unlock(&cfg80211_mutex);
153 struct cfg80211_registered_device *
154 cfg80211_get_dev_from_ifindex(struct net *net, int ifindex)
156 struct cfg80211_registered_device *rdev = ERR_PTR(-ENODEV);
157 struct net_device *dev;
159 mutex_lock(&cfg80211_mutex);
160 dev = dev_get_by_index(net, ifindex);
163 if (dev->ieee80211_ptr) {
164 rdev = wiphy_to_dev(dev->ieee80211_ptr->wiphy);
165 mutex_lock(&rdev->mtx);
167 rdev = ERR_PTR(-ENODEV);
170 mutex_unlock(&cfg80211_mutex);
174 /* requires cfg80211_mutex to be held */
175 int cfg80211_dev_rename(struct cfg80211_registered_device *rdev,
178 struct cfg80211_registered_device *rdev2;
179 int wiphy_idx, taken = -1, result, digits;
181 assert_cfg80211_lock();
183 /* prohibit calling the thing phy%d when %d is not its number */
184 sscanf(newname, PHY_NAME "%d%n", &wiphy_idx, &taken);
185 if (taken == strlen(newname) && wiphy_idx != rdev->wiphy_idx) {
186 /* count number of places needed to print wiphy_idx */
188 while (wiphy_idx /= 10)
191 * deny the name if it is phy<idx> where <idx> is printed
192 * without leading zeroes. taken == strlen(newname) here
194 if (taken == strlen(PHY_NAME) + digits)
199 /* Ignore nop renames */
200 if (strcmp(newname, dev_name(&rdev->wiphy.dev)) == 0)
203 /* Ensure another device does not already have this name. */
204 list_for_each_entry(rdev2, &cfg80211_rdev_list, list)
205 if (strcmp(newname, dev_name(&rdev2->wiphy.dev)) == 0)
208 result = device_rename(&rdev->wiphy.dev, newname);
212 if (rdev->wiphy.debugfsdir &&
213 !debugfs_rename(rdev->wiphy.debugfsdir->d_parent,
214 rdev->wiphy.debugfsdir,
215 rdev->wiphy.debugfsdir->d_parent,
217 printk(KERN_ERR "cfg80211: failed to rename debugfs dir to %s!\n",
220 nl80211_notify_dev_rename(rdev);
225 int cfg80211_switch_netns(struct cfg80211_registered_device *rdev,
228 struct wireless_dev *wdev;
231 if (!rdev->wiphy.netnsok)
234 list_for_each_entry(wdev, &rdev->netdev_list, list) {
235 wdev->netdev->features &= ~NETIF_F_NETNS_LOCAL;
236 err = dev_change_net_namespace(wdev->netdev, net, "wlan%d");
239 wdev->netdev->features |= NETIF_F_NETNS_LOCAL;
243 /* failed -- clean up to old netns */
244 net = wiphy_net(&rdev->wiphy);
246 list_for_each_entry_continue_reverse(wdev, &rdev->netdev_list,
248 wdev->netdev->features &= ~NETIF_F_NETNS_LOCAL;
249 err = dev_change_net_namespace(wdev->netdev, net,
252 wdev->netdev->features |= NETIF_F_NETNS_LOCAL;
256 wiphy_net_set(&rdev->wiphy, net);
261 static void cfg80211_rfkill_poll(struct rfkill *rfkill, void *data)
263 struct cfg80211_registered_device *rdev = data;
265 rdev->ops->rfkill_poll(&rdev->wiphy);
268 static int cfg80211_rfkill_set_block(void *data, bool blocked)
270 struct cfg80211_registered_device *rdev = data;
271 struct wireless_dev *wdev;
277 mutex_lock(&rdev->devlist_mtx);
279 list_for_each_entry(wdev, &rdev->netdev_list, list)
280 dev_close(wdev->netdev);
282 mutex_unlock(&rdev->devlist_mtx);
288 static void cfg80211_rfkill_sync_work(struct work_struct *work)
290 struct cfg80211_registered_device *rdev;
292 rdev = container_of(work, struct cfg80211_registered_device, rfkill_sync);
293 cfg80211_rfkill_set_block(rdev, rfkill_blocked(rdev->rfkill));
296 static void cfg80211_process_events(struct wireless_dev *wdev)
298 struct cfg80211_event *ev;
301 spin_lock_irqsave(&wdev->event_lock, flags);
302 while (!list_empty(&wdev->event_list)) {
303 ev = list_first_entry(&wdev->event_list,
304 struct cfg80211_event, list);
306 spin_unlock_irqrestore(&wdev->event_lock, flags);
310 case EVENT_CONNECT_RESULT:
311 __cfg80211_connect_result(
312 wdev->netdev, ev->cr.bssid,
313 ev->cr.req_ie, ev->cr.req_ie_len,
314 ev->cr.resp_ie, ev->cr.resp_ie_len,
316 ev->cr.status == WLAN_STATUS_SUCCESS,
320 __cfg80211_roamed(wdev, ev->rm.bssid,
321 ev->rm.req_ie, ev->rm.req_ie_len,
322 ev->rm.resp_ie, ev->rm.resp_ie_len);
324 case EVENT_DISCONNECTED:
325 __cfg80211_disconnected(wdev->netdev,
326 ev->dc.ie, ev->dc.ie_len,
327 ev->dc.reason, true);
329 case EVENT_IBSS_JOINED:
330 __cfg80211_ibss_joined(wdev->netdev, ev->ij.bssid);
337 spin_lock_irqsave(&wdev->event_lock, flags);
339 spin_unlock_irqrestore(&wdev->event_lock, flags);
342 static void cfg80211_event_work(struct work_struct *work)
344 struct cfg80211_registered_device *rdev;
345 struct wireless_dev *wdev;
347 rdev = container_of(work, struct cfg80211_registered_device,
351 cfg80211_lock_rdev(rdev);
352 mutex_lock(&rdev->devlist_mtx);
354 list_for_each_entry(wdev, &rdev->netdev_list, list)
355 cfg80211_process_events(wdev);
357 mutex_unlock(&rdev->devlist_mtx);
358 cfg80211_unlock_rdev(rdev);
362 /* exported functions */
364 struct wiphy *wiphy_new(const struct cfg80211_ops *ops, int sizeof_priv)
366 static int wiphy_counter;
368 struct cfg80211_registered_device *rdev;
371 WARN_ON(ops->add_key && (!ops->del_key || !ops->set_default_key));
372 WARN_ON(ops->auth && (!ops->assoc || !ops->deauth || !ops->disassoc));
373 WARN_ON(ops->connect && !ops->disconnect);
374 WARN_ON(ops->join_ibss && !ops->leave_ibss);
375 WARN_ON(ops->add_virtual_intf && !ops->del_virtual_intf);
376 WARN_ON(ops->add_station && !ops->del_station);
377 WARN_ON(ops->add_mpath && !ops->del_mpath);
379 alloc_size = sizeof(*rdev) + sizeof_priv;
381 rdev = kzalloc(alloc_size, GFP_KERNEL);
387 mutex_lock(&cfg80211_mutex);
389 rdev->wiphy_idx = wiphy_counter++;
391 if (unlikely(!wiphy_idx_valid(rdev->wiphy_idx))) {
393 mutex_unlock(&cfg80211_mutex);
399 mutex_unlock(&cfg80211_mutex);
401 /* give it a proper name */
402 dev_set_name(&rdev->wiphy.dev, PHY_NAME "%d", rdev->wiphy_idx);
404 mutex_init(&rdev->mtx);
405 mutex_init(&rdev->devlist_mtx);
406 INIT_LIST_HEAD(&rdev->netdev_list);
407 spin_lock_init(&rdev->bss_lock);
408 INIT_LIST_HEAD(&rdev->bss_list);
409 INIT_WORK(&rdev->scan_done_wk, __cfg80211_scan_done);
411 device_initialize(&rdev->wiphy.dev);
412 rdev->wiphy.dev.class = &ieee80211_class;
413 rdev->wiphy.dev.platform_data = rdev;
415 rdev->wiphy.ps_default = CONFIG_CFG80211_DEFAULT_PS_VALUE;
417 wiphy_net_set(&rdev->wiphy, &init_net);
419 rdev->rfkill_ops.set_block = cfg80211_rfkill_set_block;
420 rdev->rfkill = rfkill_alloc(dev_name(&rdev->wiphy.dev),
421 &rdev->wiphy.dev, RFKILL_TYPE_WLAN,
422 &rdev->rfkill_ops, rdev);
429 INIT_WORK(&rdev->rfkill_sync, cfg80211_rfkill_sync_work);
430 INIT_WORK(&rdev->conn_work, cfg80211_conn_work);
431 INIT_WORK(&rdev->event_work, cfg80211_event_work);
434 * Initialize wiphy parameters to IEEE 802.11 MIB default values.
435 * Fragmentation and RTS threshold are disabled by default with the
438 rdev->wiphy.retry_short = 7;
439 rdev->wiphy.retry_long = 4;
440 rdev->wiphy.frag_threshold = (u32) -1;
441 rdev->wiphy.rts_threshold = (u32) -1;
445 EXPORT_SYMBOL(wiphy_new);
447 int wiphy_register(struct wiphy *wiphy)
449 struct cfg80211_registered_device *rdev = wiphy_to_dev(wiphy);
451 enum ieee80211_band band;
452 struct ieee80211_supported_band *sband;
453 bool have_band = false;
455 u16 ifmodes = wiphy->interface_modes;
457 /* sanity check ifmodes */
459 ifmodes &= ((1 << __NL80211_IFTYPE_AFTER_LAST) - 1) & ~1;
460 if (WARN_ON(ifmodes != wiphy->interface_modes))
461 wiphy->interface_modes = ifmodes;
463 /* sanity check supported bands/channels */
464 for (band = 0; band < IEEE80211_NUM_BANDS; band++) {
465 sband = wiphy->bands[band];
471 if (WARN_ON(!sband->n_channels || !sband->n_bitrates))
475 * Since we use a u32 for rate bitmaps in
476 * ieee80211_get_response_rate, we cannot
477 * have more than 32 legacy rates.
479 if (WARN_ON(sband->n_bitrates > 32))
482 for (i = 0; i < sband->n_channels; i++) {
483 sband->channels[i].orig_flags =
484 sband->channels[i].flags;
485 sband->channels[i].orig_mag =
486 sband->channels[i].max_antenna_gain;
487 sband->channels[i].orig_mpwr =
488 sband->channels[i].max_power;
489 sband->channels[i].band = band;
500 /* check and set up bitrates */
501 ieee80211_set_bitrate_flags(wiphy);
503 res = device_add(&rdev->wiphy.dev);
507 res = rfkill_register(rdev->rfkill);
511 mutex_lock(&cfg80211_mutex);
513 /* set up regulatory info */
514 wiphy_update_regulatory(wiphy, NL80211_REGDOM_SET_BY_CORE);
516 list_add(&rdev->list, &cfg80211_rdev_list);
517 cfg80211_rdev_list_generation++;
519 mutex_unlock(&cfg80211_mutex);
522 rdev->wiphy.debugfsdir =
523 debugfs_create_dir(wiphy_name(&rdev->wiphy),
524 ieee80211_debugfs_dir);
525 if (IS_ERR(rdev->wiphy.debugfsdir))
526 rdev->wiphy.debugfsdir = NULL;
528 if (wiphy->custom_regulatory) {
529 struct regulatory_request request;
531 request.wiphy_idx = get_wiphy_idx(wiphy);
532 request.initiator = NL80211_REGDOM_SET_BY_DRIVER;
533 request.alpha2[0] = '9';
534 request.alpha2[1] = '9';
536 nl80211_send_reg_change_event(&request);
539 cfg80211_debugfs_rdev_add(rdev);
544 device_del(&rdev->wiphy.dev);
547 EXPORT_SYMBOL(wiphy_register);
549 void wiphy_rfkill_start_polling(struct wiphy *wiphy)
551 struct cfg80211_registered_device *rdev = wiphy_to_dev(wiphy);
553 if (!rdev->ops->rfkill_poll)
555 rdev->rfkill_ops.poll = cfg80211_rfkill_poll;
556 rfkill_resume_polling(rdev->rfkill);
558 EXPORT_SYMBOL(wiphy_rfkill_start_polling);
560 void wiphy_rfkill_stop_polling(struct wiphy *wiphy)
562 struct cfg80211_registered_device *rdev = wiphy_to_dev(wiphy);
564 rfkill_pause_polling(rdev->rfkill);
566 EXPORT_SYMBOL(wiphy_rfkill_stop_polling);
568 void wiphy_unregister(struct wiphy *wiphy)
570 struct cfg80211_registered_device *rdev = wiphy_to_dev(wiphy);
572 rfkill_unregister(rdev->rfkill);
574 /* protect the device list */
575 mutex_lock(&cfg80211_mutex);
577 BUG_ON(!list_empty(&rdev->netdev_list));
580 * Try to grab rdev->mtx. If a command is still in progress,
581 * hopefully the driver will refuse it since it's tearing
582 * down the device already. We wait for this command to complete
583 * before unlinking the item from the list.
584 * Note: as codified by the BUG_ON above we cannot get here if
585 * a virtual interface is still associated. Hence, we can only
586 * get to lock contention here if userspace issues a command
587 * that identified the hardware by wiphy index.
589 mutex_lock(&rdev->mtx);
590 /* unlock again before freeing */
591 mutex_unlock(&rdev->mtx);
593 cfg80211_debugfs_rdev_del(rdev);
595 /* If this device got a regulatory hint tell core its
596 * free to listen now to a new shiny device regulatory hint */
597 reg_device_remove(wiphy);
599 list_del(&rdev->list);
600 cfg80211_rdev_list_generation++;
601 device_del(&rdev->wiphy.dev);
602 debugfs_remove(rdev->wiphy.debugfsdir);
604 mutex_unlock(&cfg80211_mutex);
606 flush_work(&rdev->scan_done_wk);
607 cancel_work_sync(&rdev->conn_work);
608 kfree(rdev->scan_req);
609 flush_work(&rdev->event_work);
611 EXPORT_SYMBOL(wiphy_unregister);
613 void cfg80211_dev_free(struct cfg80211_registered_device *rdev)
615 struct cfg80211_internal_bss *scan, *tmp;
616 rfkill_destroy(rdev->rfkill);
617 mutex_destroy(&rdev->mtx);
618 mutex_destroy(&rdev->devlist_mtx);
619 list_for_each_entry_safe(scan, tmp, &rdev->bss_list, list)
620 cfg80211_put_bss(&scan->pub);
624 void wiphy_free(struct wiphy *wiphy)
626 put_device(&wiphy->dev);
628 EXPORT_SYMBOL(wiphy_free);
630 void wiphy_rfkill_set_hw_state(struct wiphy *wiphy, bool blocked)
632 struct cfg80211_registered_device *rdev = wiphy_to_dev(wiphy);
634 if (rfkill_set_hw_state(rdev->rfkill, blocked))
635 schedule_work(&rdev->rfkill_sync);
637 EXPORT_SYMBOL(wiphy_rfkill_set_hw_state);
639 static int cfg80211_netdev_notifier_call(struct notifier_block * nb,
643 struct net_device *dev = ndev;
644 struct wireless_dev *wdev = dev->ieee80211_ptr;
645 struct cfg80211_registered_device *rdev;
650 rdev = wiphy_to_dev(wdev->wiphy);
652 WARN_ON(wdev->iftype == NL80211_IFTYPE_UNSPECIFIED);
655 case NETDEV_REGISTER:
656 mutex_init(&wdev->mtx);
657 INIT_LIST_HEAD(&wdev->event_list);
658 spin_lock_init(&wdev->event_lock);
659 mutex_lock(&rdev->devlist_mtx);
660 list_add(&wdev->list, &rdev->netdev_list);
661 rdev->devlist_generation++;
662 /* can only change netns with wiphy */
663 dev->features |= NETIF_F_NETNS_LOCAL;
665 if (sysfs_create_link(&dev->dev.kobj, &rdev->wiphy.dev.kobj,
667 printk(KERN_ERR "wireless: failed to add phy80211 "
668 "symlink to netdev!\n");
671 wdev->sme_state = CFG80211_SME_IDLE;
672 mutex_unlock(&rdev->devlist_mtx);
673 #ifdef CONFIG_WIRELESS_EXT
674 if (!dev->wireless_handlers)
675 dev->wireless_handlers = &cfg80211_wext_handler;
676 wdev->wext.default_key = -1;
677 wdev->wext.default_mgmt_key = -1;
678 wdev->wext.connect.auth_type = NL80211_AUTHTYPE_AUTOMATIC;
679 wdev->wext.ps = wdev->wiphy->ps_default;
680 wdev->wext.ps_timeout = 100;
681 if (rdev->ops->set_power_mgmt)
682 if (rdev->ops->set_power_mgmt(wdev->wiphy, dev,
684 wdev->wext.ps_timeout)) {
685 /* assume this means it's off */
686 wdev->wext.ps = false;
690 case NETDEV_GOING_DOWN:
691 switch (wdev->iftype) {
692 case NL80211_IFTYPE_ADHOC:
693 cfg80211_leave_ibss(rdev, dev, true);
695 case NL80211_IFTYPE_STATION:
697 #ifdef CONFIG_WIRELESS_EXT
698 kfree(wdev->wext.ie);
699 wdev->wext.ie = NULL;
700 wdev->wext.ie_len = 0;
701 wdev->wext.connect.auth_type = NL80211_AUTHTYPE_AUTOMATIC;
703 __cfg80211_disconnect(rdev, dev,
704 WLAN_REASON_DEAUTH_LEAVING, true);
705 cfg80211_mlme_down(rdev, dev);
713 #ifdef CONFIG_WIRELESS_EXT
714 cfg80211_lock_rdev(rdev);
715 mutex_lock(&rdev->devlist_mtx);
717 switch (wdev->iftype) {
718 case NL80211_IFTYPE_ADHOC:
719 cfg80211_ibss_wext_join(rdev, wdev);
721 case NL80211_IFTYPE_STATION:
722 cfg80211_mgd_wext_connect(rdev, wdev);
728 mutex_unlock(&rdev->devlist_mtx);
729 cfg80211_unlock_rdev(rdev);
732 case NETDEV_UNREGISTER:
733 cfg80211_lock_rdev(rdev);
735 if (WARN_ON(rdev->scan_req && rdev->scan_req->dev == dev)) {
736 rdev->scan_req->aborted = true;
737 ___cfg80211_scan_done(rdev);
740 mutex_lock(&rdev->devlist_mtx);
742 * It is possible to get NETDEV_UNREGISTER
743 * multiple times. To detect that, check
744 * that the interface is still on the list
745 * of registered interfaces, and only then
746 * remove and clean it up.
748 if (!list_empty(&wdev->list)) {
749 sysfs_remove_link(&dev->dev.kobj, "phy80211");
750 list_del_init(&wdev->list);
751 rdev->devlist_generation++;
752 mutex_destroy(&wdev->mtx);
753 #ifdef CONFIG_WIRELESS_EXT
754 kfree(wdev->wext.keys);
757 mutex_unlock(&rdev->devlist_mtx);
758 cfg80211_unlock_rdev(rdev);
761 if (!(wdev->wiphy->interface_modes & BIT(wdev->iftype)))
762 return notifier_from_errno(-EOPNOTSUPP);
763 if (rfkill_blocked(rdev->rfkill))
764 return notifier_from_errno(-ERFKILL);
771 static struct notifier_block cfg80211_netdev_notifier = {
772 .notifier_call = cfg80211_netdev_notifier_call,
775 static void __net_exit cfg80211_pernet_exit(struct net *net)
777 struct cfg80211_registered_device *rdev;
780 mutex_lock(&cfg80211_mutex);
781 list_for_each_entry(rdev, &cfg80211_rdev_list, list) {
782 if (net_eq(wiphy_net(&rdev->wiphy), net))
783 WARN_ON(cfg80211_switch_netns(rdev, &init_net));
785 mutex_unlock(&cfg80211_mutex);
789 static struct pernet_operations cfg80211_pernet_ops = {
790 .exit = cfg80211_pernet_exit,
793 static int __init cfg80211_init(void)
797 err = register_pernet_device(&cfg80211_pernet_ops);
799 goto out_fail_pernet;
801 err = wiphy_sysfs_init();
805 err = register_netdevice_notifier(&cfg80211_netdev_notifier);
807 goto out_fail_notifier;
809 err = nl80211_init();
811 goto out_fail_nl80211;
813 ieee80211_debugfs_dir = debugfs_create_dir("ieee80211", NULL);
815 err = regulatory_init();
822 debugfs_remove(ieee80211_debugfs_dir);
824 unregister_netdevice_notifier(&cfg80211_netdev_notifier);
828 unregister_pernet_device(&cfg80211_pernet_ops);
832 subsys_initcall(cfg80211_init);
834 static void cfg80211_exit(void)
836 debugfs_remove(ieee80211_debugfs_dir);
838 unregister_netdevice_notifier(&cfg80211_netdev_notifier);
841 unregister_pernet_device(&cfg80211_pernet_ops);
843 module_exit(cfg80211_exit);